Menambahkan Firebase ke project Apple

Prasyarat

• Instal yang berikut ini:

  • Xcode 13.3.1 atau yang lebih baru

• Pastikan project Anda memenuhi persyaratan berikut:

  • Project Anda harus menarget versi platform berikut atau yang lebih baru:
    • iOS 10
    • macOS 10.12
    • tvOS 12
    • watchOS 6

• Siapkan perangkat Apple fisik atau gunakan simulator untuk menjalankan aplikasi Anda.

  Apakah Anda ingin menggunakan Cloud Messaging?

  Untuk menggunakan Cloud Messaging di platform Apple, berikut adalah prasyaratnya:

  • Siapkan perangkat Apple fisik.
  • Dapatkan Kunci Autentikasi Notifikasi Push Apple untuk akun Apple Developer.
  • Di Xcode, aktifkan Notifikasi Push di App > Capabilities.

• Login ke Firebase menggunakan Akun Google Anda.

Jika Anda belum memiliki project Xcode dan hanya ingin mencoba produk Firebase, Anda dapat mendownload salah satu contoh panduan memulai kami.

Langkah 1: Buat project Firebase

Agar dapat menambahkan Firebase ke aplikasi Apple, Anda perlu membuat project Firebase yang akan dihubungkan ke aplikasi Anda. Buka bagian Memahami Project Firebase untuk mempelajari project Firebase lebih lanjut.

Langkah 2: Daftarkan aplikasi Anda ke Firebase

Untuk menggunakan Firebase di aplikasi Apple, Anda perlu mendaftarkan aplikasi ke project Firebase. Mendaftarkan aplikasi sering kali disebut sebagai "menambahkan" aplikasi ke project Anda.

1. Buka Firebase console.

2. Di bagian tengah halaman ringkasan project, klik ikon iOS+ untuk meluncurkan alur kerja penyiapan.

   Jika Anda sudah menambahkan aplikasi ke project Firebase, klik Add app untuk menampilkan opsi platform.

3. Masukkan ID paket aplikasi Anda di kolom bundle ID.

   Apa itu ID paket, dan di mana lokasinya?

   • ID paket secara unik mengidentifikasi aplikasi dalam ekosistem Apple.

   • Temukan ID paket Anda: buka project di Xcode, pilih aplikasi level teratas di navigator project, lalu pilih tab General.

     Nilai kolom Bundle Identifier adalah ID paket (misalnya, com.yourcompany.yourproject).

   • Perhatikan bahwa nilai ID paket peka huruf besar/kecil dan tidak dapat diubah untuk aplikasi Firebase ini setelah didaftarkan ke project Firebase Anda.

4. (Opsional) Masukkan informasi lain aplikasi: App nickname dan App Store ID.

   Bagaimana App nickname dan App Store ID digunakan dalam Firebase?

   • App nickname: ID internal praktis yang hanya terlihat oleh Anda di Firebase console.

   • App Store ID: Digunakan oleh Firebase Dynamic Links untuk mengalihkan pengguna ke halaman App Store Anda dan oleh Google Analytics untuk mengimpor peristiwa konversi ke Google Ads. Jika aplikasi Anda belum memiliki App Store ID, Anda dapat menambahkan ID tersebut nanti di Project settings.

5. Klik Register app.

Langkah 3: Tambahkan file konfigurasi Firebase

1. Klik Download GoogleService-Info.plist untuk mendapatkan file konfigurasi platform Apple Firebase Anda (GoogleService-Info.plist).

   Apa yang perlu Anda ketahui tentang file konfigurasi ini?

   • File konfigurasi Firebase berisi ID unik, tetapi tidak bersifat rahasia, untuk project Anda. Untuk mempelajari file konfigurasi ini lebih lanjut, baca Memahami Project Firebase.

   • Anda dapat mendownload file konfigurasi Firebase lagi kapan saja.

   • Pastikan nama file konfigurasi tidak diberi karakter tambahan, seperti (2).

2. Pindahkan file konfigurasi ke root project Xcode Anda. Jika diminta, pilih untuk menambahkan file konfigurasi ke semua target.

Jika memiliki beberapa ID paket dalam project, Anda harus mengaitkan setiap ID paket dengan aplikasi yang terdaftar di Firebase console, sehingga setiap aplikasi dapat memiliki file GoogleService-Info.plist sendiri.

Langkah 4: Tambahkan Firebase SDK ke aplikasi Anda

Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase.

