Uruchamianie aplikacji demonstracyjnej

Na tej stronie dowiesz się, jak przeprowadzić kompleksowy test za pomocą aplikacji w wersji demonstracyjnej Konsola Google Play.

Kroki

Aby pobrać pakiet SDK, uruchom aplikację w wersji demonstracyjnej, sprawdź, czy aplikacja działa prawidłowo. wyświetlić informacje o czasie renderowania klatek z aplikacji w Konsoli Google Play, :

1. Pobierz plik ZIP pakietu SDK i rozpakuj go.
2. Utwórz i uruchom aplikację w wersji demonstracyjnej.
3. Uruchom aplikację do monitorowania.
4. Utwórz kompilację wersji.
5. Uruchom kompilację wersji.
6. Wyświetl wykresy w Konsoli Google Play.

Utwórz i uruchom aplikację w wersji demonstracyjnej

Uruchom aplikację w wersji demonstracyjnej APT Insights w Android Studio, aby sprawdzić, czy wszystko jest w porządku. niezbędną kompilację. Ten projekt używa CMake do tworzenia kodu natywnego i pokazuje, z pliku gamesdk.cmake – jest to najprostszy sposób na pierwsze kroki.

Aby uruchomić aplikację w wersji demonstracyjnej:

1. Rozpakuj zawartość pliku ZIP do folderu.
2. Otwórz Android Studio.
3. Kliknij 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 opcje programisty i debugowanie USB włączone urządzenia.

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

   .

   .

7. Przykładowy plik APK powinien skompilować i zainstalować na urządzeniu docelowym. Jeśli sprawdź, czy występują błędy:

   • Masz obsługiwaną wersję Androida. SDK; zobacz pole compileSdkVersion w module aplikacji build.gradle . Dostępne opcje zaktualizuj wersję pakietu SDK z Karta Platformy SDK w Menedżerze pakietów SDK.
   • Masz obsługiwaną wersję Androida. NDK zobacz pole ndkVersion w pliku build.gradle modułu aplikacji . Dostępne opcje zainstalować konkretną wersję pakietu NDK na karcie Narzędzia SDK w Menedżerze pakietów SDK.
   • Plik local.properties w projekcie nie zawiera wpisu dotyczącego ndk.dir Ta lokalizacja jest określana przez Android Studio i używa klucza NDK powyżej. Jeśli masz ten wpis, wyczyść cały wiersz.
   • Po każdej zmianie ustawień kompilacji wyczyść projekt (Kompilacja > Oczyść) projektu) i odśwież połączone projekty C++ (Kompilacja > Odśwież połączone projekty) Projekty C++).

Uruchom aplikację monitora

W przypadku kompilacji do debugowania aplikacji w wersji demonstracyjnej lub innej aplikacji obsługującej Tuning Fork możesz skonfigurować aplikację tak, aby wysyłała i odbierała dane z lokalnego punktu końcowego, niż serwer Google Play. Aby to zrobić, ustaw endpoint_uri_override w ustawienia Tuning Fork:

#ifndef NDEBUG
   settings.endpoint_uri_override = "http://localhost:9000";
#endif

Musisz też uwzględnić te uprawnienia w AndroidManifest.xml plik:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Aplikacja w wersji demonstracyjnej ma już te zmiany (zobacz insightsdemo.cpp).

Za pomocą tej funkcji możesz sprawdzić, czy aplikacja wysyła i odbiera odpowiednie dane. Aby to sprawdzić, uruchom aplikację w wersji demonstracyjnej i aplikację Tuning Fork Monitor pod adresem o tej samej nazwie. Ta aplikacja do monitorowania działa jako serwer lokalny i wyświetla dane które tworzy aplikacja z obsługą Tuning Fork.

Równoczesne uruchamianie aplikacji do monitorowania i aplikacji demonstracyjnej w celu sprawdzenia, czy wersja demonstracyjna Aplikacja działa prawidłowo, wykonaj te czynności:

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

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

2. Otwórz aplikację do monitorowania.
3. Naciśnij przycisk ekranu głównego na urządzeniu z Androidem, by wysłać aplikację Tuning Fork Monitor do w tle urządzenia.
4. Uruchom ponownie aplikację w wersji demonstracyjnej na pierwszym planie przez około 30 sek.
5. Wróć do aplikacji Tuning Fork Monitor.
6. Aplikacja w wersji demonstracyjnej znajduje się w sekcji Aktywne aplikacje jako com.tuningfork.insightsdemo 16 Kliknij ten wpis, aby zobaczyć szczegóły aplikacji i transmitować na żywo dane telemetryczne.

Tworzenie kompilacji wersji

Utwórz kompilację wersji demonstracyjnej aplikacji w Android Studio. Przesyłasz tę kompilację w Konsoli Google Play, aby włączyć wykresy czasu renderowania klatek w Android Vitals.

1. Włączanie interfejsu Android Performance Parameters API w konsoli Google Cloud. Ten interfejs API umożliwia aplikacji komunikowanie się z Google Play. Nie musisz ograniczać klucza interfejsu API w przypadku aplikacji w wersji demonstracyjnej.

2. Pamiętaj, aby skopiować klucz interfejsu API z poprzedniego kroku do api_key w polu 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 używa . Zmień ten identyfikator w pliku build.gradle aplikacji:

   applicationId "com.tuningfork.your-unique-identifier"
   

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

5. Utwórz konfigurację podpisywania dla 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 dla konfiguracji.

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

   1. Wybierz Plik > Struktura projektu > Utwórz warianty.
   2. Wybierz kartę Typy kompilacji.
   3. Wybierz typ kompilacji o nazwie release.
   4. W polu Konfiguracja podpisywania wybierz konfigurację wersji. .

7. W oknie projektu Android Studio wybierz katalog app. (Ten umożliwia wybór menu w następnym kroku).

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

9. Wybierz Kompilacja > Pakiety / pliki APK > Utwórz pliki APK. Podczas tworzenia kliknij link locate (Znajdź), by odszukać plik APK wersji.

10. Utwórz nową aplikację dla wersji demonstracyjnej w Konsoli Google Play. Dla: więcej informacji znajdziesz w Prześlij aplikację.

11. Prześlij pakiet APK wersji na ścieżkę testu wewnętrznego. Aby dowiedzieć się więcej, zobacz Przygotowanie i i wdrażać nowe wersje.

Uruchom kompilację wersji

Wybierz urządzenie docelowe i kliknij Uruchom. Musisz użyć tego samego pliku APK, który został przesłany do Konsola Google Play.

Pozwól aplikacji w wersji demonstracyjnej przez jakiś czas działać. Może minąć do 30 minut, zanim Konsola Play, aby zacząć wyświetlać dane. Sprawdź, czy dane są przesyłane do serwera, wybierając poziom logowania Info w oknie Logcat. Jeśli zobaczysz komunikat z błędami w dzienniku, zobacz 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świetl wykresy w Konsoli Google Play

Otwórz Konsolę Google Play i wybierz aplikację testową. Wybierz Android Vitals > Skuteczność > Statystyki, aby zobaczyć wykres czasu renderowania klatek.

Rysunek 4. Wykres Android Vitals

Udało Ci się przeprowadzić kompleksowy test za pomocą Tuning Fork bibliotece. Testowy projekt aplikacji możesz usunąć w Konsoli Google Play, nie jest już potrzebna.