İlk uygulamanızı oluşturma

Bu öğreticide, Windows veya Mac için Visual Studio 2022'de Visual Studio 2022'de ilk .NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) uygulamanızı oluşturmayı ve çalıştırmayı öğreneceksiniz. Bu, geliştirme ortamınızın doğru ayarlandığından emin olmak için yardımcı olur.

Visual Studio

Önkoşullar

• Visual Studio 2022 17.8 veya üzeri, .NET Çok Platformlu Uygulama Kullanıcı Arabirimi iş yükü yüklü. Daha fazla bilgi için bkz . Yükleme.

Uygulama oluşturun

Bu öğreticide Visual Studio 2022'de ilk .NET MAUI uygulamanızı oluşturacak ve bir Android öykünücüsunda çalıştıracaksınız:

Windows üzerinde iOS için .NET MAUI uygulamaları geliştirmek için bir Mac derleme konağı gerekir. Özellikle iOS'u hedeflemeniz gerekmiyorsa ve Mac'iniz yoksa, bunun yerine Android veya Windows'u kullanmaya başlamayı göz önünde bulundurun.

Bu öğreticide Visual Studio'da ilk .NET MAUI uygulamanızı oluşturacak ve bir iOS simülatöründe çalıştıracaksınız:

Bu öğreticide Visual Studio 2022'de ilk .NET MAUI uygulamanızı oluşturacak ve Windows'da çalıştıracaksınız:

1. Visual Studio 2022'i başlatın. Başlangıç penceresinde Yeni proje oluştur'a tıklayarak yeni bir proje oluşturun:

   

2. Yeni proje oluştur penceresinde Tüm proje türleri açılan listesinde MAUI'yi seçin, .NET MAUI Uygulama şablonunu seçin ve İleri düğmesine tıklayın:

   

3. Yeni projenizi yapılandırın penceresinde projenizi adlandırın, uygun bir konum seçin ve İleri düğmesine tıklayın:

   

4. Ek bilgi penceresinde hedeflemek istediğiniz .NET sürümünü seçin ve Oluştur düğmesine tıklayın:

   

5. Projenin oluşturulmasını ve bağımlılıklarının geri yüklenmesini bekleyin:

   

6. Visual Studio araç çubuğunda Hata Ayıklama Hedefi açılan listesini kullanarak Android Öykünücüleri'ni ve ardından Android Öykünücüsü girdisini seçin:

   

7. Visual Studio araç çubuğunda Android Öykünücüsü düğmesine basın:

   

   Visual Studio varsayılan Android SDK'sını ve Android Öykünücüsü'yü yüklemeye başlar.

8. Android SDK - Lisans Sözleşmesi penceresinde Kabul Et düğmesine basın:

   

9. Android SDK - Lisans Sözleşmesi penceresinde Kabul Et düğmesine basın:

   

10. Kullanıcı Hesabı Denetimi iletişim kutusunda Evet düğmesine basın:

    

11. Lisans Kabulü penceresinde Kabul Et düğmesine basın:

    

    Visual Studio'nın Android SDK'sını ve Android Öykünücüsü'ni indirmesini bekleyin.

12. Visual Studio araç çubuğunda Android Öykünücüsü düğmesine basın:

    

    Visual Studio varsayılan bir Android öykünücüsü oluşturmaya başlar.

13. Kullanıcı Hesabı Denetimi iletişim kutusunda Evet düğmesine basın:

    

14. Yeni Cihaz penceresinde Oluştur düğmesine basın:

    

    Visual Studio'nın bir Android öykünücüsü indirmesini, sıkıştırmasını açmasını ve oluşturmasını bekleyin.

15. Android Aygıt Yöneticisi penceresini kapatın:

    

16. Visual Studio araç çubuğunda Pixel 5 - API 34 (Android 14.0 - API 33) düğmesine basarak uygulamayı derleyin ve çalıştırın:

    

    Visual Studio, Android öykünücüsunu başlatır, uygulamayı derler ve uygulamayı öykünücüye dağıtır.

    Uyarı

    Android öykünücü performansını en üst düzeye çıkarmak için donanım hızlandırma etkinleştirilmelidir. Bunun yapılmaması öykünücünün çok yavaş çalıştırılmasına neden olur. Daha fazla bilgi için bkz . Android öykünücüleriyle donanım hızlandırmayı etkinleştirme (Hyper-V & AEHD).

17. Android öykünücüsünün çalışan uygulamasında Beni tıklat düğmesine birkaç kez basın ve düğme tıklama sayısı sayısının arttığını gözlemleyin.

    

