Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Menambahkan Firebase ke project iOS Anda

Prasyarat

  • Instal yang berikut:

    • Xcode 12.2 atau yang lebih baru
    • CocoaPods 1.10.0 atau yang lebih baru
  • Pastikan project Anda memenuhi persyaratan berikut:

    • Project Anda harus menargetkan iOS 10 atau yang lebih baru.
  • Siapkan perangkat iOS fisik atau gunakan simulator iOS 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 iOS, Anda perlu membuat project Firebase untuk terhubung ke aplikasi iOS. 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 iOS 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 sudah menambahkan aplikasi ke project Firebase Anda, klik Tambahkan aplikasi untuk menampilkan opsi platform.

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

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

  5. Klik Daftarkan aplikasi.

Langkah 3: Tambahkan file konfigurasi Firebase

  1. Klik Download GoogleService-Info.plist untuk mendapatkan file konfigurasi iOS 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 Anda 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

Sebaiknya gunakan CocoaPods untuk menginstal library Firebase. Namun, jika tidak ingin menggunakan CocoaPods, Anda bisa mengintegrasikan framework SDK secara langsung atau menggunakan Swift Package Manager.

Apakah Anda menggunakan salah satu contoh panduan memulai? Project Xcode dan Podfile (dengan pod) sudah ada, tetapi Anda masih perlu menambahkan file konfigurasi Firebase dan menginstal pod.

  1. Buat Podfile jika belum memilikinya:

    cd your-project-directory
    pod init
  2. Tambahkan pod Firebase yang ingin digunakan dalam aplikasi Anda ke Podfile tersebut.

    Anda dapat menambahkan produk Firebase yang didukung ke aplikasi iOS.

    Analytics diaktifkan

    platform :ios, ‘10.0’
    # Add the Firebase pod for Google Analytics pod 'Firebase/Analytics' # For Analytics without IDFA collection capability, use this pod instead # pod ‘Firebase/AnalyticsWithoutAdIdSupport’ # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'

    Pelajari lebih lanjut IDFA, ID iklan tingkat perangkat, dalam dokumentasi Privasi Pengguna dan Penggunaan Data dan App Tracking Transparency Apple.

    Analytics tidak diaktifkan

    platform :ios, ‘10.0’
    # Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'
  3. Instal pod, lalu buka file .xcworkspace untuk melihat project di Xcode:

    pod install
    open your-project.xcworkspace

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 Analytics, jalankan 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, buka FAQ & pemecahan masalah iOS.

Pod yang tersedia

Bagian ini mencantumkan produk Firebase yang didukung untuk iOS dan podnya. Pelajari library Firebase iOS ini lebih lanjut:

Layanan atau Produk Pod Tambahkan Analytics?
AdMob pod 'Google-Mobile-Ads-SDK'
Analytics pod 'Firebase/Analytics'
App Check pod 'Firebase/AppCheck'
App Distribution pod 'Firebase/AppDistribution'
Authentication pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
SDK Klien Cloud Functions for Firebase pod 'Firebase/Functions'
Cloud Messaging pod 'Firebase/Messaging'
Cloud Storage pod 'Firebase/Storage'
Crashlytics pod 'Firebase/Crashlytics'
Dynamic Links pod 'Firebase/DynamicLinks'
In-App Messaging pod 'Firebase/InAppMessaging'
(wajib ada)
Penginstalan Firebase pod 'Firebase/Installations'
Firebase ML Custom Model API pod 'Firebase/MLModelDownloader'
Performance Monitoring pod 'Firebase/Performance'
Realtime Database pod 'Firebase/Database'
Remote Config pod 'Firebase/RemoteConfig'

Mengintegrasi tanpa CocoaPods

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

Framework

Selain mendukung platform iOS, zip kini menyertakan file .xcframework yang menambahkan dukungan Catalyst berbasis komunitas. Untuk mengetahui detailnya, baca artikel README Firebase iOS SDK 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.

Swift Package Manager

Pelajari lebih lanjut integrasi Swift Package Manager di panduan kami.

Langkah berikutnya

Mempelajari Firebase:

Menambahkan layanan Firebase ke aplikasi Anda: