Tambahkan Firebase ke proyek Apple Anda

Prasyarat

• Pasang yang berikut ini:

  • Xcode 13.3.1 atau lebih baru

• Pastikan proyek Anda memenuhi persyaratan berikut:

  • Proyek Anda harus menargetkan versi platform ini atau yang lebih baru:
    • iOS 11
    • macOS 10.13
    • tvOS 12
    • watchOS 6

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

  Apakah Anda ingin menggunakan Cloud Messaging?

  Untuk Cloud Messaging di platform Apple, berikut prasyaratnya:

  • Siapkan perangkat Apple fisik .
  • Dapatkan Kunci Autentikasi Notifikasi Push Apple untuk akun Pengembang Apple Anda.
  • Aktifkan Pemberitahuan Push di Xcode di bawah App > Capabilities .

• Masuk ke Firebase menggunakan akun Google Anda.

Jika Anda belum memiliki proyek Xcode dan hanya ingin mencoba produk Firebase, Anda dapat mendownload salah satu contoh quickstart kami.

Langkah 1 : Buat proyek Firebase

Sebelum dapat menambahkan Firebase ke aplikasi Apple, Anda perlu membuat proyek Firebase untuk terhubung ke aplikasi Anda. Kunjungi Memahami Proyek Firebase untuk mempelajari lebih lanjut tentang proyek Firebase.

Langkah 2 : Daftarkan aplikasi Anda dengan Firebase

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

1. Buka konsol Firebase .

2. Di tengah halaman ikhtisar proyek, klik ikon iOS+ untuk meluncurkan alur kerja penyiapan.

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

3. Masukkan ID bundel aplikasi Anda di bidang ID bundel .

   Apa itu bundel ID, dan di mana Anda menemukannya?

   • ID bundel secara unik mengidentifikasi aplikasi di ekosistem Apple.

   • Temukan ID bundel Anda: buka proyek Anda di Xcode, pilih aplikasi tingkat atas di navigator proyek, lalu pilih tab Umum .

     Nilai bidang Pengenal Bundel adalah ID bundel (misalnya, com.yourcompany.yourproject ).

   • Ketahuilah bahwa nilai ID bundel peka terhadap huruf besar-kecil, dan tidak dapat diubah untuk aplikasi Firebase ini setelah didaftarkan ke proyek Firebase Anda.

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

   Bagaimana nama panggilan Aplikasi dan ID App Store digunakan dalam Firebase?

   • Nama panggilan aplikasi : Pengidentifikasi kenyamanan internal yang hanya dapat dilihat oleh Anda di konsol Firebase

   • 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 platform Apple Firebase Anda ( GoogleService-Info.plist ).

   Apa yang perlu Anda ketahui tentang file konfigurasi ini?

   • File konfigurasi Firebase berisi pengidentifikasi unik namun tidak rahasia untuk proyek Anda. Untuk mempelajari lebih lanjut tentang file konfigurasi ini, kunjungi Memahami Proyek Firebase .

   • Anda dapat mengunduh kembali file konfigurasi Firebase Anda kapan saja.

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

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

Jika Anda memiliki beberapa ID paket dalam proyek, Anda harus mengaitkan setiap ID paket dengan aplikasi terdaftar di konsol Firebase 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 proyek aplikasi Anda terbuka, arahkan ke 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 pustaka Firebase yang ingin Anda gunakan.

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

Setelah selesai, Xcode akan secara otomatis mulai menyelesaikan dan mengunduh dependensi Anda di latar belakang.

Langkah 5 : Inisialisasi Firebase di aplikasi Anda

Langkah terakhir adalah menambahkan kode inisialisasi ke aplikasi Anda. Anda mungkin telah melakukannya sebagai bagian dari penambahan Firebase ke aplikasi Anda. Jika Anda menggunakan proyek contoh quickstart , ini telah dilakukan untuk Anda.

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

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Cepat

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

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

2. Konfigurasikan instance bersama FirebaseApp dalam metode application(_:didFinishLaunchingWithOptions:) delegasi aplikasi Anda:

   SwiftUI

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

   Cepat

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

   Objective-C

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

3. Jika Anda menggunakan SwiftUI, Anda harus membuat delegasi aplikasi dan melampirkannya ke struktur App Anda melalui UIApplicationDelegateAdaptor atau NSApplicationDelegateAdaptor . Anda juga harus menonaktifkan swizzling delegasi aplikasi. Untuk informasi selengkapnya, lihat petunjuk SwiftUI .

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Jika Anda telah menyertakan Firebase SDK untuk Google Analytics, Anda dapat menjalankan aplikasi Anda untuk mengirimkan verifikasi ke Firebase console bahwa Anda telah berhasil memasang Firebase.

Itu dia! Anda dapat melompat ke langkah berikutnya .

Namun, jika Anda kesulitan menyiapkan, kunjungi Pemecahan masalah & FAQ platform Apple .

Pustaka yang tersedia

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

• Dokumentasi referensi ( Swift | Obj-C )

• Repo GitHub SDK platform Apple Firebase

Integrasikan tanpa menggunakan Swift Package Manager

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

CocoaPods

Pelajari lebih lanjut tentang integrasi CocoaPods di panduan kami .

Kerangka kerja

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

1. Unduh kerangka SDK zip . Ini adalah file berukuran ~200MB dan mungkin perlu waktu untuk mengunduh.

2. Buka zip file, lalu tinjau README untuk kerangka kerja yang ingin disertakan dalam aplikasi Anda.

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

Langkah selanjutnya

Pelajari tentang Firebase:

• Kunjungi Memahami Proyek Firebase untuk mempelajari lebih lanjut tentang proyek Firebase dan praktik terbaik untuk proyek.

• Jelajahi contoh aplikasi Firebase .

• Dapatkan pengalaman langsung dengan Firebase iOS Codelab .

• Jelajahi kode sumber terbuka di GitHub .

• Bersiaplah untuk meluncurkan aplikasi Anda:

  • Siapkan peringatan anggaran untuk proyek Anda di Google Cloud Console.
  • Pantau dasbor Penggunaan dan penagihan di Firebase console untuk mendapatkan gambaran keseluruhan tentang penggunaan proyek Anda di beberapa layanan Firebase.
  • Tinjau daftar periksa peluncuran Firebase .

• Mengalami masalah dengan Firebase dan proyek Apple Anda? Kunjungi Pemecahan masalah & FAQ platform Apple .

Tambahkan layanan Firebase ke aplikasi Anda:

• Dapatkan wawasan tentang perilaku pengguna dengan Analytics .

• Siapkan autentikasi pengguna dengan Authentication .

• Menyimpan 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 yang aman dengan Cloud Functions .

• Kirim notifikasi dengan Cloud Messaging .

• Cari tahu kapan dan mengapa aplikasi Anda mogok dengan Crashlytics .