浏览器构建：故障排除

备注

此页面汇总了浏览器构建.

AAPS-CI 故障排除

aaps-ci-preparation 网页

  • 当您使用文件管理器打开 aaps-ci-preparation.html 时，它将在您的手机上启动一个临时本地服务器来显示网页并接收 Google 刷新令牌。

  • 此本地服务器在大约 10 分钟后超时。如果您看到下面的屏幕，则文件管理器已经关闭了本地服务器。

  • 关闭**准备页面和文件管理器应用，然后从文件管理器重新打开 aaps-ci-preparation.html 并完成剩余步骤。在设置过程中创建初始 Google 连接时尤其需要这样做。

aaps_ci_html_not_found

Google 刷新令牌已过期

  • 如果 6 个月未使用，Google OAuth2 刷新令牌将会过期，并且在其他情况下也可能会失效（例如，您更改了 Google 账户密码，或手动撤销了访问权限）。有关更多详细信息，请参阅 Google OAuth2 文档。

  • 您将看到一条错误，指示访问令牌无效，如下所示：

aaps_ci_token_expired

  • 如果您的构建由于 Google 刷新令牌过期或撤销而失败，您将需要重做 Google Drive Auth 步骤以获取新的 GDRIVE_OAUTH2 令牌并更新 GitHub 存储库中的密钥，然后重新运行构建工作流程。

    • 如果授权再次失败，或者 Google 不再征求您的同意，请先从您的 Google 账户中删除现有的 AAPS 访问权限，请参阅下文。

从您的 Google 账户中删除 AAPS 访问权限并重新启动授权

  • 如果Google Drive授权一直失败，或者您想从干净的状态重新开始，请先删除您之前授予AAPS的访问权限，然后重新进行授权。

  • 在您的手机上，打开 https://myaccount.google.com，点击 安全，向下滚动到 您与第三方应用和服务的连接，然后打开链接的应用列表。您也可以直接前往https://myaccount.google.com/connections。

  • 点击列表中的 AAPS。

aaps_ci_google_access_1

  • 该页面显示您授予 AAPS（与应用一起使用的 Google Drive 文件）的访问权限。点击 全部删除 以删除连接，或点击 查看详细信息 首先查看它。

    aaps_ci_google_access_2

  • 在详细信息页面上，点击“删除所有访问权限”并确认。 AAPS 不再出现在链接的应用列表中。

aaps_ci_google_access_3

  • 现在彻底重新启动授权：关闭**准备页面和文件管理器应用，从文件管理器重新打开aaps-ci-preparation.html并重做Google Drive Auth步骤。 Google 将要求您再次授予访问权限，并且该页面将提供新的 GDRIVE_OAUTH2 令牌。

    • 使用新令牌更新 GitHub 存储库中的 GDRIVE_OAUTH2 密钥，然后重新运行构建工作流程。

禁用可能干扰 OAUTH 验证的软件

  • 在尝试获取 OAUTH 密钥之前，禁用手机上的任何 VPN 或安全应用（防火墙、反恶意软件等）。

检查 GitHub Actions 权限设置

  • 确保 GitHub Actions 策略设置为“允许所有操作和可重用工作流程”（设置 → 操作 → 常规）。

aaps_ci_actions_permission

actions/checkout@v4 和 actions/setup-java@v4 不允许在 xxxxx/AndroidAPS 中使用。 此工作流中的操作必须位于： xxxxx 拥有的存储库内

检查 GitHub 工作流程权限设置

  • 如果构建立即失败并出现类似于下面的“无效工作流程文件”错误，则说明存储库的默认工作流程权限限制过于严格：

Invalid workflow file
The workflow is not valid. .github/workflows/aaps-ci.yml (Line: 361, Col: 3):
Error calling workflow 'xxxxx/AndroidAPS/.github/workflows/cleanup-workflow-runs.yml@...'.
The nested job 'cleanup' is requesting 'actions: write', but is only allowed 'actions: none'.

  • 确保工作流程权限设置为“读写权限”（设置 → 操作 → 常规 → 工作流程权限），然后保存并重新运行构建工作流程。

aaps_ci_workflow_permissions

使用包含特殊字符的密码在签名步骤构建失败

  • 如果您的密码正确但在签署 APK 时构建失败，请检查您的 KEYSTORE_PASSWORD 或 KEY_PASSWORD 是否包含 $、反引号、" 或 \。构建工作流程解析这四个字符并更改或截断密码。

  • 在 GitHub 中编辑秘密，并仅在这四个字符前面添加一个反斜杠 \。例如，对于密码 abc$def"ghi，请输入 abc\$def\"ghi。

  • 所有其他角色，包括 %、*、# 和 !，必须保持原样。他们前面的反斜杠将成为密码的一部分。

  • 重新运行构建工作流程。

  • 竖条| 是一种特殊情况。 选项 1 的准备页面将密钥库、密码和别名组合成一个由 | 分隔的 KEYSTORE_SET 机密，并且工作流程将其拆分为该字符。准备页面生成的密码仅包含字母和数字，因此选项 1 不会发生这种情况。只有当您自己根据包含 | 的密码组装 KEYSTORE_SET 密钥时，才会发生这种情况。在这种情况下，请删除 KEYSTORE_SET 并输入 选项 2 的单独密码。