Sorun giderme

Uygulamanız derlenemezse sorununuza çözüm olabilecek bilinen sorunları giderme makalesini gözden geçirin. Sorun Android öykünücüsüyle ilgiliyse bkz . Android öykünücüsü sorunlarını giderme.

6. Visual Studio araç çubuğunda, Çerçeve'yi ve ardından net8.0-windows girişini seçmek için Hedefte Hata Ayıklama açılan listesini kullanın:

   

7. Visual Studio araç çubuğunda, uygulamayı derlemek ve çalıştırmak için Windows Makinesi düğmesine basın:

   

   Geliştirici Modu'nu etkinleştirmediyseniz, Visual Studio bunu etkinleştirmenizi ister. Windows için Geliştirici Modunu Etkinleştir iletişim kutusunda geliştiricilerin ayarlarına tıklayarak Ayarlar uygulamasını açın:

   

   Ayarlar uygulamasında Geliştirici Modu'nu açın ve bildirimi kabul edin:

   

   Ayarlar uygulamasını kapatın ve ardından Windows için Geliştirici Modunu Etkinleştir iletişim kutusunu kapatın.

8. Çalışan uygulamada, Bana birkaç kez tıklayın düğmesine basın ve düğme tıklama sayısı sayısının arttığını gözlemleyin:

   

Sorun giderme

Uygulamanız derlenemezse sorununuza çözüm olabilecek bilinen sorunları giderme makalesini gözden geçirin.

6. Visual Studio'da IDE'yi mac derleme konağıyla eşleştirin. Daha fazla bilgi için bkz . iOS geliştirmesi için Mac ile eşleştirme.

7. Visual Studio araç çubuğunda Hata Ayıklama Hedefi açılan listesini kullanarak iOS Simülatörleri'ni ve ardından belirli bir iOS simülatörünü seçin:

   

8. Visual Studio araç çubuğunda, uygulamanızı derlemek ve çalıştırmak için seçtiğiniz iOS simülatörünün Başlat düğmesine basın:

   

   Visual Studio uygulamayı derleyecek, Windows için uzak iOS Simülatörü'nü başlatacak ve uygulamayı uzak simülatöre dağıtacaktır. Windows için uzak iOS Simülatörü hakkında daha fazla bilgi için bkz . Windows için Uzak iOS Simülatörü.

9. Çalışan uygulamada Bana birkaç kez tıklayın düğmesine basın ve düğme tıklama sayısı sayısının arttığını gözlemleyin.

   

Sorun giderme

Uygulamanız derlenemezse sorununuza çözüm olabilecek bilinen sorunları giderme makalesini gözden geçirin.

Mac Catalyst'i hedefleyen .NET MAUI uygulamaları yalnızca Mac için Visual Studio 2022 kullanılarak başlatılabilir ve hata ayıklanabilir.

Mac için Visual Studio

Not

Mac için Visual Studio, 31 Ağustos 2024'e kadar kullanımdan kaldırılması planlanıyorMicrosoft'un Modern Yaşam Döngüsü İlkesi. Mac için Visual Studio 17.6, 31 Ağustos 2024'e kadar destek almaya devam edecek ve güvenlik sorunlarına yönelik hizmet güncelleştirmeleri ve Apple'dan güncelleştirilmiş platformlar. Mac'te geliştirmeye yönelik alternatif seçenekler de dahil olmak üzere daha fazla bilgi için bkz. Mac için Visual Studio neler oluyor?.

Önkoşullar

• .NET, .NET MAUI, Android ve iOS iş yüklerinin yüklü olduğu Mac için Visual Studio 2022 17.6. Daha fazla bilgi için bkz . Yükleme.

Önemli

.NET 8 ile Mac için Visual Studio kullanmak için Visual Studio Tercihleri Diğer Önizleme Özellikleri > Yüklüyse .NET 8 SDK'sını kullanın (yeniden başlatma gerektirir) onay kutusunu etkinleştirin.>>>

Uygulama oluşturun

Bu öğreticide Mac için Visual Studio 2022'de ilk .NET MAUI uygulamanızı oluşturacak ve seçtiğiniz platformda çalıştıracaksınız:

1. Mac için Visual Studio 2022'i başlatın. Başlangıç penceresinde Yeni'ye tıklayarak yeni bir proje oluşturun:

   

2. Yeni projeniz için şablon seçin penceresinde Çok Platformlu > Uygulama'yı seçin, .NET MAUI Uygulaması şablonunu seçin ve Devam düğmesine tıklayın:

   

