Kullanmaya Başlama Xamarin.Essentials

  • Makale

Xamarin.Essentials , kullanıcı arabirimi nasıl oluşturulursa oluşturulsın paylaşılan koddan erişilebilen tüm iOS, Android veya UWP uygulamalarıyla çalışan tek bir platformlar arası API sağlar. Desteklenen işletim sistemleri hakkında daha fazla bilgi için platform ve özellik destek kılavuzuna bakın.

Yükleme

Xamarin.Essentials Bir NuGet paketi olarak kullanılabilir ve Visual Studio'daki tüm yeni projelerde bulunur. Aşağıdaki adımlarla Visual Studio kullanılarak mevcut projelere de eklenebilir.

  1. Xamarin için Visual Studio araçlarıyla Visual Studio'yu indirin ve yükleyin.

  2. Var olan bir projeyi açın veya Visual Studio C# altındaki Boş Uygulama şablonunu (Android, iPhone ve iPad veya Platformlar Arası) kullanarak yeni bir proje oluşturun.

    Önemli

    UWP projesine ekleniyorsa, proje özelliklerinde Derleme 16299 veya üzerinin ayarlandığından emin olun.

  3. Xamarin.Essentials Her projeye NuGet paketini ekleyin:

    Çözüm Gezgini panelinde çözüm adına sağ tıklayın ve NuGet Paketlerini Yönet'i seçin. Paketi arayın Xamarin.Essentials ve Android, iOS, UWP ve .NET Standard kitaplıkları gibi TÜM projelere yükleyin.

  4. API'lere başvurmak için Xamarin.Essentials herhangi bir C# sınıfında öğesine başvuru ekleyin.

    using Xamarin.Essentials;

  5. Xamarin.Essentials platforma özgü kurulum gerektirir:

    Xamarin.Essentials API düzeyi 19'a karşılık gelen en düşük 4.4 Android sürümünü destekler, ancak derleme için hedef Android sürümü API düzeyi 28 ve düzey 29'a karşılık gelen 9.0 veya 10.0 olmalıdır. (Visual Studio'da, bu iki sürüm Android projesinin Proje Özellikleri iletişim kutusunda, Android Bildirimi sekmesinde ayarlanır. Mac için Visual Studio'de, Android projesinin Proje Seçenekleri iletişim kutusunda, Android Uygulaması sekmesinde ayarlanır.)

    Android 9.0'a karşı derleme yaparken, Xamarin.Essentials gerektirdiği Xamarin.Android.Support kitaplıklarının 28.0.0.3 sürümünü yükler. Uygulamanızın gerektirdiği diğer tüm Xamarin.Android.Support kitaplıkları da NuGet paket yöneticisi kullanılarak 28.0.0.3 sürümüne güncelleştirilmelidir. Uygulamanız tarafından kullanılan tüm Xamarin.Android.Support kitaplıkları aynı olmalı ve en az 28.0.0.3 sürümü olmalıdır. Çözümünüzde NuGet ekleme Xamarin.Essentials veya NuGet'leri güncelleştirme konusunda sorun yaşıyorsanız sorun giderme sayfasına bakın.

    Android 10.0'a karşı derleme yaparken sürüm 1.5.0'dan başlayarak, Xamarin.Essentials gereken AndroidX destek kitaplıklarını yükleyin. Geçişi henüz gerçekleştirmediyseniz AndroidX belgelerini okuyun.

    Android projesinde MainLauncher veya başlatılan herhangi bir Activity projede, Xamarin.Essentials yönteminde OnCreate başlatılmalıdır:

    protected override void OnCreate(Bundle savedInstanceState) {
    //...
    base.OnCreate(savedInstanceState);
    Xamarin.Essentials.Platform.Init(this, savedInstanceState); // add this line to your code, it may also be called: bundle
    //...

    Android'de çalışma zamanı izinlerini işlemek için herhangi Xamarin.Essentials bir OnRequestPermissionsResultalmalıdır. Aşağıdaki kodu tüm Activity sınıflara ekleyin:

    public override void OnRequestPermissionsResult(int requestCode, string[] permissions, Android.Content.PM.Permission[] grantResults)
{
    Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);

    base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
}

  6. Xamarin.Essentials Her özellik için kod parçacıklarını kopyalayıp yapıştırmanızı sağlayan kılavuzları izleyin.

Xamarin.Essentials - Mobil Uygulamalar için Platformlar Arası API'ler (video)

Diğer Kaynaklar

Xamarin'i kullanmaya yeni başlayan geliştiricilerin Xamarin geliştirmesine başlarken ziyaret etmelerini öneririz.

Xamarin.Essentials Geçerli kaynak kodunu, sırada ne olduğunu görmek, örnekleri çalıştırmak ve depoyu kopyalamak için GitHub Deposu'nu ziyaret edin. Topluluk katkıları memnuniyetle karşılanır!

her özelliği için API belgelerine Xamarin.Essentialsgöz atın.