MAUI 打包安卓 APK 不难,但几个关键步骤漏掉一个,就装不上或一启动就闪退。核心就四步:改格式、配权限、打发布、加签名。
把默认 AAB 改成 APK 格式
MAUI 默认生成的是 Google Play 要求的 AAB 包,本地安装必须用 APK。改法有两种,推荐直接改项目文件:
双击项目名打开 .csproj 文件,在<propertygroup></propertygroup>里加一行:
<androidpackageformat>apk</androidpackageformat>保存后,在 Visual Studio 中右键项目 → “属性” → Android → “选项”标签页 → 确认“Android 包格式”已设为 apk 确保当前是 Release 配置(顶部工具栏切换),不是 Debug
配置 AndroidManifest.xml 和基础信息
这个文件在
Platforms\Android\AndroidManifest.xml,不配好会安装成功但打不开。 打开它,检查并补充必要权限,比如网络、存储、定位等,例如:
<uses-permission android:name="android.permission.INTERNET"></uses-permission>核对
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 可反复安装,只要不换密钥,后续更新也能覆盖安装。临时密钥记得备份好,丢了就得重装用户数据。