3. Yeni .NET MAUI Uygulamanızı yapılandırın penceresinde hedeflemek istediğiniz .NET sürümünü seçin ve Devam düğmesine tıklayın:

   

4. Yeni .NET MAUI Uygulamanızı yapılandırın penceresinde proje adı olarak MyMauiApp girin, proje için uygun bir konum seçin ve Oluştur düğmesine tıklayın:

   

5. Projenin oluşturulmasını ve bağımlılıklarının geri yüklenmesini bekleyin:

   

6. Mac'inizde Android SDK bileşenleri yoksa Mac için Visual Studio 2022 bir bilgi çubuğu görüntüler. Android SDK'sını yüklemek için Yükle düğmesine tıklayın:

   

7. Android SDK penceresinde Android bağımlılıklarını otomatik olarak indir ve yükle onay kutusunu seçin ve İndir ve Yükle düğmesine tıklayın:

   

8. Lisans Kabulü penceresinde Kabul Et düğmesine tıklayın:

   

   Mac için Visual Studio 2022'nin Android SDK'sını indirmesini bekleyin:

9. Mac için Visual Studio 2022 araç çubuğunda hata ayıklama hedefini Android Öykünücüsü olarak değiştirin:

   

10. Mac için Visual Studio 2022 araç çubuğunda Yürüt düğmesine basarak uygulamayı derleyin ve başlatmayı deneyin:

    

    Mac için Visual Studio 2022 uygulamayı oluşturur ve ardından varsayılan bir Android öykünücüsü oluşturur.

11. Yeni Cihaz penceresinde Oluştur düğmesine tıklayın:

    

12. Lisans Kabulü penceresinde Kabul Et düğmesine tıklayın:

    

    Mac için Visual Studio 2022'nin bir Android öykünücüsü indirip yüklemesini bekleyin.

13. Android Aygıt Yöneticisi penceresini kapatın:

    

14. Mac için Visual Studio 2022 araç çubuğunda hata ayıklama hedefini Pixel 5 - API 34 (API 34) olarak değiştirin:

    

15. Mac için Visual Studio 2022 araç çubuğunda Yürüt düğmesine basarak uygulamayı Android öykünücüsunda başlatın:

    

    Mac için Visual Studio 2022, Android öykünücüyü başlatır, uygulamayı derler ve uygulamayı öykünücüye dağıtır.

16. Android öykünücüsünün çalışan uygulamasında Bana birkaç kez tıklayın düğmesine basın ve düğme tıklama sayısı sayısının arttığını gözlemleyin:

    

6. Mac için Visual Studio 2022 araç çubuğunda hata ayıklama hedefinin bir iOS simülatörüne ayarlandığından emin olun:

   

7. Mac için Visual Studio 2022 araç çubuğunda Yürüt düğmesine basarak uygulamayı seçtiğiniz iOS simülatöründe başlatın:

   

   Mac için Visual Studio 2022 iOS simülatörünü başlatır, uygulamayı derler ve uygulamayı simülatöre dağıtır.

8. Çalışan uygulamada, Bana birkaç kez tıklayın düğmesine basın ve düğme tıklama sayısı sayısının arttığını gözlemleyin:

   

6. Mac için Visual Studio 2022 araç çubuğunda hata ayıklama hedefinin Mac'im (MacCatalyst) olarak ayarlandığından emin olun:

   

7. Mac için Visual Studio 2022'de MyMauiApp projesine sağ tıklayın ve Proje Dosyasını Düzenle'yi seçin. Ardından, proje dosya düzenleyicisinde ilk <ItemGroup>önce aşağıdaki XML'yi ekleyin:

   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net8.0-maccatalyst|AnyCPU'">
       <RuntimeIdentifiers>maccatalyst-x64;maccatalyst-arm64</RuntimeIdentifiers>
   </PropertyGroup>
   

8. Mac için Visual Studio 2022 araç çubuğunda Yürüt düğmesine basarak uygulamayı Mac bilgisayarınızda başlatın:

   

   Mac için Visual Studio 2022 uygulamayı derleyecek ve dağıtacaktır.

9. Çalışan uygulamada, Bana birkaç kez tıklayın düğmesine basın ve düğme tıklama sayısı sayısının arttığını gözlemleyin:

   

Windows'ı hedefleyen .NET MAUI uygulamaları yalnızca Visual Studio 2022 kullanılarak başlatılabilir ve hata ayıklanabilir.

Visual Studio Code (Önizleme)

Not

Visual Studio Code'da .NET MAUI desteği hala önizleme aşamasındadır. Deneyin ve geri bildiriminizi paylaşın!

