Repositori ini berisi kode sumber untuk semua Firebase SDK platform Apple kecuali FirebaseAnalytics.
Firebase adalah platform pengembangan aplikasi dengan alat untuk membantu Anda membangun, mengembangkan, dan memonetisasi aplikasi Anda. Informasi lebih lanjut tentang Firebase dapat ditemukan di situs resmi Firebase.
Lihat subbagian di bawah untuk rincian tentang berbagai metode instalasi. Jika tersedia, disarankan untuk menginstal perpustakaan apa pun dengan akhiran Swift untuk mendapatkan pengalaman terbaik saat menulis aplikasi Anda di Swift.
Pemasangan pod standar
Manajer Paket Swift
Menginstal dari repo GitHub
Kartago Eksperimental
Untuk petunjuk tentang pemasangan pod standar, kunjungi: https://firebase.google.com/docs/ios/setup.
Petunjuk untuk dukungan Swift Package Manager dapat ditemukan di file Markdown SwiftPackageManager.md.
Petunjuk ini dapat digunakan untuk mengakses repo Firebase di cabang, tag, atau penerapan lainnya.
Lihat Referensi Sintaks Podfile untuk instruksi dan opsi tentang penggantian lokasi sumber pod.
Semua rilis resmi ditandai dalam repo ini dan tersedia melalui CocoaPods. Untuk mengakses snapshot sumber lokal atau cabang yang belum dirilis, gunakan arahan Podfile seperti berikut:
Untuk mengakses FirebaseFirestore melalui cabang:
pod 'FirebaseCore', :git => 'https://github.com/firebase/firebase-ios-sdk.git', :branch => 'main'pod 'FirebaseFirestore', :git => 'https:// github.com/firebase/firebase-ios-sdk.git', :branch => 'utama'
Untuk mengakses FirebaseMessaging melalui versi repo firebase-ios-sdk yang telah diperiksa:
pod 'FirebaseCore', :path => '/path/ke/firebase-ios-sdk'pod 'FirebaseMessaging', :path => '/path/to/firebase-ios-sdk'
Petunjuk untuk distribusi eksperimental Carthage dapat ditemukan di Carthage.md.
Untuk detail tentang penggunaan Firebase dari Framework atau perpustakaan, lihat firebase_in_libraries.md.
Untuk mengembangkan perangkat lunak Firebase di repositori ini, pastikan Anda memiliki setidaknya perangkat lunak berikut:
Xcode 15.2 (atau lebih baru)
CocoaPods masih merupakan cara pengembangan yang kanonik, tetapi sebagian besar repo sekarang mendukung pengembangan dengan Swift Package Manager.
Instal yang berikut ini:
CocoaPods 1.12.0 (atau lebih baru)
CocoaPod menghasilkan
Untuk pod yang ingin Anda kembangkan:
pod gen Firebase{nama di sini}.podspec --local-sources=./ --auto-open --platforms=ios Catatan: Jika cache CocoaPods sudah kedaluwarsa, Anda mungkin perlu menjalankan pod repo update sebelum perintah pod gen .
Catatan: Setel opsi --platforms ke macos atau tvos untuk mengembangkan/menguji platform tersebut. Sejak 10.2, Xcode tidak menangani ruang kerja CocoaPods multi-platform dengan benar.
Firestore memiliki proyek Xcode mandiri. Lihat file Penurunan Harga Firestore/README.
pod gen {name here}.podspec --local-sources=./ --auto-open --platforms=ios
Centang kotak Mac di App-iOS Build Settings
Tanda tangani Aplikasi di tab Pengaturan Penandatanganan & Kemampuan
Klik Pod di Manajer Proyek
Tambahkan Penandatanganan ke aplikasi host iOS dan target pengujian unit
Pilih skema Unit-unit
Jalankan untuk membangun dan menguji
Alternatifnya, nonaktifkan proses masuk di setiap target:
Buka tab Pengaturan Bangun
Klik +
Pilih Add User-Defined Setting
Tambahkan setting CODE_SIGNING_REQUIRED dengan nilai NO
Untuk mengaktifkan skema pengujian: ./scripts/setup_spm_tests.sh
open Package.swift atau klik dua kali Package.swift di Finder.
Xcode akan membuka proyek
Pilih skema perpustakaan yang akan dibangun atau rangkaian pengujian yang akan dijalankan
Pilih platform target dengan memilih tujuan pengoperasian beserta skemanya
Lihat file Penurunan Harga AddNewPod untuk detailnya.
Untuk informasi tentang mengelola header dan impor, lihat File Markdown HeadersImports.
Untuk memastikan bahwa kode diformat secara konsisten, jalankan skrip ./scripts/check.sh sebelum membuat permintaan tarik (PR).
Tindakan GitHub akan memverifikasi bahwa setiap perubahan kode dilakukan dengan cara yang sesuai gaya. Instal clang-format dan mint :
pembuatan bir install clang-format@19brew install mint
Pilih skema dan tekan Command-u untuk membuat komponen dan menjalankan pengujian unitnya.
Untuk menjalankan contoh aplikasi dan pengujian integrasi, Anda memerlukan file GoogleService-Info.plist yang valid. Proyek Firebase Xcode berisi file plist tiruan tanpa nilai sebenarnya, namun dapat diganti dengan file plist asli. Untuk mendapatkan file GoogleService-Info.plist Anda sendiri:
Buka Konsol Firebase
Buat proyek Firebase baru, jika Anda belum memilikinya
Untuk setiap contoh aplikasi yang ingin Anda uji, buat aplikasi Firebase baru dengan ID paket aplikasi contoh tersebut (misalnya, com.google.Database-Example )
Unduh GoogleService-Info.plist yang dihasilkan dan tambahkan ke proyek Xcode.
Untuk instruksi pembuatan laporan cakupan, lihat file scripts/code_coverage_report/README Markdown.
Lihat bagian di bawah untuk instruksi khusus untuk komponen tersebut.
Untuk pengembangan Firebase Auth tertentu, lihat README Sampel Auth untuk mendapatkan petunjuk tentang cara membuat dan menjalankan pod FirebaseAuth beserta berbagai sampel dan pengujian.
Pengujian Integrasi Database Firebase dapat dijalankan terhadap Database Emulator yang berjalan secara lokal atau terhadap instance produksi.
Untuk menjalankan instance emulator lokal, aktifkan ./scripts/run_database_emulator.sh start sebelum menjalankan pengujian integrasi.
Untuk menjalankan instance produksi, berikan GoogleServices-Info.plist yang valid dan salin ke FirebaseDatabase/Tests/Resources/GoogleService-Info.plist . Aturan Keamanan Anda harus ditetapkan ke publik saat pengujian Anda berjalan.
Firebase Dynamic Links tidak digunakan lagi dan tidak boleh digunakan dalam project baru. Layanan akan ditutup pada 25 Agustus 2025.
Silakan lihat dokumentasi FAQ Penghentian Tautan Dinamis kami untuk panduan lebih lanjut.
Untuk pengembangan Firebase Performance Monitoring tertentu, lihat Performance README untuk petunjuk tentang cara membuat SDK dan Performance TestApp README untuk petunjuk tentang mengintegrasikan Performance dengan Aplikasi pengujian dev.
Untuk menjalankan pengujian Integrasi Penyimpanan, ikuti petunjuk di StorageIntegration.swift.
Pemberitahuan push hanya dapat dikirimkan ke ID Aplikasi yang disediakan secara khusus di portal pengembang. Untuk menguji penerimaan pemberitahuan push, Anda perlu:
Ubah pengidentifikasi bundel aplikasi sampel menjadi milik Anda di akun Pengembang Apple dan aktifkan ID Aplikasi tersebut untuk pemberitahuan push.
Anda juga harus mengunggah Kunci Autentikasi Penyedia APN atau sertifikat Anda ke Firebase Console di Project Settings > Cloud Messaging > [Your Firebase App] .
Pastikan perangkat iOS Anda ditambahkan ke portal Pengembang Apple sebagai perangkat uji.
Simulator iOS tidak dapat mendaftar untuk notifikasi jarak jauh dan tidak akan menerima notifikasi push. Untuk menerima pemberitahuan push, ikuti langkah-langkah di atas dan jalankan aplikasi di perangkat fisik.
Lihat README Vertex AI for Firebase untuk petunjuk tentang cara membuat dan menguji SDK.
Firebase menyediakan dukungan beta resmi untuk macOS, Catalyst, dan tvOS. visionOS dan watchOS didukung komunitas. Terima kasih atas kontribusi komunitas untuk banyak PR multi-platform.
Saat ini, sebagian besar produk Firebase tersedia di seluruh platform Apple. Masih terdapat sedikit kesenjangan, terutama pada visionOS dan watchOS. Untuk mengetahui detail tentang matriks dukungan saat ini, lihat diagram ini di dokumentasi Firebase.
Jika didukung, visionOS berfungsi seperti yang diharapkan dengan pengecualian Firestore melalui Swift Package Manager yang memerlukan distribusi sumber.
Untuk mengaktifkan distribusi sumber Firestore, keluar dari Xcode dan buka proyek yang diinginkan dari baris perintah dengan variabel lingkungan FIREBASE_SOURCE_FIRESTORE : open --env FIREBASE_SOURCE_FIRESTORE /path/to/project.xcodeproj . Untuk kembali menggunakan distribusi biner Firestore, keluar dari Xcode dan buka Xcode seperti biasa, tanpa variabel lingkungan.
Berkat kontribusi komunitas, banyak Firebase SDK yang kini dikompilasi, menjalankan pengujian unit, dan berfungsi di watchOS. Lihat Contoh Aplikasi Jam Tangan Independen.
Perlu diingat bahwa watchOS tidak didukung secara resmi oleh Firebase. Meskipun kami dapat mengetahui masalah pengujian unit dasar dengan GitHub Actions, mungkin ada beberapa perubahan yang membuat SDK tidak lagi berfungsi seperti yang diharapkan di watchOS. Jika Anda mengalami hal ini, harap ajukan masalah.
Selama penyiapan aplikasi di konsol, Anda mungkin sampai pada langkah yang menyebutkan sesuatu seperti "Memeriksa apakah aplikasi telah berkomunikasi dengan server kami". Ini bergantung pada Analytics dan tidak akan berfungsi di watchOS. Aman untuk mengabaikan pesan tersebut dan melanjutkan , SDK lainnya akan berfungsi seperti yang diharapkan.
watchOS memiliki dukungan terbatas. Karena pembatasan watchOS, pengecualian mach dan gangguan sinyal tidak dicatat. (Kerusakan di SwiftUI dihasilkan sebagai pengecualian mach, jadi tidak akan dicatat)
Berkat kontribusi dari komunitas, FirebaseCombineSwift berisi dukungan untuk kerangka Combine Apple. Modul ini sedang dalam pengembangan dan belum didukung untuk digunakan di lingkungan produksi. Untuk lebih jelasnya, silakan merujuk ke dokumen.
Lihat Roadmap untuk mengetahui lebih lanjut tentang rencana dan petunjuk Firebase Apple SDK Open Source.
Lihat Berkontribusi untuk informasi selengkapnya tentang berkontribusi pada Firebase Apple SDK.
Isi repositori ini dilisensikan di bawah Lisensi Apache, versi 2.0.
Penggunaan Anda atas Firebase diatur oleh Persyaratan Layanan untuk Layanan Firebase.
