Zanim zaczniesz
Jeśli jeszcze nie masz tego za sobą, dodaj Firebase do swojego projektu Apple.
Krok 1. Dodaj do swojej aplikacji Monitorowanie wydajności
Gdy dodasz pakiet SDK Performance Monitoring, Firebase automatycznie rozpocznie zbieranie danych renderowania ekranu aplikacji, z cyklem życia aplikacji (np. czas uruchomienia aplikacji) oraz dla żądań sieciowych HTTP/S.
Użyj menedżera pakietów Swift, aby zainstalować zależności Firebase i nimi zarządzać.
- W Xcode po otwarciu projektu aplikacji przejdź do File > Dodaj pakiety.
- Gdy pojawi się prośba, dodaj repozytorium SDK platform Apple Platform SDK Firebase:
- Wybierz bibliotekę monitorowania wydajności.
- Dodaj flagę
-ObjC
do sekcji Inne flagi łączące w ustawieniach kompilacji celu. - Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie lub zależności w tle.
https://github.com/firebase/firebase-ios-sdk.git
Następnie skonfiguruj moduł Firebase:
- Zaimportuj moduł
FirebaseCore
doUIApplicationDelegate
, jak i wszelkie inne Moduły Firebase używane przez przedstawiciela aplikacji. Aby na przykład użyć Cloud Firestore i Uwierzytelniania:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Skonfiguruj
FirebaseApp
współdzielonej instancji w uprawnieniach przedstawiciela aplikacji Metodaapplication(_:didFinishLaunchingWithOptions:)
:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- Jeśli używasz SwiftUI, musisz utworzyć i dołączyć przedstawiciela aplikacji.
do struktury
App
za pomocąUIApplicationDelegateAdaptor
lubNSApplicationDelegateAdaptor
Musisz też wyłączyć przełączanie przekazywania dostępu do aplikacji. Dla: więcej informacji znajdziesz w instrukcjach SwiftUI.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
-
Ponownie skompiluj aplikację.
Krok 2. Wygeneruj zdarzenia dotyczące skuteczności na potrzeby początkowego wyświetlania danych
Firebase rozpocznie przetwarzanie zdarzeń, gdy dodasz pakiet SDK do aplikacji. Jeśli nadal tworzysz aplikację lokalnie, użyj jej, aby wygenerować zdarzenia do początkowego zbierania i przetwarzania danych.
Kontynuuj tworzenie aplikacji za pomocą symulatora lub urządzenia testowego.
Generowanie zdarzeń przez przełączanie aplikacji między tłem a pierwszym planem wielokrotnie i korzystając z aplikacji, przechodząc na różne ekrany, lub uruchamianiu żądań sieciowych.
Otwórz panel Skuteczność. konsoli Firebase. Początkowe dane powinny się wyświetlić w ciągu za kilka minut.
Jeśli nie widzisz swoich danych początkowych, zapoznaj się z sekcją dotyczącą rozwiązywania problemów .
Krok 3. (Opcjonalnie) Wyświetl komunikaty z dziennika dotyczące zdarzeń związanych z wydajnością
Włącz logowanie debugowania w następujący sposób:
- W Xcode (minimalna wersja 14.1) wybierz Product > Schemat > Edytuj schemat.
- W menu po lewej stronie kliknij Uruchom i wybierz kartę Argumenty.
- W sekcji Arguments Passed at Launch (Argumenty przekazane przy uruchomieniu) dodaj parametr
-FIRDebugEnabled
.
Sprawdź, czy w komunikatach logu nie ma żadnych komunikatów o błędach.
Monitorowanie wydajności dodaje do komunikatów logu tag
Firebase/Performance
, dzięki czemu możesz może filtrować komunikaty dziennika.Sprawdź następujące typy logów, które wskazują, że Monitorowanie wydajności jest rejestrowanie zdarzeń wydajności:
Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
Logging network request trace: URL
Kliknij adres URL, aby wyświetlić dane w konsoli Firebase. Może to chwilę potrwać momentu aktualizacji danych na pulpicie nawigacyjnym.
Jeśli aplikacja nie rejestruje zdarzeń związanych z wydajnością, zapoznaj się z informacjami na temat rozwiązywania problemów .
Krok 4. (Opcjonalnie) Dodaj niestandardowe monitorowanie dla określonego kodu
Aby monitorować dane o wydajności powiązane z określonym kodem w aplikacji, możesz: instrumentów niestandardowych logów czasu.
Dzięki niestandardowemu śledzeniu kodu możesz sprawdzić, ile czasu zajmuje uruchomienie aplikacji określonego zadania lub zestawu zadań, np. wczytanie zestawu obrazów lub wysłanie zapytań; w bazie danych. Domyślnym wskaźnikiem niestandardowego śledzenia kodu jest jego czas trwania, ale możesz też dodawać wskaźniki niestandardowe, takie jak trafienia w pamięci podręcznej i ostrzeżenia związane z pamięcią.
W kodzie definiujesz początek i koniec niestandardowego logu czasu (oraz dodaj dowolne wymagane dane niestandardowe) za pomocą interfejsu API dostępnego w pakiecie SDK Performance Monitoring.
Zapoznaj się z artykułem Dodawanie monitorowania dla określonego kodu. , by dowiedzieć się więcej o tych funkcjach i sposobach ich dodawania do aplikacji.
Krok 5. Wdróż aplikację i sprawdź jej wyniki
Po sprawdzeniu poprawności monitorowania skuteczności za pomocą symulatora Xcode i co najmniej jednego urządzeń testowych, możesz wdrożyć zaktualizowaną wersję aplikacji u użytkowników.
Dane o skuteczności możesz sprawdzać w Panel Skuteczność w konsoli Firebase.
Znane problemy
- W Monitorze wydajności występują znane problemy ze zgodnością z GTMSQLite. Nie zalecamy monitorowania wydajności w aplikacjach, które korzystają z GTMSQLite.
- Wskaźnik przesuwania metod po wywołaniu usługi
FirebaseApp.configure()
może zakłócać działanie usługi SDK do monitorowania wydajności. - Znane problemy z symulatorem iOS 8.0–8.2 uniemożliwiają Monitorowanie wydajności rejestrowania zdarzeń dotyczących skuteczności. Te problemy są rozwiązywane w symulatorze iOS 8.3 i nowszych wersjach.
- Nawiązano połączenia przy użyciu instancji
backgroundSessionConfiguration
NSURLSession czas połączenia będzie dłuższy niż zakładany. Te połączenia są są wykonywane poza procesem, a czasy odzwierciedlają zdarzenia wywołania zwrotnego procesu.
Dalsze kroki
Sprawdź i uruchom Przykładowy kod monitorowania wydajności na iOS na GitHubie.
Więcej informacji o danych zbieranych automatycznie przez Monitorowanie wydajności:
- dane związane z cyklem życia aplikacji, takie jak: czas uruchamiania aplikacji
- dane na potrzeby renderowania ekranu w aplikacji;
- Dane o wysłanych żądaniach sieciowych HTTP/S przez Twoją aplikację
wyświetlać, śledzić i filtrować dane z danymi o wydajności w konsoli Firebase.
Dodaj monitorowanie dotyczące określonych zadań lub przepływów pracy w aplikacji przez instrumenting niestandardowych logów czasu.