Importar Aplicações

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:

  1. GitLab - https://gitlab.com/<NOME PROJETO>/<NOME REPO>
  2. GitHub - https://github.com/<UTILIZADOR>/<PROJETO>
  3. Bitbucket - https://bitbucket.org/<USADOR>/<PROJETO>/
  4. NotABug - https://notabug.org/<USADOR>/<PROJETO>
  5. Git - git://<REPO> or https://<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.