Wprowadzenie do Monitorowania wydajności pod kątem Flutter

Z tego przewodnika dowiesz się, jak skonfigurować Monitorowanie wydajności Firebase, aby uzyskać wgląd w charakterystykę wydajności aplikacji Flutter.

Zanim zaczniesz

Jeśli jeszcze tego nie zrobisz, skonfiguruj i zainicjuj Firebase w projekcie Flutter.

Krok 1. Dodaj Monitorowanie wydajności do aplikacji

  1. W katalogu głównym projektu Flutter uruchom to polecenie, aby zainstalować wtyczkę Flutter Monitorowanie wydajności:

    flutter pub add firebase_performance

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

    flutterfire configure

    Uruchomienie tego polecenia spowoduje, że konfiguracja Firebase w aplikacji Flutter będzie aktualna, a w przypadku Androida do aplikacji zostanie dodana wymagana wtyczka Gradle Monitorowanie wydajności.

  3. Po zakończeniu ponownie skompiluj projekt Flutter:

    flutter run

Po dodaniu pakietu SDK Monitorowanie wydajności Firebase automatycznie zacznie zbierać dane związane z cyklem życia aplikacji (np. czas uruchamiania aplikacji) oraz dane dotyczące żądań sieciowych HTTP/S.

W przypadku Fluttera automatyczne monitorowanie wydajności renderowania ekranu nie jest możliwe w przypadku poszczególnych ekranów Fluttera. Pojedynczy kontroler widoku natywnie obejmuje całą aplikację Flutter, więc podstawowy natywny pakiet SDK Firebase nie wie o przejściach między ekranami.

Krok 2. Wygeneruj zdarzenia związane z wydajnością, aby wyświetlić wstępne dane

Firebase zacznie przetwarzać zdarzenia, gdy dodasz pakiet SDK do aplikacji. Jeśli nadal pracujesz lokalnie, korzystaj z aplikacji, aby generować zdarzenia na potrzeby wstępnego zbierania i przetwarzania danych.

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

  2. Generuj zdarzenia, przełączając aplikację między tłem a pierwszym planem, korzystając z niej, przechodząc między ekranami lub wywołując żądania sieciowe.

  3. Otwórz panel Skuteczność w konsoli Firebase. W ciągu kilku minut powinny pojawić się wstępne dane.

    Jeśli nie widzisz wstępnych danych, zapoznaj się ze wskazówkami dotyczącymi rozwiązywania problemów.

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

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

    Monitorowanie wydajności oznacza komunikaty z dziennika tymi tagami, aby można było je filtrować:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. Sprawdź, czy występują te typy dzienników, które wskazują, że Monitorowanie wydajności rejestruje zdarzenia związane z 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. Aktualizacja danych w panelu może potrwać kilka minut.

Krok 4.: (Opcjonalnie) Dodaj niestandardowe monitorowanie konkretnego kodu

Aby monitorować dane o skuteczności związane z konkretnym kodem w aplikacji, możesz instrumentować niestandardowe logi czasu kodu.

Dzięki niestandardowemu logowi czasu kodu możesz zmierzyć, ile czasu zajmuje aplikacji wykonanie określonego zadania lub zestawu zadań, np. wczytanie zestawu obrazów lub wysłanie zapytania do bazy danych. Domyślną miarą niestandardowego logu czasu kodu jest jego czas trwania, ale możesz też dodawać niestandardowe miary, takie jak trafienia w pamięć podręczną i ostrzeżenia o pamięci.

W kodzie definiujesz początek i koniec niestandardowego logu czasu kodu (oraz dodajesz dowolne niestandardowe miary) za pomocą interfejsu API udostępnianego przez pakiet SDK Monitorowanie wydajności.

Aby dowiedzieć się więcej o tych funkcjach i o tym, jak dodać je do aplikacji, przeczytaj artykuł Dodawanie monitorowania konkretnego kodu.

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

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

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

Dalsze kroki