Uzantıyı yükleme

Visual Studio Code için .NET MAUI uzantısını ayarlamak için yönergeleri izleyin.

Uygulamanızı oluşturma

Yeni bir .NET MAUI uygulaması oluşturmak için:

1. Gezgin'de .NET Projesi Oluştur'a tıklayın VEYACTRL/CMD+SHIFT+P> .NET: Yeni Proje....
2. .NET MAUI Uygulaması veya .NET MAUI Blazor Uygulaması'nı seçin.
3. Boş bir klasör seçin. Dosya gezgini yeniden açılırsa klasörünüz boş değildir.
4. Projeyi adlandırın.
5. Projenin Çözüm Gezgini başarıyla yüklendiğinden emin olun ve bir C# veya XAML dosyası açın.

Var olan bir .NET MAUI projenizi Visual Studio Code'da Dosya > Aç.... aracılığıyla da açabilirsiniz.

Şimdi uygulamanızı Visual Studio Code'da C# Dev Kit'in Çözüm Gezgini görmeniz gerekir. .NET MAUI uzantısı C# Dev Kit'e bağlı olduğundan tüm özelliklerini .NET MAUI uzantısıyla birlikte kullanabilirsiniz.

Hedef cihazınızı seçin

Visual Studio Code'un sağ alt köşesindeki küme ayraçları simgesine { } tıklayın. Burada Başlangıç Projenizi değiştirebilir, Hata Ayıklama Hedefinizi geliştirme makinenizde geçerli herhangi bir değerle değiştirebilir ve iki ayarı visual studio code durum çubuğuna sabitleyebilirsiniz:

".NET MAUI" komutunu kullanarak CTRL/CMD+SHIFT+P ve arayarak komut paletinde Başlangıç Projesi ve Hata Ayıklama Hedefi'ni de ayarlayabilirsiniz.

Varsayılan olarak, yerel macOS veya Windows geliştirme makinenize dağıtabilirsiniz. macOS'ta, iOS simülatörlerine de dağıtabilirsiniz.

Android öykünücülerini kullanmak istiyorsanız şu adımları izleyin:

1. Terminalinizde adresine <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/latest/bin/gidin.
2. Windows'da veya ./sdkmanager --install emulatorsdkmanager --install system-images;android-33;google_apis;x86_64 macOS'ta ve ./sdkmanager --install system-images;android-33;google_apis;x86_64 üzerinde çalıştırınsdkmanager --install emulator.
3. Ardından, Android'in avdmanager'ı ile komut satırında yeni bir öykünücü oluşturabilirsiniz. Örneğin, Windows veya ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64" macOS üzerinde çalıştırabilirsinizavdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64".

Fiziksel Android cihazlarda da hata ayıklayabilirsiniz.

Uygulamanızda hata ayıklama

Uygulamanızda hata ayıklamak için Visual Studio Code'un Çalıştır ve Hata Ayıkla menüsüne gidin ve "Çalıştır ve Hata Ayıkla" düğmesini seçin. Alternatif olarak, hata ayıklama oturumu başlatmak için kullanabilirsiniz F5 . Visual Studio Code bir hata ayıklayıcı seçmenizi isterse ".NET MAUI" öğesini seçtiğinizden emin olun.

Hata ayıklayıcı, küme ayraçları { } menüsünde ayarladığınız Hata Ayıklama Hedefi ve Başlangıç Projesi'ni otomatik olarak seçer. Herhangi bir şey seçmediyseniz, hata ayıklama hedefi seçmeniz istenir.

Uygulamanız hata ayıklamaya başladıktan sonra, kesme noktaları ayarlamak, kodunuzun tamamında adım adım gezinmek ve daha fazlasını yapmak için yerleşik Visual Studio Code hata ayıklama araçlarını kullanabilirsiniz.

Daha fazla bilgi edinin

Uzantıyla ilgili herhangi bir sorunla karşılaşırsanız sorun giderme adımlarını izleyebilir, bilinen sorunlarımızı görebilir veya geri bildirim sağlayabilirsiniz.

Sonraki adımlar

Bu öğreticide, ilk .NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) uygulamanızı oluşturmayı ve çalıştırmayı öğrendiniz.

.NET MAUI ile uygulama oluşturmanın temellerini öğrenmek için bkz . .NET MAUI uygulaması oluşturma. Alternatif olarak, tam bir .NET MAUI eğitim kursu için bkz . .NET MAUI ile mobil ve masaüstü uygulamaları oluşturma.