Importul de aplicații

Pentru a vă ajuta să începeți să lucrați la includerea unei noi aplicații, utilizați fdroid import pentru a configura un nou proiect șablon. Acesta are două moduri de operare, pornind de la un repo git clonat:

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

Sau începând cu un URL către o pagină de proiect:

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

Atunci când se specifică o adresă URL folosind indicatorul --url=, fdroid import va folosi acea adresă URL pentru a afla informații despre proiect, iar dacă găsește un repo git, îl va clona și pe acela. Pentru ca acest lucru să funcționeze, URL-ul trebuie să indice un format de proiect pe care scriptul îl înțelege. În prezent, acesta este limitat la unul dintre următoarele:

  1. GitLab - https://gitlab.com/<PROJECTNAME>/<REPONAME>
  2. GitHub - https://github.com/<USER>/<PROJECT>
  3. Bitbucket - https://bitbucket.org/<USER>/<PROJECT>/
  4. NuUnBug - https://notabug.org/<USER>/<PROJECT>
  5. Git - git://<REPO> sau https://<REPO>

În funcție de tipul de proiect, pot fi colectate mai multe sau mai puține informații. O adresă URL de repo goală, cum ar fi cea de la git://, este cea mai puțin preferabilă opțiune dintre toate, deoarece va trebui să introduceți manual mult mai multe informații. În timp ce compilările bazate pe gradle ar trebui să fie detectate automat pentru toate tipurile, legăturile către issue tracker nu pot fi setate pentru proiectele git simple. De asemenea, puteți utiliza unul dintre următoarele argumente pentru a precompleta metadatele:

  • -u <URL>, --url=<URL>: URL-ul proiectului din care se importă.
  • -s <DIR>, --subdir=<DIR>: Calea de acces către subdirectorul principal al proiectului android, dacă nu se află în root.
  • -c <CATEGORIES>, --categories=<CATEGORIES>: Lista de categorii separate prin virgulă.
  • -l <LICENSE>, --license=<LICENSE>: Licența generală a proiectului.
  • --revision <REV>: Permite specificarea unei revizuiri diferite (sau a unei ramuri git) pentru importul inițial

În cazul în care importul se realizează cu succes, se va crea un fișier de metadate. Va trebui să îl editați în continuare pentru a verifica informațiile și pentru a completa spațiile libere.

Dacă nu reușește, vi se va spune de ce. Dacă a ajuns până la recuperarea codului sursă, îl puteți inspecta mai departe, căutând în tmp/importer, unde va exista un checkout complet.

O cauză frecventă a eșecului inițial este faptul că directorul proiectului este de fapt un subdirector în depozit. În acest caz, rulați din nou importatorul folosind opțiunea --subdir pentru a-i spune unde. Acesta nu va încerca să determine acest lucru în mod automat, deoarece pot exista mai multe opțiuni.