Na tej stronie opisujemy, jak przeprowadzić kompleksowy test za pomocą aplikacji demonstracyjnej i Konsoli Google Play.
Kroki
Aby pobrać pakiet SDK, uruchomić aplikację demonstracyjną, sprawdzić, czy aplikacja działa prawidłowo, i wyświetlić informacje o czasie wczytywania klatek z aplikacji w Konsoli Google Play:
- Pobierz plik ZIP pakietu SDK i rozpakuj go.
- Utwórz i uruchom aplikację demonstracyjną.
- Uruchom aplikację do monitorowania.
- Utwórz kompilację wersji.
- Uruchom kompilację wersji.
- Wykresy znajdziesz w Konsoli Google Play.
Tworzenie i uruchamianie aplikacji demonstracyjnej
Uruchom aplikację APT Insights Demo w Android Studio, aby mieć pewność, że wszystko kompiluje się poprawnie. W tym projekcie wykorzystano CMake do tworzenia kodu natywnego i pokazujemy, jak użyć pliku gamesdk.cmake
, który jest najprostszym sposobem na rozpoczęcie pracy.
Aby uruchomić aplikację demonstracyjną, wykonaj te czynności:
- Wyodrębnij zawartość pliku ZIP do folderu.
- Otwórz Android Studio.
- Kliknij File > Open (Plik > Otwórz) i wybierz
gamesdk/samples/tuningfork/insightsdemo/build.gradle
. - Poczekaj, aż Android Studio zsynchronizuje projekt.
- Podłącz urządzenie (lub utwórz urządzenie wirtualne), aby uruchomić próbkę. Włącz na urządzeniu opcje programisty i debugowanie USB.
Wybierz urządzenie docelowe i kliknij Uruchom
. Więcej informacji znajdziesz w artykule Tworzenie i uruchamianie aplikacji.
Rysunek 1. Aplikacja testowa została uruchomiona Przykładowy plik APK powinien zostać skompilowany i zainstalowany na urządzeniu docelowym. Jeśli napotkasz błędy, sprawdź te kwestie:
- Masz obsługiwaną wersję pakietu Android SDK. Więcej informacji znajdziesz w polu
compileSdkVersion
w module aplikacjibuild.gradle
. Wersję pakietu SDK możesz zaktualizować na karcie Platformy SDK w Menedżerze pakietów SDK. - Masz obsługiwaną wersję pakietu Android NDK. Więcej informacji znajdziesz w polu
ndkVersion
w plikubuild.gradle
modułu aplikacji. Możesz zainstalować konkretną wersję pakietu NDK, korzystając z karty Narzędzia SDK w Menedżerze pakietów SDK. - Plik
local.properties
w projekcie nie zawiera wpisundk.dir
. Lokalizacja jest określana przez Android Studio i używana jest wersja NDK z powyższej wersji. Jeśli masz ten wpis, wyczyść cały wiersz. - Po zmianie ustawień kompilacji wyczyść projekt (Kompilacja > Wyczyść projekt) i odśwież połączone projekty C++ (Kompilacja > Odśwież połączone projekty C++).
- Masz obsługiwaną wersję pakietu Android SDK. Więcej informacji znajdziesz w polu
Uruchamianie aplikacji do monitorowania
Za pomocą kompilacji przeznaczonej do debugowania aplikacji demonstracyjnej lub dowolnej innej aplikacji z obsługą Tuning Fork możesz skonfigurować w aplikacji wysyłanie i odbieranie danych z lokalnego punktu końcowego, a nie serwera Google Play. Aby to zrobić, skonfiguruj endpoint_uri_override
w ustawieniach Tuning Fork:
#ifndef NDEBUG
settings.endpoint_uri_override = "http://localhost:9000";
#endif
Musisz też mieć w pliku AndroidManifest.xml
te uprawnienia:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Te zmiany są już wprowadzone w aplikacji demonstracyjnej (zobacz insightsdemo.cpp
).
Możesz użyć tej funkcji, aby sprawdzić, czy aplikacja wysyła i odbiera odpowiednie dane. Aby to sprawdzić, uruchom jednocześnie aplikację demonstracyjną i aplikację Tuning Fork Monitor. Ta aplikacja do monitorowania działa jak serwer lokalny i wyświetla dane generowane przez aplikację z obsługą Tuning Fork.
Aby jednocześnie uruchomić aplikację do monitorowania i aplikację demonstracyjną w celu sprawdzenia, czy aplikacja demonstracyjna działa prawidłowo, wykonaj te czynności:
- Zainstaluj pakiet APK aplikacji Tuning Fork Monitor na urządzeniu docelowym za pomocą adb:
adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
- Otwórz aplikację do monitorowania.
- Naciśnij przycisk ekranu głównego Androida, aby wysłać aplikację Tuning Fork Monitor do tła na urządzeniu.
- Uruchom ponownie aplikację demonstracyjną na pierwszym planie na około 30 sekund.
- Wróć do aplikacji Tuning Fork Monitor.
- Aplikacja demonstracyjna jest widoczna w sekcji Aplikacje aktywne jako
com.tuningfork.insightsdemo 16
. Kliknij ten wpis, aby wyświetlić szczegóły aplikacji i dane telemetryczne na żywo.
![](https://developer.android.google.cn/static/images/games/performance-tuner/monitor-app1.png?authuser=7&hl=pl)
![](https://developer.android.google.cn/static/images/games/performance-tuner/monitor-app2.png?authuser=7&hl=pl)
Tworzenie kompilacji wersji
Utwórz w Android Studio kompilację wersji demonstracyjnej aplikacji. Przesyłasz tę kompilację do Konsoli Google Play, aby włączyć w Android Vitals wykresy czasu klatek.
Włącz interfejs Android Performance Parameters API w konsoli Google Cloud. Umożliwia aplikacji komunikację z Google Play. Nie musisz ograniczać klucza interfejsu API aplikacji w wersji demonstracyjnej.
Pamiętaj, aby skopiować klucz interfejsu API z poprzedniego kroku do pola
api_key
wgamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt
.Identyfikator aplikacji w wersji demonstracyjnej jest zarezerwowany, więc nie można przesłać pliku APK, który z niego korzysta. Zmień ten identyfikator w pliku
build.gradle
aplikacji:applicationId "com.tuningfork.your-unique-identifier"
Wyczyść projekt (Kompilacja > Oczyść projekt) i odśwież połączone projekty w C++ (Kompilacja > Odśwież połączone projekty C++).
Utwórz konfigurację podpisywania na potrzeby kompilacji wersji.
- Wybierz Plik > Struktura projektu > Moduły.
- Wybierz kartę Signing Configs (Konfiguracje podpisywania).
- Dodaj nową konfigurację o nazwie
release
. - Utwórz magazyn kluczy na potrzeby konfiguracji.
Powiąż konfigurację podpisywania wersji z wariantem kompilacji wersji.
- Wybierz Plik > Struktura projektu > Warianty kompilacji.
- Kliknij kartę Typy kompilacji.
- Wybierz typ kompilacji o nazwie
release
. - W polu Konfiguracja podpisywania wybierz zmienną konfiguracji wersji.
W oknie projektu Android Studio wybierz katalog app. Spowoduje to włączenie opcji menu w następnym kroku.
Zmień aktywny wariant kompilacji na
release
(Kompilacja > Wybierz wariant kompilacji).Kliknij Build > Build Buns/APK(s) > Build APK(s)(Utwórz > Pakiety kompilacji/APK > Kompiluj pliki APK). Po zakończeniu kompilacji kliknij link zlokalizuj, aby znaleźć pakiet APK wersji.
Utwórz w Konsoli Google Play nową aplikację w wersji demonstracyjnej. Więcej informacji znajdziesz w artykule Przesyłanie aplikacji.
Prześlij plik APK wersji na ścieżkę testów wewnętrznych. Więcej informacji znajdziesz w artykule o przygotowywaniu i wdrażaniu wersji.
Uruchamianie kompilacji wersji
Wybierz urządzenie docelowe i kliknij Uruchom
.
Musisz użyć tego samego pakietu APK wersji, który został przesłany do Konsoli Google Play.
Pozwól aplikacji demonstracyjnej na pewien czas. Zanim Konsola Google Play zacznie wyświetlać dane, może minąć do 30 minut. Sprawdź, czy dane są przesyłane na serwer, wybierając poziom logu Informacje w oknie Logcat. Jeśli widzisz w dzienniku błędy, zapoznaj się z sekcją Rozwiązywanie typowych problemów.
... I/TuningFork:Web: Connecting to:
https://performanceparameters.googleapis.com/v1/applications/com.tuningfork.yourapp/apks/24:uploadTelemetry
... I/TuningFork: Scene loading 30 (true) took 166 ms
... I/TuningFork:Web: Response code: 200
... I/TuningFork:Web: Response message: OK
... I/TuningFork.GE: UPLOAD request returned 200 {}
Wyświetlanie wykresów w Konsoli Google Play
Otwórz Konsolę Google Play i wybierz aplikację testową. Aby zobaczyć wykres czasu renderowania klatki, kliknij Android Vitals > Skuteczność > Statystyki.
Rysunek 4. Wykres Android Vitals
Udało Ci się przeprowadzić kompleksowy test z użyciem biblioteki Tuning Fork. Projekt aplikacji testowej możesz usunąć w Konsoli Google Play, ponieważ nie jest już potrzebny.