Menambahkan Firebase ke Project iOS Anda

Prasyarat

Sebelum memulai, ada beberapa hal yang perlu disiapkan di lingkungan Anda:

Xcode 9.4.1 atau yang lebih baru
Sebuah project Xcode dengan target iOS 8 atau yang lebih baru
Project Swift harus menggunakan Swift 3.0 atau yang lebih baru
ID paket dari aplikasi Anda
CocoaPods 1.4.0 atau yang lebih baru
Untuk Cloud Messaging:
- Perangkat iOS fisik
- Kunci Autentikasi Apple Push Notification untuk akun Developer Apple
- Di Xcode, aktifkan Push Notifications di App > Capabilities

Jika belum memiliki project Xcode, download salah satu sampel quickstart jika Anda hanya ingin mencoba sebuah fitur Firebase. Jika Anda menggunakan quickstart, ingatlah untuk mendapatkan ID paket dari setelan project. Anda akan memerlukannya untuk langkah selanjutnya.

Menambahkan Firebase ke aplikasi

Waktunya menambahkan Firebase ke aplikasi Anda. Untuk melakukannya, Anda memerlukan project Firebase dan file konfigurasi Firebase untuk aplikasi Anda.

Untuk membuat project Firebase:

Buka Firebase console.
Klik Tambahkan project, lalu pilih atau masukkan Nama project.
- Jika Anda memiliki project Google yang terkait dengan aplikasi Anda, pilih project tersebut dari menu dropdown Nama project.
- Jika Anda belum memiliki project Google, masukkan Nama project baru.
(Opsional) Edit Project ID.

Firebase menetapkan ID unik ke project Firebase Anda secara otomatis. ID ini ditampilkan di layanan Firebase yang tersedia untuk publik, misalnya:
- URL Realtime Database default — your-project-id.firebaseio.com
- Nama bucket Cloud Storage default — your-project-id.appspot.com
- Subdomain Hosting default — your-project-id.firebaseapp.com
Setelah Firebase menyediakan resource untuk project Firebase Anda, Anda tidak dapat mengubah project ID.
Jadi, jika ingin menggunakan ID khusus dengan layanan Firebase, Anda harus menggunakan ID tersebut untuk project ID dalam langkah penyiapan ini.
Ikuti langkah-langkah penyiapan yang tersisa 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. Proses ini biasanya perlu waktu beberapa menit. Setelah selesai, Anda akan dibawa ke halaman ringkasan untuk project Firebase Anda di Firebase console.

Setelah memiliki project, Anda dapat menambahkan aplikasi iOS ke dalamnya:

Klik Tambahkan Firebase ke aplikasi iOS dan ikuti langkah penyiapannya. Jika Anda mengimpor project Google yang sudah ada, prosesnya dapat terjadi secara otomatis dan Anda dapat langsung mendownload file konfigurasi.
Saat diminta, masukkan ID paket aplikasi Anda. Anda harus memasukkan ID paket yang digunakan aplikasi. Hal ini hanya dapat dilakukan saat Anda menambahkan aplikasi tersebut ke project Firebase.
Tambahkan file konfigurasi iOS Firebase ke aplikasi Anda:
1. 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.
2. Pindahkan file konfigurasi ke root project Xcode Anda. Jika diminta, pilih untuk menambahkan file konfigurasi ke semua target.
Catatan: File konfigurasi Firebase mengaitkan aplikasi Anda dengan project Firebase Anda beserta resource-nya.
Isi file dianggap publik, termasuk ID khusus platform Anda (dimasukkan dalam wizard penyiapan Firebase console) dan nilai yang khusus untuk project Firebase Anda, seperti URL Realtime Database dan nama bucket Storage. Oleh karena itu, gunakan aturan keamanan untuk melindungi data Anda di Realtime Database, Cloud Firestore, dan Storage.

Untuk project open source, secara umum kami tidak merekomendasikan penyertaan file konfigurasi dalam kontrol sumber karena, dalam sebagian besar kasus, pengguna harus membuat project Firebase-nya sendiri dan mengarahkan aplikasinya ke backend-nya sendiri.
Setelah Anda menambahkan kode inisialisasi, jalankan aplikasi untuk mengirimkan verifikasi ke Firebase console bahwa Anda telah berhasil menginstal Firebase.

Menambahkan SDK

Jika Anda menyiapkan project baru, Anda harus menginstal SDK. Anda mungkin sudah melakukannya sebagai bagian dari pembuatan project Firebase.

Sebaiknya, gunakan CocoaPods untuk menginstal library. Anda bisa menginstal Cocoapods dengan mengikuti petunjuk penginstalan. Jika tidak ingin menggunakan CocoaPods, Anda bisa mengintegrasikan framework SDK secara langsung tanpa menggunakan CocoaPods.

Jika Anda berencana untuk mendownload dan menjalankan salah satu sampel quickstart, project Xcode dan Podfile sudah tersedia, tetapi Anda perlu menginstal pod dan mendownload file GoogleService-Info.plist. Jika ingin mengintegrasikan library Firebase ke dalam salah satu project, Anda perlu menambahkan pod untuk library yang ingin digunakan.

Jika Anda belum memiliki project Xcode, buatlah sekarang.
Buat Podfile jika Anda belum memilikinya:
```
$ cd your-project directory
$ pod init
```
Tambahkan pod yang ingin Anda instal. Anda bisa menyertakan Pod di Podfile seperti ini:
```
pod 'Firebase/Core'
```
Ini akan menambah library prasyarat yang diperlukan untuk mengaktifkan dan menjalankan Firebase dalam aplikasi iOS Anda, bersama dengan Google Analytics for Firebase. Daftar pod dan subspec yang saat ini tersedia bisa dilihat di bawah. Ini juga dihubungkan dalam panduan penyiapan fitur tertentu.
Instal pod dan buka file .xcworkspace untuk melihat project di Xcode.
```
$ pod install
$ open your-project.xcworkspace
```
Download file GoogleService-Info.plist dari Firebase console, lalu sertakan file tersebut ke dalam aplikasi.

Menginisialisasi 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 panduan mulai cepat, hal ini telah dilakukan untuk Anda.

Impor modul Firebase di UIApplicationDelegate Anda:
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```
Konfigurasikan instance bersama FirebaseApp, yang 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];
```

Pod yang Tersedia

Pod berikut ini tersedia untuk fitur Firebase yang berbeda.

Pod	Layanan
pod 'Firebase/Core'	Pustaka prasyarat dan Analytics
pod 'Firebase/AdMob'	AdMob
pod 'Firebase/Messaging'	Cloud Messaging
pod 'Firebase/Database'	Realtime Database
pod 'Firebase/Invites'	Invites
pod 'Firebase/DynamicLinks'	Dynamic Links
pod 'Fabric' pod 'Crashlytics'	Crashlytics
pod 'Firebase/RemoteConfig'	Remote Config
pod 'Firebase/Auth'	Authentication
pod 'Firebase/Storage'	Storage
pod 'Firebase/Performance'	Pemantauan Performa
pod 'Firebase/Firestore'	Cloud Firestore
pod 'Firebase/Functions'	SDK Klien Cloud Functions for Firebase
pod 'Firebase/MLVision'	ML Kit Vision API
pod 'Firebase/MLVisionLabelModel'	ML Kit (deteksi label di perangkat)
pod 'Firebase/MLVisionBarcodeModel'	ML Kit (Pemindaian barcode di perangkat)
pod 'Firebase/MLVisionTextModel'	ML Kit (Pengenalan teks di perangkat)
pod 'Firebase/MLVisionFaceModel'	ML Kit (Deteksi wajah di perangkat)

Mengintegrasi tanpa CocoaPods

Jika tidak ingin menggunakan CocoaPods, Anda tetap bisa memanfaatkan Firebase SDK dengan mengimpor framework secara langsung.

Download framework SDK zip (file biasanya berukuran ~500MB dan mungkin perlu waktu untuk mendownloadnya).
Buka kompresi zip dan lihat file README untuk mengetahui Framework yang akan disertakan dalam project Anda.
Tambahkan tanda penaut ObjC di Other Linker Settings dalam setelan build target Anda.

Langkah berikutnya

Mempelajari Firebase:

Pelajari aplikasi Firebase contoh.
Dapatkan pengalaman langsung dengan Firebase iOS Codelab.
Pelajari kode open source di GitHub.

Menambahkan fitur Firebase ke aplikasi Anda:

Mendapatkan analisis tentang perilaku pengguna dengan Analytics.
Menyiapkan autentikasi pengguna dengan Authentication.
Menyimpan informasi pengguna dengan Realtime Database atau data blob dengan Cloud Storage.
Mengirim notifikasi kepada pengguna dengan Cloud Messaging.
Mengetahui kapan dan mengapa aplikasi Anda mengalami error dengan Crashlytics.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Terakhir diperbarui Maret 22, 2019.