Prasyarat
Instal yang berikut:
- Xcode 12.0 atau yang lebih baru
- CocoaPods 1.9.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.
- 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.
Buka Firebase console.
Di bagian tengah halaman ringkasan project, klik ikon iOS (
) untuk meluncurkan alur kerja penyiapan.Jika Anda sudah menambahkan aplikasi ke project Firebase, klik Tambahkan aplikasi untuk menampilkan opsi platform.
Masukkan ID paket aplikasi Anda di kolom ID paket iOS.
(Opsional) Masukkan informasi aplikasi lainnya: Nama panggilan aplikasi dan ID App Store.
Klik Daftarkan aplikasi.
Langkah 3: Tambahkan file konfigurasi Firebase
Klik Download GoogleService-Info.plist untuk mendapatkan file konfigurasi iOS Firebase Anda (
GoogleService-Info.plist
).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 dapat mengintegrasikan framework SDK secara langsung atau menggunakan Swift Package Manager (beta).
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.
Buat Podfile jika Anda belum memilikinya:
cd your-project-directory
pod init
Tambahkan pod 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'
# 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'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'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.
- Impor modul Firebase di
UIApplicationDelegate
Anda:Swift
import Firebase
Objective-C
@import Firebase;
- Konfigurasikan instance bersama
FirebaseApp
, biasanya ada dalam metodeapplication:didFinishLaunchingWithOptions:
aplikasi Anda:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- 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.
Pod yang Tersedia
Bagian ini mencantumkan produk Firebase yang didukung untuk iOS dan podnya. Pelajari library Firebase iOS ini lebih lanjut:
Repositori GitHub Firebase iOS SDK
Layanan atau Produk | Pod | Tambahkan Analytics? |
---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
|
Analytics | pod 'Firebase/Analytics' |
|
App Distribution | pod 'Firebase/AppDistribution' |
|
Authentication | pod 'Firebase/Auth' |
|
Cloud Firestore | pod 'Firebase/Firestore' |
|
Cloud Functions for Firebase Client SDK | pod 'Firebase/Functions' |
|
Cloud Messaging | pod 'Firebase/Messaging' |
|
Cloud Storage | pod 'Firebase/Storage' |
|
Firebase Crashlytics | pod 'Firebase/Crashlytics' |
|
Dynamic Links | pod 'Firebase/DynamicLinks' |
|
In-App Messaging | pod 'Firebase/InAppMessaging' |
(wajib ada) |
Firebase ML Vision API | pod 'Firebase/MLVision' |
|
Firebase ML Custom Model API | pod 'Firebase/MLModelInterpreter' |
|
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 .
Download framework SDK zip. File ini berukuran ~200 MB dan mungkin perlu waktu agak lama untuk didownload.
Ekstrak file tersebut, lalu pelajari
README
untuk Framework yang ingin Anda sertakan dalam aplikasi.Tambahkan flag linker
ObjC
diOther Linker Settings
pada setelan build target Anda.
Swift Package Manager
Dukungan Swift Package Manager saat ini masih berada dalam versi beta. Pelajari dokumentasi tentang GitHub, dan ajukan masukan ke pelacak masalah GitHub.
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 Penggunaan dan penagihan di Firebase console.
- Periksa checklist peluncuran Firebase.
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.