Apache Cordova – це потужний фреймворк для розроблення мобільних застосунків із відкритим вихідним кодом, який дає змогу розробникам створювати кросплатформні мобільні застосунки, використовуючи стандартні веб-технології, такі як HTML, CSS і JavaScript. Використовуючи Cordova, розробники можуть створювати додатки, що працюють на декількох мобільних платформах, зберігаючи при цьому єдину кодову базу, що значно скорочує час і вартість розробки.
У цьому докладному посібнику ми розповімо вам про те, як установити Apache Cordova на Ubuntu 24.04 LTS, налаштувати необхідне середовище розробки і почати роботу над своїм першим проектом Cordova. Незалежно від того, чи є ви досвідченим розробником, чи тільки починаєте займатися розробкою мобільних застосунків, цей посібник надасть вам знання та інструменти для початку вашої подорожі Cordova на Ubuntu.
Попередні умови
Перш ніж ми перейдемо до процесу встановлення, давайте переконаємося, що у вас є все необхідне для успішного налаштування Apache Cordova на системі Ubuntu 24.04 LTS:
Системні вимоги
- Комп’ютер під керуванням Ubuntu 24.04 LTS (редакція Desktop або Server)
- Не менше 4 ГБ оперативної пам’яті (рекомендується 8 ГБ або більше для більш плавної роботи)
- Достатня кількість вільного місця на диску (щонайменше 10 ГБ для інструментів розробки та Android SDK)
- Активне підключення до Інтернету для завантаження необхідних пакетів та інструментів
Необхідне програмне забезпечення та інструменти
Щоб встановити й ефективно використовувати Apache Cordova, вам знадобляться такі програмні компоненти:
- js і npm (менеджер пакетів Node)
- Java Development Kit (JDK)
- Android Studio та Android SDK
- Git (система контролю версій)
Підготовка середовища Ubuntu 24.04 LTS
Перш ніж приступати до встановлення, рекомендується оновити систему. Відкрийте термінал і виконайте такі команди:
sudo apt update
sudo apt upgrade
Це дасть змогу переконатися, що у вашій системі встановлено останні пакети та оновлення безпеки.
Встановлення Node.js і npm
Node.js – найважливіший компонент для роботи Apache Cordova. Ми встановимо його разом із npm, який використовується для управління пакетами Node.js.
Використання офіційного репозиторію Node.js
Щоб переконатися, що у вас остання версія Node.js, ми скористаємося офіційним репозиторієм Node.js. Виконайте наступні кроки:
Встановіть необхідні пакети для додавання нового сховища:
sudo apt install curl software-properties-common
Додайте репозиторій NodeSource для Node.js 18.x (або останньої версії LTS):
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
Встановлення Node.js і npm через командний рядок
Додавши репозиторій, ви можете встановити Node.js і npm:
sudo apt install nodejs
Ця команда встановить і Node.js, і npm.
Перевірка встановлення
Щоб переконатися, що Node.js і npm були встановлені правильно, перевірте їхні версії:
node --version
npm --version
Ви повинні побачити номери версій Node.js і npm.
Встановлення Apache Cordova
Тепер, коли у нас налаштовані Node.js і npm, ми можемо приступити до встановлення Apache Cordova.
Використання npm для глобального встановлення Cordova
Щоб встановити Cordova глобально у вашій системі, використовуйте таку команду npm:
sudo npm install -g cordova
Прапор -g гарантує, що Cordova буде встановлена глобально, що зробить її доступною з будь-якої директорії у вашій системі.
Перевірка встановлення Cordova
Після завершення інсталяції переконайтеся, що Cordova була встановлена правильно, перевіривши її версію:
cordova --version
Ця команда має показати номер версії встановленої Cordova.
Розуміння інформації про версію Cordova
Інформація про версію не тільки підтверджує успішне встановлення, а й допомагає відстежувати версію Cordova, яку ви використовуєте. Це важливо для сумісності з плагінами, а також під час вивчення документації та посібників.
Налаштування середовища розробки Android
Щоб розробляти Android-додатки за допомогою Cordova, вам необхідно встановити середовище розробки Android в системі Ubuntu.
Встановлення комплекту засобів розробки Java (JDK)
Для розробки Android потрібен комплект засобів розробки Java. Встановіть OpenJDK за допомогою такої команди:
sudo apt install default-jdk
Переконайтеся в правильності встановлення, перевіривши версію Java:
java --version
Встановлення Android Studio та Android SDK
Android Studio надає найсучасніший Android SDK та інструменти. Для її встановлення виконайте такі дії:
- Завантажте Android Studio з офіційного сайту.
- Розпакуйте завантажений архів у відповідне місце, наприклад, /opt:
sudo tar -xvzf android-studio-*.tar.gz -C /opt
- Створіть запис на робочому столі для зручного доступу:
sudo nano /usr/share/applications/android-studio.desktop
Додайте такий зміст:
[Desktop Entry]
Version=1.0
Type=Application
Name=Android Studio
Exec=/opt/android-studio/bin/studio.sh
Icon=/opt/android-studio/bin/studio.png
Categories=Development;IDE;
Terminal=false
Запустіть Android Studio і дотримуйтесь вказівок майстра інсталяції, щоб встановити Android SDK і необхідні інструменти.
Налаштування змінних оточення
Щоб Cordova могла знайти Android SDK, необхідно налаштувати змінні оточення. Додайте такі рядки до файлу ~/.bashrc:
export ANDROID_SDK_ROOT=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_SDK_ROOT/tools/bin
export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools
Після збереження файлу перезавантажте його:
source ~/.bashrc
Створення першого проекту Cordova
Налаштувавши оточення, давайте створимо ваш перший проект Cordova.
Використання Cordova CLI для створення нового проекту
Щоб створити новий проект Cordova, виконайте таку команду:
cordova create MyFirstApp com.example.myfirstapp MyFirstApp
Ця команда створює нову директорію під назвою «MyFirstApp» з базовою структурою проекту Cordova.
Розуміння структури проекту
Перейдіть до каталогу проекту та вивчіть його структуру:
cd MyFirstApp
ls -l
Ви побачите такі каталоги, як www (де знаходиться ваш веб-додаток), platforms (для коду, специфічного для платформи) і plugins (для плагінів Cordova).
Додавання платформ до проєкту
Додайте платформу Android до свого проєкту:
cordova platform add android
Ця команда готує ваш проєкт до розробки під Android.
Створення та запуск програми на Cordova
Тепер, коли у нас є готовий проєкт, давайте зберемо і запустимо його.
Збірка програми для Android
Щоб створити додаток для Android, виконайте команду:
cordova build android
Ця команда компілює ваш веб-додаток і створює APK-файл для Android.
Запуск програми на емуляторі
Щоб запустити додаток на емуляторі Android, виконайте такі дії:
- Створіть віртуальний пристрій Android (AVD) за допомогою менеджера AVD в Android Studio.
- Виконайте таку команду:
cordova emulate android
Розгортання на фізичному пристрої
Щоб запустити додаток на фізичному пристрої Android, виконайте такі дії:
- Увімкніть налагодження по USB на пристрої Android.
- Підключіть пристрій до комп’ютера через USB.
- Запустіть:
cordova run android
Усунення загальних проблем
У процесі інсталяції та розробки ви можете зіткнутися з деякими проблемами. Тут наведено рішення поширених проблем:
Проблеми зі шляхами та змінними оточення
Якщо ви зіткнулися з помилкою «команда не знайдена», переконайтеся, що ваш PATH правильно встановлений у ~/.bashrc. Двічі перевірте шляхи до Android SDK та інструментів платформи.
Конфлікти залежностей
Якщо ви зіткнулися з конфліктами залежностей, спробуйте очистити кеш npm і перевстановити Cordova:
npm cache clean --force
sudo npm install -g cordova
Помилки складання та їх вирішення
У разі виникнення помилок складання перевірте таке:
- Переконайтеся, що встановлено всі необхідні компоненти Android SDK.
- Переконайтеся, що файл config.xml вашого проекту правильно налаштований.
- Запустіть cordova requirements, щоб перевірити, чи всі вимоги виконані для ваших цільових платформ.
Найкращі практики та поради
Щоб забезпечити безпроблемну розробку з Cordova на Ubuntu 24.04 LTS, зверніть увагу на ці найкращі практики:
Підтримка Cordova та залежностей в актуальному стані
Регулярно оновлюйте Cordova та її залежності:
sudo npm update -g cordova
cordova platform update android
Оптимізація продуктивності в Ubuntu 24.04 LTS
- Використовуйте SSD-накопичувач для прискорення збірки та роботи емулятора.
- Виділіть достатньо оперативної пам’яті для Android Studio та емуляторів.
- Розгляньте можливість використання апаратного прискорення для емуляторів Android.
Міркування безпеки
- Постійно оновлюйте систему Ubuntu та інструменти розробки.
- Використовуйте HTTPS для будь-яких зовнішніх ресурсів у додатках Cordova.
- Регулярно перевіряйте та оновлюйте плагіни, які використовуються у ваших проєктах.
Вітаємо! Ви успішно встановили Apache Cordova. Для отримання додаткової допомоги або корисної інформації ми рекомендуємо вам відвідати офіційний сайт Apache.