Share via

.NET Yükseltme Yardımcısı ile bir Xamarin.Forms uygulamayı .NET MAUI uygulamasına yükseltme

  • Makale

.NET Yükseltme Yardımcısı, çözümün proje dosyasını dönüştürerek ve ortak kod güncelleştirmeleri gerçekleştirerek projeleri .NET Çok Platformlu Uygulama Kullanıcı Arabirimi'ne (.NET MAUI) yükseltmenize Xamarin.Forms yardımcı olur. Özellikle araç şunları yapacaktır:

  • Sınıf kitaplığı projesini Xamarin.Forms , Xamarin.iOS projesini ve Xamarin.Android projesini SDK stili projelere dönüştürün.
  • Proje dosyalarındaki hedef çerçeveyi net8.0-android gerektiği gibi ve net8.0-iosolarak güncelleştirin.
  • Proje dosyalarında ayarlayın <UseMaui>true</UseMaui> .
  • Ek proje özellikleri ekleyin ve gerekli olmayan proje özelliklerini kaldırın.
  • Belirli NuGet paketlerini ekleme ve kaldırma:
    • Xamarin.Forms ve Xamarin.Essentials NuGet paketlerini kaldırın.
    • Xamarin.CommunityToolkit NuGet paketini NuGet paketiyle .NET MAUI Community Toolkit değiştirin.
    • Kullanılıyorsa NuGet paketlerinin SkiaSharp uyumlu sürümlerini .NET MAUI uyumlu sürümleriyle değiştirinXamarin.Forms.
  • Ad alanına başvuruları Xamarin.Essentials kaldırın ve ad alanını Xamarin.Forms ve Microsoft.Maui.Controls ad alanlarıyla Microsoft.Maui değiştirin.

Aracı çalıştırdıktan sonra geçişi tamamlamak için ek çaba gerekir.

Not

.NET MAUI için .NET Yükseltme Yardımcısı UWP projelerini, iOS uzantı projelerini veya bağlama projelerini yükseltmeyi desteklemez.

Dönüştürebileceği diğer uygulama türleri de dahil olmak üzere .NET Yükseltme Yardımcısı hakkında daha fazla bilgi için bkz . .NET Yükseltme Yardımcısı'na genel bakış.

Kullanmaya başlayın

.NET Yükseltme Yardımcısı, Windows'da Visual Studio uzantısı olarak ve Windows ve Mac için BIR CLI aracı olarak kullanılabilir. Bunu kullanmak için projenizin Xamarin.Forms 4,8 veya üzerini kullanması Xamarin.Forms gerekir. Ancak, en iyi başarı için projenizin Xamarin.Forms 5.0 ve .NET Standard 2.0 veya üzerini kullanmasını Xamarin.Forms öneririz.

Önemli

.NET MAUI için .NET Yükseltme Yardımcısı hala geliştirme aşamasındadır. Bu aracı geliştirmeye devam edebilmemiz için lütfen bir 'area:Maui' etiketiyle geri bildirim gönderin.

.NET Yükseltme Yardımcısı, aşağıdakilerin gerçekleştirileceği yükseltme türünü sorar:

  • Yerinde: Bu seçenek, kopya oluşturmadan projenizi yükselter.
  • Yan yana: Bu seçenek projenizi kopyalar ve kopyayı yükselterek özgün projeyi tek başına bırakır. Şu anda .NET MAUI yan yana yükseltme, her proje başlığını yükseltmek için yeni projeler oluşturulmasını gerektirir. Bir proje başlığını mevcut bir projeye yükseltme girişimi büyük olasılıkla hatalara neden olur ve şu anda desteklenen bir deneyim değildir.

Uygulamanızı Xamarin.Forms .NET MAUI'ye yükseltmeden önce uygulamanızı 5 kullanacak Xamarin.Forms şekilde güncelleştirmeli Xamarin.Forms ve hala düzgün çalıştığından emin olmalısınız. Ayrıca, uygulamanızın kullandığı bağımlılıkları en son sürümlere güncelleştirmeniz gerekir.

Bu, ve .NET MAUI arasındaki Xamarin.Forms API farklarını en aza indirgeyeceği için geçiş işleminin geri kalanını basitleştirmeye yardımcı olur ve varsa bağımlılıklarınızın .NET uyumlu sürümlerini kullandığınızdan emin olur.

Visual Studio'da hızlı işlemler

.NET Yükseltme Yardımcısı, ad alanlarını ampul olarak görüntülenen uygun .NET MAUI ad alanlarına dönüştürmek Xamarin.Forms için hızlı bir eyleme sahiptir:

Screenshot of previewing the application of a light bulb suggestion.

Hızlı işlem, dosya genelinde gerekli değişiklikleri yapar.

Not

Hızlı işlem ampulleri, dosyaları projenizden Xamarin.Forms bir .NET MAUI projesine geçirirken görünür.

Yükleme

Yükseltme yardımcısını çalıştırmak için Visual Studio 2022 sürüm 17.6.0 veya üzeri önerilir. Yükseltme yardımcısı uzantısını yüklemek için:

  1. Visual Studio'yu açın ve Uzantıları > Yönet menü öğesini seçin.
  2. Uzantıları Yönet iletişim kutusunda .NET Yükseltme Yardımcısı'nı arayın ve indirin.
  3. Uzantı indirildikten sonra Visual Studio'yu kapatın. Uzantı daha sonra yüklenir.

Visual Studio Market'te yeni bir sürüm kullanılabilir olduğunda uzantılar otomatik olarak güncelleştirilir. Daha fazla bilgi için bkz . Otomatik uzantı güncelleştirmeleri.

Yükseltme yardımcısını çalıştırma

Çözüm Gezgini'da projeye sağ tıklayın ve Yükselt'i seçin.

Sonraki adımlar

El ile geçiş