Імпорт застосунків

Додати застосунок може бути простіше, якщо згенерувати шаблон за допомогою fdroid import. Це можна зробити двома способами, наприклад почавши з клонування git-репозиторію застосунку:

git clone https://gitlab.com/fdroid/fdroidclient
cd fdroidclient
fdroid import

Або одразу зазначивши URL-адресу сторінки проєкту:

fdroid import --url=http://address.of.project

За URL-адресою, зазначеною прапором --url=, fdroid import спробує виявити дані про проєкт. У разі виявлення git-репозиторію, його буде автоматично клоновано. Щоб це спрацювало, адреса має вказувати на підтримуваний формат проєкту. Наразі підтримуються такі формати:

  1. GitLab — https://gitlab.com/<ПРОЄКТ>/<РЕПОЗИТОРІЙ>
  2. GitHub — https://github.com/<КОМАНДА>/<ПРОЄКТ>
  3. Bitbucket — https://bitbucket.org/<КОМАНДА>/<ПРОЄКТ>/
  4. NotABug — https://notabug.org/<КОМАНДА>/<ПРОЄКТ>
  5. Git — git://<РЕПОЗИТОРІЙ> чи https://<РЕПОЗИТОРІЙ>

Залежно від типу проєкту, вдаватиметься зібрати різну кількість даних. Адреса простого репозиторію, як-от git://, — найменш бажаний варіант, бо більшість даних доведеться ввести вручну. Збірка на основі gradle зазвичай автоматично виявляється незалежно від типу репозиторію, але прості git-проєкти не дають змоги виявити посилання на трекери обговорень. Можете заздалегідь вказати певні метадані такими аргументами:

  • -u <URL>, --url=<URL>: Адреса проєкту, який слід імпортувати.
  • -s <КАТАЛОГ>, --subdir=<КАТАЛОГ>: Шлях до підкаталога головного Android-проєкту, якщо цей проєкт не в корені.
  • -c <КАТЕГОРІЇ>, --categories=<КАТЕГОРІЇ>: Розділений комами перелік категорій.
  • -l <ЛІЦЕНЗІЯ>, --license=<ЛІЦЕНЗІЯ>: Загальна ліцензія проєкту.
  • --revision <РЕВІЗІЯ>: Дає змогу вказати нетипову ревізію (чи git-гілку) для початкового імпорту

Якщо імпорт вдасться, буде створено файл метаданих. Відредагуйте його: перевірте виявлені дані й заповніть пропуски.

В разі помилки, вам буде повідомлено її причину. Якщо вдасться принаймні завантажити вихідний код, повна його копія буде в каталозі tmp/importer.

Часто збій трапляється на самому початку, бо каталог проєкту — це насправді один із підкаталогів репозиторію. В такому разі повторіть спробу імпорту, вказавши каталог опцією --subdir. Каталог не визначається автоматично, бо варіантів може бути декілька.