应用源

添加、检查更新和安装应用的方式因来源和用户为该应用配置的设置而异。

以下选项适用于所有应用，无论其应用源如何：

• 仅跟踪：启用此选项后，您可以接收应用的更新通知，而无需尝试实际下载其 APK。这对于跟踪没有 APK 或无法通过 Obtainium 轻松提取 APK 的应用的更新非常有用。有些应用源只允许跟踪，例如 ApkMirror。请注意，版本检测对任何添加为仅跟踪的应用都不起作用。
• 版本检测：请参阅版本检测部分。
• 通过正则表达式筛选 APK：当一个应用版本有多个 APK 时，系统会提示用户手动选择一个。这除了操作不方便之外，还意味着应用将不会在后台静默更新，即使在其它情况下可以这样做。该选项可让用户指定一个正则表达式，用于筛去不匹配的 APK（最好只有一个选项）。
• 尽可能按 CPU 架构筛选 APK：该选项将使 Obtainium 自动筛选掉任何与用户设备不兼容的 APK。筛选逻辑非常简单，是基于 APK 文件名，因此并不总是可靠的，在许多情况下，用户可能仍需要自己进行筛选。
• 应用名称：这允许用户为应用指定自己的名称，而不是使用 Obtainium 提取的名称。
• 禁用后台更新：该选项将防止应用在后台静默更新，即使后台更新已启用，并且该应用符合在后台更新的所有条件。
• 跳过更新通知：通过此选项，Obtainium 将避免通知用户此应用有可用更新或已在后台更新。

除此以外，每个应用还有额外的特定应用源选项。其中大多数选项不言自明，而且可能会经常更新，因此本 Wiki 不涉及这些选项。不过，有些应用源确实有更特殊的行为，需要更多解释说明，下文将对此进行介绍。

当前支持的应用源

• 开源——通用：
  • GitHub
  • GitLab
  • Codeberg（Forgejo）
  • F-Droid
  • 第三方 F-Droid 仓库
  • IzzyOnDroid
  • SourceHut
• 其它——通用：
  • APKPure
  • Aptoide
  • Uptodown
  • itch.io
  • Huawei AppGallery
  • 腾讯应用宝
  • Vivo 应用商店
  • RuStore
  • Apk4Free
  • CoolAPK
  • Farsroid
  • LiteAPKs
  • Jenkins Jobs
  • APKMirror（仅跟踪）
  • RockMods（仅跟踪）
• 特定应用：
  • Telegram 应用
  • Neutron Code
• 下载直链
• “HTML”（后备）：返回包含 APK 文件链接的 HTML 页面的任何其它链接

GitHub

GitHub 对特定时间内的 API 请求数量设置了上限。由于 Obtainium 使用 GitHub API 抓取发布信息，因此如果你有几十个以上的来自 GitHub 源的应用，就可能会遇到“速率限制”错误。您可以添加个人访问令牌以解决此问题。

GitHub 还允许开发者托管其应用的多个版本。这通常是指同一应用的旧版本，但也可能包括预发布版本、变体等。——因此，Obtainium 提供了各种筛选器，让您可以浏览这些版本，并准确抓取您感兴趣的版本。

一些额外选项具有不太明显的含义：

• 验证最新标签：启用后，Obtainium 将选择开发者标记为"最新"的版本，而不是按时间顺序最近的版本。两者通常相同，但在某些情况下可能不同。这会额外消耗一次 GitHub API 调用（从而更快达到速率限制）。
• 排序方式：控制当有多个版本可用时的排序方式。默认按日期排序，"智能名称"排序尝试从版本标题推断版本顺序，"名称"排序使用严格的字母数字排序。"带日期回退的智能名称"选项使用基于名称的排序，但在名称无法比较时回退到基于日期的排序。
• 使用最新资产日期作为发布日期：启用后，显示的发布日期将是版本中最近上传资产的时间，而不是版本本身的发布时间。
• 检查仓库重命名：启用后，Obtainium 将检测仓库是否已重命名，并提示您相应更新应用的链接。

您还可以在源特定设置中提供 GitHub 代理前缀（例如 gh-proxy.com）。设置后，所有 GitHub API 请求都将通过该代理路由，这有助于解决某些地区的速率限制或访问问题。

GitHub 源支持搜索，并允许您按最低星标数筛选结果。

