Question

为了开始新应用的收录工作，请使用 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 将使用这个 URL 来查找项目的信息，如果找到一个 git 代码库就会克隆它。为了使其发挥作用，URL 必须指向脚本所理解的项目格式。目前，这只限于以下格式之一:

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

项目类型不同，收集到的信息量就可能不同。 裸代码库 URL（如 git:// url）是最不可取的选项，因为你必须手动输入很多信息。虽然基于 gradle 的构建应该针对所有类型的版本进行自动检测，但对于普通 git 项目，不能设置指向问题跟踪器的链接。你还可以使用以下参数之一来预填充元数据：

• -u <URL>, --url=<URL>：要导入的项目的 URL。
• -s <DIR>, --subdir=<DIR>: 如果该项目不在根目录下，则指定主 Android 项目子目录的路径。
• -c <CATEGORIES>, -categories=<CATEGORIES>: 逗号分隔的类别列表。
• -l <LICENSE>, --license=<LICENSE>: 项目整体的许可。
• --revision <REV>：允许为初始导入指定不同的修订版（或 git 分支）

如果导入成功，将创建一个元数据文件。你将需要进一步编辑这个文件，以检查信息并填写空白处。

如果导入失败了，你会被告知原因。如果它检索到了源代码，你可以在 tmp/importer 中进一步检查，那里会有完整的 checkout。

初次导入失败的一个常见原因是，项目目录实际上是存储库中的一个子目录。在这种情况下，再次运行导入程序，并使用 --subdir 选项告诉它项目目录的位置。导入程序不会尝试自动确定项目目录，因为可能有多个选项。