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 aplikacji funkcję 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 niej wymagany wtyczkę 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. Pojedynczy kontroler widoku zawiera całą aplikację Flutter w wersji natywnej, dzięki czemu pakiet SDK Firebase nie jest świadomy przełączania ekranów.

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

Firebase zaczyna przetwarzać zdarzenia, gdy dodasz pakiet SDK do aplikacji. Jeśli nadal pracujesz nad aplikacją lokalnie, generuj zdarzenia, aby rozpocząć 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ą, nawiązując z nią interakcje przez nawigowanie po ekranach lub wywołując żądania sieciowe.

  3. Otwórz w konsoli Firebase panel Wydajność. Pierwsze dane powinny się pojawić 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ź, czy występują te typy dziennikó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 monitorowanie niestandardowe dla określonego kodu

Aby monitorować dane o wydajności powiązane z konkretnym kodem w aplikacji, możesz użyć niestandardowych logów kodu.

Dzięki niestandardowemu śledzeniu kodu możesz mierzyć, ile czasu zajmuje aplikacji wykonanie określonego zadania lub zestawu zadań, takich jak wczytywanie zestawu obrazów czy wysyłanie zapytania do bazy danych. Domyślnym rodzajem danych dla ścieżki kodu niestandardowego jest jego czas trwania, ale możesz też dodać niestandardowe dane, takie jak trafienia do pamięci podręcznej i ostrzeżenia dotyczące pamięci.

W kodzie 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. Wprowadź aplikację, a potem sprawdź 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