.NET MAUI 多平台应用 UI 应用

.NET 多平台应用 UI 使用文档

.NET 多平台应用 UI (.NET MAUI) 允许你使用面向 Android、iOS、macOS、Windows 和 Tizen 上的移动和桌面外形规格的 .NET 跨平台 UI 工具包生成本机应用。本教程介绍如何在 Windows 上的 Visual Studio 2022 或 Visual Studio 2022 for Mac 17.4 预览版中创建和运行第一个 .NET 多平台应用 UI (.NET MAUI) 应用。

1. 若要创建 .NET MAUI 应用，需要最新的 Visual Studio 2022：

   • 下载 2022 社区

   • 下载 2022 专业版

   • 下载 2022 企业版

   安装 Visual Studio 或修改安装，并使用默认可选安装选项安装 .NET 多平台应用 UI 开发工作负载，如果已经安装了vs2022 的话也可以使用Visual Studio Installer来修改安装：

   

2. 启动 Visual Studio 2022，并在“开始”窗口中单击“ 创建新项目 ”以创建新项目：

   

3. 在“创建新项目”窗口中，选择“所有项目类型”下拉列表中的 MAUI，选择 .NET MAUI 应用模板，然后单击“下一步”按钮：

   

    备注

   如果还安装了 .NET 7 预览版，则 Visual Studio 中可能不会显示 .NET MAUI 模板。 有关详细信息，请参阅 Visual Studio 中不显示 .NET MAUI 模板。

4. 在 “配置新项目 ”窗口中，为项目命名，选择合适的位置，然后单击“ 下一步 ”按钮：

   

5. 在 “其他信息 ”窗口中，单击“ 创建 ”按钮：

   

6. 等待创建项目并还原其依赖项：

   

7. 在 Visual Studio 工具栏中，使用 “调试目标” 下拉列表选择 Android 模拟器 ，然后选择 Android Emulator 条目：

   

8. 在 Visual Studio 工具栏中，按 Android 模拟器 按钮：

   

   Visual Studio 将开始安装默认的 Android SDK 和 Android 模拟器。

9. 在 Android SDK - 许可协议 窗口中，按 “接受 ”按钮：

   

10. 在 Android SDK - 许可协议 窗口中，按 “接受 ”按钮：

    

11. 在 “用户帐户控制 ”对话框中，按 “是 ”按钮：

    

12. 在 “许可接受 ”窗口中，按 “接受 ”按钮：

    

    等待 Visual Studio 下载 Android SDK 和 Android Emulator。

13. 在 Visual Studio 工具栏中，按 Android 模拟器 按钮：

    

    Visual Studio 将开始创建默认的 Android 模拟器。

14. 在 “用户帐户控制 ”对话框中，按 “是 ”按钮：

    

15. 在“ 新建设备 ”窗口中，按 “创建 ”按钮：

    

    等待 Visual Studio 下载、解压缩和创建 Android 模拟器。
    注意：如果下载失败，可以根据使用如下方法下载：点击站长之家 输入  dl-ssl.google.com  点击ping检测，下来找  到检测结果 ，复制一个响应时间和TTL较短的ip，然后打开C:\Windows\System32\drivers\etc 下的hosts文件添加如下内容

    #Android SDK Manager下载和更新失败方法详解
    74.125.23.93 dl-ssl.google.com

    之后保存，如果无法保存可以先把hosts文件拷贝出来，修改添加内容，之后保存，再复制粘贴到C:\Windows\System32\drivers\etc 下的hosts文件，覆盖即可，这样就可以下载了，如果还是不行的话，可以更换其他的响应时间和TTL较短的ip，多寿试试即可。

16. 关闭 Android 设备管理器 窗口：

    

17. 在 Visual Studio 工具栏中，按 Pixel 5 - API 30 (Android 11.0 - API 30) 按钮生成并运行应用：

    

    Visual Studio 将启动 Android 模拟器，生成应用，并将应用部署到模拟器。

     警告

    必须启用硬件加速才能最大限度地提高 Android 仿真器性能。 无法执行此操作将导致模拟器运行速度非常慢。 有关详细信息，请参阅 如何使用 Android 仿真器 (Hyper-V & HAXM) 启用硬件加速 。

    注意：这个启用硬件加速才能最大限度地提高 Android 仿真器性能，一般需要启用的，否则会很慢，还有可能会出现 Android 模拟器给出错误“冷启动重置:仿真引擎失败"；并退出，Android emulator gives error "Resetting for cold boot: emulation engine failed" and exits

    启用 HYPER-V 加速或者使用 HAXM 加速启用硬件以后就可以运行了，本文是安装HAXM，并使用 HAXM 加速启用硬件，运行就可以了

18. 在 Android 模拟器中正在运行的应用中，多次按 “单击我” 按钮，并观察按钮单击次数的计数递增。

    

后续步骤

本教程介绍如何创建并运行第一个 .NET 多平台应用 UI (.NET MAUI) 应用。

若要了解使用 .NET MAUI 生成应用的基础知识，请参阅 创建 .NET MAUI 应用。

参考教程：在 Windows 上的 Visual Studio 2022 中创建和运行第一个 .NET 多平台应用 UI (.NET MAUI) 应用。