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.

Membuat project Firebase

Di Firebase console, klik Tambahkan project, lalu pilih atau masukkan Nama project.

Jika sudah memiliki project Google Cloud Platform (GCP), Anda dapat memilih project tersebut dari menu drop-down Nama project. Jika tidak, masukkan Nama project baru.
(Opsional) Edit Project ID.

Firebase menetapkan ID unik ke project Firebase Anda secara otomatis. Buka bagian Memahami Project Firebase untuk mempelajari cara Firebase menggunakan project ID.

Setelah Firebase menyediakan resource untuk project Firebase Anda, Anda tidak dapat mengubah project ID.
Untuk menggunakan ID khusus, Anda harus mengedit project ID selama langkah penyiapan ini.
Ikuti langkah-langkah penyiapan selanjutnya di Firebase console, lalu klik Buat project (atau Tambahkan Firebase, jika Anda menggunakan project Google yang sudah ada).

Firebase menyediakan resource untuk project Firebase Anda secara otomatis. Setelah selesai, Anda akan dibawa ke halaman ringkasan untuk project Firebase Anda di Firebase console.

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.

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.
Masukkan ID paket aplikasi di kolom ID paket iOS.

Pastikan Anda memasukkan ID yang benar-benar digunakan aplikasi Anda. Nilai ini tidak dapat ditambah atau diubah setelah Anda mendaftarkan aplikasi dengan project Firebase.
- 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).
(Opsional) Masukkan informasi aplikasi lain seperti yang diminta oleh alur kerja penyiapan.
- Nama panggilan aplikasi: ID internal praktis yang hanya dapat dilihat oleh Anda di Firebase console.
- ID App Store: Digunakan oleh Firebase Dynamic Links dan Google Analytics for Firebase, masing-masing untuk mengarahkan pengguna ke halaman App Store Anda dan 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 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).
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.

Buat Podfile jika Anda belum memilikinya:
```
cd your-project-directory
```
```
pod init
```
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.
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.

Impor modul Firebase di UIApplicationDelegate Anda:
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```
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.

Download framework SDK zip. File ini berukuran sekitar 1 GB dan perlu waktu agak lama untuk mendownloadnya.
Ekstrak file tersebut, lalu pelajari README untuk Framework yang ingin Anda sertakan dalam aplikasi.
Tambahkan flag linker ObjC dalam Other Linker Settings ke setelan build target Anda.

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.
Bersiaplah untuk meluncurkan aplikasi Anda:
- Tetapkan pemberitahuan penagihan.
- Periksa checklist peluncuran Firebase.

Menambahkan fitur Firebase ke aplikasi:

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.