Catch up on everthing we announced at this year's Firebase Summit. Learn more

Zacznij korzystać z monitorowania wydajności na platformach Apple

Zanim zaczniesz

Jeśli jeszcze nie masz, dodać Firebase do projektu firmy Apple .

Krok 1: Dodaj do monitorowania wydajności aplikacji

Po dodaniu Performance Monitoring SDK, Firebase automatycznie rozpoczyna zbieranie danych dla Twojej aplikacji ekranu renderingu , dane związane z cyklem życia aplikacji (jak czas startu aplikacji ), a dane dla zapytań sieciowych HTTP / S .

Użyj Menedżera pakietów Swift, aby zainstalować zależności Firebase i zarządzać nimi.

  1. W Xcode, z projektem otwartej aplikacji, należy przejść do menu Plik> Swift Pakiety> Dodaj Package zależność.
  2. Po wyświetleniu monitu dodaj repozytorium SDK platformy Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. Wybierz bibliotekę monitorowania wydajności.
  5. Po zakończeniu Xcode automatycznie rozpocznie rozwiązywanie i pobieranie twoich zależności w tle.

Następnie skonfiguruj moduł Firebase:

  1. Zaimportować moduł Firebase w UIApplicationDelegate :

    Szybki

    import Firebase

    Cel C

    @import Firebase;
  2. Skonfiguruj FirebaseApp wspólne wystąpienie, zazwyczaj w swojej aplikacji application:didFinishLaunchingWithOptions: metodę:

    Szybki

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Cel C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  1. Ponownie skompiluj swoją aplikację.

Krok 2: Generowanie zdarzeń osiągi początkowym wyświetlaniem 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.

  1. Kontynuuj tworzenie aplikacji za pomocą symulatora lub urządzenia testowego.

  2. 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.

  3. Idź na desce rozdzielczej wydajności konsoli Firebase. Powinieneś zobaczyć swoje początkowe dane w ciągu kilku minut.

    Jeśli nie pojawi się ekran swojego wstępnych danych, przejrzeć wskazówki dotyczące rozwiązywania problemów .

Krok 3: (opcjonalnie) Przeglądanie wiadomości dziennika zdarzeń dla wydajności

  1. Włącz rejestrowanie debugowania w następujący sposób:

    1. W Xcode (minimum v12.5), wybierz schemat produktu> Schemat> Edytuj.
    2. Wybierz polecenie Uruchom z menu po lewej stronie, a następnie wybierz kartę argumentów.
    3. W Argumenty przekazywane w sekcji uruchamianie, dodać -FIRDebugEnabled .
  2. Sprawdź komunikaty dziennika pod kątem komunikatów o błędach.

  3. Monitorowanie wydajności tagi swoje komunikaty dziennika z Firebase/Performance , dzięki czemu można filtrować wiadomości dziennika.

  4. 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
  5. Kliknij adres URL, aby wyświetlić swoje dane w konsoli Firebase. Aktualizacja danych w panelu może zająć kilka chwil.

Jeśli aplikacja nie jest rejestrowanie zdarzeń z wydajnością, przejrzeć wskazówki dotyczące rozwiązywania problemów .

Krok 4: (opcjonalnie) Dodaj własny monitoring dla kodu specyficznego

Monitorować dane dotyczące wydajności związanych z kodem określonego w swojej aplikacji, MOŻESZ przyrządów kod zwyczaj ślady .

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.

Wizyta Dodaj monitorowania specyficzny kod , aby dowiedzieć się więcej na temat tych funkcji i jak je dodać do swojej aplikacji.

Krok 5: Deploy aplikacja następnie powodowało

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żna monitorować dane dotyczące wydajności w desce rozdzielczej wydajności 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.
  • Metoda swizzling po wywołaniu FirebaseApp.configure() może zakłócać działanie Monitorowanie SDK.
  • 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 NSURLSession za backgroundSessionConfiguration zaprezentuje dłużej niż oczekiwano czasu połączenia. Połączenia te są wykonywane poza procesem, a czasy odzwierciedlają zdarzenia wywołania zwrotnego w procesie.

Następne kroki