手机上把项目打包成 APK 的流程

本篇讲在 iApp 里把做好的项目生成 APK 安装包的完整流程，以及包名、签名这两件影响后续升级的事。相关文章：裕语言入门与第一个项目.md · 怎么下载安装到手机.md

一、打包前先定两件事

• 应用名与图标：这是装到手机后桌面上显示的东西，打包前在项目设置里改好；
• 包名：第一次就定好，之后不再改。包名相同的两个安装包，签名一致时后装的会覆盖先装的；包名不同，手机会把它们当成两个应用。

二、在手机上完成打包

iApp 的打包不需要电脑：在项目菜单里选打包（不同版本入口名称略有差异），等进度走完，APK 会保存到手机存储里指定的位置。

几个实际提醒：

• 打包耗时与项目体积成正比，素材多的项目等得久一点；
• 打完可以先用项目菜单里的「安装测试」类入口装到自己手机上跑一遍，再发给别人；
• 对方安装时同样会遇到「未知来源」提示，提前说一声，省得对方以为文件坏了。

三、签名：决定应用能不能「升级」

安卓体系里，覆盖安装（升级）要求前后两个 APK 包名一致且签名一致。落到日常使用：

• 同一个项目反复打包，签名跟着项目走，覆盖安装一般不成问题；
• 删了项目重做、或换了设备打包，遇到无法覆盖安装时，先卸载旧版再装新版（旧版数据会丢，重要项目先备份）；
• 打包相关的签名信息按软件内提示保管好，别随手清掉。

四、多端打包：安卓之外的入口

新的版本线（V7 及以后）里出现了多端打包方向：教程里有「打包成手机 App 应用」「打包成电脑 App 应用」「打包成网站 H5」这类课程，更新日志里还出现过鸿蒙端、iOS 端的打包记录。能不能用这些入口、各自怎么选，以打包界面里实际出现的选项为准——界面上没有，就是当前项目版本不支持。

五、打包常见失败原因

• 带病打包：明显报错的代码先修掉，带病打出的 APK 装上也会闪退；
• 包名冲突：改过包名又想覆盖旧版，会装不上，卸载旧的再装；
• 素材缺失：项目里引用的图片、音频丢失，打包可能报错，导入项目时注意素材要完整。

打好的 APK 直接传文件就能发给别人；自己换手机时想连项目源码一起带走，靠的是备份与云端上传，不是这个 APK。上手环节遇到问题的，回裕语言入门与第一个项目.md或怎么下载安装到手机.md对号入座；iApp 的整体功能与界面截图，也可以在 iApp 介绍站里翻一翻。