Google стремится к продвижению расового равенства для чернокожего населения. Смотри как.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Начало работы с Performance Monitoring для Android

Прежде чем вы начнете

Если вы еще не сделали, добавить Firebase в свой Android проекта .

В вашем проектном уровне build.gradle file , не забудьте включить репозиторий Maven Google, как в вашем buildscript и allprojects секций.

Шаг 1: Добавьте Performance Monitoring SDK для вашего приложения

SDK Мониторинг производительности позволяет осуществлять мониторинг автоматических следов продолжительности и каких - либо дополнительных пользовательских следов в вашем приложении.

  1. В вашем модуле (приложение уровень) Gradle файл (обычно app/build.gradle ):

    // ...
    
    dependencies {
      // ...
    
      // Add the dependency for the Performance Monitoring library
      implementation 'com.google.firebase:firebase-perf:19.0.8'
    }
    
  2. Перекомпилируйте приложение.

Шаг 2: Добавьте плагин мониторинга для вашего приложения

Performance Monitoring Gradle плагин позволяет инструментария , который обеспечивает обработку @AddTrace аннотаций и автоматический HTTP / S мониторинг запросов сети .

Чтобы добавить Performance Monitoring плагин для вашего приложения:

  1. В вашем модуле (приложение уровня) Gradle файл (обычно app/build.gradle ), применять плагин для мониторинга производительности:

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services'
    // Apply the Performance Monitoring plugin
    apply plugin: 'com.google.firebase.firebase-perf'
    
    android {
      // ...
    }
    
  2. В корневом уровне ( на уровне проекта) Gradle файл ( build.gradle ), добавьте правила для включения мониторинга производительности плагина.

    buildscript {
    
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // Add the Bintray repository
          jcenter()
        }
    
        dependencies {
          // ...
    
          // To benefit from the latest Performance Monitoring plugin features,
          // update your Android Gradle Plugin dependency to at least v3.4.0
          classpath 'com.android.tools.build:gradle:3.4.0'
    
          classpath 'com.google.gms:google-services:4.3.3'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.3.1'  // Performance Monitoring plugin
        }
    }
    
  3. Перекомпилируйте приложение.

Шаг 3: Генерация события производительности для начального отображения данных

Firebase может обнаружить, что вы успешно добавили SDK в приложение, когда он получает информацию о событии (например, приложения взаимодействия) из вашего приложения. Если вы все еще развивается локально, взаимодействуют с вашим приложением, чтобы генерировать события для обнаружения SDK, а также первоначального сбора и обработки данных.

  1. Продолжать развивать приложение, используя эмулятор или тестовое устройство, которое отвечает следующим требованиям:

    • Android эмулятор с недавним изображением и услуг Play Google 15.0.0 или более поздней версии

    • Тест устройство со службами Google Play 15.0.0 или более поздняя версия

  2. Генерация события пути переключения вашего приложения между фоном и передним планом несколько раз, взаимодействуя с приложением с помощью навигации по экранам, и / или запуска сетевых запросов.

  3. Перейти к разделу производительности консоли Firebase , чтобы увидеть , если Firebase распознал SDK.

    Если вы не видите «SDK обнаружен» сообщения в течение 2 часов после добавления SDK для вашего приложения, ознакомьтесь с советами по устранению неполадок .

  4. Мониторинг производительности обрабатывает данные о событиях производительности перед отображением на приборной панели Performance . Вы должны увидеть начальный вывод данных в течение 24 часов, появляется сообщение обнаружения SDK.

    Если вы не видите отображение ваших исходных данных, просмотрите советы по устранению неполадок .

Шаг 4: (Необязательно) Просмотр сообщения журнала для событий производительности

  1. Включить ведение журнала отладки для мониторинга эффективности во время сборки, добавив <meta-data> элемент вашего приложения AndroidManifest.xml файл, например так:

    <application>
        <meta-data
          android:name="firebase_performance_logcat_enabled"
          android:value="true" />
    </application>
    
  2. Проверьте ваши сообщения журнала для сообщений об ошибках.

  3. Мониторинг производительности теги регистрируемых сообщений с FirebasePerformance . Использование фильтрации LogCat, вы можете конкретно просмотреть продолжительность трассировки и HTTP / S сеть протоколирования запрос, выполнив следующую команду:

    adb logcat -s FirebasePerformance
  4. Проверьте наличие следующих типов журналов, которые показывают, что мониторинг производительности регистрируют события производительности:

    • Logging trace metric: TRACE_NAME
    • Logging network request trace: URL

Если ваше приложение не регистрирует события производительности, просмотрите советы по устранению неполадок .

Шаг 5: (Необязательно) Добавьте пользовательский мониторинг для конкретного кода

Вы можете создавать собственные следы , чтобы контролировать данные о производительности , связанные с определенным кодом в вашем приложении.

С пользовательской трассировки, вы можете измерить, сколько времени требуется приложение для выполнения конкретной задачи или набора задач, таких как загрузка набора изображений или запросов к базе данных. По умолчанию метрики для пользовательской трассировки является его продолжительностью, но вы также можете добавлять собственные показатели, такие как обращения в кэше и предупреждения памяти.

В коде, вы определяете начало и конец пользовательской трассировки (и добавить любые необходимые пользовательские метрики), используя API, предоставленный мониторинг производительности SDK. Для приложений Android, вы также можете отслеживать продолжительность конкретных методов с использованием @AddTrace аннотации .

Посещение Добавить мониторинг для конкретного кода приложения на заказ , чтобы узнать больше об этих функциях и как добавить их к вашему приложению.

Шаг 6: Развертывание приложение затем результаты обзора

После того, как вы проверили производительность мониторинга с помощью одного или нескольких тестовых устройств, вы можете развернуть обновленную версию приложения для пользователей.

Вы можете отслеживать данные о производительности в приборной панели Performance консоли Firebase.

Известные проблемы

  • Performance Monitoring Gradle плагин v1.1.0 может привести к несоответствию в гуавы зависимостей, что приводит к следующей ошибке:

    Error:Execution failed for task ':app:packageInstantRunResourcesDebug'.
    > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

    Если вы видите эту ошибку, вы можете:

    • Обновление мониторинга производительности плагина v1.1.1 или более поздняя версия (последний является v1.3.1).

    • Заменить Performance Monitoring плагин линии зависимостей в корневом уровне ( на уровне проекта) Gradle файла ( build.gradle ), следующим образом :

      buildscript {
        // ...
      
        dependencies {
          // ...
      
          // Replace the standard Performance Monitoring plugin dependency line, as follows:
          classpath ('com.google.firebase:perf-plugin:1.1.0') {
                      exclude group: 'com.google.guava', module: 'guava-jdk5'
          }
        }
      }
      
  • Отчеты о мониторинге производительности общего размера полезной нагрузки для HTTP / S сетевых запросов, основанных на множестве значений в заголовке HTTP Content-Length. Это значение не всегда может быть точным.

  • Производительность Мониторинг поддерживает только основной процесс в нескольких технологических приложениях Android.

Следующие шаги