Ведение лога отладки для ЕдиногоАгента: различия между версиями

Текущая версия от 19:28, 2 января 2025

Модули платформы / Цифровой опыт / Мобильные приложения / Инструментальные приложения для Android / Ведение лога отладки для ЕдиногоАгента

Активируйте ведение лога отладки для устранения неполадок ЕдиногоАгента .

Не включайте ведение лога отладки для рабочих приложений.

Используйте флаги отладки явно для целей отладки, а не для производства. Удалите эти флаги при создании PlayStore или производственного приложения, поскольку дополнительное ведение лога может замедлить работу вашего мобильного приложения или записывать конфиденциальную информацию в логи устройства.

Активировать режим ведения лога отладки

Вы можете активировать логи отладки с помощью подключаемого модуля AppOptima Android Gradle или ЕдиныйАгент SDK для Android.

Плагин AppOptima для Android Gradle

Включите ведение лога отладки через agentLoggingсвойство.

Groovy:

<AppOptima {
    configurations {
        sampleConfig {
            debug {
                agentLogging true
            }
        }
    }
}

Kotlin:

<configure<com.AppOptima.tools.android.dsl.AppOptimaExtension> {
    configurations {
        create("sampleConfig") {
            debug {
                agentLogging(true)
            }
        }
    }
}

ЕдиныйАгент SDK

Включите ведение лога отладки с помощью ConfigurationBuilder.withDebugLogging(boolean)метода.

Java:

<AppOptima.startup(this, new AppOptimaConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconURL>")
  .withDebugLogging(true)
  .buildConfiguration());

Kotlin:

<AppOptima.startup(this, AppOptimaConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconURL>")
  .withDebugLogging(true)
  .buildConfiguration())

Получить логи с устройства

ЕдиныйАгент для Android использует структуру логов по умолчанию из Android. Вы можете использовать окно Logcat в Android Studio или инструмент командной строки logcat для просмотра сообщений лога.

Чтобы получить логи Android через окно Logcat в Android Studio

Подключите устройство к компьютеру или запустите эмулятор. Обратите внимание, что ваше устройство должно быть настроено для разработки .
В Android Studio перейдите в View > Tool Windows > Logcat и выберите свое устройство.
Создайте фильтр.

Новый Logсat:

Выполните следующие действия, если вы включили новый инструмент Logcat в Android Studio Dolphin или используете Android Studio Electric Eel.

Введите tag~:^dtx|^caaв поле фильтра.
Если вы изменили параметр форматирования, переключитесь на стандартное представление по умолчанию .

Предыдущий Logcat:

Выполните следующие действия, если вы используете предыдущую версию Logcat.

Введите имя фильтра, например AppOptima OneAgent , в поле Имя фильтра .
Введите ^dtx|^caaрегулярное выражение в поле Тег лога .

4. Запустите инструментированное приложение, используя флаги отладки.

5. Скопируйте и вставьте строки лога в текстовый файл.

@@ Строка 1: / Строка 1: @@
+'''''[[Модули платформы]] / [[Модули платформы|Цифровой опыт]] / [https://docs.expert-apm.ru/index.php/%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D1%8B#:~:text=%D0%9C%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F Мобильные приложения] / [https://docs.expert-apm.ru/index.php/%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D1%8B#:~:text=%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%20%D0%B4%D0%BB%D1%8F%20Android Инструментальные приложения для Android] / Ведение лога отладки для ЕдиногоАгента'''''
 Активируйте ведение лога отладки для устранения неполадок ЕдиногоАгента .
@@ Строка 6: / Строка 8: @@
 == Активировать режим ведения лога отладки ==
-Вы можете активировать логи отладки с помощью подключаемого модуля Astromkey Android Gradle или ЕдиныйАгент SDK для Android.
+Вы можете активировать логи отладки с помощью подключаемого модуля AppOptima Android Gradle или ЕдиныйАгент SDK для Android.
-=== Плагин Astromkey для Android Gradle ===
+=== Плагин AppOptima для Android Gradle ===
 Включите ведение лога отладки через <code>agentLogging</code>свойство.
 '''Groovy:'''
-  <code>astromkey {
+  <AppOptima {
       configurations {
           sampleConfig {
@@ Строка 20: / Строка 22: @@
           }
       }
-  }</code>
+  }
 '''Kotlin:'''
-  <code>configure<com.astromkey.tools.android.dsl.AstromkeyExtension> {
+  <configure<com.AppOptima.tools.android.dsl.AppOptimaExtension> {
       configurations {
           create("sampleConfig") {
@@ Строка 30: / Строка 32: @@
           }
       }
-  }</code>
+  }
 === ЕдиныйАгент SDK ===
@@ Строка 36: / Строка 38: @@
 '''Java:'''
-  <code>Astromkey.startup(this, new AstromkeyConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconURL>")
+  <AppOptima.startup(this, new AppOptimaConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconURL>")
     .withDebugLogging(true)
-    .buildConfiguration());</code>
+    .buildConfiguration());
 '''Kotlin:'''
-  <code>Astromkey.startup(this, AstromkeyConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconURL>")
+  <AppOptima.startup(this, AppOptimaConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconURL>")
     .withDebugLogging(true)
-    .buildConfiguration())</code>
+    .buildConfiguration())
 == Получить логи с устройства ==
@@ Строка 60: / Строка 62: @@
 * Если вы изменили параметр форматирования, переключитесь на стандартное представление по умолчанию .
-[[Файл:logc1.png]]
+[[Файл:logc1.png|1083x1083пкс]]
 '''Предыдущий Logcat:'''
@@ Строка 66: / Строка 68: @@
 Выполните следующие действия, если вы используете предыдущую версию Logcat.
-* Введите имя фильтра, например Astromkey OneAgent , в поле Имя фильтра .
+* Введите имя фильтра, например AppOptima OneAgent , в поле Имя фильтра .
 * Введите <code>^dtx|^caa</code>регулярное выражение в поле Тег лога .