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.
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.Di Xcode, instal pustaka Firebase dengan membuka File > Add Packages
Di prompt yang muncul, pilih repositori Firebase GitHub:
https://github.com/firebase/firebase-ios-sdk.git
Pilih versi Firebase yang ingin Anda gunakan. Untuk project baru, sebaiknya gunakan Firebase versi terbaru.
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:
Buat Podfile jika Anda belum memilikinya. Dari root direktori proyek Anda, jalankan perintah berikut:
pod init
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'
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:
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.
Buka zip file, lalu tinjau
README
untuk kerangka kerja yang ingin disertakan dalam aplikasi Anda.Tambahkan flag linker
-ObjC
diOther Linker Settings
Anda di pengaturan build target Anda.