如何在 F-Droid 上发布您的应用？

F-Droid 是一个由社区维护的 Android 自由开源软件仓库，类似于 Google Play 商店。但与 Google Play 商店不同的是，F-Droid 只包含尊重用户自由的开源应用。

对于新手来说，在 F-Droid 上发布应用可能有点令人困惑。
最近，我在 F-Droid 上发布了我的第一个免费开源应用（点击此处查看）。

在这篇文章中，我将带您了解我在 F-Droid 上发布我的应用程序所遵循的步骤。

注意：您的应用只有完全开源（包括所有使用的库和依赖项）才能被 F-Droid 收录。点击此处了解更多关于其收录政策的信息。

请注意，我使用的是 Linux 环境，并没有在 Windows 机器上进行测试。

第一步：

首先你需要一个GitLab账号，因为 F-Droid 代码库托管在 GitLab 上。注册 GitLab 账号后，你需要 fork fdroiddata代码库。

第二步：

安装fdroidserver。可以使用 apt 命令完成此操作：

sudo apt install fdroidserver

但是，我在使用通过 apt 安装的 fdroidserver 时遇到了一些问题。
因此，我建议直接从 master 分支安装：

git clone https://gitlab.com/fdroid/fdroidserver.git
export PATH="$PATH:$PWD/fdroidserver"

步骤 3：

克隆 fdroiddata（或你的分支）并导入：

git clone https://gitlab.com/fdroid/fdroiddata
cd fdroiddata

第四步：

运行以下命令以确保程序能够正常fdroid工作并正确读取元数据文件：

fdroid init
fdroid readmeta

第五步：

使用fdroid import以下命令添加您的项目：

fdroid import --url https://github.com/YOUR-USERNAME/REPO --subdir app

在 --url 标签后替换为您的项目仓库链接。

步骤 6：

上述步骤将在元数据目录中创建一个文件，例如metadata/app.id.yml。
使用文本编辑器打开并编辑此文件：

nano metadata/YOUR-APP-ID.yml

您需要填写应用详情，例如类别、许可证、网站等。您可以在这里了解相关信息。

步骤 7：

运行以下命令以确保元数据文件完整且无错误：

fdroid readmeta

第 8 步：

运行以下命令清理文件：

fdroid rewritemeta YOUR-APP-ID

步骤 9：

运行以下命令，并确保它没有报告任何警告：

fdroid lint YOUR-APP-ID

如果出现任何警告，请修复它们。

第十步：

让我们使用以下命令来构建应用程序：

fdroid build -v -l YOUR-APP-ID

如果你的电脑上没有安装 Android SDK，或者安装不正确，你可能会在这一步遇到错误。别担心，安装 SDK 并正确设置路径即可。我的情况是路径设置不正确，所以我使用了以下命令来修正错误：

export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/tools

注意：如果由于机器上未配置的内容而仍然遇到任何错误/警告，我建议您进行下一步，并在将管道推送到 GitLab 后检查管道是否通过。

第 11 步：

现在您可以提交代码并推送到我们的 GitLab 仓库（您的 fork 版本）。您可以使用以下命令完成此操作：

git add .
git commit -m "Added <Your App Name Here>"
git remote set-url origin https://gitlab.com/YOUR-USERNAME/fdroiddata.git
git push -u origin master

第 12 步：

检查 CI/CD 流水线。现在您可以提交合并请求，F-Droid 维护人员将审核该请求，如果一切正常，他们会将其合并到主分支。

补充信息：如果您想添加图标、屏幕截图等图形资源，可以通过在应用仓库中添加 Fastlane 或 Triple-T 文件夹结构来实现。您可以点击此处了解更多信息。
例如，我在我的应用仓库中创建了以下文件夹：fastlane/metadata/android/，从而实现了 Fastlane 文件夹结构
。您可以将图形资源添加到 images 文件夹中。如果您想添加屏幕截图，需要在 images 文件夹内创建一个名为 phoneScreenshots 的文件夹，并将屏幕截图添加到该文件夹​​中。您还可以将摘要和描述添加到 fastlane/metadata/android/ 文件夹中，并将其从元数据 YML 文件中移除，这样每次更改描述、摘要等内容时，就无需提交新的合并请求。如果您需要参考，可以点击此处查看我的项目。最后，请不要忘记更新元数据 YML 文件中的提交 ID。

呼，终于结束了！

应用元数据合并后，可能需要一到两天才能在 F-Droid 应用商店中显示。

您可以使用官方图形在 F-Droid 上宣传您的应用程序下载。

<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" height="75">

你对F-Droid有什么看法？你是否在F-Droid上发布过你的应用？请在下方留言讨论。

参考：

1. https://gitlab.com/fdroid/fdroiddata/-/blob/master/CONTRIBUTING.md
2. https://www.f-droid.org/en/docs/Inclusion_Policy/
3. https://f-droid.org/docs/Build_Metadata_Reference/
4. https://f-droid.org/en/docs/All_About_Descriptions_Graphics_and_Screenshots/
5. https://blog.fossasia.org/publish-an-open-source-app-on-fdroid/