创建 GitHub 个人访问令牌

1. 登录 GitHub。
2. 进入开发者设置中的 Fine-grained tokens。
3. 选择 Generate new token。
4. 给 Token 命名并设置有效期。
5. 滚动到底部，选择 Generate token。
6. 复制 Token 并将其粘贴到 Obtainium 设置中。请立即复制您的 Token，因为您将无法再次查看。

GitLab

GitLab 发行版中的 APK 有时会以非标准方式附加，导致 Obtainium 无法轻松获取。GitLab API 提供了更可靠的提取 APK 的方式，但没有 API 密钥就无法使用。虽然这对大多数 GitLab 仓库来说都不是问题，但您可以在 Obtainium 的设置中添加自己的个人访问令牌，以便在极端情况下更可靠地提取 APK。

与 GitHub 一样，GitLab 也允许开发者托管同一应用的旧版本，因此我们会根据情况提供其它选项。

创建 GitLab 个人访问令牌

1. 登录 GitLab。
2. 进入设置中的个人访问令牌。
3. 选择添加新令牌。
4. 给令牌命名并设置有效期。
5. 勾选 read_api。
6. 滚动到底部，选择创建个人访问令牌。
7. 复制令牌并将其粘贴到 Obtainium 设置中。请立即复制您的令牌，因为您将无法再次查看。

何时需要这样做？

请参阅该解释，了解 GitLab 发行版中的非标准 APK 附件

F-Droid 第三方仓库

与大多数其它来源不同，F-Droid 仓库在同一链接下包含多个应用的信息。这意味着，除了版本库链接之外，您还必须单独在"应用 ID 或名称"字段中提供所需的应用名称或应用包名。如果您不确定特定仓库中包含哪些应用，可以使用导入/导出上的 "搜索来源"按钮来查找。

请注意，Obtainium 无法自动判断给定链接是否指向第三方 F-Droid 仓库。这意味着，默认情况下，向 Obtainium 添加第三方 F-Droid 仓库将导致错误使用 HTML 源（Obtainium 在无法识别任何链接时使用的后备源）。您必须从"覆盖来源"下拉菜单中手动选择"F-Droid 第三方仓库"，才能解决这个问题。

附加的版本选择选项具有不同的行为：

• 尝试选择建议的版本代码：Obtainium 将尝试使用 F-Droid 仓库标记为建议/当前版本的版本代码。这是默认设置，适用于大多数仓库。
• 自动选择最高版本代码：Obtainium 将选择仓库中版本代码号最高的版本，而不是建议的版本。如果仓库未正确标记建议版本，或者您希望确保始终获得数字上最高的版本，此选项非常有用。

APKMirror

APKMirror 是一个“仅跟踪”源。这意味着，虽然您可以将 APKMirror 链接添加到 Obtainium 以获取更新通知，但无法下载和安装应用。这是因为 APKMirror 的维护者不允许这样做（参见 issue #44）。

由于 APKMirror 使用 RSS 源检测新版本，您可以使用“按正则表达式筛选版本标题”选项来缩小其跟踪的版本范围。

HTML

“HTML”源是一个后备选项，可用于任何 Obtainium 不明确支持的应用源。由于其灵活性，它也是支持小众、不太流行的源，而不会使 Obtainium 变得臃肿的一种方式。

HTML 源的工作原理：

