IKuznetsov: Новая страница: « = Конфигурация = Настройка ЕдиногоАгента для '''iOS''' осуществляется преимущественно через файл конфигурации `Info.plist` вашего приложения. Такой подход позволяет определять параметры конфигурации во время сборки. В сценариях, требующих настройки во...»

2026-08-19T17:46:01Z

Новая страница: « = Конфигурация = Настройка ЕдиногоАгента для '''iOS''' осуществляется преимущественно через файл конфигурации <code>Info.plist</code> вашего приложения. Такой подход позволяет определять параметры конфигурации во время сборки. В сценариях, требующих настройки во...»

Новая страница

= Конфигурация =
Настройка ЕдиногоАгента для '''iOS''' осуществляется преимущественно через файл конфигурации <code>Info.plist</code> вашего приложения. Такой подход позволяет определять параметры конфигурации во время сборки. В сценариях, требующих настройки во время выполнения, можно использовать ручной запуск.

Чтобы файлы вашего приложения оставались <code>Info.plist</code> чистыми, вы можете переместить все ключи, связанные с ЕдинымАгентом, <code>DTX</code> в отдельный файл <code>Astromkey.plist</code>. Создайте этот файл в том же месте, что и ваш основной файл <code>Info.plist</code>, и добавьте его в этап сборки '''Copy Bundle Resources''' целевого приложения. Файл <code>Astromkey.plist</code> должен находиться в корне вашего пакета ресурсов. Для получения дополнительной информации см. файл <code>Info.plist</code>.

Полный список всех доступных ключей конфигурации см. в разделе «Ключи конфигурации iOS».

== Ключи конфигурации ==
В таблицах ниже перечислены наиболее часто используемые ключи конфигурации для '''iOS''' ЕдиногоАгента. Добавьте эти ключи в файл конфигурации <code>Info.plist</code> вашего приложения, чтобы настроить поведение ЕдиногоАгента.

=== Необходимая конфигурация ===
{| class="wikitable"
!Ключ конфигурации
!Тип
!Описание
|-
|<code>DTXApplicationID</code>
|String
|Уникальный идентификатор вашего приложения. Получите его с помощью мастера настройки инструментов Ключ-АСТРОМ.
|-
|<code>DTXBeaconURL</code>
|String
|URL-адрес конечной точки маяка для вашей среды Ключ-АСТРОМ. Получите его в мастере настройки инструментов Ключ-АСТРОМ.
|}

=== Общая конфигурация ===
{| class="wikitable"
!Ключ конфигурации
!Тип
!По умолчанию
!Описание
|-
|<code>DTXAutoStart</code>
|Boolean
|true
|При установке значения <code>true</code> ЕдиныйАгент запускается автоматически при запуске вашего приложения. Установите значение <code>false</code> для ручного запуска.
|-
|<code>DTXUserOptIn</code>
|Boolean
|false
|Если <code>true</code>, ЕдиныйАгент не собирает никаких данных, пока пользователь явно не даст на это согласие через <code>Astromkey.applyUserPrivacyOptions(...)</code>.
|-
|<code>DTXLogLevel</code>
|String
|OFF
|Управляет уровнем детализации логов ЕдиногоАгента. Значения: <code>ALL</code>, <code>INFO</code>, <code>WARNING</code>, <code>SEVERE</code>, <code>OFF</code>.
|}

=== Сообщения о сбоях и ANR ===
{| class="wikitable"
!Ключ конфигурации
!Тип
!По умолчанию
!Описание
|-
|<code>DTXCrashReportingEnabled</code>
|Boolean
|true
|Включает или отключает автоматическое формирование отчетов о сбоях.
|-
|<code>DTXANRReportingEnabled</code>
|Boolean
|true
|Включает или отключает обнаружение статуса «Приложение не отвечает» ('''ANR''').
|}

=== Инструментарий веб-запросов ===
{| class="wikitable"
!Ключ конфигурации
!Тип
!По умолчанию
!Описание
|-
|<code>DTXInstrumentWebRequestTiming</code>
|Boolean
|true
|Включает или отключает автоматическую проверку веб-запросов.
|-
|<code>DTXURLFilters</code>
|Array
|[]
|Набор шаблонов URL-адресов, которые следует исключить из автоматической инструментации. Поддерживаются подстановочные знаки.
|}

=== Инструментарий для просмотра и управления жизненным циклом ===
{| class="wikitable"
!Ключ конфигурации
!Тип
!По умолчанию
!Описание
|-
|<code>DTXInstrumentLifecycleMonitoring</code>
|Boolean
|true
|Включает или отключает автоматический мониторинг жизненного цикла представлений для подклассов <code>UIViewController</code>.
|-
|<code>DTXExcludedLifecycleClasses</code>
|Array
|[]
|Массив имен классов <code>UIViewController</code>, которые следует исключить из мониторинга жизненного цикла.
|}
Дополнительные параметры конфигурации, включая мониторинг действий пользователя, настройки гибридных приложений, отслеживание местоположения и привязку сертификатов, см. в разделе «Ключи конфигурации iOS».

