İlk uygulamanızı oluşturma

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ükleme işlemini başlatır.

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

   

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

   

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

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

    

11. Android SDK Platformu eksik iletişim kutusunda Yükle düğmesine basın:

    

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

    

    Visual Studio'da Android SDK bileşenlerinin yüklenmesini bekleyin.

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

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

    

15. Visual Studio araç çubuğunda Pixel 7 - API 35 (Android 15.0 - API 35) düğmesine basın:

    

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

    

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

    

    Android SDK'sını indirmek için Visual Studio'yu yüklemesini bekleyin.

18. Visual Studio araç çubuğunda Pixel 7 - API 35 (Android 15.0 - API 35) 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).

19. 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, uygulamayı derlemek ve çalıştırmak için Windows Makinesi düğmesine basın:

   

7. Ç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 Visual Studio Code kullanılarak başlatılabilir ve hata ayıklanabilir.

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

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

Bu öğreticide, Mac'teki Visual Studio Code'da ilk .NET MAUI uygulamanızı oluşturacak ve macOS'ta çalıştıracaksınız:

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

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

8. Visual Studio Code'un en altındaki durum çubuğunda { } küme ayraçları simgesine basın ve Debug Target bir Android emülatörü olarak ayarlandığından emin olun.

   

   Hata ayıklama hedefini windows üzerinde CTRL+SHIFT+P veya macOS'ta CMD+SHIFT+P ve .NET MAUI seçerek de ayarlayabilirsiniz: Komut paletinden Android Cihaz seçin.

9. F5 veya Visual Studio Code'un sağ üst köşesindeki Çalıştır düğmesine basarak uygulamayı Android'de derleyin ve çalıştırın:

   

   Komut paletinde bir hata ayıklayıcı seçmeniz istenirse, C# ve ardından projenizin başlatma yapılandırmasını seçin.

10. Seçtiğiniz Android öykünücüsünün çalışan uygulamasında bana tıklayın düğmesine birkaç kez basın ve düğmeye tıklama sayısının arttığını gözlemleyin.

    

Android cihazında uygulamada hata ayıklama

Android cihazında uygulamada hata ayıklamak için:

1. Cihazınızın dağıtım için ayarlandığından emin olun. Daha fazla bilgi için bkz. Dağıtım için cihaz ayarlama.
2. Cihazınızı makinenize takın ve Visual Studio Code'da hata ayıklama hedefi olarak seçin.
3. Uygulamayı çalıştırın.

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

8. Visual Studio Code'un en altındaki durum çubuğunda{ } küme ayraçları simgesine basın ve Hata Ayıklama Hedefi belirli bir iOS simülatörüne ayarlandığından emin olun:

   

   Hata ayıklama hedefini CMD+SHIFT+P tuşlarına basıp .NET MAUI: Komut paletinden iOS Cihaz'ni seçerek de ayarlayabilirsiniz.

9. F5 veya Visual Studio Code'un sağ üst köşesindeki Çalıştır düğmesine basarak uygulamayı iOS üzerinde derleyin ve çalıştırın:

   

   Komut paletinde bir hata ayıklayıcı seçmeniz istenirse, C# ve ardından projenizin başlatma yapılandırmasını seçin.

10. Çalışan uygulamayı seçtiğiniz iOS simülatöründe açın, Click me düğmesine birkaç kez tıklayın ve düğme tıklama sayısının arttığını gözlemleyin.

    

iOS cihazında uygulamada hata ayıklama

Bir iOS cihazında uygulamada hata ayıklamak için:

1. Xcode > Ayarları > Hesapları'nde Apple Kimliğinizi Xcode'a eklediğinizden emin olun.
2. Apple Geliştirici Programı'na üyeyseniz cihazınızın ekibinize kayıtlı olduğundan emin olun.
3. Cihazınızda Geliştirici Modu'nu etkinleştirin. Uygulamanızı ilk kez çalıştırdığınızda cihazda bir açılır pencere alabilirsiniz. İzin Ver'i seçtiğinizden emin olun. Geliştirici Modu hakkında daha fazla bilgi için bkz. developer.apple.com'da bir cihazda Geliştirici Modunu Etkinleştirme .
4. Cihazınızı makinenize takın ve Visual Studio Code'da hata ayıklama hedefi olarak seçin.
5. Uygulamayı çalıştırın.

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

8. Visual Studio Code'un en altındaki durum çubuğunda, { } küme ayraçları simgesine basın ve Hata Ayıklama Hedefi'nin Mac'inize ayarlandığından emin olun:

   

   Hata ayıklama hedefini CMD+SHIFT+P tuşlarına basıp .NET MAUI seçerek de ayarlayabilirsiniz: Komut paletinden macOS Cihaz seçin.

9. F5 veya Visual Studio Code'un sağ üst köşesindeki Çalıştır düğmesine basarak uygulamayı macOS üzerinde derleyin ve çalıştırın:

   

   Komut paletinde bir hata ayıklayıcı seçmeniz istenirse, C# ve ardından projenizin başlatma yapılandırmasını seçin.

10. Ç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:

    

7. Visual Studio Code'un en altındaki durum çubuğunda { } küme ayraçları simgesine basın ve Hata Ayıklama Hedefi Windows olarak ayarlandığından emin olun.

   

   Hata ayıklama hedefini, CTRL+SHIFT+P tuşlarına basıp .NET MAUI seçerek de ayarlayabilirsiniz: Komut paletinden Windows Cihaz seçin.

8. F5 veya Visual Studio Code'un sağ üst köşesindeki Çalıştır düğmesine basarak uygulamayı Windows üzerinde derleyin ve çalıştırın:

   

   Komut paletinde bir hata ayıklayıcı seçmeniz istenirse, C# ve ardından projenizin başlatma yapılandırmasını seçin.

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: