为了开始新应用的收录工作,请使用 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 必须指向脚本所理解的项目格式。目前,这只限于以下格式之一:
- GitLab -
https://gitlab.com/<PROJECTNAME>/<REPONAME> - GitHub -
https://github.com/<USER>/<PROJECT> - Bitbucket -
https://bitbucket.org/<USER>/<PROJECT>/ - NotABug -
https://notabug.org/<USER>/<PROJECT> - 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
选项告诉它项目目录的位置。导入程序不会尝试自动确定项目目录,因为可能有多个选项。
