.NET MAUI 教程：入门与配置

.NET MAUI 教程：入门与配置

mauidotnet/maui: .NET MAUI (Multi-platform App UI) 是.NET生态下的一个统一跨平台应用程序开发框架，允许开发者使用C#和.NET编写原生移动和桌面应用，支持iOS、Android、Windows等操作系统。项目地址:https://gitcode.com/gh_mirrors/ma/maui

1. 项目的目录结构及介绍

在.NET Multi-platform App UI（简称.NET MAUI）项目中，目录结构通常如下：

YourProject/
├── Android/
│   └── ... // Android 平台相关的代码和资源
├── iOS/
│   └── ... // iOS 平台相关的代码和资源
├── macOS/
│   └── ... // macOS 平台相关的代码和资源
├── Shared/
│   ├── YourProject.Core.csproj // 共享业务逻辑和跨平台代码
│   └── ... // 跨平台的资源和类库
├── YourProjectiOS.csproj
├── YourProjectAndroid.csproj
├── YourProjectDesktop.csproj
├── YourProject.csproj // 主工程，包含所有子项目引用
└── MauiApp.cs // 应用入口点

• Shared/ 目录：存放跨平台的应用代码和资源。
• YourProjectiOS.csproj, YourProjectAndroid.csproj, YourProjectDesktop.csproj: 分别是iOS、Android和macOS平台的具体项目文件。
• YourProject.csproj: 主工程文件，包含所有子项目引用。
• MauiApp.cs: 应用的主入口点，继承自MauiApplication。

2. 项目的启动文件介绍

.NET MAUI应用的启动通常由MauiApp.cs文件控制。这个文件定义了应用的生命周期方法，如CreateBuilder()和Build()。在这里你可以设置服务容器，注册依赖项以及定制应用程序的行为。

一个典型的MauiApp.cs示例：

using Microsoft.Maui;
using Microsoft.Maui.Controls;

namespace YourProject
{
    public class MauiApp : MauiApplication
    {
        protected override MauiAppBuilder CreateBuilder()
        {
            return base.CreateBuilder()
                .UseMauiApp<YourApp>();
        }
    }

    public partial class YourApp : Application
    {
        public YourApp()
        {
            InitializeComponent();
        }
    }
}

• CreateBuilder(): 初始化MauiAppBuilder实例，用于构建整个应用程序。
• UseMauiApp<YourApp>(): 指定要使用的Application派生类，通常是你的YourApp类。

3. 项目的配置文件介绍

.NET MAUI项目主要通过.csproj文件进行配置，每个平台都有自己的.csproj文件。这些文件包含了项目属性、引用的库以及平台特定的编译指令。例如：

• YourProjectiOS.csproj: 包含iOS特定的配置，如设备目标、最小SDK版本等。
• YourProjectAndroid.csproj: 包含Android特定的配置，如支持的最低API级别、图标和主题设置等。

此外，还可以使用appsettings.json文件存储应用程序的配置数据，这在跨平台上共享配置非常有用。appsettings.json中的值可以通过Microsoft.Extensions.Configuration库在代码中访问。

请注意，由于.NET MAUI是一个快速发展的框架，其目录结构和配置文件可能随着新版本的发布而变化。确保查看最新的官方文档以获取最新信息。更多细节可以参考 .NET MAUI官方文档。

mauidotnet/maui: .NET MAUI (Multi-platform App UI) 是.NET生态下的一个统一跨平台应用程序开发框架，允许开发者使用C#和.NET编写原生移动和桌面应用，支持iOS、Android、Windows等操作系统。项目地址:https://gitcode.com/gh_mirrors/ma/maui