Bekerja dengan Kemampuan di Xamarin.iOS

Artikel
01/10/2024

Menambahkan kemampuan ke aplikasi sering memerlukan penyiapan provisi tambahan. Panduan ini menjelaskan pengaturan yang diperlukan untuk semua kemampuan.

Apple memberi pengembang kemampuan, sering dikenal sebagai layanan aplikasi, sebagai sarana memperluas fungsionalitas dan memperluas cakupan apa yang dapat dilakukan aplikasi iOS. Kemampuan ini memungkinkan pengembang untuk menambahkan integrasi fitur platform yang lebih dalam ke aplikasi mereka, seperti: kemampuan untuk memiliki transaksi moneter yang dimulai dari aplikasi, layanan perangkat tambahan seperti Siri, dan banyak lagi. Kemampuan ini dapat digunakan dengan proyek Xamarin.iOS. Daftar lengkap layanan dijelaskan di bawah ini:

Grup Aplikasi
Domain Terkait
Perlindungan Data
Pusat Permainan
HealthKit
HomeKit
Konfigurasi Aksesori Nirkabel
Icloud
Pembelian Dalam Aplikasi
Audio Antar Aplikasi
Apple Pay
Dompet
Pemberitahuan Push
VPN Pribadi
Siri
Maps
Mode Latar belakang
Berbagi Rantai Kunci
Ekstensi Jaringan
Konfigurasi Hotspot
Multipath
Pembacaan Tag NFC

Kemampuan dapat diaktifkan baik melalui Visual Studio untuk Mac dan Visual Studio 2019, atau secara manual di Portal Pengembang Apple. Kemampuan tertentu seperti Wallet, Apple Pay, dan iCloud memerlukan konfigurasi tambahan ID Aplikasi.

Panduan ini menjelaskan cara mengaktifkan masing-masing App Services ini di aplikasi Anda secara otomatis di Visual Studio dan secara manual melalui pusat pengembang, termasuk penyiapan tambahan yang mungkin diperlukan.

Menambahkan App Services

Untuk menggunakan kemampuan, aplikasi harus memiliki profil provisi valid yang berisi ID Aplikasi dengan layanan yang benar diaktifkan. Membuat profil provisi ini dapat dilakukan secara otomatis di Visual Studio untuk Mac dan Visual Studio 2019, atau secara manual di Pusat Pengembang Apple.

Bagian ini menjelaskan cara menggunakan provisi otomatis Visual Studio atau Pusat Pengembang untuk mengaktifkan sebagian besar kemampuan. Ada beberapa kemampuan seperti Wallet, iCloud, Apple Pay, dan App Groups yang memerlukan pengaturan tambahan. Ini dijelaskan secara rinci dalam panduan yang berdampingan.

Penting

Tidak semua kemampuan dapat ditambahkan dan dikelola dengan Provisi Otomatis. Daftar berikut berisi kemampuan yang didukung:

HealthKit
HomeKit
VPN Pribadi
Konfigurasi Aksesori Nirkabel
Audio Antar Aplikasi
Sirikit
Hotspot
Ekstensi Jaringan
Pembacaan Tag NFC
Multipath

Pemberitahuan Push, Pusat Game, Pembelian Dalam Aplikasi, Peta, Berbagi Rantai Kunci, Domain Terkait, dan kemampuan Perlindungan Data saat ini tidak didukung. Untuk menambahkan kemampuan ini, gunakan provisi manual dan ikuti langkah-langkah di bagian Pusat Pengembang.

Kemampuan ditambahkan ke Entitlements.plist di Visual Studio untuk Mac. Untuk menambahkan kemampuan, gunakan langkah-langkah berikut:

Buka file Info.plist aplikasi iOS Anda dan pilih skema Provisi Otomatis dan Tim Anda dari kotak kombo. Ikuti langkah-langkah dalam panduan Provisi Otomatis jika Anda memerlukan bantuan:
Buka file Entitlements.plist dan pilih kemampuan yang ingin Anda tambahkan:

Memilih kemampuan melakukan dua hal:
- Menambahkan fitur tersebut ke ID Aplikasi Anda
- Menambahkan pasangan kunci/nilai pemberian izin ke file Entitlements.plist Anda.
Visual Studio untuk Mac akan memberi tahu Anda ketika tugas-tugas ini telah dilakukan dengan menampilkan pesan keberhasilan berikut:

Menggunakan Pusat Pengembang

Menggunakan pusat pengembang adalah proses dua langkah yang memerlukan pembuatan ID Aplikasi lalu menggunakan ID Aplikasi tersebut untuk membuat profil provisi. Langkah-langkah ini dirinci di bawah ini.

Membuat ID Aplikasi dengan layanan aplikasi

