Menambahkan Firebase ke project iOS Anda

Prasyarat

  • Instal Xcode 10.1 atau versi yang lebih baru.

  • Instal CocoaPods 1.4.0 atau versi yang lebih baru.

  • Buka project Anda di Xcode.

    • Project Anda harus menargetkan iOS 8 atau versi yang lebih baru.

    • Project Swift harus menggunakan Swift 3.0 atau versi yang lebih baru.

  • Siapkan perangkat iOS fisik atau simulator iOS untuk menjalankan aplikasi Anda.

    • Untuk Cloud Messaging, Anda memerlukan:

      • Perangkat iOS fisik
      • Kunci Autentikasi Apple Notifikasi Push untuk akun Developer Apple
      • Di Xcode, aktifkan Notifikasi Push di App > Capabilities.

    • Untuk semua produk Firebase lainnya, Anda dapat menggunakan perangkat iOS fisik atau simulator iOS.

  • Login ke Firebase menggunakan Akun Google Anda.

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

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 bagian Memahami Project Firebase untuk mempelajari lebih lanjut praktik terbaik dan pertimbangan dalam menambahkan aplikasi ke project Firebase, termasuk cara menangani beberapa variasi build.

  1. Di tengah halaman ringkasan project Firebase console, klik ikon iOS untuk meluncurkan alur kerja penyiapan.

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

  2. Masukkan ID paket aplikasi di kolom ID paket iOS.

    • Temukan ID paket ini dengan membuka aplikasi Anda di XCode, lalu akses tab General di direktori Runner level teratas. Nilai kolom ID Paket adalah ID paket iOS (misalnya com.yourcompany.yourproject).

  3. (Opsional) Masukkan informasi aplikasi lain seperti yang diminta oleh alur kerja penyiapan.

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

    • Anda dapat mendownload file konfigurasi iOS Firebase lagi kapan saja.

    • Pastikan file konfigurasi tidak ditambahkan dengan 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.

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.

Perlu diingat, jika Anda menggunakan salah satu contoh panduan memulai, project Xcode dan Podfile (dengan pod) sudah tersedia. Meskipun demikian, Anda tetap harus menambahkan file konfigurasi Firebase dan menginstal pod.

Anda dapat menambahkan produk Firebase yang didukung ke aplikasi iOS. Sebaiknya Anda mulai dengan Google Analytics untuk Firebase.

  1. Buat Podfile jika Anda belum memilikinya:

    cd your-project-directory
    pod init

  2. Tambahkan pod yang ingin digunakan dalam aplikasi Anda ke Podfile tersebut. Misalnya, untuk Analytics:

    pod 'Firebase/Analytics'

    Pod ini akan menambah library prasyarat yang diperlukan untuk mengaktifkan dan menjalankan Firebase dalam aplikasi iOS Anda, bersama dengan Google Analytics for Firebase.

  3. Instal pod, lalu buka file .xcworkspace Anda 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 melakukan ini saat menambahkan Firebase ke aplikasi Anda. Jika Anda menggunakan project contoh panduan memulai, hal ini telah dilakukan secara otomatis.

  1. Impor modul Firebase di UIApplicationDelegate Anda:

    Swift

    import Firebase

    Objective-C

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

    Swift

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

    Objective-C

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

Setelah menambahkan kode inisialisasi, jalankan aplikasi Anda untuk mengirimkan verifikasi ke Firebase console bahwa Anda telah berhasil menginstal Firebase.

Pod yang Tersedia

Pod berikut tersedia untuk berbagai produk Firebase.

Produk Pod
AdMob pod 'Firebase/AdMob'
Analisis pod 'Firebase/Analytics'
Autentikasi 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 'Fabric'
pod 'Crashlytics'
Dynamic Links pod 'Firebase/DynamicLinks'
In-App Messaging pod 'Firebase/InAppMessaging'
Tampilan In-App Messaging pod 'Firebase/InAppMessagingDisplay'
ML Kit: Vision API pod 'Firebase/MLVision'
ML Kit: Model Pelabelan Gambar pod 'Firebase/MLVisionLabelModel'
ML Kit: Model Pemindaian Kode Batang pod 'Firebase/MLVisionBarcodeModel'
ML Kit: Model Pengenalan Teks pod 'Firebase/MLVisionTextModel'
ML Kit: Model Deteksi Wajah pod 'Firebase/MLVisionFaceModel'
ML Kit: Model Deteksi dan Pelacakan Objek pod 'Firebase/MLVisionObjectDetection'
ML Kit: Natural Language API pod 'Firebase/MLNaturalLanguage'
ML Kit: Model Identifikasi Bahasa pod 'Firebase/MLNLLanguageID'
ML Kit: Model Terjemahan pod 'Firebase/MLNLTranslate'
ML Kit: Model Smart Reply pod 'Firebase/MLNLSmartReply'
ML Kit: API Model Kustom pod 'Firebase/MLModelInterpreter'
ML Kit: AutoML Vision Edge API pod 'Firebase/MLVisionAutoML'
Pemantauan Performa pod 'Firebase/Performance'
Realtime Database pod 'Firebase/Database'
Remote Config pod 'Firebase/RemoteConfig'

Mengintegrasi tanpa CocoaPods

Jika tidak ingin menggunakan CocoaPods, Anda tetap bisa memanfaatkan Firebase SDK dengan mengimpor framework secara langsung.

  1. Download framework SDK zip. File ini berukuran sekitar 1 GB dan perlu waktu agak lama untuk mendownloadnya.

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

  3. Tambahkan flag linker ObjC dalam Other Linker Settings ke setelan build target Anda.

Langkah berikutnya

Mempelajari Firebase:

Menambahkan fitur Firebase ke aplikasi: