Установка Ionic на Ubuntu 18.04 (Bionic Beaver)

Требования

• Сервер или рабочая машина под управлением Ubuntu 18.04 (Bionic Beaver).
• Непользователь root с правами sudo.

Важно: перед установкой убедитесь, что у вас стабильное подключение к интернету и достаточно свободного места для загрузки node_modules (обычно десятки мегабайт, может быть больше).

Установка Node.js и Cordova

По умолчанию в репозитории Ubuntu 18.04 может не быть нужной версии Node.js. В руководстве используется установка через официальный PPA от NodeSource (примеры для ветки 8.x, как в оригинале). Команды выполняйте в терминале под пользователем с sudo:

sudo apt-get install python-software-properties -y  
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -

Далее установите Node.js:

sudo apt-get install nodejs -y

После этого установите Cordova глобально через npm:

sudo npm install -g cordova

Коротко: Node.js — среда выполнения JavaScript. Cordova — мост к нативным API (камера, GPS и т.д.).

Установка Ionic Framework

Ionic предоставляет CLI для создания, сборки и упаковки гибридных приложений. Установите его глобально:

sudo npm install -g ionic

Проверить версию Ionic можно командой:

ionic -v

Пример вывода в оригинале был:

3.20.0

Создание проекта в Ionic

Создайте новый проект Cordova/Ionic в удобной папке:

ionic start HelloWorld blank

Это создаст директорию HelloWorld. Перейдите в неё и посмотрите содержимое:

cd HelloWorld/  
ls -l

В оригинальном примере список файлов выглядел так (примерное содержимое проекта):

total 260
-rw-r--r--   1 3434 3434     92 Jun  9 15:43 ionic.config.json
drwxr-xr-x 536 root root  20480 Jun  9 15:46 node_modules
-rw-r--r--   1 3434 3434   1135 Jun  9 15:43 package.json
-rw-r--r--   1 root root 224175 Jun  9 15:46 package-lock.json
drwxr-xr-x   6 3434 3434   4096 Jun  9 15:43 src
-rw-r--r--   1 3434 3434    519 May 30 23:39 tsconfig.json
-rw-r--r--   1 3434 3434    178 May 30 23:39 tslint.json

Добавление Android-платформы и сборка

Чтобы подготовить проект под Android и запустить сборку/эмуляцию, выполните:

ionic platform add android  
ionic cordova build android  
ionic cordova emulate android

Если вы собираете на физическом устройстве, убедитесь, что включена отладка по USB и установлены соответствующие драйверы/SDK.

Отладка и частые проблемы

• npm или npm install ругается на права: избегайте использования sudo для локальных пакетов; глобальные пакеты можно устанавливать через sudo, как в примерах, или настроить npm без sudo.
• Cordova не находит Android SDK: убедитесь, что ANDROID_HOME и PATH настроены (Android SDK и Java JDK должны быть установлены).
• Эмулятор не запускается: установите Android Emulator и соответствующие системные образы через Android SDK Manager.

Совет: после ошибки внимательно читайте вывод команд — он обычно подсказывает недостающие зависимости.

Когда это не сработает

• Если вы используете новую версию Ubuntu или требуете актуального Node.js, замените setup_8.x на setup_14.x или другую поддерживаемую версию в зависимости от требований проекта.
• Для нативной разработки (лучше производительность, доступ ко всем API) используйте Android Studio/Gradle напрямую на Java/Kotlin и Xcode для iOS.

Альтернативные подходы

• Ionic с Capacitor: современная альтернатива Cordova, которую поддерживает команда Ionic. Капаситор проще интегрируется с нативными API и плагинами.
• React Native или Flutter: если нужна более «нативная» производительность и сложная логика UI.

Чек-лист для разработчика

• Ubuntu 18.04 и пользователь с sudo.
• Установлен Node.js через NodeSource.
• Установлен cordova и ionic глобально.
• Создан проект ionic start.
• Добавлена платформа android.
• Собрана и/или заэмулирована сборка.

Совместимость и миграция

• Оригинальные команды используют Node.js 8.x. Для новых проектов проверьте совместимость версий Ionic/Cordova с более новыми версиями Node.js.
• При миграции на Capacitor потребуется адаптация плагинов и build-скриптов.

Критерии приёмки

• Проект успешно создается командой ionic start без ошибок.
• ionic -v возвращает версию CLI.
• ionic cordova build android выполняется и генерирует APK/билд без ошибок.

Роль-based checklist

• Девелопер: настроить локальную среду, создать проект, проверить UI в браузере (ionic serve).
• Инженер сборки: настроить CI для сборки Android, добавить keystore и переменные окружения.
• Тестировщик: запустить эмулятор/физическое устройство и проверить основные сценарии (таргетные API, камера, GPS).

Итог

Вы установили Node.js, Cordova и Ionic на Ubuntu 18.04, создали проект и выполнили сборку для Android. Если планируете долгосрочную разработку, проверьте совместимость версий и подумайте о Capacitor как современной альтернативе Cordova.

Короткое резюме:

• Используйте PPA NodeSource для установки Node.js.
• Устанавливайте cordova и ionic через npm.
• Создавайте проект с ionic start и добавляйте платформы через ionic platform add.