.gitignore для проектів PhoneGap / Cordova 3.0 - що я повинен зробити?

Я просто спробував створити новий проект phonegap 3.0 ... Примітка: я новачок у phonegap. У будь-якому випадку, я бачу, що папка проекту містить:

• .cordova
• merges
• platforms
• plugins
• www

І спробувавши, phonegap local run androidя бачу багато бінарних / генерованих файлів у platforms/android. Це не цікавить мене, які частини цієї структури папок слід додати до мого сховища git. Як правило, я вважаю вкрай поганою практикою введення бінарних файлів. Тому я зазвичай додавати шаблони , як bin/, obj/, *.o, і *.pycт.д. , щоб .gitignoreуникнути забруднення мого GIT сховища з речами , які тільки служить для створення злиття конфліктів.

Безумовно, wwwслід додати git, але як щодо інших частин проекту. Наскільки вони є продуктами вихідного коду та до якого розміру вони конфігурують проект?

Що ти робиш? Звичайно, я новачок, тому я ледве розумію, у чому тут сенс ...

Відповідь залежить від того, на яких платформах ви розробляєте додаток phongap, і якщо ви дотримуєтесь стандартної структури каталогів.

Якщо ваша структура каталогів проекту є стандартною, ви можете почати з цього gitignore та змінити його для своїх потреб.

За правилом ви повинні виключати всі згенеровані файли, такі як bin/і gen/каталоги. Якщо ви розробляєте версію програми для Android, вам слід також виключити файли збірки *.apk.

Усі генеровані файли у androidпідкаталозі також повинні бути виключені:

Android/bin/
Android/gen/
Android/assets/

Розширення на відповідь @Jake Moshenko:

Мені подобається ідея пропустити platformsкаталог. Насправді я вмію виключати pluginsі platformsкаталоги, і каталоги. Гарна відправна точка для .gitignore:

platforms/
plugins/

Проблема в цьому полягає в тому, що чиста копія репо повинна бути ініціалізована, перш ніж ви дійсно можете працювати з нею. Можливо, має сенс створити сценарій init, такий як:

#!/bin/bash
textReset=$(tput sgr0)
textGreen=$(tput setaf 2)
message_info () {
  echo "${textGreen}[my-app]${textReset} $1"
}

message_info "Creating necessary directories..."
mkdir plugins
mkdir platforms

message_info "Adding platforms..."
# If using cordova, change to: cordova platform add android
phonegap build android
phonegap build ios

message_info "Adding plugins..."
# If using cordova, change to: cordova plugin add
phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git

Застереження цього підходу полягає в тому, що він робить трохи складніше налаштувати конкретний код програми / конфігурацію платформи поза тим, що підтримується phonegap / cordova (тобто підтримка орієнтації на екран).

Оновлення: Bash Gist

Цей суть містить більш повний сценарій для обробки проекту, який не виконує завдання pluginsта platformsкаталоги. Він забезпечує механізм копіювання значків та зображень на екрані splashscreen з www до каталогів платформи (для iOS та Android), встановлення плагінів та обробки конкретних файлів платформи, які слід додати до контролю версій.

Оновлення: Grunt Gist

Ось ще одна істота, яка є портом Grunt згаданого сценарію bash. (Дякую @obie за те, що він запропонував бурчати).

Тож я просто з'ясував це через спроби та помилки. platformsКаталог може бути опущений , якщо ви використовуєте PhoneGap локальну або віддалену збірку, так як він генерується на льоту. Усі інші папки, включаючи приховану папку .cordova, потрібні.

Я просто хотів залишити тут свій досвід з цим питанням та підхід, який ми нарешті дотримувались.

У нашому проекті phonegap ми почали фіксувати всі файли, за винятком папки / платформи, використовуючи файл .gitignore. Ми думали так, коли розробник клонував сховище, єдиною дією, що залишилася зробити, було б виконання:

phonegap / cordova додати платформу

Але це було не так Після того, як платформу було додано, і ми спробували її скласти, з’явилася помилка, і додаток не встановлено на пристрої.

Оглядаючи журнали, ми отримали кілька звернень, що ця помилка була пов’язана із плагінами. Тож ми вирішили перевстановити всі плагіни, які ми використовували в проекті, і вимкнути, що програма запуститься правильно.

Тому моя порада - зберегти у сховищі весь вміст за винятком платформи папок та плагінів. Створіть та завантажте у сховище файл README зі списком плагінів, використаних у проекті.

Таким чином, коли розробник клонує сховище, йому / їй доведеться:

1.- Додати платформи: phonegap / cordova додати платформу "платформа"

2.- Додайте плагіни: phonegap / cordova plugin додайте "плагін"

Сподіваюся, це допомагає!

З повагою

Багато цих матеріалів є старими і насправді не стосується останньої версії Apache Cordova. Я використовую Apache Cordova 5.1.1, і цей .gitignore дозволяє мені все-таки налаштувати користувацькі піктограми тощо, блокуючи всі речі, які нам не потрібні для версії для Android та IOS. Так .gradle використовується, тому не видаляйте його!

www/
.gradle/
build/
.tmp/
.temp/
coverage/
*.log
node_modules/
bower_components/

Хоча це дещо особисті переваги, я пішов із цим (для проекту лише для Android). Видалення більшості, але збереження звичаю

ToonPlane/platforms/android/*
!ToonPlane/platforms/android/AndroidManifest.xml
ToonPlane/plugins/*
!ToonPlane/plugins/android.json
!ToonPlane/plugins/fetch.json