== Пример конфигурации ==
В следующем примере показана типичная конфигурация <code>Info.plist</code>:

'''Пример конфигурации Info.plist'''<pre>
<key>DTXApplicationID</key>
<string>ВАШ_ИД_ЗАЯВЛЕНИЯ</string>
<key>DTXBeaconURL</key>
<string>https://your-environment.astromkey.com/mbeacon</string>
<key>DTXLogLevel</key>
<string>OFF</string>
<key>DTXCrashReportingEnabled</key>
<true/>
<key>DTXInstrumentWebRequestTiming</key>
<true/>
<key>DTXUserOptIn</key>
<false/>
</pre>

== Ручной запуск ==
По умолчанию ЕдиныйАгент запускается автоматически при запуске вашего приложения. Если вам необходимо настроить такие параметры, как <code>beaconUrl</code> или <code>applicationId</code> во время выполнения, вы можете использовать ручной запуск.

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

=== Отключить автоматический запуск ===
Во-первых, отключите автоматический запуск в вашей системе <code>Info.plist</code>:<pre>
<key>DTXAutoStart</key>
<false/>
</pre>

=== Запустите ЕдиныйАгент вручную ===
Вызовите функцию <code>Astromkey.startupWithConfig(...)</code> как можно раньше в жизненном цикле вашего приложения — в идеале, на этапе <code>application(_:didFinishLaunchingWithOptions:)</code>.

'''Swift'''<pre>
import Astromkey

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
Astromkey.startupWithConfig([
kDTXApplicationID: "YOUR_APPLICATION_ID",
kDTXBeaconURL: "https://your-environment.astromkey.com/mbeacon"
])
return true
}
}
</pre>'''Objective-C'''<pre>
@import Astromkey;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[Astromkey startupWithConfig:@{
kDTXApplicationID: @"YOUR_APPLICATION_ID",
kDTXBeaconURL: @"https://your-environment.astromkey.com/mbeacon"
}];
return YES;
}

@end
</pre>

=== Стартап с дополнительными опциями ===
Дополнительные параметры конфигурации можно передавать при ручном запуске, используя те же ключи, что и в следующем примере <code>Info.plist</code>:

'''Swift'''<pre>
Astromkey.startupWithConfig([
kDTXApplicationID: "YOUR_APPLICATION_ID",
kDTXBeaconURL: "https://your-environment.astromkey.com/mbeacon",
kDTXCrashReportingEnabled: true,
kDTXLogLevel: "INFO",
kDTXAllowAnyCert: false,
kDTXUserOptIn: false
])
</pre>'''Objective-C'''<pre>
[Astromkey startupWithConfig:@{
kDTXApplicationID: @"YOUR_APPLICATION_ID",
kDTXBeaconURL: @"https://your-environment.astromkey.com/mbeacon",
kDTXCrashReportingEnabled: @YES,
kDTXLogLevel: @"INFO",
kDTXAllowAnyCert: @NO,
kDTXUserOptIn: @NO
}];
</pre>Переданные значения <code>Astromkey.startupWithConfig(...)</code> имеют приоритет над настройками <code>Info.plist</code>. Любые настройки, не включенные в словарь, будут использоваться в качестве значений по умолчанию из <code>Info.plist</code>. Убедитесь, что автозапуск отключен, если вы планируете запускать агента вручную.

== Ведение отладочного логирования ==
Включите отладочное логирование для устранения неполадок, связанных со сбором данных или инициализацией агента. Это позволит получать подробные данные от ЕдиногоАгента в системных журналах вашего устройства.

Отладочное логирование предназначено исключительно для целей разработки и устранения неполадок. Не включайте его в производственной среде.

=== Включить отладочное логирование ===
Чтобы включить отладочное логирование для '''iOS''', добавьте ключ конфигурации <code>DTXLogLevel</code> в файл <code>Info.plist</code> вашего приложения:<pre>
<key>DTXLogLevel</key>
<string>ALL</string>
</pre>В качестве альтернативы, можно включить ведение журнала программно при ручном запуске:

'''Swift'''<pre>
Astromkey.startupWithConfig([
kDTXApplicationID: "YOUR_APPLICATION_ID",
kDTXBeaconURL: "https://your-environment.astromkey.com/mbeacon",
kDTXLogLevel: "ALL"
])
</pre>'''Objective-C'''<pre>
[Astromkey startupWithConfig:@{
kDTXApplicationID: @"YOUR_APPLICATION_ID",
kDTXBeaconURL: @"https://your-environment.astromkey.com/mbeacon",
kDTXLogLevel: @"ALL"
}];
</pre>

Конфигурация IOS - История изменений