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
- Proyek Anda harus menargetkan versi platform ini atau yang lebih baru:
Siapkan perangkat Apple fisik atau gunakan simulator untuk menjalankan aplikasi Anda.
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.
Buka konsol Firebase .
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.
Masukkan ID bundel aplikasi Anda di bidang ID bundel .
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.
(Opsional) Masukkan informasi aplikasi lainnya: Nama panggilan aplikasi dan ID App Store .
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 .
Klik Daftarkan aplikasi .
Langkah 3 : Tambahkan file konfigurasi Firebase
Klik Download GoogleService-Info.plist untuk mendapatkan file konfigurasi platform Apple Firebase Anda (
GoogleService-Info.plist
).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)
.
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.
- Di Xcode, dengan proyek aplikasi Anda terbuka, arahkan ke File > Add Packages .
- Saat diminta, tambahkan repositori SDK platform Apple Firebase:
- Pilih versi SDK yang ingin Anda gunakan.
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, tambahkanFirebaseAnalyticsWithoutAdId
sebagai gantinya.
https://github.com/firebase/firebase-ios-sdk
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.
- Impor modul
FirebaseCore
diUIApplicationDelegate
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; // ...
- Konfigurasikan instance bersama
FirebaseApp
dalam metodeapplication(_: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];
- Jika Anda menggunakan SwiftUI, Anda harus membuat delegasi aplikasi dan melampirkannya ke struktur
App
Anda melaluiUIApplicationDelegateAdaptor
atauNSApplicationDelegateAdaptor
. 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() } } } }
- 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:
Repo GitHub SDK platform Apple Firebase
Layanan atau Produk | Pod | Perpustakaan SwiftPM | Tambahkan Analitik? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | T/A | |
Analitik | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
Pemeriksaan Aplikasi | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
Distribusi Aplikasi | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
Autentikasi | pod 'FirebaseAuth' | FirebaseAuth | |
Toko Api Awan | pod 'FirebaseFirestore' | FirebaseFirestore | |
Cloud Functions untuk SDK Klien Firebase | pod 'FirebaseFunctions' | FirebaseFunctions | |
Pesan Awan | pod 'FirebaseMessaging' | FirebaseMessaging | |
Penyimpanan awan | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
Tautan Dinamis | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
Perpesanan Dalam Aplikasi | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (yg dibutuhkan) |
Instalasi Firebase | pod 'FirebaseInstallations' | FirebaseInstallations | |
API Model Khusus Firebase ML | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
Pemantauan Kinerja | pod 'FirebasePerformance' | FirebasePerformance | |
Basis Data Waktu Nyata | pod 'FirebaseDatabase' | FirebaseDatabase | |
Konfigurasi Jarak Jauh | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
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 .
Unduh kerangka SDK zip . Ini adalah file berukuran ~200MB dan mungkin perlu waktu untuk mengunduh.
Buka zip file, lalu tinjau
README
untuk kerangka kerja yang ingin disertakan dalam aplikasi Anda.Tambahkan flag linker
-ObjC
diOther 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 .