İ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.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, Ayarlar uygulamasını açmak için geliştiriciler için ayarlar'a tıklayı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.

Visual Studio Code

Önkoşullar

• .NET MAUI uzantısının yüklü olduğu Visual Studio Code. Daha fazla bilgi için bkz . Yükleme.

Uygulama oluşturun

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

1. Visual Studio Code’u başlatın. Gezgin'de, Gezgin'de .NET Projesi Oluştur'a tıklayın. Alternatif olarak, CTRL/CMD+SHIFT+P .NET: Yeni Proje... seçeneğini belirleyin.
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.

Not

Var olan bir .NET MAUI projesini Visual Studio Code'da Dosya > Aç... menüsü 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

Hedef cihazınızı seçmek için Visual Studio Code'un sağ alt köşesindeki köşeli ayraç simgesine { } tıklayın. Bu simgeyi kullanarak başlangıç projenizi değiştirebilir, hata ayıklama hedefinizi geliştirme makinenizde geçerli olan herhangi bir değerle değiştirebilir ve iki ayarı Visual Studio Code durum çubuğuna sabitleyebilirsiniz:

Ayrıca, CTRL/CMD+SHIFT+P tuşlarını kullanarak ve ".NET MAUI" araması yaparak komut paletinde başlangıç projesini ayarlayabilir ve hedefin hatalarını ayıklayabilirsiniz.

Herhangi bir ek adım olmadan yerel geliştirme makinenize (Windows masaüstü veya Xcode ile macOS) dağıtabilirsiniz.

Hedef: Android

Android öykünücüleri kullanmak istiyorsanız, öykünücüyü yüklemek ve oluşturmak için şu adımları izleyin:

1. Terminalinizde adresine <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/11.0/bin/gidin.

2. Öykünücüyü yüklemek için kullanın sdkmanager .

   Windows'da terminalde aşağıdaki komutları çalıştırın:

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   macOS'ta terminalde aşağıdaki komutları çalıştırın:

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   Not

   Komut satırı bağımsız değişkenlerinin sdkmanager etrafındaki tırnak işaretleri önemlidir.

3. Ardından, Android'in avdmanager'ı ile komut satırında yeni bir öykünücü oluşturabilirsiniz.

   Windows'da terminalde aşağıdaki komutları çalıştırın:

   avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   macOS'ta terminalde aşağıdaki komutları çalıştırın:

   ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   Not

   Komut satırı bağımsız değişkenlerinin avdmanager etrafındaki tırnak işaretleri önemlidir.

Fiziksel Android cihazlarda da hata ayıklayabilirsiniz.

Hedef iOS

iOS simülatörleri Xcode'da yerleşik olarak bulunur. Simülatörleri indirmek için, Xcode ilk kez başlatıldığında bunları yükleme seçeneğinin belirlendiğinden emin olun veya Xcode > Ayarları > Platformları'na gidin ve yüklenecek bir simülatör çalışma zamanı seçin.

Bir iOS cihazıyla hata ayıklamak için, hata ayıklamayı denemeden önce şu adımları izleyin:

1. Xcode > Ayarları > Hesabı'nda Apple kimliğinizi belirtin.
2. Apple Geliştirici Programı'na üyeyseniz cihazı ekibinize kaydedin.
3. Bir cihazda Geliştirici Modunu Etkinleştirme bölümünde açıklandığı gibi 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.

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 F5 kullanabilirsiniz. Visual Studio Code bir hata ayıklayıcı seçmenizi isterse C# öğesini seçtiğinizden emin olun.

Not

Uzantının önizleme sürümlerinde hata ayıklayıcısı .NET MAUI olarak listelenmiştir. Kararlı sürümde bu yapılandırma C# ile değiştirildi.

Hata ayıklayıcı, küme ayraçları { } menüsünde ayarladığınız hata ayıklama hedefini ve başlangıç projesini otomatik olarak seçer. Herhangi bir şey seçmediyseniz bir 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 sorunlara göz atabilir 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.