Yükleme

Yerel, platformlar arası .NET Çok platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) uygulamaları geliştirmek için Visual Studio 2022 17.12 veya üzeri ya da .NET MAUI uzantısına sahip en son Visual Studio Code gerekir.

Visual Studio

Windows'da yerel, platformlar arası .NET MAUI uygulamaları geliştirmeye başlamak için yükleme adımlarını izleyerek Visual Studio 2022 17.12 veya üzerini yükleyin.

Önkoşullar

• Visual Studio 2022 17.12 veya üzeri. Desteklenen işletim sistemleri, donanım, desteklenen diller ve ek gereksinimler ve yönergeler hakkında bilgi için bkz . Visual Studio 2022 Sistem Gereksinimleri.

iOS ve Mac Catalyst için .NET MAUI uygulamaları oluşturmak, imzalamak ve dağıtmak için şunları da yapmanız gerekir:

• Xcode ile uyumlu bir Mac. Daha fazla bilgi için Apple'ın en düşük gereksinimler belgelerine bakın.
• Kullandığınız .NET MAUI sürümüne bağlı olarak Xcode'un belirli bir sürümü. Daha fazla bilgi için bkz . Sürüm sürümleri.
• Apple Kimliği ve ücretli Apple Geliştirici Programı kaydı. Cihazlara uygulama dağıtmak ve uygulamaları Apple Store'a göndermek için Bir Apple Kimliği gereklidir.

Alternatif olarak, uygulamanızın hata ayıklama derlemelerini doğrudan Windows'tan iOS cihazınıza çalışırken yeniden başlatma ile dağıtmak için şunları yapmanız gerekir:

• Bir Apple Geliştirici hesabı ve ücretli Apple Geliştirici Programı kaydı.

Yükleme

1. .NET MAUI uygulamaları oluşturmak için Visual Studio 2022'nin en son sürümünü indirmeniz gerekir:

   • Visual Studio 2022 Community'i indirin

   • Visual Studio 2022 Professional'ı indirin

   • Visual Studio 2022 Enterprise'ı indirin

2. Visual Studio'yu yükleyin veya Visual Studio yükleyicisi aracılığıyla mevcut yüklemenizi değiştirin ve varsayılan isteğe bağlı yükleme seçenekleriyle .NET Çok Platformlu Uygulama Kullanıcı Arabirimi geliştirme iş yükünü yükleyin:

   

Visual Studio Code

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:

• Xcode ile uyumlu bir Mac. Daha fazla bilgi için Apple'ın en düşük gereksinimler belgelerine bakın.
• Kullandığınız .NET MAUI sürümüne bağlı olarak Xcode'un belirli bir sürümü. Daha fazla bilgi için bkz . Sürüm sürümleri.
• Apple Kimliği ve ücretli Apple Geliştirici Programı kaydı. Cihazlara uygulama dağıtmak ve uygulamaları Apple Store'a göndermek için Bir Apple Kimliği gereklidir.

Visual Studio Code'u yükleme

1. .NET MAUI uygulamaları oluşturmak için Visual Studio Code'un en son sürümünü indirmeniz gerekir:

   • Visual Studio Code İndir

2. 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:

1. Visual Studio Code'ı başlatın.

2. 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:

1. .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:

1. .NET yükleyicisiniindirin.

2. .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 .

   Bahşiş

   Linux'ta, yükleme yönergelerinibetik aracılığıyla kullanarak .NET SDK'sını yükleyebilirsiniz.

.NET SDK'sının yüklü olduğunu doğrulamak için:

1. Bir terminal açın.

2. 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:

1. Bir terminal açın.

2. 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:

1. Bir terminal açın.

2. 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.

Hedef platformları ayarlama

.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 işletim sistemi	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 Daha fazla bilgi için bkz. java JDKindirme ve yükleme .
• Android SDK'sını indirin ve yükleyin. Daha fazla bilgi için bkz. Android SDK'sını indirme ve yükleme.
• Android öykünücüsü indir ve yükle. Daha fazla bilgi için bkz. Android öykünücüsü indirme ve yükleme.

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:

1. 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.

