命令行构建说明

适用于熟悉命令行和 git 的用户

构建 AAPS 最简单的方式是使用浏览器构建。

已在 Fedora 和 Debian Linux 上测试；其他系统只需进行少量调整即可使用。

要求

请从此表确认所需的最低 Java 版本。使用系统软件包管理器安装相应的 OpenJDK 软件包。例如在 Debian 中，软件包名称类似于 openjdk-21-jdk，其中应包含 javac 和 keytool 二进制文件。

从 Android Studio 页面下载 Android Command line tools 软件包。无需安装 Android Studio 本身。有关安装此软件包的更多信息，请参阅 sdkmanager 文档。安装软件包后，手动设置两个环境变量：ANDROID_HOME 和 PATH。最后运行 sdkmanager --licenses 完成安装。

使用 Gradle wrapper 构建 AAPS

1. 生成用于签名 AAPS 的 Java 密钥库文件

如果已经有用于签名 AAPS 的密钥库文件，请重复使用该文件。

keytool -genkeypair -v \
  -keystore aaps-keystore.jks \
  -alias aaps-key \
  -keyalg RSA \
  -keysize 4096 \
  -validity 20000

每次更新 AAPS 时，都需要密钥库文件和密码短语。

2. 编译 AAPS APK 文件

如果尚未克隆，请克隆 git 仓库。AAPS 使用 master 分支提供最新稳定版本；请确保位于希望构建的分支或标签上。

在仓库中运行 ./gradlew :app:assembleFullRelease。该命令会自动下载 Gradle 和依赖项，然后编译代码。构建成功后，应在 app/build/outputs/apk/full/release/app-full-release-unsigned.apk 找到未签名 APK。它还应在 $ANDROID_HOME 中安装 apksigner 二进制文件。再次更新 PATH。

3. 从未签名 APK 创建已签名 APK 文件

切换到主目录并创建已签名 APK 文件：

apksigner sign \
  --ks path/to/aaps-keystore.jks \
  --ks-key-alias aaps-key \
  --out app-full-release-signed.apk \
  ./AndroidAPS/app/build/outputs/apk/full/release/app-full-release-unsigned.apk

现在你已拥有可用于安装或升级的 app-full-release-signed.apk。