构建 Android 应用

它能做什么

打开一个 Android 项目，点击编辑器工具栏里的 Android 图标 构建 APK。这个按钮只出现在 Android 项目中，也就是带有 app/build.gradle.kts 和 com.android.application 插件的项目。命令面板里的说明是：在手机上把这个 Android 项目编译成 APK。

创建 Android 项目

打开 项目，点按 新建 进入 新建项目。里面有两个 Android 模板。两者都是标准的 Gradle 项目，所以也能在 Android Studio 中打开。

安装 APK

构建结束后，面板会显示 APK 已就绪，以及耗时、大小和所用密钥。

1. 1点击 保存到“下载”。文件会保存到 Download/PocketCode/<项目名>-debug.apk。发布版构建的文件名以 -release.apk 或 -release.aab 结尾。
2. 2也可以点击 分享… 发送给其他应用。在 Android 9 上，无法从这个界面保存到“下载”，请使用 分享…。
3. 3在“文件”应用中打开该文件。第一次安装时，Android 会请求安装未知来源应用的权限。允许后即可安装。

发布版 APK 和 AAB

在 构建应用 面板里选择类型。发布版构建需要发布密钥。没有密钥时，面板会提示：你还没有发布密钥。请创建一个，或导入你已在使用的密钥。在添加密钥之前，构建 一直是灰色的。

构建完成后

• 发布版 APK 会保存为 <项目名>-release.apk。
• AAB 完成后，面板会提示：请在 Google Play Console 中上传此文件。应用包无法直接安装到手机上。
• 在 Galaxy S24 上，Compose 模板的发布版构建在启用 R8 的情况下用了 44 秒，APK 为 1.2 MB。

用 R8 压缩代码

R8 会压缩并混淆发布版构建的代码。只有当 app/build.gradle.kts 的 release 块里设置了 isMinifyEnabled = true，它才会生效。面板会提醒你这一点。

1. 1打开 app/build.gradle.kts，在 release 块里设置 isMinifyEnabled = true。
2. 2构建 发布版 APK 或 发布版应用包（AAB）。
3. 3R8 运行后，结果里会提示：R8 已混淆代码。请保留 app/build/outputs/mapping/release/mapping.txt。

• 请保留 mapping.txt。Play Console 用它来解读崩溃报告。
• 读取或写入文件的 R8 规则（例如 -printmapping 或 -include）出于安全考虑会被拒绝。
• 使用 Compose 时，R8 需要内存：在 Galaxy S24 上最多约 335 MB。内存较小的手机上可能会失败。

目前不支持的内容

目前在手机上构建还做不到的事。

• .java 文件暂时无法编译。它们会显示为 手机上暂不支持，并附上文件和行号。​尚未提供
• 不支持 Groovy 的 build.gradle。请使用 build.gradle.kts。​尚未提供
• 构建无法识别的内容会显示为 手机上暂不支持。不影响结果的设置会显示为 设置已忽略。​尚未提供
• 在内存较小的手机上，R8 可能会内存不足，使用 Compose 时更常见。​设备
• 读取或写入文件的 R8 规则会被拒绝。​有意为之
• PocketCode 不会安装 APK。你需要从“文件”应用中打开它。​有意为之
• 构建工具来自 Google Play，所以应用必须从 Google Play 安装。​Google Play
• 第一次构建需要联网，以下载工具和库。​需要网络

清除构建缓存

构建会把库和已编译的文件保存在手机上，让之后的构建更快。要释放这部分空间：

1. 1打开 设置。
2. 2点击 清除构建缓存：释放为构建 Android 应用而保存的库和已编译文件。
3. 3下一次构建会重新下载这些库。

常见问题

常见问题和处理办法。