Instal Firebase di aplikasi Apple Anda

Manajer Paket Swift

Dimulai dengan v8.0.0 dari Firebase Apple SDK, dukungan Pengelola Paket Swift Firebase tidak lagi dalam versi beta dan tersedia secara umum untuk digunakan. CocoaPods tidak diperlukan untuk pengguna Swift Package Manager.

Untuk Firebase versi 8 dan lebih tinggi, Swift Package Manager adalah metode penginstalan yang disarankan.

Melalui Xcode

Dukungan Swift Package Manager membutuhkan 13.3.1 atau lebih tinggi.

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

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

3. Di prompt yang muncul, pilih repositori Firebase GitHub:

   https://github.com/firebase/firebase-ios-sdk.git
   

4. Pilih versi Firebase yang ingin Anda gunakan. Untuk project baru, sebaiknya gunakan Firebase versi terbaru.

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

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

Melalui Package.swift

Untuk mengintegrasikan Firebase ke paket Swift melalui manifes Package.swift , Anda bisa menambahkan Firebase ke larik dependencies paket Anda. Untuk detail lebih lanjut, lihat dokumentasi Swift Package Manager .

dependencies: [

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

],

Kemudian di setiap target yang bergantung pada produk Firebase, tambahkan ke array dependencies dari target tersebut.

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

Pertimbangan khusus produk

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

Google Analytics

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

Crashlytics

Crashlytics mengharuskan Anda mengunggah simbol debug.

Anda dapat menggunakan fase pembuatan skrip proses untuk Xcode agar secara otomatis mengunggah simbol debug setelah pembuatan. Temukan skrip yang dijalankan di sini:

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

Opsi lain untuk mengunggah simbol adalah dengan menggunakan skrip upload-symbols . Tempatkan skrip di subdirektori file proyek Anda (misalnya scripts/upload-symbols ), lalu pastikan skrip dapat dieksekusi:

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 13.3.1 dan CocoaPods 1.10.0 atau lebih tinggi. Berikut cara menginstal Firebase menggunakan CocoaPods:

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

   pod init

2. Ke Podfile Anda, tambahkan pod Firebase yang ingin Anda gunakan di aplikasi Anda.

   Anda dapat menambahkan salah satu 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 tentang IDFA, pengidentifikasi iklan tingkat perangkat, dalam dokumentasi Transparansi Pelacakan Aplikasi dan Penggunaan Data dan Privasi Pengguna 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 Anda untuk melihat proyek di Xcode:

   pod install --repo-update

   open your-project.xcworkspace

Pertimbangan khusus produk

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

Crashlytics

Crashlytics mengharuskan Anda mengunggah simbol debug.

Anda dapat menggunakan fase pembuatan skrip proses untuk Xcode agar secara otomatis mengunggah simbol debug setelah pembuatan. Temukan skrip yang dijalankan di sini:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartago

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

Integrasikan secara manual

Firebase menyediakan distribusi XCFramework biner bawaan untuk pengguna yang ingin mengintegrasikan Firebase tanpa menggunakan pengelola ketergantungan. Untuk menginstal Firebase:

1. Unduh kerangka SDK zip . File ini berisi potongan arsitektur untuk semua arsitektur target yang tersedia untuk semua Firebase SDK dan karenanya mungkin perlu waktu untuk mengunduh.

2. Buka zip file, lalu tinjau README untuk kerangka kerja yang ingin disertakan dalam aplikasi Anda.

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