.NET MAUI 環境配置技巧

語言: CN / TW / HK

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

01

基礎元件部分

.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

02

Android 環境設定

有部分地區下載 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日交節。.

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 作為安卓的模擬環境:

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

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

http://github.com/intel/haxm

03

iOS 環境設定

最新的 Xcode 是需要安裝的(因為 Xcode 14 剛釋出, .NET MAUI 還沒有完整⽀持,請使⽤ Xcode 13.4.1)

  • 下載 Xcode 13.4.1

連結: http://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 雲端的解決⽅案,節約⼀下成本

http://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 檢視完整操作指引。