İlk uygulamanızı oluşturma

Bu öğreticide, Windows üzerinde Visual Studio 2022'de veya Windows, macOS veya Linux'ta Visual Studio Code'da 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.12 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ü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.

Visual Studio Code

Önkoşullar

• .NET MAUI uzantısının yüklü ve yapılandırılmış olduğu Visual Studio Code:
  • C# Dev Kit'e bağlı Microsoft hesabınız.
  • .NET SDK'sı yüklü.
  • .NET MAUI SDK'sı yüklü.
  • Mac bilgisayarınızda yüklü olan Xcode, simülatör çalışma zamanları ve Xcode komut satırı araçları, eğer Apple platformlarını hedefliyorsanız dahil olmak üzere.
  • Makinenizde Microsoft OpenJDK, Android SDK ve, Android hedefleniyorsa, bir Android öykünücüsü yüklü olmalı.

Daha fazla bilgi için bkz . Yükleme.

Uygulama oluşturun

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:

1. Visual Studio Code’u başlatın. Gezgini'de, .NET Projesi Oluştur'e basın:

   

   Alternatif olarak, Windows'ta Ctrl+Shift+P tuşlarına veya macOS'ta Cmd+Shift+P tuşlarına ve ardından .NET: Yeni Proje... komutuna basın.

2. Komut paletinde .NET MAUI Uygulaması şablonunu seçin:

   

3. Proje Konumu iletişim kutusunda yeni projenin oluşturulmasını istediğiniz konumu seçin.

   Önemli

   Projeler boş bir klasörde oluşturulmalıdır.

4. Komut paletinde, yeni projeniz için bir ad girin ve ENTER tuşunabasın:

   

5. Komut paletinde proje oluşturbasın:

   

   Gerekirse klasörü güvenilir bir konum olarak kabul ederek projenin oluşturulmasını bekleyin.

6. Gezginiprojenizin kök düğümünü genişletin ve MainPage.xaml.csgibi bir C# dosyası açın:

   

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

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 tuşlarına veya macOS'ta Cmd+Shift+P tuşlarına basıp .NET MAUI: Komut paletinden Android Cihazı'nı seçerek de ayarlayabilirsiniz .

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

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:

   

   Ayrıca Cmd+Shift+P tuşlarına basıp .NET MAUI: Komut paletinden iOS Cihazı'nı seçin'i seçerek hata ayıklama hedefini 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 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.

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:

   

   Ayrıca Cmd+Shift+P tuşlarına basıp .NET MAUI: Komut paletinden macOS Cihazı'nı seçin'i seçerek hata ayıklama hedefini ayarlayabilirsiniz.

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: Komut paletinden Windows Cihazı'nı seçerek de ayarlayabilirsiniz .

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:

   

Sorun giderme

Uygulamanızın derlenememesi ve dağıtılamaması durumunda, sorununuzu çözebilecek bilinen sorunların giderilmesiyle ilgili başlıklımakalesini gözden geçirin.

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.