Telusuri ke Pusat Pengembang Apple di Mac (mac host build jika menggunakan komputer windows) dan masuk.
Pilih Sertifikat, Pengidentifikasi, dan Profil:
Di bawah Pengidentifikasi, pilih ID Aplikasi:
Tekan tombol + di sudut kanan atas untuk membuat ID Aplikasi baru.
Masukkan deskripsi ID Aplikasi, pilih ID Aplikasi Eksplisit, dan masukkan ID bundel dalam format com.domain.appname. ID bundel ini harus cocok dengan ID bundel dalam proyek Anda:
Di bawah App Services pilih layanan atau layanan yang diperlukan di aplikasi Anda:
Tekan Lanjutkan.
Konfirmasi ID Aplikasi Anda. Setiap layanan akan berada di salah satu status berikut: Diaktifkan, Dinonaktifkan, atau Dapat Dikonfigurasi, seperti yang diilustrasikan di bawah ini. Jika Diaktifkan, siap digunakan dalam profil provisi. Jika dapat Dikonfigurasi, penyiapan tambahan diperlukan untuk kemampuan ini. Langkah-langkah tambahan ini dijelaskan secara lebih rinci di bagian selanjutnya.
Klik Daftar lalu Selesai. ID Aplikasi yang baru dibuat harus ditampilkan di daftar ID Aplikasi iOS.

Membuat Profil Provisi

Sekarang buat profil provisi yang berisi ID Aplikasi ini. Ikuti langkah berikut:

Di Pusat Pengembang Apple, telusuri Ke Profil Provisi > Semua:
Tekan tombol + di sudut kanan atas untuk membuat profil provisi baru.
Pilih jenis profil provisi yang Anda butuhkan, dan klik Lanjutkan:
Dari daftar dropdown, pilih ID Aplikasi yang dibuat pada langkah-langkah di atas dan tekan Lanjutkan:
Pilih sertifikat yang digunakan untuk menandatangani aplikasi dan tekan Lanjutkan:
Pilih perangkat yang akan disertakan dalam profil ini dan tekan Lanjutkan:
Beri nama profil sehingga dapat diidentifikasi dan tekan Lanjutkan untuk membuat profil:
Tekan tombol Unduh untuk mengunduhnya, dan klik dua kali pada file di Finder untuk menginstal profil provisi.
Jika Anda menggunakan Visual Studio pastikan bahwa opsi Provisi Manual dipilih.
Di Visual Studio untuk Mac/Visual Studio, telusuri penandatanganan Bundel Opsi > Proyek dan atur profil provisi ke profil yang baru saja dibuat:

Penting

Anda mungkin juga perlu mengatur kunci pemberian hak dalam file Entitlement.plist dan kunci privasi dalam file Info.plist. Informasi selengkapnya tentang pemberian izin ini disediakan dalam panduan Bekerja dengan Pemberian Izin.

Langkah berikutnya

Setelah Kemampuan diaktifkan di sisi server, masih ada pekerjaan yang perlu dilakukan untuk memungkinkan aplikasi Anda menggunakan fungsionalitas. Daftar di bawah ini menjelaskan langkah-langkah tambahan yang mungkin perlu diambil:

Gunakan namespace kerangka kerja di aplikasi Anda.
Tambahkan hak yang diperlukan ke Aplikasi Anda. Informasi tentang hak yang diperlukan dan cara menambahkannya dirinci dalam panduan Pengenalan Pemberian Hak.

Kemampuan Pemecahan Masalah

Daftar di bawah ini merinci beberapa masalah paling umum yang dapat membuat blokir jalan saat mengembangkan aplikasi dengan layanan aplikasi diaktifkan.

Pastikan bahwa ID yang benar telah dibuat dan didaftarkan dengan benar di bagian Sertifikat, ID , & Profil di Portal Pengembang Apple.
Pastikan bahwa Layanan telah ditambahkan ke ID Aplikasi (atau Ekstensi) dan bahwa layanan dikonfigurasi untuk menggunakan Grup Aplikasi/ID Pedagang/Kontainer yang dibuat di atas dalam Sertifikat, ID , & Profil Portal Pengembang Apple.
Pastikan bahwa Profil Provisi dan ID Aplikasi telah diinstal dan Info.plist Aplikasi (dalam Proyek Xamarin) menggunakan salah satu ID Aplikasi yang dikonfigurasi di atas.
Pastikan bahwa file Entitlements.plist Aplikasi (dalam Proyek Xamarin) mengaktifkan layanan yang benar.
Pastikan bahwa kunci privasi yang sesuai diatur dalam info.plist
Dalam Penandatanganan Bundel iOS Aplikasi, pastikan bahwa Pemberian Izin Kustom diatur ke Entitlements.plist. Ini bukan pengaturan default untuk build Simulator Debug dan iOS.

Ringkasan

Panduan ini menjelaskan Kemampuan, atau layanan aplikasi, dan menjelaskan bagaimana mereka dapat diaktifkan di Visual Studio dan di Pusat Pengembang Apple. Ini juga merinci cara menyiapkan layanan yang lebih rumit seperti Wallet, iCloud, Apple Pay, dan App Groups. Terakhir, ini mencakup langkah-langkah berikutnya untuk menyiapkan dan opsi pemecahan masalah sederhana.

Bagikan melalui