maui android 命令行发布流程
.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/