Skip to content

Latest commit

 

History

History
90 lines (63 loc) · 5.23 KB

CORDOVA.md

File metadata and controls

90 lines (63 loc) · 5.23 KB
Raw

Мобильное приложение GOLOS Блоги

Работает на Android.

git clone https://github.com/golos-blockchain/ui-blogs

Сборка приложения

Для сборки требуется Linux (например, Ubuntu 18 - 20).

  1. Если у вас Linux современных версий (например Ubuntu 20 или выше) - установите Node.js 18 (Windows, Linux).
    Если у вас Ubuntu 18 или иной старый Linux - установите Node.js 16.

  2. Установите Android Studio.

  3. Запустите Android Studio. Установите все, что будет предложено при установке.

  4. Создайте пустое приложение Android (с любым Activity и конфигурацией), соберите его. Это нужно для проверки правильности установки Android Studio.

  5. Запустите терминал.

  6. Установите глобальные зависимости:

npx yarn global add [email protected]
  1. Скачайте репозиторий с помощью git clone (команда есть выше), и зайдите в его папку с помощью:
cd ui-blogs
  1. Внесите все настройки в файле config/mobile.json:
  • site_domain (пример: golos.id то есть основной домен Блогов)
  • images
  • auth_service
  • notify_service
  • wallet_service
  • messenger_service
  • app_updater
  1. Установите все зависимости (для сборки).
npx yarn install
  1. Выполните команду (/root/ - это должен быть ваш путь к папке профиля, в ней лежит папка Android):
export ANDROID_SDK_ROOT=/root/Android/Sdk
  1. Установка совместимой системы сборки.

Установите JDK (отдельно от Android Studio):

sudo apt-get install openjdk-8-jdk

После этого команда javac -version должна выдавать ответ вида: javac 1.8.x

Установите Gradle (отдельно от Android Studio):

sudo apt-get install gradle

Добавьте /root/Android/Sdk/platform-tools в переменную PATH (для adb, вспомогательное, для сборки не обязательно)

  1. Откройте Android Studio, а из нее откройте SDK Manager (кнопка "☰" -> Tools -> SDK Manager). Установите Android build tools 30.0.3. Для этого слева выбираете Languages & Frameworks -> Android SDK, во вкладках сверх выбираете SDK Tools, включаете Show package details, отключаете Hide obsolete packages, после чего выбираете нужную версию Build tools и нажимаете Apply для установки.

  2. Если собираетесь автоматически устанавливать и запускать приложение (а не вручную, перекинув apk на устройство), то сделайте следующее. Подключите устройство по USB (разрешив отладку) и убедитесь, что adb видит его, выполнив в командной строке команду

adb devices
  1. Соберите приложение.
npx yarn run build:mobile

Сборка происходит в два этапа - сначала собирается код React с помощью Webpack, затем на его основе собирается мобильное приложение с помощью Cordova.

Этап Cordova может выдавать ошибки, которые нужно устранить дополнительно.

В случае ошибки с требованием установить Build Tools нужной версии или иные компоненты, необходимо поступить как описано в пункте 12, выбрав нужную версию нужного компонента и установив. Затем снова попробовать собрать (используя при этом команду npx yarn run postbuild:mobile, чтобы не повторять этап Webpack, который уже выполнен).

В случае успешной сборки собранный APK будет в cordova/platforms/android/app/build/outputs/apk/debug Кроме того, APK сразу же устанавливается на устройство. Об успешной установке свидетельствует сообщение INSTALL SUCCESS. Ошибка типа "sh" ?? ????? говорит о том, что устройство не обнаружено (например, проблемы с разъемом, кабелем).