Uygulama oluşturma .NET MAUIBlazor Hybrid

Makale
11/12/2024

Not

Bu, bu makalenin en son sürümü değildir. Geçerli sürüm için bu makalenin .NET 9 sürümüne bakın.

Uyarı

ASP.NET Core'un bu sürümü artık desteklenmiyor. Daha fazla bilgi için bkz . .NET ve .NET Core Destek İlkesi. Geçerli sürüm için bu makalenin .NET 9 sürümüne bakın.

Önemli

Bu bilgiler, ticari olarak piyasaya sürülmeden önce önemli ölçüde değiştirilebilen bir yayın öncesi ürünle ilgilidir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Geçerli sürüm için bu makalenin .NET 9 sürümüne bakın.

Bu öğreticide uygulama oluşturma ve çalıştırma işlemi gösterilmektedir .NET MAUIBlazor Hybrid . Şunları yapmayı öğreneceksiniz:

.NET MAUI Blazor Hybrid Visual Studio'da uygulama projesi oluşturma
Uygulamayı Windows'da çalıştırma
Uygulamayı Android Öykünücüsü'nde öykünülmüş bir mobil cihazda çalıştırma

Önkoşullar

Desteklenen platformlar (.NET MAUI belgeler)
.NET Multi-platform App UI.
Microsoft Edge WebView2: WebView2 yerel bir uygulama çalıştırırken Windows'da gereklidir. Uygulamaları geliştirirken .NET MAUIBlazor Hybrid ve yalnızca Visual Studio öykünücülerinde WebView2 çalıştırırken gerekli değildir.
Android öykünücüsünün performansını geliştirmek için donanım hızlandırmayı etkinleştirin.

Bu öğreticinin önkoşulları ve yazılım yükleme hakkında daha fazla bilgi için belgelerde aşağıdaki kaynaklara .NET MAUI bakın:

.NET MAUI Blazor Hybrid Uygulama oluşturma

Visual Studio’yu başlatın. Başlangıç Penceresi'nde Yeni proje oluştur'u seçin:

Yeni çözüm.

Yeni proje oluştur penceresinde, MAUI şablonlarını filtrelemek için Proje türü açılan listesini kullanın:

Şablonları olarak filtreleyin .NET MAUI.

Uygulama şablonunu ve ardından İleri.NET MAUI:Blazor Hybrid

Şablon seçin.

Not

.NET 7 veya önceki sürümlerinde şablona Uygulama.NET MAUIBlazor verilmiştir.

Yeni projenizi yapılandırın iletişim kutusunda:

Proje adını olarak MauiBlazorayarlayın.
Proje için uygun bir konum seçin.
İleri düğmesini seçin.

Projeyi yapılandırın.

Ek bilgiler iletişim kutusunda Çerçeve açılan listesiyle çerçeve sürümünü seçin. Oluştur düğmesini seçin:

Çerçeve sürümünü seçmek ve projeyi oluşturmak için ek bilgi iletişim kutusu.

Visual Studio'nun projeyi oluşturmasını ve projenin bağımlılıklarını geri yüklemesini bekleyin. Bağımlılıklar girdisini açarak Çözüm Gezgini ilerleme durumunu izleyin.

Bağımlılıklar geri yükleniyor:

Bağımlılıklar geri yükleniyor.

Geri yüklenen bağımlılıklar:

Geri yüklenen bağımlılıklar.

Uygulamayı Windows'da çalıştırma

Visual Studio araç çubuğunda, projeyi oluşturmak ve başlatmak için Windows Makinesi düğmesini seçin:

Geliştirici Modu etkin değilse, geliştiriciler için Ayarlar> (Windows 11) bölümünden etkinleştirmeniz istenir. Anahtarı Açık olarak ayarlayın.

Windows masaüstü uygulaması olarak çalışan uygulama:

Windows üzerinde çalışan uygulama.

Uygulamayı Android Öykünücüsü'nde çalıştırma

