Mulai menggunakan Xamarin.Essentials

  • Artikel

Xamarin.Essentials menyediakan API lintas platform tunggal yang berfungsi dengan aplikasi iOS, Android, atau UWP apa pun yang dapat diakses dari kode bersama terlepas dari bagaimana antarmuka pengguna dibuat. Lihat panduan dukungan platform & fitur untuk informasi selengkapnya tentang sistem operasi yang didukung.

Penginstalan

Xamarin.Essentials tersedia sebagai paket NuGet dan disertakan dalam setiap proyek baru di Visual Studio. Ini juga dapat ditambahkan ke proyek yang ada menggunakan Visual Studio dengan langkah-langkah berikut.

  1. Unduh dan instal Visual Studio dengan alat Visual Studio untuk Xamarin.

  2. Buka proyek yang sudah ada, atau buat proyek baru menggunakan templat Aplikasi Kosong di bawah Visual Studio C# (Android, i Telepon & iPad, atau Lintas Platform).

    Penting

    Jika menambahkan ke proyek UWP, pastikan Build 16299 atau yang lebih tinggi diatur dalam properti proyek.

  3. Xamarin.Essentials Tambahkan paket NuGet ke setiap proyek:

    Di panel Penjelajah Solusi, klik kanan pada nama solusi dan pilih Kelola Paket NuGet. Cari Xamarin.Essentials dan instal paket ke semua proyek termasuk pustaka Android, iOS, UWP, dan .NET Standard.

  4. Tambahkan referensi ke Xamarin.Essentials di kelas C# apa pun untuk mereferensikan API.

    using Xamarin.Essentials;

  5. Xamarin.Essentials memerlukan penyiapan khusus platform:

    Xamarin.Essentials mendukung versi Android minimum 4.4, yang sesuai dengan API level 19, tetapi versi Android target untuk kompilasi harus 9.0 atau 10.0, yang sesuai dengan API level 28 dan level 29. (Di Visual Studio, kedua versi ini diatur dalam dialog Properti Proyek untuk proyek Android, di tab Manifes Android. Di Visual Studio untuk Mac, mereka diatur dalam dialog Opsi Proyek untuk proyek Android, di tab Aplikasi Android.)

    Saat mengkompilasi terhadap Android 9.0, Xamarin.Essentials instal versi 28.0.0.3 dari pustaka Xamarin.Android.Support yang diperlukan. Pustaka Xamarin.Android.Support lain yang diperlukan aplikasi Anda juga harus diperbarui ke versi 28.0.0.3 menggunakan manajer paket NuGet. Semua pustaka Xamarin.Android.Support yang digunakan oleh aplikasi Anda harus sama, dan setidaknya harus versi 28.0.0.3. Lihat halaman pemecahan masalah jika Anda mengalami masalah saat menambahkan Xamarin.Essentials NuGet atau memperbarui NuGets dalam solusi Anda.

    Dimulai dengan versi 1.5.0 saat mengkompilasi terhadap Android 10.0, Xamarin.Essentials instal pustaka dukungan AndroidX yang diperlukan. Baca dokumentasi AndroidX jika Anda belum melakukan transisi.

    Dalam proyek MainLauncher Android atau apa pun Activity yang diluncurkan, Xamarin.Essentials harus diinisialisasi dalam OnCreate metode :

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

    Untuk menangani izin runtime di Android, Xamarin.Essentials harus menerima apa pun OnRequestPermissionsResult. Tambahkan kode berikut ke semua Activity kelas:

    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 Ikuti panduan yang memungkinkan Anda menyalin dan menempelkan cuplikan kode untuk setiap fitur.

Xamarin.Essentials - API Lintas Platform untuk Aplikasi Seluler (video)

Sumber Daya Lain

Kami merekomendasikan pengembang baru untuk kunjungan Xamarin memulai pengembangan Xamarin.

Xamarin.Essentials Kunjungi Repositori GitHub untuk melihat kode sumber saat ini, apa yang akan terjadi selanjutnya, jalankan sampel, dan kloning repositori. Kontribusi komunitas dipersilakan!

Telusuri dokumentasi API untuk setiap fitur Xamarin.Essentials.