Instal Firebase di aplikasi Apple Anda

Manajer Paket Swift

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

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

Melalui Xcode

Dukungan Swift Package Manager memerlukan 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 menavigasi ke File > Add Packages

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

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

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

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

Setelah Anda 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 dapat menambahkan Firebase ke larik dependencies paket Anda. Untuk detail selengkapnya, 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 larik dependencies dari target tersebut.

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

Pertimbangan khusus produk

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

Google Analytics

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

Crashlytics

Crashlytics mengharuskan Anda mengupload simbol debug.

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

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

Pilihan 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 mengunggah file dSYM secara manual. Untuk catatan penggunaan dan instruksi 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 memasang 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.

   Analisis 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, di dokumentasi Privasi Pengguna dan Penggunaan Data dan Transparansi Pelacakan Aplikasi 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 ekstra agar berfungsi dengan benar.

Crashlytics

Crashlytics mengharuskan Anda mengupload simbol debug.

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartago

Dukungan Carthage 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 dependensi. Untuk menginstal Firebase:

1. Unduh kerangka kerja SDK zip . File ini berisi irisan arsitektur untuk semua arsitektur target yang tersedia untuk semua SDK Firebase dan dengan demikian mungkin perlu waktu untuk mengunduh.

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

3. Tambahkan tanda -ObjC di Other Linker Settings di pengaturan pembuatan target Anda.