關于 .NET MAUI 國內?伙伴在配置 .NET MAUI 的時候，遇到不少問題。希望通過本教程，給到大家?些指引。
01
基礎組件部分
.NET SDK 安裝
建議安裝最新的 .NET SDK
下載地址 https://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
02
Android 環境設定
有部分地區下載 Android SDK 和模擬器是有問題的，我這?說說?些解決辦法
JDK 安裝
安卓的環境依賴于 JDK ，微軟已經把原來的 Adoption OpenJDK 升級到 Microsoft OpenJDK 11 了。
你可以通過 https://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 離線版本下載地址
鏈接: https://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日交節。.
a
? ?/ build-tools - 編譯?具
可以設定不同版本的編譯?具
在該?錄下，創建以下??錄
build-tools_r31_(對應系統).zip 解壓后 重命名為 /31.0.0
build-tools_r32_(對應系統).zip 解壓后 重命名為 /32.1.0.rc1
build-tools_r33_(對應系統).zip 解壓后 重命名為 /33.0.0
b
? ?/ cmdline-tools - 命令??具
命令??件
基于不同平臺解壓，重命名為 7.0 ，把所有?件直接放在 cmdline-tools ?件夾內
c
? ?/ emulator - 模擬器可執??件
直接基于你的平臺解壓放置該?件夾內即可
這??定要記得?點，需要把 package.xml 授權?件放進去，否則你沒有辦法從 Visual Studio 中開啟模擬器。
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 作為安卓的模擬環境：
https://learn.microsoft.com/en-us/windows/android/wsa/
模擬器運?，如果你是 X86_64 架構，請開啟 Intel HAXM
https://github.com/intel/haxm
03
iOS 環境設定
最新的 Xcode 是需要安裝的（因為 Xcode 14 剛發布， .NET MAUI 還沒有完整?持，請使? Xcode 13.4.1）
下載 Xcode 13.4.1
鏈接: https://pan.baidu.com/s/1libEvYE752lVJKV5Q-j_NQ?pwd=sf2p
macOS 是?持多 Xcode 的開發環境的，如圖
安裝完 Xcode 后記得配置好 Visual Studio 的路徑
也可以通過命令?設定默認的 Xcode，這?建議選擇默認為 Xcode 13.4.1
sudo xcode-select -s <path/to/>Xcode.app(Xcode 13.4.1)把環境變量設置好
macOS / Linux 下
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"Windows 下的配置
關于 Windows Remote
現在 Windows 是要遠程連接 macOS 的設備，才能啟?模擬器和真機的，所以?家必須有?臺 Mac 系列的
相關設備，這?我建議?家? macOS 云端的解決?案，節約?下成本
https://www.macincloud.com/
還有必須 Windows 和 macOS 上的版本統?否則會有版本不同步出錯的情況。
04
在 VS 設定好相關的路徑
在 Visual Studio 2022 設定好 iOS 和 Android 的配置路徑這是最后?步
macOS 路徑設定
Xcode 的路徑配置 Perferences -> SDK -> Apple?
Android?路徑設定
Android 的路徑配置 Perferences -> SDK -> Android -> Locations
Windows 路徑設定
05
小結
.NET MAUI 的配置問題不是出于 .NET 本身更多是出現在 Android 和 iOS 的環境配置上，特別 Android SDK會根據地區和?絡供應商的設定?變。希望該內容能幫到各位在 .NET MAUI 環境安裝遇到困難的?伙伴。
CA周記往期回顧:
更多原創文章與資源共享
請關注Kinfey Techtalk
點擊下方【閱讀原文】在Github 查看完整操作指引。
與for(auto c:s))
)
