.NET MAUI 工作坊实战指南

.NET MAUI 工作坊实战指南

dotnet-maui-workshopA full day workshop (.NET MAUI Workshop in a Box) on how to build apps with .NET MAUI for iOS, Android, macOS, and Windows项目地址:https://gitcode.com/gh_mirrors/do/dotnet-maui-workshop

本教程旨在详细解析位于 https://github.com/dotnet-presentations/dotnet-maui-workshop.git 的开源项目。我们将深入了解其结构、启动文件以及核心配置，帮助开发者快速上手并深入探索.NET Multi-platform App UI (MAUI) 开发。

1. 项目目录结构及介绍

.NET MAUI 应用的目录结构体现了高度组织化和模块化的特性。以下是对该工作坊项目主要目录的解析：

主要目录解析

• .editorconfig: 定义代码风格的一致性规则。
• Assets: 包含应用所需的静态资源，如图标、 Splash 屏幕等。
• Platforms: 特定平台相关的配置或调整，尽管在许多现代.NET MAUI项目中，这部分可能较轻量，因为目标是跨平台一致性。
• Properties: 包含launchSettings.json，用于定义调试和启动配置。
• Pages: 存放所有UI页面，展示应用的功能界面。
• Program.cs 和 MainPage.xaml: 分别是应用的入口点和默认启动页面。
• Services, ViewModels, Models（如果存在）: 分别用于业务逻辑、视图模型和数据模型的组织。
• .csproj 文件: 项目文件，定义了项目依赖、编译选项等。

2. 项目的启动文件介绍

Program.cs

在.NET MAUI项目中，Program.cs 是程序的起点。它初始化应用程序并设置其主要上下文。示例代码通常包括启动应用的核心逻辑，如下所示：

using MauiApp1;

namespace MauiApp1
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateMauiApp().Run(args);
        }

        public static MauiApp CreateMauiApp()
        {
            return MauiApp.CreateBuilder()
                .UseMauiApp<App>()
                .ConfigureFonts(fonts =>
                {
                    fonts.AddFont("OpenSans-Regular.ttf", "OpenSans Regular");
                    fonts.AddFont("OpenSans-Semibold.ttf", "OpenSans Semibold");
                })
                .Build();
        }
    }
}

这段代码配置了应用程序的基础，指定了主类和字体配置。

MainPage.xaml

是应用展示的第一个界面，使用XAML语言定义UI布局和样式。例如：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="YourNamespace.MainPage">
    <StackLayout>
        <Label Text="Hello, World!" />
    </StackLayout>
</ContentPage>

此文件控制着初始显示的内容和外观。

3. 项目的配置文件介绍

.csproj

项目的元数据文件，包含了项目引用、编译属性、项目输出类型等关键信息。例如：

<Project Sdk="Microsoft.NET.Sdk.Maui">

  <PropertyGroup>
    <TargetFramework>net6.0-android;net6.0-ios;net6.0-macos;net6.0-windows10.0.19041</TargetFramework>
    ...
  </PropertyGroup>

  <!-- ...其他配置... -->

</Project>

appsettings.json (如果有)

虽然不在所有.NET MAUI项目中都存在，但如果项目中有，则通常存放应用程序的配置信息，供运行时读取使用，但特别注意在实际案例中检查是否存在此文件。

通过上述分析，开发者可以系统地了解项目的架构和基础配置，快速投入开发工作。

dotnet-maui-workshopA full day workshop (.NET MAUI Workshop in a Box) on how to build apps with .NET MAUI for iOS, Android, macOS, and Windows项目地址:https://gitcode.com/gh_mirrors/do/dotnet-maui-workshop