Menambahkan Firebase ke Project iOS

Prasyarat

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

• Xcode 10.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. Buka bagian Memahami Project Firebase untuk mempelajari project Firebase lebih lanjut.

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

4. Setelah Anda menambahkan kode inisialisasi, jalankan aplikasi untuk mengirimkan verifikasi ke Firebase console bahwa Anda telah berhasil menginstal Firebase.

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.

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.

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/Analytics'
   
   

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

1. Impor modul Firebase di UIApplicationDelegate Anda:

   Swift

   import Firebase
   

   Objective-C

   @import Firebase;
   

2. 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];

Pod yang Tersedia

Pod berikut ini tersedia untuk fitur Firebase yang berbeda.

Mengintegrasikan tanpa CocoaPods

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

1. Download framework SDK zip (file ini berukuran sekitar 1 GB, mungkin perlu waktu agak lama untuk mendownloadnya).
2. Buka kompresi zip dan lihat file README untuk mengetahui Framework yang akan disertakan dalam project Anda.
3. Tambahkan tanda linker ObjC dalam Other Linker Settings ke 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.

• Bersiap 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.