2. Aşağıdaki yaklaşımlardan biri aracılığıyla OpenJDK yolunu yapılandırdığınızdan emin olun:

   1. 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.

   2. Visual Studio Code'da, Windows'ta Ctrl+Shift+P tuşlarına veya macOS'ta Cmd+Shift+P tuşlarına basın ve ardından .NET MAUI: Android'i yapılandır'ı ve ardından Java SDK'sı konumunu seçerek kullanıcı/çalışma alanı düzeyinde Java SDK'sı yolunu ayarlayın.

   3. $(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:

1. Aşağıdaki yaklaşımlardan birini kullanarak Android SDK'sını indirin ve yükleyin:

   1. 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.
   2. 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.
   3. 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.
   4. Linux'ta tercih ettiğiniz paket yöneticisi aracılığıyla Android SDK'sını indirin ve yükleyin.

2. Aşağıdaki yaklaşımlardan biriyle Android SDK yolunu yapılandırdığınızdan emin olun:

   1. 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.
   2. Visual Studio Code'da, Windows'ta Ctrl+Shift+P tuşlarına veya macOS'ta Cmd+Shift+P tuşlarına basın ve ardından .NET MAUI: Android'i yapılandır'ı ve ardından Android SDK konumunu seçerek android SDK yolunu kullanıcı/çalışma alanı düzeyinde ayarlayın.
   3. $(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.

3. Visual Studio Code'da, Windows'ta Ctrl+Shift+P tuşlarına veya macOS'ta Cmd+Shift+P tuşlarına basıp .NET MAUI: Android'i yapılandır'ı ve ardından Android ortamını yenile'yi 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:

1. Terminalde {YOUR_ANDROID_SDK_FOLDER}/cmdline-tools/{version}/bin/ konumuna gidin.

2. 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.

3. 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:

1. 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.

2. Bir terminalde aşağıdaki komutu çalıştırarak Xcode komut satırı araçlarını alın:

   xcode-select --install
   

3. 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.

4. Visual Studio Code'da , Cmd+Shift+P tuşlarına basıp .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, Çıkış penceresine (Windows'da Ctrl+Shift+U veya macOS'ta Cmd+Shift+U ) gidip açılan listeden .NET MAUI'yi 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:

Visual Studio Code (Deneysel)

Önkoşullar

iOS ve Mac Catalyst için .NET MAUI uygulamaları oluşturmak, imzalamak ve dağıtmak için şunları yapmanız gerekir:

• Xcode ile uyumlu bir Mac. Daha fazla bilgi için Apple'ın en düşük gereksinimler belgelerine bakın.
• Kullandığınız .NET MAUI sürümüne bağlı olarak Xcode'un belirli bir sürümü. Daha fazla bilgi için bkz . Sürüm sürümleri.
• Apple Kimliği ve ücretli Apple Geliştirici Programı kaydı. Cihazlara uygulama dağıtmak ve uygulamaları Apple Store'a göndermek için Bir Apple Kimliği gereklidir.

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.

.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 işletim sistemi	Android

Visual Studio Code'u yükleme

1. .NET MAUI uygulamaları oluşturmak için Visual Studio Code'un en son sürümünü indirmeniz gerekir:

   • Visual Studio Code İndir

2. 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:

1. Visual Studio Code'ı başlatın.

2. 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.

Rehberdeki adımları takip edin.

.NET MAUI uzantısını yükledikten sonra ,NET MAUI kılavuzu ".NET MAUI'yi Kullanmaya Başlama" sizi memnun edecektir.

Önemli

Geliştirilmiş kurulum deneyimine erişmek için Maui > Yapılandırması: Geliştirilmiş Kurulum Deneyimiayarının açık olması gerekir.

.NET MAUI ortamınızı ve hedef platformlarınızı tam olarak yapılandırmak için her adımda yönergeleri izleyin:

1. Hesabınızı C# Dev Kit uzantısına bağlama
2. .NET ortamınızı ayarlama
3. .NET MAUI ortamınızı ayarlama
4. iOS ve macOS ortamınızı ayarlama
5. Android ortamınızı ayarlama

Not

iOS ve macOS ortamınızı ayarlama adımını görmek ve izlemek için Mac'te olmanız gerekir.

Android ortamınızı ayarlama adımı, Hedef platform olarak Android ile başarılı olmak için ihtiyacınız olan her şeyi ayarlar ve iOS ve macOS ortamınızı ayarlama adımı, iOS ve Mac ile başarılı olmak için ihtiyacınız olan her şeyi hedef platformlar olarak ayarlar.

Bu kılavuza komut paletinden de erişilebilir. Hoş Geldiniz: İzlenecek Yol'u açın... öğesini ve ardından .NET MAUI'yi Kullanmaya Başlayın'ı seçin.

Geliştirilmiş kurulum deneyimine erişme

1. Visual Studio Code'da Windows'ta Ctrl+Shift+P tuşlarına veya macOS'ta Cmd+Shift+P tuşlarına basın, Tercihler: Ayarlar'ı (UI) aç'ı seçin.

   

2. Uzantılar > .NET MAUI'ye gidin ve Maui > Yapılandırması: Geliştirilmiş Kurulum Deneyimi ayarını denetleyin.

   

3. .NET MAUI kullanmaya başlama kılavuzuna geri dönün. İzlenecek yoldaki diğer adımlar arasında Android ortamınızı ayarlama'yı görebildiğinizden emin olun.

   

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:

1. .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:

1. .NET yükleyicisiniindirin.

2. .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 .

   Bahşiş

   Linux'ta, yükleme yönergelerinibetik aracılığıyla kullanarak .NET SDK'sını yükleyebilirsiniz.

.NET SDK'sının yüklü olduğunu doğrulamak için:

1. Bir terminal açın.

2. 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:

1. Bir terminal açın.

2. 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:

1. Bir terminal açın.

2. 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.

Android ortamınızı ayarlama

Android geliştirme ortamınızı ayarlamak için Android Ortamınızı ayarlama kılavuzu adımındaki Android Ortamını Yapılandır düğmesine tıklayarak tam Android edinme akışına girmeniz yeterlidir.

Android edinme akışı, Android ortamınızı analiz eder ve eksik tüm bileşenleri yüklemeyi önerir:

• Android SDK ve Java SDK' sı: Android SDK ve Java SDK bileşenleri gereklidir.

  • Android edinme akışı, bu bileşenleri doğrudan yüklemenizi veya zaten sahip olabileceğiniz önceden var olan bir yüklemeyi seçmenizi ister.

    

  • SDK ve JDK yüklemelerinizi daha fazla yapılandırmak için Android'i el ile yükleme ve yapılandırma yönergelerine bakın.

• Android öykünücüsü: Android öykünücüsünün yüklenmesi önerilir ve fiziksel cihaz olmadığında gereklidir.

  • Android edinme akışı, doğrudan bir varsayılan öykünücü yüklemenizi ister.

    

  • Öykünücüleri daha fazla yapılandırmak için , yönergeleri izleyerek android öykünücüyü el ile yükleyin.

Önemli

Android lisanslarının Terminal'de el ile gözden geçirilmesi ve kabul edilmesi gerekir. İstendiğinde her lisansı gözden geçirin. Kabul etmek için 'y' yazın ve 'Enter' tuşuna basın.

Android ortamınız düzgün yapılandırıldığında size ".NET MAUI için Android ortamınız ayarlandı!" bildirimi gönderilir.

Android ortamınızın durumuyla ilgili diğer ayrıntılar için Çıkış bölmesini görüntüleyin.

iOS ve macOS ortamınızı ayarlama

Mac'inizi Visual Studio Code ile iOS ve Mac Catalyst üzerinde .NET MAUI geliştirmesi için ayarlamak için:

1. 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.

2. Bir terminalde aşağıdaki komutu çalıştırarak Xcode komut satırı araçlarını alın:

   xcode-select --install
   

3. 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.

4. Visual Studio Code'da, iOS ve macOS Ortamınızı ayarlama kılavuzu adımında iOS ve macOS Ortamını Yapılandır'a tıklayarak Xcode ortamınızın 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.

Xcode ortamınız düzgün yapılandırıldığında size, ".NET MAUI için iOS ve macOS ortamınız hazır!" şeklinde bildirilecektir.

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:

Sonraki adımlar

Windows'da Visual Studio 2022'de veya Visual Studio Code'da ilk .NET MAUI uygulamanızı oluşturmayı ve çalıştırmayı öğrenmek için aşağıdaki düğmeye tıklayın.

İlk uygulamanızı oluşturma