MAUI怎么打包安卓应用 MAUI APK打包发布教程

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 可反复安装,只要不换密钥,后续更新也能覆盖安装。临时密钥记得备份好,丢了就得重装用户数据。