Запустите демонстрационное приложение

На этой странице описано, как запустить сквозное тестирование с помощью демонстрационного приложения и консоли Google Play.

Шаги

Чтобы загрузить SDK, запустить демонстрационное приложение, убедиться, что приложение работает правильно, и просмотреть информацию о синхронизации кадров из приложения в консоли Google Play, выполните следующие действия:

1. Загрузите ZIP-файл SDK и разархивируйте его.
2. Создайте и запустите демонстрационное приложение.
3. Запустите приложение монитора.
4. Создайте сборку релиза.
5. Запустите сборку релиза.
6. Просмотрите графики в консоли Google Play.

Создайте и запустите демонстрационное приложение

Запустите демонстрационное приложение APT Insights в Android Studio, чтобы убедиться, что все построено правильно. В этом проекте используется CMake для создания собственного кода, и показано, как использовать файл gamesdk.cmake , который является самым простым способом начать работу.

Чтобы запустить демонстрационное приложение, сделайте следующее:

1. Извлеките содержимое файла .zip в папку.
2. Откройте Android-студию.
3. Нажмите «Файл» > «Открыть» и выберите gamesdk/samples/tuningfork/insightsdemo/build.gradle .
4. Подождите, пока Android Studio синхронизирует проект.
5. Подключите устройство (или создайте виртуальное устройство ), чтобы запустить образец. Включите параметры разработчика и отладку по USB на устройстве.

6. Выберите целевое устройство и нажмите « Выполнить». . Дополнительные сведения см. в разделе Создание и запуск приложения .

   

7. Образец APK должен быть собран и установлен на целевом устройстве. Если вы столкнулись с ошибками, проверьте следующее:

   • У вас есть поддерживаемая версия Android SDK; дополнительную информацию см. в поле compileSdkVersion в файле build.gradle модуля приложения. Вы можете обновить версию SDK на вкладке «Платформы SDK» в диспетчере SDK.
   • У вас есть поддерживаемая версия Android NDK; дополнительную информацию см. в поле ndkVersion в файле build.gradle модуля приложения. Вы можете установить определенную версию NDK на вкладке «Инструменты SDK» в диспетчере SDK.
   • В файле local.properties проекта нет записи для ndk.dir . Это расположение указывается Android Studio и использует версию NDK, указанную выше. Если у вас есть эта запись, очистите всю строку.
   • После любого изменения параметров сборки очистите проект ( Сборка > Очистить проект ) и обновите связанные проекты C++ ( Сборка > Обновить связанные проекты C++ ).

Запустите приложение монитора

С помощью отладочной сборки демонстрационного приложения или любого другого приложения с поддержкой Tuning Fork вы можете настроить приложение для отправки и получения данных с локальной конечной точки, а не с сервера Google Play. Для этого установите endpoint_uri_override в настройках камертона:

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

Вы также должны включить следующие разрешения в файл AndroidManifest.xml :

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

В демо-приложении уже есть эти изменения (см. insightsdemo.cpp ).

Вы можете использовать эту функцию, чтобы убедиться, что приложение отправляет и получает правильные данные. Чтобы убедиться в этом, одновременно запустите демонстрационное приложение и приложение Tuning Fork Monitor. Это приложение для мониторинга действует как локальный сервер и отображает данные, которые производит приложение с поддержкой Tuning Fork.

Чтобы одновременно запустить приложение мониторинга и демонстрационное приложение и убедиться, что демонстрационное приложение работает правильно, выполните следующие действия:

1. Установите APK-файл приложения Tuning Fork Monitor на целевое устройство с помощью adb :

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

2. Откройте приложение мониторинга.
3. Нажмите кнопку Android Home, чтобы перевести приложение Tuning Fork Monitor в фоновый режим на устройстве.
4. Снова запустите демонстрационное приложение на переднем плане примерно на 30 секунд.
5. Вернитесь в приложение Tuning Fork Monitor.
6. Демо-приложение отображается в разделе « Живые приложения» как com.tuningfork.insightsdemo 16 . Коснитесь этой записи, чтобы просмотреть сведения о приложении и телеметрию в реальном времени.

Создать сборку выпуска

Создайте выпускную сборку демонстрационного приложения в Android Studio. Вы загружаете эту сборку в консоль Google Play, чтобы включить графики синхронизации кадров в Android Vitals.

1. Включите API параметров производительности Android в Google Cloud Console. Этот API позволяет приложению взаимодействовать с Google Play. Вам не нужно ограничивать ключ API для демонстрационного приложения.

2. Обязательно скопируйте ключ API из предыдущего шага в поле api_key в gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt .

3. Идентификатор приложения демонстрационного приложения зарезервирован, поэтому невозможно загрузить APK, который его использует. Измените этот идентификатор в файле build.gradle приложения:

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

4. Очистите проект ( Сборка > Очистить проект ) и обновите связанные проекты C++ ( Сборка > Обновить связанные проекты C++ ).

5. Создайте конфигурацию подписи для сборок выпуска.

   1. Выберите «Файл» > «Структура проекта» > «Модули» .
   2. Выберите вкладку «Конфигурации подписи» .
   3. Добавьте новую конфигурацию с именем release .
   4. Создайте хранилище ключей для конфигурации.

6. Свяжите конфигурацию подписи выпуска с вариантом сборки выпуска.

   1. Выберите «Файл» > «Структура проекта» > «Варианты сборки» .
   2. Выберите вкладку «Типы сборки» .
   3. Выберите тип сборки с именем release .
   4. В поле «Конфигурация подписи» выберите переменную конфигурации выпуска.

7. В окне проекта Android Studio выберите каталог приложения . (Этот выбор позволяет выбрать меню на следующем шаге.)

8. Измените активный вариант сборки на release ( Сборка > Выбрать вариант сборки ).

9. Выберите «Сборка» > «Создать пакеты/APK» > «Создать APK» . Когда сборка завершится, щелкните ссылку «Найти» , чтобы найти APK-файл выпуска.

10. Создайте новое приложение для демонстрационного приложения в консоли Google Play. Дополнительную информацию см. в разделе «Загрузка приложения» .

11. Загрузите релизный APK-файл на дорожку внутреннего тестирования . Дополнительные сведения см. в разделе Подготовка и выпуск выпусков .

Запустите сборку релиза

Выберите целевое устройство и нажмите « Выполнить». . Вы должны использовать тот же APK-файл выпуска, который вы загрузили в консоль Google Play.

Дайте демо-приложению поработать некоторое время. Прежде чем консоль Google Play начнет отображать данные, может пройти до 30 минут. Убедитесь, что данные загружаются на сервер, выбрав уровень журнала «Информация» в окне Logcat . Если вы видите ошибки в журнале, см. раздел Устранение распространенных ошибок .

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

Просмотрите графики в консоли Google Play.

Откройте консоль Google Play и выберите тестовое приложение. Выберите Android Vitals > Производительность > Аналитика, чтобы просмотреть график времени кадра.

Рисунок 4. График Android Vitals

Вы успешно выполнили сквозной тест с библиотекой Tuning Fork. Вы можете удалить проект тестового приложения в консоли Google Play, так как он больше не нужен.