当前位置：首页 > news >正文

.NET MAUI框架编译Android应用流程

news 2025/8/13 5:06:21

基础介绍

.NET MAUI (Multi-platform App UI) 是微软推出的跨平台应用开发框架，允许开发者使用C#和XAML创建可在Windows、macOS、iOS和Android上运行的原生应用。

本文档将详细介绍如何使用.NET MAUI编译Android应用。

核心优势

跨平台开发：一套代码，多平台运行
原生性能：提供接近原生应用的性能表现
统一开发体验：使用熟悉的C#语言和.NET生态系统
单一代码库：维护一套代码即可支持多个平台
丰富的生态系统：利用.NET生态系统的强大功能

简单使用

环境搭建

以下只介绍.net MAUI的环境配置，关于Android开发环境的配置不再描述；

安装与配置

vs安装时需要选择安装时选择以下工作负载

在这里插入图片描述

安装.NET MAUI环境，命令如下：

dotnet workload install maui
dotnet workload install maui-android

验证.NET MAUI是否成功安装，命令如下：

dotnet workload list

创建项目

创建新的MAUI项目

使用命令行创建项目：dotnet new maui -n MyMauiApp
或使用Visual Studio模板:File -> New -> Project -> .NET MAUI App.

配置Android设置

修改项目文件 (MyMauiApp.csproj)

<Project Sdk="Microsoft.NET.Sdk"><PropertyGroup><TargetFrameworks>net9.0-android</TargetFrameworks><TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net9.0-windows10.0.19041.0</TargetFrameworks><OutputType>Exe</OutputType><RootNamespace>MyMauiApp</RootNamespace><UseMaui>true</UseMaui><SingleProject>true</SingleProject><ImplicitUsings>enable</ImplicitUsings><!-- Android特定配置 --><SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">21.0</SupportedOSPlatformVersion><SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'windows'">10.0.17763.0</SupportedOSPlatformVersion><TargetPlatformMinVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'windows'">10.0.17763.0</TargetPlatformMinVersion></PropertyGroup>
</Project>

在Platforms/Android/AndroidManifest.xml目录下配置Android清单文件如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"><application android:allowBackup="true" android:icon="@mipmap/appicon" android:roundIcon="@mipmap/appicon_round" android:supportsRtl="true"></application><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><uses-permission android:name="android.permission.INTERNET" />
</manifest>

签名配置

配置签名文件

生成签名文件后，将签名文件、签名别名等信息填入项目配置中，比如MyMauiApp.csproj

<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'"><AndroidKeyStore>True</AndroidKeyStore><AndroidSigningKeyStore>sense.keystore</AndroidSigningKeyStore><AndroidSigningKeyAlias>sense</AndroidSigningKeyAlias><AndroidSigningKeyPass>sense123</AndroidSigningKeyPass><AndroidSigningStorePass>sense123</AndroidSigningStorePass>
</PropertyGroup>

编译方式

命令行编译

调试版本编译

# 编译Android调试版本
dotnet build -f net9.0-android# 或指定配置
dotnet build -f net9.0-android -c Debug

发布版本编译

# -p指定Android sdk的存在路径
dotnet publish -f net9.0-android -c Release -p:AndroidPackageFormat=apk -p:AndroidSdkDirectory="F:\AndroidBuilding\android-sdk"