Menambahkan Firebase ke Project iOS Anda

Prasyarat

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

  • Xcode 9.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 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:

  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. Project Anda akan diberi ID unik secara otomatis dan ID tersebut digunakan dalam fitur Firebase yang terlihat secara publik, seperti URL database dan subdomain Firebase Hosting. 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.

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.

  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:

Menambahkan fitur Firebase ke aplikasi Anda:

Kirim masukan tentang...

Butuh bantuan? Kunjungi halaman dukungan kami.