.NET MAUI 環境配置技巧

關於 .NET MAUI 國內⼩夥伴在配置 .NET MAUI 的時候，遇到不少問題。希望通過本教程，給到大家⼀些指引。

.NET SDK 安裝

建議安裝最新的 .NET SDK

下載地址 http://dotnet.microsoft.com/download/dotnet/6.0

安裝 .NET MAUI

安裝 .NET MAUI 成功後，通過 workload 新增 .NET MAUI 的庫。.NET workload 可以在 .NET SDK 的基礎上安裝，安裝不同應⽤場景的⽀持，如 .NET MAUI ， 如 Blazor 等。你可以通過命令⾏的⽅式，使⽤workload。

dotnet workload install maui

1. Linux 或者 macOS 需要管理員許可權，所以需要 sudo

2. 有⼩夥伴喜歡⽤ Visual Studio 2022 一站式安裝完成，該指引更偏向⼀步步調整

3. .NET 7 還在 RC 階段，等釋出會同步更新

.NET MAUI ⼤概每 2-3 周有⼀個版本的更新，所以建議各位⼩夥伴執行：

dotnet workload update maui

各位可以通過執⾏以下命令去檢查 .NET MAUI 的版本

dotnet workload list

有部分地區下載 Android SDK 和模擬器是有問題的，我這⾥說說⼀些解決辦法

JDK 安裝

安卓的環境依賴於 JDK ，微軟已經把原來的 Adoption OpenJDK 升級到 Microsoft OpenJDK 11 了。

你可以通過 http://learn.microsoft.com/java/openjdk/download 針對 Windows / macOS / Linux 開發平臺安裝最新的 Microsoft OpenJDK 版本 ， 並配置好 Java_HOME 和 PATH。

在 macOS / Linux 下 , JAVA_HOME , 和 PATH 的配置如下：

export JAVA_HOME="{你的 Java 安裝路徑}/Contents/Home"
export PATH="$JAVA_HOME/bin:$PATH"

在 Windows 下 的 Path 配置

Android SDK 安裝

在 Visual Studio 2022 安裝環境裝會把 Android Command line tools 和 Android SDK 的最新版本安裝好，這是最理想的情況，但如果各位⼩夥伴遇到⽹絡安裝問題，可以參考下⾯步驟⼀步步安裝。

Android SDK 離線版本下載地址

連結: http://pan.baidu.com/s/1lXRIwLpBaf0UgmvyRJg7BQ?pwd=m1qw

• 配置 Android SDK

在你的開發環境下，建立 SDK 的存放⽬錄(示例建立⽬錄為 Android/sdk)，在該⽬錄下建立以下⽂件夾

注意

這⾥提供 offline 的 Android SDK 包括 31， 32 ，33 分別對應 Android 12 ， Android 12.1 ， Android 13 ， 建議⼩夥伴都下載安裝好。

• ⽂件夾介紹

在你的開發環境下，建立 SDK 的存放⽬錄(示例建立⽬錄為 Android/sdk)，在該⽬錄下建立以下⽂件夾南方）；太陽黃經達150°於每年公曆8月22-24日交節。.

d

/ platform-tools - 平臺相關的命令⾏⼯具

直接根據平臺解壓完成即可

e

/ platforms - android sdk

直接解壓⽂件

platform-31_r01.zip 解壓後重命名為 android-31

platform-32_r01.zip 解壓後重命名為 android-32

platform-33_r02.zip 解壓後重命名為 android-33

f

/ system-images - 模擬器映象

這個解決的是可以幫你構建離線映象，這⾥我提供了 Google API 的 x86_64 和 arm64 位的映象

如 Android 13 的模擬器對應的就是我的 33 ⽂件夾

在該⽬錄下，建立 android-33 ， 繼續建立該⽂件夾的⼦⽂件夾 google_apis, 並根據平臺的架構 x86_64 或者 arm64_v8a 建立對應的⼦⽂件夾 ，如我是 apple silion ，就是 arm64_v8a

g

/ patcher

建立⼦⽂件夾 v4 ，解壓 zip 包把⽂件放置在v4 ⽂件夾內，並把 package.xml 同時放置在 v4 ⽂件夾

也可以安裝 WSA 作為安卓的模擬環境：

http://learn.microsoft.com/en-us/windows/android/wsa/

模擬器運⾏，如果你是 X86_64 架構，請開啟 Intel HAXM

http://github.com/intel/haxm

sudo xcode-select -s <path/to/>Xcode.app(Xcode 13.4.1)

export ANDROID_HOME="/Users/luk/Tools/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/platform-tools"
export PATH="$PATH:$ANDROID_HOME/emulator"
export PATH="$PATH:$ANDROID_HOME/cmdline-tools/7.0/bin"