Sebelum kamu memulai
Jika Anda belum melakukannya, tambahkan Firebase ke proyek Apple Anda .
Langkah 1 : Tambahkan Performance Monitoring ke aplikasi Anda
Setelah Anda menambahkan Performance Monitoring SDK, Firebase otomatis mulai mengumpulkan data untuk perenderan layar aplikasi Anda, data yang terkait dengan siklus hidup aplikasi Anda (seperti waktu mulai aplikasi ), dan data untuk permintaan jaringan HTTP/S .
Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase.
- Di Xcode, dengan proyek aplikasi Anda terbuka, arahkan ke File > Add Packages .
- Saat diminta, tambahkan repositori SDK platform Apple Firebase:
- Pilih pustaka Pemantauan Kinerja.
- Setelah selesai, Xcode akan secara otomatis mulai menyelesaikan dan mengunduh dependensi Anda di latar belakang.
https://github.com/firebase/firebase-ios-sdk
Selanjutnya, konfigurasikan modul Firebase:
- Impor modul
FirebaseCore
diUIApplicationDelegate
Anda, serta modul Firebase lainnya yang digunakan oleh delegasi aplikasi Anda. Misalnya, untuk menggunakan Cloud Firestore dan Authentication:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Cepat
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Konfigurasikan instance bersama
FirebaseApp
dalam metodeapplication(_:didFinishLaunchingWithOptions:)
delegasi aplikasi Anda:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Cepat
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- Jika Anda menggunakan SwiftUI, Anda harus membuat delegasi aplikasi dan melampirkannya ke struktur
App
Anda melaluiUIApplicationDelegateAdaptor
atauNSApplicationDelegateAdaptor
. Anda juga harus menonaktifkan swizzling delegasi aplikasi. Untuk informasi selengkapnya, lihat petunjuk SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
Kompilasi ulang aplikasi Anda.
Langkah 2 : Hasilkan peristiwa kinerja untuk tampilan data awal
Firebase mulai memproses peristiwa saat Anda berhasil menambahkan SDK ke aplikasi Anda. Jika Anda masih mengembangkan secara lokal, berinteraksilah dengan aplikasi Anda untuk menghasilkan peristiwa untuk pengumpulan dan pemrosesan data awal.
Terus kembangkan aplikasi Anda menggunakan simulator atau perangkat uji.
Hasilkan peristiwa dengan mengalihkan aplikasi Anda antara latar belakang dan latar depan beberapa kali, berinteraksi dengan aplikasi Anda dengan menavigasi melintasi layar, dan/atau memicu permintaan jaringan.
Buka dasbor Performa konsol Firebase. Anda akan melihat tampilan data awal Anda dalam beberapa menit.
Jika Anda tidak melihat tampilan data awal Anda, tinjau tips pemecahan masalah .
Langkah 3 : (Opsional) Lihat pesan log untuk peristiwa kinerja
Aktifkan logging debug, sebagai berikut:
- Di Xcode (minimum v13.3.1), pilih Product > Scheme > Edit schema .
- Pilih Jalankan dari menu sebelah kiri, lalu pilih tab Argumen .
- Di bagian Arguments Passed on Launch , tambahkan
-FIRDebugEnabled
.
Periksa pesan log Anda untuk setiap pesan kesalahan.
Performance Monitoring menandai pesan lognya dengan
Firebase/Performance
sehingga Anda dapat memfilter pesan log Anda.Periksa jenis log berikut yang menunjukkan bahwa Performance Monitoring mencatat peristiwa kinerja:
-
Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
-
Logging network request trace: URL
-
Klik URL untuk melihat data Anda di konsol Firebase. Mungkin perlu beberapa saat untuk memperbarui data di dasbor.
Jika aplikasi Anda tidak mencatat peristiwa kinerja, tinjau tips pemecahan masalah .
Langkah 4 : (Opsional) Tambahkan pemantauan khusus untuk kode tertentu
Untuk memantau data kinerja yang terkait dengan kode tertentu di aplikasi, Anda dapat melengkapi pelacakan kode khusus .
Dengan pelacakan kode khusus, Anda dapat mengukur berapa lama waktu yang dibutuhkan aplikasi untuk menyelesaikan tugas atau kumpulan tugas tertentu, seperti memuat kumpulan gambar atau membuat kueri database Anda. Metrik default untuk pelacakan kode khusus adalah durasinya, tetapi Anda juga dapat menambahkan metrik khusus, seperti cache hits dan peringatan memori.
Dalam kode Anda, Anda menentukan awal dan akhir pelacakan kode khusus (dan menambahkan metrik khusus yang diinginkan) menggunakan API yang disediakan oleh Performance Monitoring SDK.
Kunjungi Tambahkan pemantauan untuk kode tertentu guna mempelajari lebih lanjut tentang fitur ini dan cara menambahkannya ke aplikasi Anda.
Langkah 5 : Terapkan aplikasi Anda lalu tinjau hasilnya
Setelah Anda memvalidasi Performance Monitoring menggunakan simulator Xcode dan satu atau beberapa perangkat pengujian, Anda dapat menerapkan versi terbaru aplikasi Anda kepada pengguna.
Anda dapat memantau data performa di dasbor Performa Firebase console.
Masalah Dikenal
- Performance Monitoring memiliki masalah kompatibilitas umum dengan GTMSSQLite. Kami merekomendasikan untuk tidak menggunakan Pemantauan Kinerja dengan aplikasi yang menggunakan GTMSQlite.
- Metode swizzling setelah memanggil
FirebaseApp.configure()
mungkin mengganggu Performance Monitoring SDK. - Masalah yang diketahui dengan Simulator iOS 8.0-8.2 mencegah Pemantauan Kinerja merekam peristiwa kinerja. Masalah ini telah diperbaiki di Simulator iOS 8.3 dan versi yang lebih baru.
- Koneksi yang dibuat menggunakan
backgroundSessionConfiguration
NSURLSession akan menunjukkan waktu koneksi yang lebih lama dari yang diharapkan. Koneksi ini dijalankan di luar proses dan pengaturan waktunya mencerminkan peristiwa panggilan balik dalam proses.
Langkah selanjutnya
Tinjau dan jalankan contoh kode Performance Monitoring iOS di GitHub .
Pelajari lebih lanjut tentang data yang dikumpulkan secara otomatis oleh Performance Monitoring:
- Data yang terkait dengan siklus hidup aplikasi Anda, seperti waktu mulai aplikasi
- Data untuk perenderan layar di aplikasi Anda
- Data untuk permintaan jaringan HTTP/S yang dikeluarkan oleh aplikasi Anda
Lihat, lacak, dan filter data performa Anda di Firebase console.
Tambahkan pemantauan untuk tugas atau alur kerja tertentu di aplikasi Anda dengan memperlengkapi pelacakan kode khusus .