Para ajudar a iniciar o trabalho na inclusão de uma nova aplicação, use
fdroid import para configurar um novo projeto de modelo. Tem dois modos de
operação, a começar com um git repo clonado:
git clone https://gitlab.com/fdroid/fdroidclient
cd fdroidclient
fdroid import
Ou a começar com um URL para uma página de projeto:
fdroid import --url=http://address.of.project
Quando uma URL é especificada a usar a flag --url=, fdroid import usará
essa URL para encontrar informações sobre o projeto e se encontrar um git
repo, também irá clonar-lo. Para que isso funcione, a URL deve apontar para
um formato de projeto que o script entenda. Actualmente, está limitado a um
dos seguintes:
- GitLab -
https://gitlab.com/<NOME PROJETO>/<NOME REPO> - GitHub -
https://github.com/<UTILIZADOR>/<PROJETO> - Bitbucket -
https://bitbucket.org/<USADOR>/<PROJETO>/ - NotABug -
https://notabug.org/<USADOR>/<PROJETO> - Git -
git://<REPO>orhttps://<REPO>
A depender do tipo de projeto, ou mais ou menos informações podem ser coletadas. Um URL de repositório vazio, por exemplo git://, é a opção menos preferível de todas, já que terá que inserir muito mais informações manualmente. Enquanto as compilações baseadas em gradle devem ser auto-detectadas para todos os tipos, links para rastreadores de problemas não podem ser definidos para projetos git simples. Também pode usar um dos seguintes argumentos para preencher seus metadados previamente:
-u <URL>,--URL = <URL>: URL do projeto de onde importar.-s <DIR>,--subdir = <DIR>: Caminho para o subdiretório principal do projeto Android, se não estiver na raiz.-c <CATEGORIES>,--categories=<CATEGORIES>: Lista separada por vírgulas de categorias.-l <LICENSE>,--license=<LICENSE>: Licença geral do projeto.--revision <REV>: Permite que uma revisão diferente (ou ramo git) seja especificada para a importação inicial
Se a importação for bem-sucedida, um ficheiro de metadados será criado. Precisará editar-lo ainda mais para verificar as informações e preencher os espaços em branco.
Se falhar, será informado por quê. Se chegou tão longe para recuperar o
código-fonte, pode inspecioná-lo mais a olhar em tmp/importador onde um
checkout completo existirá.
Uma causa frequente de falha inicial é que o diretório do projeto é
realmente um subdiretório no repositório. Neste caso, execute o importador
novamente a usar a opção --subdir para o dizer onde. Ele não tentará
determinar-lo automaticamente, pois pode haver várias opções.
