Zanim zaczniesz
Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu Apple .
Krok 1 : Dodaj monitorowanie wydajności do swojej aplikacji
Po dodaniu pakietu SDK monitorowania wydajności Firebase automatycznie zaczyna zbierać dane do renderowania ekranu aplikacji , dane związane z cyklem życia aplikacji (np. czas uruchomienia aplikacji ) oraz dane dotyczące żądań sieciowych HTTP/S .
Użyj Menedżera pakietów Swift, aby zainstalować zależności Firebase i zarządzać nimi.
- W Xcode przy otwartym projekcie aplikacji przejdź do pozycji Plik > Dodaj pakiety .
- Po wyświetleniu monitu dodaj repozytorium SDK platformy Firebase Apple:
- Wybierz bibliotekę monitorowania wydajności.
- Po zakończeniu Xcode automatycznie rozpocznie rozwiązywanie i pobieranie twoich zależności w tle.
https://github.com/firebase/firebase-ios-sdk
Następnie skonfiguruj moduł Firebase:
- Zaimportuj moduł
FirebaseCore
do swojegoUIApplicationDelegate
, a także wszelkie inne moduły Firebase używane przez delegata aplikacji. Na przykład, aby użyć Cloud Firestore i uwierzytelniania:Szybki
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Cel C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Skonfiguruj współużytkowane wystąpienie
FirebaseApp
, zwykle w inicjatorzeApp
lub w metodzieapplication(_:didFinishLaunchingWithOptions:)
:Szybki
// Use Firebase library to configure APIs FirebaseApp.configure()
Cel C
// Use Firebase library to configure APIs [FIRApp configure];
- Ponownie skompiluj swoją aplikację.
Krok 2 : Wygeneruj zdarzenia dotyczące wydajności w celu wstępnego wyświetlenia danych
Firebase rozpocznie przetwarzanie zdarzeń, gdy pomyślnie dodasz pakiet SDK do swojej aplikacji. Jeśli nadal programujesz lokalnie, wejdź w interakcję z aplikacją, aby wygenerować zdarzenia do wstępnego gromadzenia i przetwarzania danych.
Kontynuuj tworzenie aplikacji za pomocą symulatora lub urządzenia testowego.
Generuj zdarzenia, kilkakrotnie przełączając aplikację między tłem a pierwszym planem, wchodząc w interakcję z aplikacją poprzez nawigowanie po ekranach i/lub wyzwalając żądania sieciowe.
Przejdź do panelu wydajności konsoli Firebase. Powinieneś zobaczyć swoje początkowe dane w ciągu kilku minut.
Jeśli nie widzisz początkowych danych, zapoznaj się ze wskazówkami dotyczącymi rozwiązywania problemów .
Krok 3 : (Opcjonalnie) Wyświetl komunikaty dziennika dotyczące zdarzeń dotyczących wydajności
Włącz rejestrowanie debugowania w następujący sposób:
- W Xcode (minimum v13.3.1) wybierz Produkt > Schemat > Edytuj schemat .
- Wybierz Uruchom z lewego menu, a następnie wybierz kartę Argumenty .
- W sekcji Argumenty przekazane podczas uruchamiania dodaj
-FIRDebugEnabled
.
Sprawdź komunikaty dziennika pod kątem komunikatów o błędach.
Monitorowanie wydajności taguje swoje komunikaty dziennika za pomocą
Firebase/Performance
, dzięki czemu możesz filtrować swoje komunikaty dziennika.Sprawdź następujące typy dzienników, które wskazują, że funkcja Performance Monitoring rejestruje zdarzenia dotyczące wydajności:
-
Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
-
Logging network request trace: URL
-
Kliknij adres URL, aby wyświetlić swoje dane w konsoli Firebase. Aktualizacja danych w panelu może zająć kilka chwil.
Jeśli Twoja aplikacja nie rejestruje zdarzeń dotyczących wydajności, zapoznaj się ze wskazówkami dotyczącymi 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 Twojej aplikacji, możesz instrumentować niestandardowe ślady kodu .
Dzięki niestandardowemu śledzeniu kodu możesz zmierzyć, ile czasu zajmuje Twojej aplikacji wykonanie określonego zadania lub zestawu zadań, takich jak ładowanie zestawu obrazów lub wysyłanie zapytań do bazy danych. Domyślną metryką niestandardowego śledzenia kodu jest jego czas trwania, ale można również dodać niestandardowe metryki, takie jak trafienia w pamięci podręcznej i ostrzeżenia dotyczące pamięci.
W swoim kodzie definiujesz początek i koniec niestandardowego śledzenia kodu (i dodajesz dowolne żądane niestandardowe metryki) za pomocą interfejsu API dostarczanego przez pakiet Performance Monitoring SDK.
Odwiedź Dodaj monitorowanie, aby uzyskać konkretny kod, aby dowiedzieć się więcej o tych funkcjach i sposobach ich dodawania do aplikacji.
Krok 5 : Wdróż aplikację, a następnie sprawdź wyniki
Po zweryfikowaniu monitorowania wydajności przy użyciu symulatora Xcode i co najmniej jednego urządzenia testowego możesz wdrożyć zaktualizowaną wersję aplikacji dla użytkowników.
Możesz monitorować dane dotyczące wydajności w panelu Wydajność konsoli Firebase.
Znane problemy
- Monitorowanie wydajności ma znane problemy ze zgodnością z GTMSQLite. Zalecamy, aby nie używać monitorowania wydajności w aplikacjach korzystających z GTMSQLite.
- Zmiana metody po wywołaniu funkcji FirebaseApp.configure
FirebaseApp.configure()
może zakłócać działanie zestawu SDK monitorowania wydajności. - Znane problemy z symulatorem iOS 8.0-8.2 uniemożliwiają funkcji Performance Monitoring przechwytywanie zdarzeń dotyczących wydajności. Te problemy zostały rozwiązane w symulatorze iOS 8.3 i nowszych wersjach.
- Połączenia nawiązywane przy użyciu
backgroundSessionConfiguration
NSURLSession będą wykazywać dłuższe niż oczekiwano czasy połączeń. Połączenia te są wykonywane poza procesem, a czasy odzwierciedlają zdarzenia wywołania zwrotnego w procesie.
Następne kroki
Przejrzyj i uruchom przykładowy kod monitorowania wydajności systemu iOS w witrynie GitHub .
Dowiedz się więcej o danych zbieranych automatycznie przez Performance Monitoring:
- Dane związane z cyklem życia Twojej aplikacji, np. godzina uruchomienia aplikacji
- Dane do renderowania ekranu w Twojej aplikacji
- Dane dla żądań sieciowych HTTP/S wysyłanych przez Twoją aplikację
Wyświetlaj, śledź i filtruj dane o wydajności w konsoli Firebase.
Dodaj monitorowanie określonych zadań lub przepływów pracy w swojej aplikacji przez instrumentację niestandardowych śladów kodu .