Wprowadzenie do Monitorowania wydajności pod kątem Flutter

Ten przewodnik po szybkim uruchomieniu zawiera instrukcje konfigurowania Firebase Performance Monitoring, które pomogą Ci uzyskać wgląd w cechy wydajności aplikacji Flutter.

Zanim zaczniesz

Jeśli jeszcze tego nie zrobiono, skonfiguruj i inicjuj Firebase w projekcie Flutter.

Krok 1. Dodaj do swojej aplikacji Monitorowanie wydajności

  1. Aby zainstalować w katalogu głównym projektu Flutter wtyczkę Fluttera do monitorowania wydajności, uruchom to polecenie:

    flutter pub add firebase_performance

  2. W katalogu głównym projektu Flutter uruchom to polecenie:

    flutterfire configure

    Uruchomienie tego polecenia zapewnia, że konfiguracja Firebase Twojej aplikacji Flutter jest aktualna, a w przypadku Androida doda do aplikacji wymagany wtyczek Gradle do monitorowania wydajności.

  3. Po zakończeniu ponownie skompiluj projekt Flutter:

    flutter run

Po dodaniu pakietu SDK Monitorowania wydajności Firebase automatycznie zacznie zbierać dane dotyczące cyklu życia aplikacji (np. czas uruchamiania aplikacji) oraz dane o żądaniach sieciowych HTTP/S.

W przypadku Fluttera nie można automatycznie monitorować wydajności renderowania poszczególnych ekranów. Kontroler natywnie opatruje całą aplikację Flutter natywnie, dzięki czemu bazowy natywny pakiet SDK Firebase nie wykrywa przejść z ekranu.

Krok 2. Wygeneruj zdarzenia dotyczące skuteczności na potrzeby początkowego wyświetlania danych

Firebase zaczyna przetwarzać zdarzenia, gdy dodasz pakiet SDK do aplikacji. Jeśli nadal tworzysz aplikację lokalnie, generuj zdarzenia, aby umożliwić początkowe gromadzenie i przetwarzanie danych.

  1. kontynuować tworzenie aplikacji za pomocą symulatora lub urządzenia testowego;

  2. generować zdarzenia, przełączając aplikację kilka razy między tłem a płaszczyzną, wchodzić z nią w interaktywność przez przełączanie się między ekranami lub wywoływanie żądań sieciowych.

  3. Otwórz w konsoli Firebase panel Wydajność. Pierwsze dane powinny się wyświetlić w ciągu kilku minut.

    Jeśli nie widzisz wyświetlanych danych początkowych, zapoznaj się z wskazówkami dotyczącymi rozwiązywania problemów.

Krok 3. (Opcjonalnie) Wyświetl komunikaty z dziennika dotyczące zdarzeń związanych z wydajnością

  1. Sprawdź, czy w logach nie ma komunikatów o błędach.

    Monitorowanie wydajności oznacza swoje komunikaty dziennika tymi tagami, aby umożliwić filtrowanie komunikatów dziennika:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. Sprawdź następujące typy logów, które wskazują, że Monitorowanie wydajności rejestruje zdarzenia dotyczące wydajności:

    • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  3. Kliknij adres URL, aby wyświetlić dane w konsoli Firebase. Może minąć kilka chwil, zanim dane zostaną zaktualizowane w panelu.

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 skorzystać z niestandardowych logów czasu.

Niestandardowy ślad kodu pozwala sprawdzić, ile czasu zajmuje aplikacji wykonanie określonego zadania lub zestawu zadań, takich jak wczytanie zestawu obrazów czy wysłanie zapytania do bazy danych. Domyślnym rodzajem danych w przypadku śledzenia kodu niestandardowego jest jego czas trwania, ale możesz też dodać dane niestandardowe, takie jak trafienia do pamięci podręcznej i ostrzeżenia dotyczące pamięci.

W kodze definiujesz początek i koniec niestandardowego logu czasu (oraz dodajesz dowolne niestandardowe dane) za pomocą interfejsu API udostępnianego przez pakiet SDK do monitorowania wydajności.

Aby dowiedzieć się więcej o tych funkcjach i sposobie ich dodawania do aplikacji, przeczytaj artykuł Dodawanie monitorowania określonego kodu.

Krok 5. Wdróż aplikację i sprawdź jej wyniki

Po zweryfikowaniu działania Monitorowania wydajności za pomocą emulatora i co najmniej jednego urządzenia testowego możesz wdrożyć zaktualizowaną wersję aplikacji dla użytkowników.

Dane o skuteczności możesz sprawdzać na panelu Skuteczność w konsoli Firebase.

Dalsze kroki