Windows, macOS veya Linux'ta yerel, platformlar arası .NET MAUI uygulamaları geliştirmeye başlamak için yükleme adımlarını izleyerek en son Visual Studio Code'u yükleyin.
Önkoşullar
iOS ve Mac Catalyst için .NET MAUI uygulamaları oluşturmak, imzalamak ve dağıtmak için şunları yapmanız gerekir:
Visual Studio Code'u yükleme
.NET MAUI uygulamaları oluşturmak için Visual Studio Code'un en son sürümünü indirmeniz gerekir:
Visual Studio Code'u yükleyin. Visual Studio Code'u yükleme hakkında ayrıntılı yönergeler için bkz. Windows'da Visual Studio Code , macOSüzerinde Visual Studio Code ve Linuxüzerinde Visual Studio Code'u .
.NET MAUI uzantısını yükleme
Visual Studio Code'da .NET MAUI uygulamaları oluşturabilmeniz için önce .NET MAUI uzantısını yüklemeniz gerekir:
Visual Studio Code'ı başlatın.
Visual Studio Code'da Uzantıları sekmesine gidin ve ".NET MAUI" araması yapın. Ardından .NET MAUI uzantısını seçin ve Yükle düğmesine basarak yükleyin:
.NET MAUI uzantısı, .NET MAUI uzantısının çalışması için gereken C# Geliştirme Seti ve C# uzantılarını otomatik olarak yükler. C# Dev Kit hakkında daha fazla bilgi için bkz. Visual Studio Code için C# Geliştirme Seti.
Hesabınızı C# Dev Kit'e bağlama
C# Geliştirme Seti'nin kullanılması, etkin bir Visual Studio aboneliğine sahip bir Microsoft hesabıyla oturum açmanızı gerektirir:
.NET MAUI kullanmaya başlamak için Hoş Geldiniz sekmesinde Bağlan düğmesine basın:
Microsoft hesabınızda oturum açmak için istemleri izleyin. Daha fazla bilgi için bkz. C# Geliştirme Seti'nde oturum açma.
C# Dev Kit lisansı hakkında daha fazla bilgi için bkz. C# Dev Kit SSS.
.NET ortamınızı ayarlama
.NET MAUI uygulamaları geliştirmek için makinenizde .NET SDK'sının yüklü olması gerekir. Makinenizde .NET SDK yüklü değilse, Windows'a yüklemek için tercih edilen yaklaşım Visual Studio Yükleyicisi'dir. Daha fazla bilgi için bakınız Kurulum.
Alternatif olarak, .NET SDK'sını el ile yüklemek için:
.NET yükleyicisiniindirin.
.NET yükleyicisini çalıştırarak .NET SDK'sını yükleyin. Daha fazla bilgi için bkz. Windows, Linux ve macOSüzerinde .NET yükleme .
.NET SDK'sının yüklü olduğunu doğrulamak için:
Bir terminal açın.
Terminalde aşağıdaki komutu çalıştırın:
dotnet --version
Yüklediğiniz .NET SDK sürümünü görmeniz gerekir.
Not
.NET SDK'sının yüklü olduğunu doğrulamadan önce makinenizi yeniden başlatmanız gerekebilir.
.NET MAUI ortamınızı ayarlama
.NET MAUI uygulamaları geliştirmek için makinenizde .NET MAUI SDK'sının yüklü olması gerekir. Makinenizde .NET MAUI SDK'sı yüklü değilse, Bunu Windows'a yüklemek için tercih edilen yaklaşım Visual Studio Yükleyicisi'dir. Daha fazla bilgi için bakınız Kurulum.
Alternatif olarak, .NET MAUI SDK'sını el ile yüklemek için:
Bir terminal açın.
Windows'daki terminalde aşağıdaki komutu çalıştırın:
dotnet workload install maui
macOS üzerindeki terminalde aşağıdaki komutu çalıştırın:
sudo dotnet workload install maui
Linux üzerindeki terminalde aşağıdaki komutu çalıştırın:
dotnet workload install maui-android
.NET MAUI SDK'sının yüklü olduğunu doğrulamak için:
Bir terminal açın.
Terminalde aşağıdaki komutu çalıştırın:
dotnet workload list
Windows ve macOS'ta, yüklü sürümle birlikte maui iş yükü kimliğinin listelendiğini görmeniz gerekir. Ancak, Windows'da Visual Studio Yükleyicisi aracılığıyla yüklediyseniz aşağıdaki iş yükü kimlikleri listelenir:
android
maui-windows
maccatalyst
ios
Linux'ta maui-android iş yükü kimliğinin yüklü sürümle birlikte listelendiğini görmeniz gerekir.
.NET MAUI uygulaması derlemek ve hatalarını ayıklamak için geliştirme makinenizin işletim sistemine göre geçerli bir hedef platforma sahip olmanız gerekir. Aşağıdaki tabloda her işletim sisteminde desteklenen hedef platformlar listelenmektedir:
| İşletim Sisteminiz |
Desteklenen Hedef Platformlar |
| Windows |
Windows, Android |
| macOS |
Android, iOS, macOS |
| Linux |
Android |
Android ve Apple platformları için bir .NET MAUI uygulaması oluşturmak için ek kurulum ve yapılandırma gerçekleştirmeniz gerekir.
Android
Visual Studio Code ile Android'de .NET MAUI geliştirmesi için makinenizi ayarlama işlemini yapmak için:
Java SDK'sını indirme ve yükleme
Java SDK'sını indirip yüklemek ve Visual Studio Code'u kullanmak üzere yapılandırmak için:
Microsoft OpenJDK 17indirin ve yükleyin. OpenJDK'yi yükleme hakkında bilgi için bkz. OpenJDK'nin Microsoft Derlemesini yükleme.
Alternatif olarak, Java SDK'sını el ile indirip yüklemek yerine java SDK'sını (ve Android SDK'sını) yüklemek için InstallAndroidDependencies derleme hedefini kullanabilirsiniz. Daha fazla bilgi için InstallAndroidDependencies hedefini kullanarakkonusuna bakın.
Önemli
Sonraki adımda gerekli olduğundan, OpenJDK'nin yüklendiği konumu not edin.
Aşağıdaki yaklaşımlardan biri aracılığıyla OpenJDK yolunu yapılandırdığınızdan emin olun:
Makinenizin Java SDK yolunu tanımlamak için JAVA_HOME ortam değişkenini ayarlayın. Bu, Java SDK yolunu makine düzeyinde tanımlayan önerilen yaklaşımdır.
Not
OpenJDK'yi Windows'a MSI aracılığıyla yüklerseniz, yükleyici JAVA_HOME ortam değişkenini ayarlama seçeneğini seçebilirsiniz.
Visual Studio Code'da, Windows'da CTRL+SHIFT+P veya macOS'ta CMD+SHIFT+P basın ve ardından .NET MAUI: Androidyapılandırma seçeneğini belirleyin ve ardından Java SDK'sı konumunu seçin java SDK yolunu kullanıcı/çalışma alanı düzeyinde ayarlayın.
$(JavaSdkDirectory) MSBuild özelliğini OpenJDK yoluna ayarlayarak .csproj dosyanızdaki Java SDK yolunu yapılandırın. Bu işlem, proje düzeyinde Java SDK yolunu tanımlar.
Android SDK'sını indirme ve yükleme
Android SDK'sını indirip yüklemek ve Visual Studio Code'u kullanmak üzere yapılandırmak için:
Aşağıdaki yaklaşımlardan birini kullanarak Android SDK'sını indirin ve yükleyin:
- Yeni bir .NET MAUI projesi oluşturarak Android SDK'sını indirip yükleyin ve ardından Android ortamınızı ayarlamanıza yardımcı olan
InstallAndroidDependencies derleme hedefini kullanın. Önerilen yaklaşım budur. Daha fazla bilgi için InstallAndroidDependencies hedefini kullanarakkonusuna bakın.
- Visual Studio'da .NET MAUI geliştirme iş yükünü yükleyip Androidüzerinde .NET MAUI uygulaması oluşturup çalıştırarak Android SDK'yı indirip Windows'a yükleyin. Bu işlem, Android SDK ve Android öykünücüsunun yüklenmesini sağlar.
- Android STUDIO aracılığıyla Android SDK'sını indirin ve yükleyin. Daha fazla bilgi için developer.android.com adresinde Android Studio yükleme bölümüne bakın.
- Linux'ta tercih ettiğiniz paket yöneticisi aracılığıyla Android SDK'sını indirin ve yükleyin.
Aşağıdaki yaklaşımlardan biriyle Android SDK yolunu yapılandırdığınızdan emin olun:
- Makinenizin Android SDK yolunu tanımlamak için
ANDROID_HOME ortam değişkenini ayarlayın. Bu, Android SDK yolunu makine düzeyinde tanımlayan önerilen yaklaşımdır.
- Visual Studio Code'da, Windows'da CTRL+SHIFT+P veya macOS'ta CMD+SHIFT+P basın ve ardından .NET MAUI: AndroidYapılandırma seçeneğini belirleyin ve ardından Android SDK konumunu seçin Android SDK yolunu kullanıcı/çalışma alanı düzeyinde ayarlayın.
-
$(AndroidSdkDirectory) MSBuild özelliğini Android SDK yoluna ayarlayarak .csproj dosyanızda Android SDK yolunu yapılandırın. Bu işlem, Proje düzeyinde Android SDK yolunu tanımlar.
Visual Studio Code'da, Windows'da CTRL+SHIFT+P veya macOS'ta CMD+SHIFT+P tuşlarına basıp .NET MAUI : Androidyapılandırma'yı ve ardındanAndroid ortamını yenileme seçerek Android ortamınızın doğru yapılandırıldığını doğrulayın. Algılanan hataların giderilmesi gerekir:
- Komut paletinde .NET MAUI: Android yapılandırma'yı seçin ve ardından hem Android SDK konum seçin hem de Android SDK konum seçin ve bunların her birinin yüklemelerine doğru şekilde işaret ettiğini doğrulayın. Windows'da SDK'ları Visual Studio aracılığıyla yüklerseniz, OpenJDK C:\Program Files\Microsoft konumunda, Android SDK ise C:\Program Files (x86)\Android\android-sdkkonumunda bulunur.
- Android SDK klasörünüzde derleme araçları, cmdline-toolsve platform araçlarıgibi alt klasörler olduğundan emin olun.
- OpenJDK klasörünüzde , libgibi alt klasörler olduğundan emin olun.
-
ANDROID_HOME ortam değişkeninin Android SDK yolunuz olarak ayarlandığından emin olun.
-
JAVA_HOME ortam değişkeninin Java SDK yolunuza ayarlandığından emin olun.
- Android lisansları kabul olmadıysa, yükseltilmiş bir terminalde Android SDK'nızın cmdline-tools/{version}/bin klasörüne gidin ve
sdkmanager --licenses çalıştırın ve CLI istemlerini izleyin.
InstallAndroidDependencies hedefini kullanma
Android'de .NET MAUI projeniz için gerekli bağımlılıkları yüklemek için önerilen yaklaşım, InstallAndroidDependencies MSBuild hedefini çalıştırmaktır. Bu hedef, henüz yüklü değilse Android SDK'yı sizin için yükler.
Terminalde yeni bir .NET MAUI projesi oluşturun:
dotnet new maui -n "MyMauiApp"
Terminalde dizini MyMauiAppolarak değiştirin ve derleme hedefini belirtirken uygulamayı derleyin:
cd MyMauiApp
dotnet build -t:InstallAndroidDependencies -f:net9.0-android -p:AndroidSdkDirectory="/path/to/sdk" -p:AcceptAndroidSDKLicenses=True
Not
InstallAndroidDependencies MSBuild hedefi, JavaSdkDirectory MSBuild özelliği sağlanmışsa Java SDK'sını da yükleyebilir.
Yukarıdaki komutta:
-
-p:AndroidSdkDirectory="/path/to/sdk" Android bağımlılıklarını belirtilen mutlak yola yükler veya güncelleştirir. Önerilen yollar, Windows'da %LOCALAPPDATA%/Android/Sdk ve macOS'ta $HOME/Library/Android/sdk şeklindedir.
-
-p:AcceptAndroidSDKLicenses=True geliştirme için gerekli Android lisanslarını kabul eder.
- (isteğe bağlı)
-p:JavaSdkDirectory="/path/to/sdk" Java SDK'sını belirtilen mutlak yola yükler.
Boşluk veya ASCII olmayan karakterler içeren yolları kullanmaktan kaçınmaya çalışın.
Bir Android öykünücüsü indir ve yükle
Uygulamalarınızın çalıştırıldığı bir Android öykünücüsü indirip yüklemek için:
Terminalde {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/ konumuna gidin.
Terminalde sdkmanager komutunu kullanarak bir Android öykünücüsü indirip yükleyin:
Windows'da aşağıdaki komutları çalıştırın:
sdkmanager --install emulator
sdkmanager --install "system-images;android-35;google_apis;x86_64"
macOS'ta aşağıdaki komutları çalıştırın:
./sdkmanager --install emulator
./sdkmanager --install "system-images;android-35;google_apis;arm64-v8a"
Not
Yukarıdaki komut bir Apple Silicon Mac olduğunu varsayar. Intel Mac için arm64-v8a yerine x86_64yazın.
sdkmanager komutu hakkında daha fazla bilgi için developer.android.com adresinde sdkmanager'ye bakın.
Terminalde yeni bir Android öykünücüsü oluşturmak için avdmanager komutunu kullanın:
Windows'da aşağıdaki komutları çalıştırın:
avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;x86_64"
macOS'ta aşağıdaki komutları çalıştırın:
./avdmanager create avd -n MyAndroidVirtualDevice-API35 -k "system-images;android-35;google_apis;arm64-v8a"
Not
Yukarıdaki komut bir Apple Silicon Mac olduğunu varsayar. Intel Mac için arm64-v8a yerine x86_64yazın.
komutu hakkında daha fazla bilgi için bkz. developer.android.com üzerinde avdmanager .
iOS ve macOS
Mac'inizi Visual Studio Code ile iOS ve Mac Catalyst üzerinde .NET MAUI geliştirmesi için ayarlamak için:
Kullandığınız .NET MAUI sürümünün gerektirdiği Xcode sürümünü yükleyin. Daha fazla bilgi için bkz . Sürüm sürümleri. En son kararlı Xcode sürümü Apple App Store'dan indirilebilir.
Bir terminalde aşağıdaki komutu çalıştırarak Xcode komut satırı araçlarını alın:
xcode-select --install
Xcode'ı başlatın ve tüm lisans sözleşmelerini kabul edin. Simülatörler yüklenmeye başlamazsa, Xcode > Ayarlar > Bileşen konumuna gidin ve ardından seçtiğiniz simülatör çalışma zamanlarını yükleyin.
Visual Studio Code'da, CMD+SHIFT+P tuşlarına basarak ve ardından .NET MAUI: Apple'ı yapılandır 'ı ve ardından Apple ortamınıYenile'yi seçerek Apple ortamınızın doğru yapılandırıldığını doğrulayın. Algılanan hataların giderilmesi gerekir:
- Terminalde
xcode-select --install çalıştırdığınızdan emin olun.
- Xcode'un bulunamadığını belirten bir hata alırsanız terminalde
xcode-select -p çalıştırın ve Xcode yüklemenizin yolunu döndürdüğünü denetleyin.
- Doğru yüklendiğinden emin olmak için Xcode'ı açın ve Xcode > Ayarları > Konum gidin ve Komut Satırı Araçları alanının doğru Xcode yüklemesine işaret edip etmediğini denetleyin.
Sorun giderme
Visual Studio Code'da .NET MAUI uzantısını yüklerken sorunlarla karşılaşırsanız, Çıktı penceresine (Windows'da CTRL+SHIFT+Uveya macOS'ta CMD+SHIFT+U ) gidip açılan listeden .NET MAUI seçerek sorunlarla ilgili daha fazla bilgi bulabilirsiniz.
Geri bildirimde bulunun
Visual Studio Code'un içinden .NET MAUI uzantısı hakkında geri bildirim sağlamak için Yardım > Rapor Sorunu iletişim kutusuna gidin. Ardından, değeri olarak "Hata Raporu" seçeneğini belirlediğinizden emin olun: Bu, bir açılan listedir, için değeri olarak "VS Code uzantısı", Uzantısı açılan listesi olarak ".NET MAUI" seçeneğini belirleyin:
