Menambahkan Firebase ke Project iOS Anda

Prasyarat

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

• Xcode 8.0 atau yang lebih baru
• Sebuah project Xcode dengan target iOS 8 atau yang lebih tinggi
• 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 panduan memulai, ingatlah untuk mendapatkan ID paket dari setelan project. Anda akan memerlukannya untuk berlanjut ke 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 proyek Firebase:

1. Buat project Firebase di Firebase console jika Anda belum memilikinya. Klik Tambahkan project. Jika Anda sudah memiliki project Google yang terkait dengan aplikasi seluler, pilih project tersebut dari menu drop down Nama project. Jika tidak, masukkan nama project untuk membuat project baru.
2. Opsional: Edit Project ID Anda. Project Anda akan otomatis diberikan ID unik, dan ID tersebut digunakan dalam fitur Firebase yang terlihat secara publik seperti URL database dan subdomain Firebase Hosting Anda. Anda dapat mengubahnya sekarang jika ingin menggunakan subdomain spesifik.
3. Ikuti langkah-langkah penyiapan yang tersisa, lalu klik Buat project (atau Tambahkan Firebase jika Anda menggunakan project yang ada) untuk mulai memberikan resource bagi project Anda. Prosesnya biasanya perlu waktu beberapa menit. Setelah selesai, Anda akan dibawa ke ringkasan project.

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

1. 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.
2. 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.
3. Selama proses ini, Anda akan mendownload file GoogleService-Info.plist. Anda dapat mendownload file ini lagi kapan saja.
4. 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/0}. 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.

1. Jika Anda belum memiliki project Xcode, buatlah sekarang.

2. Buat Podfile jika Anda belum memilikinya:

   $ cd your-project directory
   $ pod init
   

3. 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.

4. Instal pod dan buka file .xcworkspace untuk melihat project di Xcode.

   $ pod install
   $ open your-project.xcworkspace
   

5. Download file GoogleService-Info.plist dari Firebase console dan 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.

1. Impor modul Firebase di UIApplicationDelegate Anda:

   Swift

   import Firebase
   

   Objective-C

   @import Firebase;
   

2. Konfigurasi 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.

Mengintegrasi tanpa CocoaPods

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

1. Download framework SDK zip (file biasanya berukuran ~500MB dan mungkin perlu waktu untuk mendownloadnya).
2. Buka kompresi zip dan lihat file README untuk mengetahui Framework yang akan disertakan dalam project Anda.
3. Tambahkan tanda penaut ObjC di Other Linker Settings Anda 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 notification kepada pengguna dengan Cloud Messaging.
• Mengetahui waktu dan penyebab aplikasi Anda mengalami error dengan Crash Reporting.