Menambahkan Firebase ke project Apple

Prasyarat

  • Instal yang berikut ini:

    • Xcode 12.5 atau yang lebih baru
  • Pastikan project Anda memenuhi persyaratan berikut:

    • Project Anda harus menargetkan 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.

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

Setelah memiliki project Firebase, Anda dapat menambahkan aplikasi Apple ke dalamnya.

Buka artikel Memahami Project Firebase untuk mempelajari lebih lanjut praktik terbaik dan pertimbangan dalam menambahkan aplikasi ke project Firebase, termasuk cara menangani beberapa varian build.

  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.

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

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

  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 posisi terbuka, buka File > Swift Packages > Add Package Dependency.
  2. Jika diminta, tambahkan repositori SDK platform Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. Pilih versi SDK yang ingin Anda gunakan.
  5. 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 Firebase di UIApplicationDelegate Anda:

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  2. Konfigurasikan instance bersama FirebaseApp, biasanya ada dalam metode application:didFinishLaunchingWithOptions: aplikasi Anda:

    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:

Layanan atau Produk Pod Library SwiftPM Tambahkan Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' T/A
Analytics pod 'Firebase/Analytics' FirebaseAnalytics
App Check pod 'Firebase/AppCheck' FirebaseAppCheck
App Distribution pod 'Firebase/AppDistribution' FirebaseAppDistribution
Authentication pod 'Firebase/Auth' FirebaseAuth
Cloud Firestore pod 'Firebase/Firestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'Firebase/Functions' FirebaseFunctions
Cloud Messaging pod 'Firebase/Messaging' FirebaseMessaging
Cloud Storage pod 'Firebase/Storage' FirebaseStorage
Crashlytics pod 'Firebase/Crashlytics' FirebaseCrashlytics
Dynamic Links pod 'Firebase/DynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'Firebase/InAppMessaging' FirebaseInAppMessaging
(wajib ada)
Penginstalan Firebase pod 'Firebase/Installations' FirebaseInstallations
Firebase ML Custom Model API pod 'Firebase/MLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'Firebase/Performance' FirebasePerformance
Realtime Database pod 'Firebase/Database' FirebaseDatabase
Remote Config pod 'Firebase/RemoteConfig' FirebaseRemoteConfig

Mengintegrasikan tanpa pengelola dependensi

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

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.

CocoaPods

Pelajari integrasi CocoaPods lebih lanjut di panduan kami.

Langkah berikutnya

Mempelajari Firebase:

Menambahkan layanan Firebase ke aplikasi Anda: