17370845950

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