Menginstal Firebase di aplikasi Apple

Swift Package Manager

Firebase merekomendasikan Swift Package Manager untuk project baru.

Melalui Xcode

Dukungan Swift Package Manager memerlukan versi 14.1 atau yang lebih tinggi.

  1. Jika bermigrasi dari project berbasis CocoaPods, jalankan pod deintegrate untuk menghapus CocoaPods dari project Xcode Anda. File .xcworkspace yang dihasilkan CocoaPods dapat dihapus dengan aman setelahnya. Jika menambahkan Firebase ke project untuk pertama kalinya, Anda dapat mengabaikan langkah ini.

  2. Di Xcode, instal library Firebase dengan membuka File > Add Packages

  3. Pada perintah yang muncul, pilih repositori GitHub Firebase:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. Pilih versi Firebase yang ingin Anda gunakan. Untuk project baru, sebaiknya gunakan versi terbaru Firebase.

  5. Pilih library Firebase yang ingin Anda sertakan dalam aplikasi.

Setelah selesai, Xcode akan mulai menyelesaikan dependensi paket Anda dan mendownloadnya di latar belakang.

Melalui Package.swift

Untuk mengintegrasikan Firebase ke paket Swift melalui manifes Package.swift, Anda dapat menambahkan Firebase ke array dependencies pada paket Anda. Untuk mengetahui detail selengkapnya, lihat dokumentasi Swift Package Manager.

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Selanjutnya, pada setiap target yang bergantung pada produk Firebase, tambahkan ke dependencies array pada target tersebut.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Pertimbangan khusus produk

Beberapa produk Firebase memerlukan langkah integrasi tambahan agar dapat berfungsi dengan benar.

Google Analytics

Google Analytics memerlukan penambahan flag linker -ObjC ke setelan build target jika disertakan secara transitif.

Crashlytics

Crashlytics mengharuskan Anda mengupload simbol debug.

Anda dapat menggunakan fase build skrip jalankan agar Xcode mengupload simbol debug secara otomatis setelah proses build. Temukan skrip jalankan di sini:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

Opsi lain untuk mengupload simbol adalah menggunakan skrip upload-symbols. Tempatkan skrip di subdirektori file project Anda (misalnya scripts/upload-symbols), lalu pastikan skrip tersebut dapat dijalankan:

chmod +x scripts/upload-symbols

Skrip ini dapat digunakan untuk mengupload file dSYM secara manual. Untuk catatan penggunaan dan petunjuk tambahan untuk skrip, jalankan upload-symbols tanpa parameter apa pun.

CocoaPods

Firebase mendukung penginstalan dengan CocoaPods selain Swift Package Manager.

Distribusi CocoaPods Firebase memerlukan Xcode 14.1 dan CocoaPods 1.10.0 atau versi yang lebih tinggi. Berikut cara menginstal Firebase menggunakan CocoaPods:

  1. Buat Podfile jika belum memilikinya. Dari root direktori project Anda, jalankan perintah berikut:

    pod init
  2. Tambahkan pod Firebase yang ingin digunakan dalam aplikasi Anda ke Podfile tersebut.

    Anda dapat menambahkan produk Firebase yang didukung ke aplikasi Anda.

    Analytics diaktifkan

    # Add the Firebase pod for Google Analytics
    pod 'FirebaseAnalytics'
    
    # For Analytics without IDFA collection capability, use this pod instead
    # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
    
    # Add the pods for any other Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'FirebaseAuth'
    pod 'FirebaseFirestore'

    Pelajari lebih lanjut IDFA, ID iklan tingkat perangkat, dalam dokumentasi Privasi Pengguna dan Penggunaan Data dan App Tracking Transparency Apple.

    Analytics tidak diaktifkan

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'FirebaseAuth'
    pod 'FirebaseFirestore'
  3. Instal pod, lalu buka file .xcworkspace untuk melihat project di Xcode:

    pod install --repo-update
    open your-project.xcworkspace

Pertimbangan khusus produk

Beberapa produk Firebase memerlukan langkah integrasi tambahan agar dapat berfungsi dengan benar.

Crashlytics

Crashlytics mengharuskan Anda mengupload simbol debug.

Anda dapat menggunakan fase build skrip jalankan agar Xcode mengupload simbol debug secara otomatis setelah proses build. Temukan skrip jalankan di sini:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

Dukungan Carthage bersifat eksperimental. Baca petunjuk di GitHub untuk menyertakan Firebase di aplikasi Anda melalui Carthage.

Mengintegrasi secara manual

Firebase menyediakan distribusi XCFramework biner yang telah di-build sebelumnya untuk pengguna yang ingin mengintegrasikan Firebase tanpa menggunakan pengelola dependensi. Untuk menginstal Firebase:

  1. Download framework SDK zip. File ini berisi potongan arsitektur untuk semua arsitektur target yang tersedia untuk semua Firebase SDK, sehingga mungkin perlu waktu untuk didownload.

  2. Ekstrak file tersebut, lalu pelajari README untuk framework yang ingin Anda sertakan dalam aplikasi.

  3. Tambahkan flag linker -ObjC di Other Linker Settings pada setelan build target Anda.