AAPS 构建器设置页面
在 GitHub 中构建你自己的 AAPS 应用。无需安装任何程序，也无需使用终端。首次大约需要 10 分钟，之后每次构建都由你手动启动。
使用 AAPS Builder 在浏览器中构建页面中通过屏幕截图对每个步骤进行了更详细的说明。请在另一个标签页中打开并保持该页面。
下面的按钮会在新的 Chrome 标签页中打开 GitHub。要返回本页面，请点击 Chrome 地址栏旁边的标签页按钮（带数字的方框），然后选择本页面。
第 1 步 – 创建你的私有构建仓库
这会在你的 GitHub 账户中创建一个空的私有仓库。只有你能看到它以及它构建的应用。你不需要复刻 AndroidAPS：每次构建时，AAPS 源代码都会从官方 AndroidAPS 仓库下载。
首先在此浏览器中登录 github.com（没有账户？可以免费创建一个）。然后回到这里。请使用你的用户名（显示在 GitHub 个人资料中），不要使用电子邮箱：本页面会向 GitHub 查询该用户名是否存在。
请保留建议的名称。如果你已经使用其他名称创建了仓库，请在此输入该名称（必须完全一致）。
你的仓库：
如果你已经自行创建了空的私有仓库，请不要点击下面的按钮：在上面输入其准确名称，然后转到第 2 步。
在打开的 GitHub 页面中，名称已填好，并且已选择 Private。不要更改任何内容，也不要添加 README 或其他文件。
点击绿色的 Create repository 按钮。
回到本页面继续第 2 步。
第 2 步 – 添加构建工作流
构建工作流是告诉 GitHub 如何构建 AAPS 的文件。它来自 AAPS 文档：查看工作流。
-
打开：
，新文件.github/workflows/build.yml，内容已预先填好。 检查顶部的文件名是否为
.github/workflows/build.yml。不要更改文本内容。点击 Commit changes…，然后在打开的窗口中再次点击 Commit changes。
要更新工作流，或文本区域为空？
-
如果是首次添加工作流，请改用上面的按钮。
用复制的工作流替换全部文本（在手机上长按），然后点击两次 Commit changes…。
第 3 步 – 你的签名密钥
应用必须使用你自己的密钥签名。始终使用同一个密钥，否则更新时必须先卸载 AAPS（并丢失其设置）。请选择下面两个标签页中的一个。
例如来自 Android Studio（.jks）。
第一次构建 AAPS？你可以在此浏览器中创建新密钥。任何内容都不会发送到其他地方。
请备份你的密钥！
下载该文件。请将以下三项放在手机之外的安全位置，并放在一起（例如你自己的云存储中）：
文件
aaps-keystore.jks你的密码
密钥别名：
key0
如果以后要用其他方式构建 AAPS（例如使用 Android Studio），这三项缺一不可。
第 4 步 – 将密钥提供给你的仓库
请先完成第 3 步。
-
打开：
显示“Page not found”（404）？首先检查你是否已在此浏览器中登录 github.com：未登录时，GitHub 会对私有仓库显示 404。否则，第 1 步中填写的用户名或仓库名称与实际仓库不一致：请在 github.com 上检查，然后在第 1 步中重新输入。
点击“Copy name”，然后将其粘贴到较小的“Name”字段中：
KEYSTORE_SET点击“Copy secret”，然后将长代码粘贴到较大的“Secret”框中：
secret 是一段非常长的代码（数千个字符），不是单词 KEYSTORE_SET。请先复制并粘贴名称，再复制并粘贴这段长代码。
点击“Add secret”。完成后无需再次执行此操作。
第 5 步 – 构建应用
-
打开：
显示“Page not found”（404）？首先检查你是否已在此浏览器中登录 github.com：未登录时，GitHub 会对私有仓库显示 404。否则，第 1 步中填写的用户名或仓库名称与实际仓库不一致：请在 github.com 上检查，然后在第 1 步中重新输入。
打开的是 GitHub 应用？点击“RUN WORKFLOW”，检查版本和 variant，然后再次点击“RUN WORKFLOW”。如果应用仍显示“Nothing to see here”，请下拉列表以查看你的构建。
如果系统询问，请点击绿色按钮启用工作流。
点击“Run workflow”，然后点击绿色的“Run workflow”按钮。“latest”会构建最新的 AAPS 版本。
等待约 15–30 分钟。绿色对勾表示构建完成。
想在构建完成时收到电子邮件吗？GitHub 仅在构建失败时发送邮件。若成功时也要收到邮件，请在 github.com 上依次打开你的头像 → Settings → Notifications → System → Actions，然后取消勾选“Only notify for failed workflows”。
没有“Build AAPS”/“Run workflow”按钮？
打开你的仓库，检查文件
.github/workflows/build.yml是否存在。如果缺少该文件或文件名不同，请再次执行第 2 步。打开 Actions 标签页。如果显示工作流已禁用，请点击绿色按钮启用工作流。然后在列表中点击“Build AAPS”。
第 6 步 – 在手机上安装
每次更新前：备份你的设置！
在 AAPS 中：维护 → 导出设置。（无论如何都应定期执行，例如更改 profile 后或每月一次。）
将导出的文件复制到手机之外，例如 Google Drive 或 Dropbox。只保存在手机上的备份会与手机一起丢失。
也将 APK 文件和几份较早的导出文件保存在那里。这样你随时都能回退。
在手机上的网页浏览器（Chrome）中打开本页面。如果系统询问，请登录 github.com。
-
打开的是 GitHub 应用？该应用无法下载构建产物。在应用中打开最新的构建并点击“Artifacts ↗”，或者点击分享图标并选择 Chrome（或选择“Copy link”，然后将链接粘贴到 Chrome 地址栏）。继续在 Chrome 中操作。
显示“Page not found”（404）？首先检查你是否已在此浏览器中登录 github.com：未登录时，GitHub 会对私有仓库显示 404。否则，第 1 步中填写的用户名或仓库名称与实际仓库不一致：请在 github.com 上检查，然后在第 1 步中重新输入。
要阻止 GitHub 链接在应用中打开：Android 设置 → 应用 → GitHub → 默认打开 → 关闭“打开支持的链接”。
点击带绿色对勾 ✅ 的最新构建。
向下滚动到构建摘要，然后点击大号链接“📱 Download AAPS …”（或者继续向下滚动到“Artifacts”，点击 aaps-….apk）。请用手指在文本上滚动，不要在构建步骤示意图上滚动。
下载完成后，点击文件并选择安装。如果系统询问，请允许从此来源安装应用。
aaps-wear-….apk 用于智能手表。如果你不使用智能手表，请跳过它。
APK 不会显示在仓库的“Code”下，而只会显示在构建页面中。它会保留 14 天。
有新的 AAPS 版本？备份设置，然后按照第 5 步构建。你的仓库不会自行构建任何内容。
第 7 步 – 可选：将应用保存到 Google Drive
希望 APK 出现在 Google Drive 中（永久保存）？再添加一个 secret。
按照 AAPS 文档中的说明获取 GDRIVE_OAUTH2 值（需要在电脑上使用官方 AAPS 准备页面）：将构建产物保存到 Google Drive。
-
打开：
显示“Page not found”（404）？首先检查你是否已在此浏览器中登录 github.com：未登录时，GitHub 会对私有仓库显示 404。否则，第 1 步中填写的用户名或仓库名称与实际仓库不一致：请在 github.com 上检查，然后在第 1 步中重新输入。
点击“Copy name”，然后将其粘贴到较小的“Name”字段中：
GDRIVE_OAUTH2将 GDRIVE_OAUTH2 值粘贴到较大的“Secret”框中，然后点击“Add secret”。
下一次构建时，APK 也会保存到 Google Drive 的 AAPS/<version> 文件夹中。
如果你连续 6 个月没有构建，或更改了 Google 密码，Google 会停止该访问权限。构建会显示相应提示：请重新执行此步骤。
本页面的所有操作都在浏览器中完成。你的密钥和密码不会发送到任何地方，除非你亲自将其粘贴在那里。只有你的 GitHub 用户名会发送给 GitHub，用于检查该用户名是否存在。本页面和工作流属于 AAPS 文档，基于 AAPS Builder（AGPL-3.0）。
长代码已复制：请将其粘贴到较大的“Secret”框中，然后点击“Add secret”。
名称已复制：请将其粘贴到较小的“Name”字段中。
✓ 找到 GitHub 用户。
✗ 没有名为此名称的 GitHub 用户。请使用你的用户名（显示在 GitHub 个人资料中），不要使用电子邮箱。
已复制 ✓
请先在第 1 步输入你的 GitHub 用户名。
工作流已复制（版本 {v}）。请将其粘贴到 GitHub。
工作流版本 {v} 已准备就绪。
无法读取工作流文件。请重新加载本页面后重试。
密码和别名不能包含字符 |
请选择你的 keystore 文件。
请填写密码和别名。
Keystore 密码错误。
密钥密码错误。
在 keystore 中找不到该别名。可用别名：{aliases}
这看起来不像 keystore 文件。
Keystore 正确！继续第 4 步。
已读取 keystore。构建时会检查密码。继续第 4 步。
密码必须至少包含 8 个字符。
只能使用 a–z、A–Z、0–9 和 ! ? # – 等符号——不能有空格、重音字母，也不能包含 |
两次输入的密码不一致。
正在创建密钥…
密钥已创建。请下载下面的备份，然后继续第 4 步。