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.

  Apakah Anda ingin menggunakan Cloud Messaging?

  Untuk Cloud Messaging di iOS, berikut prasyaratnya:

  • Siapkan perangkat iOS 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 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 (plat_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.

   Apa itu ID paket, dan di mana lokasinya?

   • ID paket secara unik mengidentifikasi aplikasi dalam ekosistem Apple.

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

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

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

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

   Bagaimana Nama panggilan aplikasi dan ID App Store digunakan dalam Firebase?

   • Nama panggilan aplikasi: ID internal praktis yang hanya terlihat oleh Anda di Firebase console.

   • ID App Store: 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 ID App Store, Anda dapat menambahkan ID tersebut nanti di Setelan project.

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

   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 lagi file konfigurasi Firebase 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

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 iOS Firebase ini lebih lanjut:

• Dokumentasi referensi (Swift | Obj-C)

• Repositori GitHub Firebase iOS SDK

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:

• 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 iOS Anda? Buka FAQ & pemecahan masalah iOS.

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.