Menambahkan Firebase ke Project iOS Anda

Prasyarat

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

  • Xcode
    • 7.0 atau yang lebih baru untuk Objective-C
    • 8.0 atau yang lebih baru untuk Swift
  • Sebuah project Xcode dengan target iOS 7 atau di atasnya
  • Project Swift harus menggunakan Swift 3.0 atau yang lebih baru
  • Pengenal paket dari aplikasi Anda
  • CocoaPods 1.0.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 panduan mulai cepat jika Anda hanya ingin mencoba fitur Firebase. Jika Anda menggunakan panduan mulai cepat, ingatlah untuk mendapatkan pengenal paket dari setelan project yang diperlukan untuk langkah selanjutnya.

Menambahkan Firebase ke aplikasi Anda

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

  1. Buat project Firebase di Firebase console jika Anda belum memilikinya. Jika Anda sudah memiliki project Google yang terkait dengan aplikasi seluler, klik Impor Project Google. Jika belum, klik Buat Project Baru.
  2. 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.
  3. 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.
  4. Terakhir, download file GoogleService-Info.plist. Anda bisa mendownload file ini lagi kapan saja.
  5. Jika Anda belum melakukannya, salin ini ke dalam root project Xcode.

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 pustaka. Anda bisa menginstal Cocoapods dengan mengikuti petunjuk instalasi. Jika tidak ingin menggunakan CocoaPods, Anda bisa mengintegrasikan framework SDK secara langsung dengan mengikuti petunjuk di bawah ini.

Jika Anda berencana untuk mendownload dan menjalankan salah satu contoh panduan mulai cepat, project Xcode dan Podfile sudah tersedia. Akan tetapi, Anda perlu menginstal pod dan mendownload file GoogleService-Info.plist. Jika ingin mengintegrasikan pustaka Firebase ke dalam salah satu project, Anda perlu menambahkan pod untuk pustaka 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 pustaka 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 subkelas UIApplicationDelegate Anda:

    Swift

    import Firebase
    

    Objective-C

    @import Firebase;
    
  2. Konfigurasikan instance bersama FirebaseApp, biasanya 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 'Firebase/Crash' Crash Reporting
pod 'Firebase/RemoteConfig' Remote Config
pod 'Firebase/Auth' Authentication
pod 'Firebase/Storage' Storage
pod 'Firebase/Performance' Performance Monitoring

Mengintegrasi tanpa CocoaPods

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

  1. Download framework SDK zip (file biasanya berukuran ~100MB 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 penghubung ObjC pada Other Linker Settings dalam setelan build target Anda.

Langkah berikutnya

Mempelajari Firebase:

Menambahkan fitur Firebase ke aplikasi Anda:

Kirim masukan tentang...

Butuh bantuan? Kunjungi halaman dukungan kami.