MAUI打包安卓APK需四步:改格式为apk、配置AndroidManifest.xml权限与基础信息、通过发布流程生成、添加签名。缺一将导致无法安装或闪退,签名密钥须备份以防更新失败。

MAUI 打包安卓 APK 不难,但几个关键步骤漏掉一个,就装不上或一启动就闪退。核心就四步:改格式、配权限、打发布、加签名。
把默认 AAB 改成 APK 格式
MAUI 默认生成的是 Google Play 要求的 AAB 包,本地安装必须用 APK。改法有两种,推荐直接改项目文件:
- 双击项目名打开 .csproj 文件,在
里加一行:apk - 保存后,在 Visual Studio 中右键项目 → “属性” → Android → “选项”标签页 → 确认“Android 包格式”已设为 apk
- 确保当前是 Release 配置(顶部工具栏切换),不是 Debug
配置 AndroidManifest.xml 和基础信息
这个文件在 Platforms\Android\AndroidManifest.xml,不配好会安装成功但打不开。
- 打开它,检查并补充必要权限,比如网络、存储、定位等,例如:
- 核对
android:label(应用名称)、android:versionName(显示版本号)、android:versionCode(整数版号,每次更新需递增) - 确认
android:icon指向正确的资源,如@mipmap/appicon,图标文件要放在Resources\AppIcon\下且命名合规(小写字母、数字、下划线)
执行发布并触发分发流程
别直接点“生成”,要用发布流程才能走签名环节:
- 右键项目 → “发布” → 等待存档完成(几秒到一分钟)
- 存档完成后,点击“分发…”按钮
- 选择“临时”频道(适合测试,不用申请正式证书)
- 点“+”新建签名标识,填好别名、密码、有效期(建议 25 年)、组织信息(随便填但不能空)
- 创建后选中它,点“另存为”,选好保存路径,输入刚才设的密码确认
安装与验证要点
生成的 APK 在你指定的路径里,但别急着装,先看两眼:
- 文件后缀必须是 .apk,不是 .aab 或 .zip
- 手机要开启“未知来源应用安装”权限(设置 → 安全 → 特殊权限)
- 首次安装可能提示“此应用未经过 Google Play 验证”,点“仍要安装”即可
- 装完打开闪退?大概率是
AndroidManifest.xml缺权限,或目标 SDK 版本太高没适配(可暂时设android:targetSdkVersion="33"测试)
基本上就这些。签好名的 APK 可反复安装,只要不换密钥,后续更新也能覆盖安装。临时密钥记得备份好,丢了就得重装用户数据。