Uygulamayı Windows'da çalıştırma bölümündeki yönergeleri izlediyseniz, çalışan Windows uygulamasını durdurmak için araç çubuğundaki Hata Ayıklamayı Durdur düğmesini seçin:

Visual Studio araç çubuğunda yapılandırmayı başlat açılan düğmesini seçin. Android Öykünücüleri Android Öykünücüsü'ne tıklayın:>

Android SDK'ları, Android için uygulama oluşturmak için gereklidir. Hata Listesi panelinde, gerekli Android SDK'larını yüklemek için iletiye çift tıklamanızı isteyen bir ileti görüntülenir:

Android SDK'larını yüklemek için iletiye tıklamanızı isteyen iletinin yer aldığı Visual Studio Hata Listesi.

Android SDK Lisans Kabulü penceresi görüntülenir ve görüntülenen her lisans için Kabul Et düğmesini seçin. Android Öykünücüsü ve SDK Patch Applier lisansları için ek bir pencere görüntülenir. Kabul Et düğmesini seçin.

Visual Studio'nın Android SDK'sını ve Android Öykünücüsü'ni indirmesini bekleyin. Visual Studio kullanıcı arabiriminin sol alt köşesindeki arka plan görevleri göstergesini seçerek ilerleme durumunu izleyebilirsiniz:

Visual Studio arka plan görevleri göstergesi.

Gösterge, arka plan görevleri tamamlandığında bir onay işareti gösterir:

Visual Studio arka plan görevleri göstergesi işaretli.

Araç çubuğunda Android Öykünücüsü düğmesini seçin:

Varsayılan Android Cihazı Oluştur penceresinde Oluştur düğmesini seçin:

Varsayılan Android Cihazı penceresi oluşturun.

Visual Studio'nın bir Android Öykünücüsü indirmesini, sıkıştırmasını açmasını ve oluşturmasını bekleyin. Android telefon öykünücüsü hazır olduğunda Başlangıç düğmesini seçin.

Not

Android öykünücüsünün performansını geliştirmek için donanım hızlandırmayı etkinleştirin.

Android Aygıt Yöneticisi penceresini kapatın. Öykünülen telefon penceresi görünene, Android işletim sistemi yüklenene ve ana ekran görünene kadar bekleyin.

Önemli

Uygulamayı hata ayıklayıcıda yüklemek ve çalıştırmak için öykünülen telefonun Android işletim sistemi yüklü olarak açık olması gerekir. Öykünülen telefon çalışmıyorsa, Ctrl+ klavye kısayolunu kullanarak veya kullanıcı arabiriminde Aç/Aç düğmesini seçerek telefonu açın:

Visual Studio araç çubuğunda, projeyi derlemek ve çalıştırmak için düğmeyi seçin Pixel 5 - {VERSION} ; burada {VERSION} yer tutucu Android sürümüdür. Aşağıdaki örnekte, Android sürümü şeklindedir API 30 (Android 11.0 - API 30)ve yüklü Android SDK'sine bağlı olarak sonraki bir sürüm görüntülenir:

Piksel 5 API 30 öykünücü düğmesi.

Visual Studio projeyi oluşturur ve uygulamayı öykünücüye dağıtır.

Öykünücüyü başlatmak, öykünülen telefonu ve işletim sistemini yüklemek ve uygulamayı dağıtmak ve çalıştırmak, sistemin hızına ve donanım hızlandırmanın etkinleştirilip etkinleştirilmediğine bağlı olarak birkaç dakika sürebilir. Visual Studio'nun kullanıcı arabiriminin altındaki durum çubuğunu inceleyerek dağıtımın ilerleme durumunu izleyebilirsiniz. Hazır göstergesi bir onay işareti alır ve uygulama çalışırken öykünücünün dağıtım ve uygulama yükleme göstergeleri kaybolur:

Dağıtım sırasında:

Visual Studio alt bilgi çubuğunda görüntülenen ilk dağıtım-çalıştırma göstergesi.