maui android 命令行发布流程

2026-06-07 04:35 197 阅读

.NET 10 MAUI Android 命令行发布流程

重要:所有操作均需在命令提示符(cmd)中进入项目目录(即 .csproj 文件所在目录)

前置条件

  • 已安装 .NET 10 SDK
  • 已安装 Android SDK 和对应平台工具
  • 已安装 Java JDK(用于 keytool 命令)

1. 创建密钥文件(首次发布需要)

使用 keytool 命令生成签名密钥,用于对 APK 进行数字签名:

keytool -genkeypair ^
  -v ^
  -keystore myapp.keystore ^
  -alias myapp ^
  -keyalg RSA ^
  -keysize 2048 ^
  -validity 10000

参数说明

参数 说明
-keystore 密钥库文件名
-alias 密钥别名
-keyalg 加密算法
-keysize 密钥大小(位)
-validity 有效期(天)

💡 提示:执行后系统会提示输入密钥密码、存储密码以及组织信息,请妥善保管这些信息。


2. 发布 APK

执行 dotnet publish 命令生成已签名的 APK 文件:

dotnet publish ^
  -f net10.0-android ^
  -c Release ^
  -p:AndroidPackageFormats=apk ^
  -p:RuntimeIdentifier=android-arm64 ^
  -p:PublishTrimmed=true ^
  -p:AndroidKeyStore=true ^
  -p:AndroidSigningKeyStore=myapp.keystore ^
  -p:AndroidSigningKeyAlias=myapp ^
  -p:AndroidSigningKeyPass=你的密钥密码 ^
  -p:AndroidSigningStorePass=你的存储密码

⚠️ 安全提醒:请将命令中的 你的密钥密码你的存储密码 替换为第1步中实际设置的密码。

参数说明

参数 说明
-f net10.0-android 目标框架
-c Release 发布配置
AndroidPackageFormats apk 输出格式(可选 aab
RuntimeIdentifier android-arm64 运行时标识
PublishTrimmed true 启用剪裁以减小体积
AndroidKeyStore true 启用密钥库签名
AndroidSigningKeyStore myapp.keystore 密钥库文件路径
AndroidSigningKeyAlias myapp 密钥别名
AndroidSigningKeyPass - 密钥密码
AndroidSigningStorePass - 密钥库密码

支持的运行时标识(RID)

RID 说明
android-arm64 64位 ARM 设备(推荐)
android-arm 32位 ARM 设备
android-x86 x86 模拟器/设备
android-x64 x64 模拟器/设备

输出位置

生成的 APK 文件位于:

项目目录/bin/Release/net10.0-android/android-arm64/publish/