1. 首先向用户提供的源链接发送请求，并将响应解析为 HTML。然后在页面上查找链接。
2. 过滤掉某些链接。默认情况下，这是任何不以 .apk 结尾的链接，但您可以使用“自定义 APK 链接过滤器”来指定自己的过滤器。
3. 对剩余链接进行排序。这种排序是对整个链接进行字母数字排序，但你也可以选择只对链接的最后一段进行排序。最后一段通常是文件名，但如果在步骤 2 中使用了自己的过滤器，则可能不是。
4. 在所有剩余链接上应用另一个可选的用户定义过滤器。该过滤器与第 2 步中的过滤器的区别在于，它是所有应用源都有的更通用的过滤器——它继承自父类 AppSource（应用源中描述的 APK 过滤器选项）。在某些情况下使用它可能比在步骤 2 中使用一个更复杂的正则表达式更简单（示例请参见该评论）。与中间链接选项结合使用时也很有用。
5. 在剩余的链接中，它会选择第一个（如果启用了反向选项，则选择最后一个）。
6. 现在我们有了最终的 APK 链接，我们需要一个唯一的发布 ID 与之匹配，这样当 ID 发生变化时，我们就知道该应用有更新可用。对于其它源，唯一发布 ID 就是应用的版本，但对于 HTML 源，可能无法提取版本字符串。因此，默认情况下，将是链接的哈希值。有三种伪版本化方法可用：
   • 部分 APK 哈希（默认）：APK 文件部分的哈希值。这比链接哈希更可靠，因为它取决于文件内容，但需要下载部分 APK 进行计算。
   • APK 链接哈希：APK 下载链接的哈希值。链接更改时此值会更改。
   • ETag：使用来自 APK 下载响应的 HTTP ETag 标头。当服务器提供稳定的 ETag 但下载链接本身在不同版本间不变时，此方法很有用。
   • 此外，链接中通常会嵌入版本字符串。Obtainium 本身并不预知如何提取这些字符串（不同的网站会有不同的提取方法），因此用户可以选择指定一个正则表达式，应用于链接以提取版本——这就是"版本提取"的作用。
   • 但通常很难找到一个既能准确匹配版本，又能排除多余字符的正则表达式。为此，我们提供了"正则表达式匹配组"选项，让用户指定正则表达式中的哪个组作为版本。
   • 还有一个"提取整个页面的版本"开关。启用后，Obtainium 将尝试在 HTML 页面的任何位置查找版本字符串，而不仅仅在链接 URL 中。当版本显示在页面上但未嵌入下载链接时，此功能非常有用。
   • 版本提取功能其实并无必要——使用链接哈希值更简单、更可靠。有些用户可能只是想要它，因为真实版本看起来更漂亮/更准确，而且它允许 Obtainium 在大多数情况下使用版本检测。

您还可以为 HTML 源设置自定义请求标头。当目标网站需要特定标头才能正确提供 APK 时，您可以覆盖默认标头（例如 User-Agent）。

至于中间链接过滤器，如果使用该过滤器（请参阅 issue #820，了解在何种情况下该过滤器有用），HTML 源会在正常流程之前添加一个预备步骤：

1. 在初始 HTML 页面上查找链接。
2. 过滤掉与中间链接过滤器不匹配的任何链接。
3. 抓取剩余的第一个链接，然后将该链接作为输入提供给上述正常 HTML 源流程。

中间链接步骤有自己的子选项，用于控制如何过滤和排序链接：

• 按架构自动过滤：如果从链接文本中可检测到 CPU 架构，则自动过滤中间链接。
• 按链接文本过滤：启用后，中间链接过滤器正则表达式将应用于可见的链接文本，而不是 URL 本身。
• 匹配 <a> 标签外的链接：也匹配出现在标准锚标签之外的链接（例如嵌入在页面中的 JavaScript 数据结构中）。
• 跳过排序 / 反向排序 / 按最后链接段排序：这些选项控制在选择第一个链接之前中间链接的排序方式。

关于其它应用源的备注

• HTML：HTML 源包括默认的请求标头，这些标头应适用于大多数网站。在某些情况下（例如 SourceForge），您可能需要删除它们（也有可能需要自定义）。
• Codeberg：该源的附加选项几乎与 GitHub 相同，并且也支持搜索。
• F-Droid：任何来自 F-Droid 的应用都可能使用不同的密钥签名，与其它源的相同应用不同。这意味着从 F-Droid 发布的特定应用更新到来自其它源（如 GitHub）的应用很可能会失败。
• 腾讯应用宝：来自该源的 APK 可能为纯 32 位（armeabi-v7a）架构，无法安装在使用较新 Arm 架构 SoC 的某些设备上。
• itch.io：从 itch.io 下载可能需要处理"自定义定价"页面和 Cloudflare 保护的下载链接。某些应用可能需要通过 HTML 源的请求标头选项配置自定义 Cookie 或标头。
• 任何没有与之关联的特定服务器的源（如第三方 F-Droid 仓库、Jenkins 和 SourceHut）都不会被 Obtainium 自动识别。您必须从"覆盖来源"下拉菜单中手动选择正确的源。
• 某些源（如 APKPure）可能提供 XAPK 文件而非 APK 文件。Obtainium 的 XAPK 支持不完整，可能无法可靠运行。