1. Di Xcode, dengan project aplikasi Anda dalam keadaan terbuka, buka File > Add Packages.
2. Saat diminta, tambahkan repositori SDK platform Apple Firebase:

  https://github.com/firebase/firebase-ios-sdk

3. Pilih versi SDK yang ingin Anda gunakan.

4. Pilih library Firebase yang ingin Anda gunakan.

   Jika Google Analytics diaktifkan di project Firebase Anda, pastikan untuk menambahkan FirebaseAnalytics. Untuk Analytics tanpa kemampuan pengumpulan IDFA, tambahkan FirebaseAnalyticsWithoutAdId.

Setelah selesai, Xcode akan otomatis mulai me-resolve dan mendownload dependensi Anda di latar belakang.

Langkah 5: Inisialisasi Firebase di aplikasi Anda

Langkah terakhir adalah menambahkan kode inisialisasi ke aplikasi Anda. Anda mungkin sudah melakukannya sebagai bagian dari penambahan Firebase ke aplikasi Anda. Jika Anda menggunakan project contoh panduan memulai, hal ini telah dilakukan untuk Anda.

1. Impor modul FirebaseCore dalam UIApplicationDelegate Anda, serta semua modul Firebase lainnya yang digunakan oleh delegasi aplikasi Anda. Misalnya, untuk menggunakan Cloud Firestore dan Authentication:

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Konfigurasikan instance bersama FirebaseApp, yang biasanya ada dalam penginisialisasi App atau metode application(_:didFinishLaunchingWithOptions:) delegasi aplikasi:

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Jika Anda menyertakan Firebase SDK untuk Google Analytics, Anda dapat menjalankan aplikasi untuk mengirim verifikasi ke Firebase console bahwa Anda telah berhasil menginstal Firebase.

Selesai! Anda dapat langsung mengikuti langkah berikutnya.

Jika Anda mengalami kesulitan dalam penyiapan, kunjungi FAQ & pemecahan masalah platform Apple.

Library yang tersedia

Bagian ini mencantumkan produk Firebase yang didukung untuk platform Apple. Pelajari library platform Firebase Apple ini lebih lanjut:

• Dokumentasi referensi (Swift | Obj-C)

• Repo GitHub SDK platform Firebase Apple

Melakukan integrasi tanpa menggunakan Swift Package Manager

Jika tidak ingin menggunakan Swift Package Manager, Anda masih dapat memanfaatkan Firebase SDK dengan menggunakan CocoaPods atau mengimpor framework secara langsung.

CocoaPods

Pelajari integrasi CocoaPods lebih lanjut di panduan kami.

Framework

Selain mendukung platform iOS, zip kini menyertakan file .xcframework. Untuk mengetahui detailnya, lihat README SDK platform Apple Firebase di GitHub.

1. Download framework SDK zip. File ini berukuran ~200 MB dan mungkin perlu waktu agak lama untuk didownload.

2. Ekstrak file tersebut, lalu pelajari README untuk framework yang ingin Anda sertakan dalam aplikasi.

3. Tambahkan flag linker -ObjC di Other Linker Settings pada setelan build target Anda.

Langkah berikutnya

Mempelajari Firebase:

• Buka bagian Memahami Project Firebase untuk mempelajari lebih lanjut project Firebase dan praktik terbaik untuk project.

• Pelajari contoh aplikasi Firebase.

• Dapatkan pengalaman langsung dengan Firebase iOS Codelab.

• Pelajari kode open source di GitHub.

• Bersiap meluncurkan aplikasi Anda:

  • Siapkan pemberitahuan anggaran untuk project Anda di Google Cloud Console.
  • Pantau dasbor Usage and billing di Firebase console untuk mendapatkan gambaran keseluruhan penggunaan project Anda di berbagai layanan Firebase.
  • Periksa checklist peluncuran Firebase.

• Mengalami masalah dengan Firebase dan project Apple Anda? Kunjungi FAQ & pemecahan masalah platform Apple.

Menambahkan layanan Firebase ke aplikasi Anda:

• Dapatkan insight tentang perilaku pengguna dengan Analytics.

• Siapkan autentikasi pengguna dengan Authentication.

• Simpan data, seperti informasi pengguna, dengan Cloud Firestore atau Realtime Database.

• Simpan file, seperti foto dan video, dengan Cloud Storage.

• Picu kode backend yang berjalan di lingkungan aman dengan Cloud Functions.

• Kirim notifikasi dengan Cloud Messaging.

• Ketahui kapan dan mengapa aplikasi Anda mengalami error dengan Crashlytics.