Uruchamianie aplikacji demonstracyjnej

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:

1. Pobierz plik ZIP pakietu SDK i rozpakuj go.
2. Utwórz i uruchom aplikację demonstracyjną.
3. Uruchom aplikację do monitorowania.
4. Utwórz kompilację wersji.
5. Uruchom kompilację wersji.
6. 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:

1. Wyodrębnij zawartość pliku ZIP do folderu.
2. Otwórz Android Studio.
3. Kliknij File > Open (Plik > Otwórz) i wybierz gamesdk/samples/tuningfork/insightsdemo/build.gradle.
4. Poczekaj, aż Android Studio zsynchronizuje projekt.
5. Podłącz urządzenie (lub utwórz urządzenie wirtualne), aby uruchomić próbkę. Włącz na urządzeniu opcje programisty i debugowanie USB.

6. Wybierz urządzenie docelowe i kliknij Uruchom . Więcej informacji znajdziesz w artykule Tworzenie i uruchamianie aplikacji.

   

   Rysunek 1. Aplikacja testowa została uruchomiona

7. 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 aplikacji build.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 pliku build.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 wpisu ndk.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++).

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:

1. Zainstaluj pakiet APK aplikacji Tuning Fork Monitor na urządzeniu docelowym za pomocą adb:

   adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
   

2. Otwórz aplikację do monitorowania.
3. Naciśnij przycisk ekranu głównego Androida, aby wysłać aplikację Tuning Fork Monitor do tła na urządzeniu.
4. Uruchom ponownie aplikację demonstracyjną na pierwszym planie na około 30 sekund.
5. Wróć do aplikacji Tuning Fork Monitor.
6. 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.

Rysunek 2. Aplikacja do monitorowania wykrywa aplikację demonstracyjną

Rysunek 3. Aplikacja do monitorowania wyświetla dane z aplikacji demonstracyjnej

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.

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

2. Pamiętaj, aby skopiować klucz interfejsu API z poprzedniego kroku do pola api_key w gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt.

3. 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"
   

4. Wyczyść projekt (Kompilacja > Oczyść projekt) i odśwież połączone projekty w C++ (Kompilacja > Odśwież połączone projekty C++).

5. Utwórz konfigurację podpisywania na potrzeby kompilacji wersji.

   1. Wybierz Plik > Struktura projektu > Moduły.
   2. Wybierz kartę Signing Configs (Konfiguracje podpisywania).
   3. Dodaj nową konfigurację o nazwie release.
   4. Utwórz magazyn kluczy na potrzeby konfiguracji.

6. Powiąż konfigurację podpisywania wersji z wariantem kompilacji wersji.

   1. Wybierz Plik > Struktura projektu > Warianty kompilacji.
   2. Kliknij kartę Typy kompilacji.
   3. Wybierz typ kompilacji o nazwie release.
   4. W polu Konfiguracja podpisywania wybierz zmienną konfiguracji wersji.

7. W oknie projektu Android Studio wybierz katalog app. Spowoduje to włączenie opcji menu w następnym kroku.

8. Zmień aktywny wariant kompilacji na release (Kompilacja > Wybierz wariant kompilacji).

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

10. Utwórz w Konsoli Google Play nową aplikację w wersji demonstracyjnej. Więcej informacji znajdziesz w artykule Przesyłanie aplikacji.

11. Prześlij plik APK wersji na ścieżkę testów wewnętrznych. Więcej informacji znajdziesz w artykule o przygotowywaniu i wdrażaniu wersji.

    Uwaga: plik APK musisz przesłać na ścieżkę testu wewnętrznego w Google Play. Jeśli tego nie zrobisz, filtry prywatności zablokują wyświetlanie powiązanego wykresu.

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 {}

Uwaga: pamiętaj, aby uruchomić wariant kompilacji wersji. W przeciwnym razie dane nie zostaną przesłane do Konsoli Google Play.

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.