1.3. Установка
1.3.1. Установка серверного ПО
Для установки программного обеспечения на собственные сервера требуется произвести следующие действия:
• Загрузить Архивы с ПО на сервер (в желаемую папку на усмотрение пользователя/администратора, осуществляющего установку экземпляра ПО), на котором предполагается установить развернуть платформу. В моём случае это будет /tmp.
• Перейти в директорию с загруженными архивами и выполнить следующие команды:
• tar -xvf cde.tar.gz
• docker load -i redis-alpine.tar
• docker load -i postgres12.tar
• docker load -i core-adapter-auth.tar
• docker load -i core-adapter-intercom.tar
• docker load -i core-adapter-video.tar
• docker load -i core-web.tar
• docker load -i core-main.tar
• cd cde/core-developer-environment
• docker-compose up -d
1.3.2. Создание мобильного приложения
1.3.2.1. Подготовка android studio:
Для запуска проекта можно использовать персональный компьютер с установленными ОС Linux, Mac OS или Windows. Далее по инструкции будем рассматривать запуск и сборку приложения из под системы Linux, также будет рассмотрена установка англо-язычной версии ПО.
Подготовка Android Studio для работы:
1. Прежде всего, вам необходимо загрузить установщик с официального сайта разработчиков. Перейдите на сайт и нажмите Download Android Studio.
2. Ознакомьтесь с лицензионным соглашением, активируйте чекбокс и нажмите кнопку Download Android Studio for Linux.
3. Дождитесь завершения скачивания.
4. Когда файл будет загружен, перейдите в папку с загрузками и распакуйте содержимое архива в /opt. Для этого используйте команду вида (укажите скачанную вами версию приложения вместо 202.7486908): sudo tar xf ~/Загрузки/android-studio-ide-202.7486908-linux.tar.gz -C /opt
5. Чтобы добавить ярлык в меню приложений, создайте файл androidstudio.desktop командой: vi ~/.local/share/applications/androidstudio.desktop
6. Добавьте в файл следующий текст и сохраните его:
[Desktop Entry] Version=1.0 Type=Application Name=Android Studio Exec="/opt/android-studio/bin/studio.sh" %f Icon=/opt/android-studio/bin/studio.png Categories=Development;IDE; Terminal=false StartupNotify=true StartupWMClass=android-studio
7. После этого установка будет завершена, и вы можете запустить среду разработки из главного меню, однако окончательная установка Android Studio ещё не завершена — программа должна скачать все необходимые компоненты и настройки. Если вы работали с Android Studio ранее, в следующем окне вы можете скопировать свои настройки. Если нет, — выберите Do not import settings и нажмите ОК.
8. Потребуется некоторое время, чтобы программа могла загрузить нужные компоненты и настроить систему.
9. На следующем экране нажмите кнопку Next.
10. После этого вы сможете выбрать между стандартной автоматической инсталляцией и ручной. Второй способ позволяет выбрать для установки отдельные компоненты.
11. Выберите предпочитаемую тему оформления.
12. Ознакомьтесь со списком компонентов и их расположением.
13. Приложение отобразит уведомление о том, можете ли вы использовать эмуляторы на своём компьютере (зависит от аппаратной составляющей).
14. Далее начнётся загрузка, которая может занять довольно много времени, скорость зависит от вашего интернет соединения.
15. Когда загрузка завершится, вы можете нажать Finish и перейти к открытию проекта.
1.3.2.2. Открытие проекта
Для открытия проекта требуется:
1. В появившемся окне нажать на Open an Existing Project или просто Open.
2. Найти папку с нужным проектом, нажать ОК.
3. Через какое-то время проект загрузится и можно будет приступить к созданию собственной версии приложения.
Далее по тексту подобным убразом будет обозначаться относительный путь до требуемой папки или файла:
./app/src/maintest или так ./res/values/app_configurations.xml
1.3.2.3. Создание собственного варианта приложения:
Для создания собственного варианта приложения требуется:
1. Скопировать папку ./yard-android/app/src/maintest и поместить его по этомуже адресу, но уже с вашим названием. (Например так ./yard-android/app/src/maintest)
2. Папка долна иметь обязательные ресурсы:
• ./res/values/app_configurations.xml
• ./res/values/strings.xlm
• ./res/google-services.json (создается автоматически при создании проекта в личном кабинете FireBase необходимо заменить этот фаил на свой)
3. Не обязательные файлы:
• ./res/values/drawable - иконки приложения;
• ./res/values/mipmap* - иконки приложения.
4. Изменить в файле ./res/values/strings.xlm - "app_name" - название приложения на свое.
5. Изменить в файле /res/values/app_configurations.xml:
• "scheme_app" - указать свое значение (сейчас служит идентификатором для уникальной сборки приложения (Например maintest));
• "auth_client" - CLIENT_ID организации на мультисервисной платформы.
6. Добавить в фаил ./app/flavors.gradle: Добавить к applicationDefinitions новый элемент массива ['name': 'maintest', applicationId: 'com.maintest.yard'] где, maintest должен соответствовать значению scheme_app из файла ./res/values/strings.xlm.
1.3.2.4. Сборка проекта
1. Открыть через пункт меню Build -> Generate Signed bundle/apk
2. В диалоговом окне выбрать APK. Указать путь к ключу подписи для приложения если такого нет, нужно создать.
3. В форме требуется указать путь к ключу подписи, который был создан или уже имеющийся.
Создается ключ подписи с кнопки `Create new...`:
Поля заполняются следующим образом:
- `Key store path - Путь до хранилища ключей;`
- `Password - Пароль от хранилища;`
- `Confirm - Повторить пароль;`
- `Alias - Название ключа (Указать свое значение `scheme_app`);`
- `Password - Пароль от ключа;`
- `Confirm - Повторить пароль;`
- `First and Last Name - Ваше Имя/фамилия;`
- `Organizational Unit - Название отдела;`
- `Organization - Название организации;`
- `City or Locality - Название города;`
- `State or Province - Название области;`
- `Country Code(XX) - Код города;`
- После указания данных нажимаем `OK`.
4. Далее в списке нужно выбрать наш вариант с названием нашей сборки+ надпись Release (пример - maintestRelease).
5. После нажатия на кнопку Finish будет собираться приложение. Готовое приложение будет находится в папке app/maintest/release/maintest-release.apk
1.3.2.5. Установка приложения
Для установки также понадобится выполнить несколько шагов:
1. Переместите полученный файл «apk» на Ваш смартфон
Зайдите в диспетчер файлов и перейдите в каталог с файлом
2. Нажмите на APK, после чего выберите установщик
3. Нажмите «Установить».
Подготовка приложения к использования закончена.