Другие API tvOS

Статья
03/15/2024

Важно!

Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio, пока он не будет полностью выведен из эксплуатации, существует несколько рекомендуемых вариантов, на которые вы можете рассмотреть возможность миграции.

Узнайте больше о сроках поддержки и альтернативных вариантах.

Настройка уровня журнала

Вы можете управлять количеством сообщений журнала, отображаемых в Центре приложений в консоли. setLogLevel:Используйте -API, чтобы включить дополнительное ведение журнала во время отладки. По умолчанию для среды App Store задано значение LogLevelAssert и LogLevelWarning в противном случае.

Чтобы иметь как можно больше сообщений журнала, используйте MSACLogLevelVerbose/LogLevel.verbose.

[MSACAppCenter setLogLevel:MSACLogLevelVerbose];

AppCenter.logLevel = .verbose

Определение установок

Пакет SDK центра приложений создает UUID для каждого устройства после установки приложения. Этот идентификатор остается прежним для устройства при обновлении приложения, а новый идентификатор создается только при повторной установке приложения. Следующий API полезен для отладки.

NSUUID *installId = [MSACAppCenter  installId];

var installId = AppCenter.installId

Идентификация пользователей

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

Настройте пакет SDK центра приложений, вызвав метод :start:withServices: , как описано в руководстве по началу работы с пакетом SDK центра приложений.
userID Задайте в пакете SDK с помощью следующего кода:

[MSACAppCenter setUserId:@"your-user-id"];

AppCenter.userId = "your-user-id"

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

Примечание

Значение идентификатора пользователя ограничено 256 символами. Он будет отображаться вместе с отчетами о сбоях, но не будет использоваться для агрегирования или количества затронутых пользователей. Если вы задали идентификатор пользователя несколько раз, будет использоваться только последний идентификатор пользователя. Необходимо самостоятельно задавать идентификатор пользователя перед каждым запуском приложения, так как это значение не хранится в пакете SDK между запусками.

Отключение всех служб во время выполнения

Если вы хотите отключить все службы Центра приложений setEnabled одновременно, используйте API. Если он отключен, пакет SDK не будет пересылать какие-либо сведения в Центр приложений.

[MSACAppCenter setEnabled:NO];

AppCenter.enabled = false

Чтобы снова включить все службы, используйте тот же API, но передайте YES/true в качестве параметра.

[MSACAppCenter setEnabled:YES];

AppCenter.enabled = true

Состояние сохраняется в хранилище устройства при запуске приложений.

Примечание

Этот метод следует использовать только после AppCenter запуска.

Запретить сетевые запросы

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

[MSACAppCenter setNetworkRequestsAllowed:false];

AppCenter.networkRequestsAllowed = false

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

[MSACAppCenter setNetworkRequestsAllowed:true];

AppCenter.networkRequestsAllowed = true

Примечание

Это значение сохраняется между запусками.

В любое время можно проверка, разрешена ли отправка данных в пакете SDK центра приложений.

[MSACAppCenter isNetworkRequestsAllowed];

AppCenter.networkRequestsAllowed

Изменение состояния службы в среде выполнения

Включите или отключите службы в среде выполнения с помощью следующего кода:

[MSACAnalytics setEnabled:NO];

Analytics.enabled = false

Примечание

Этот метод следует использовать только после Analytics запуска.

Проверьте, включен ли Центр приложений

Вы также можете проверка, включен ли Центр приложений.

[MSACAppCenter isEnabled];

AppCenter.enabled

Примечание

Этот метод следует использовать только после AppCenter запуска. Он всегда возвращается false перед запуском.

Проверка версии пакета SDK центра приложений во время выполнения

Вы можете получить версию пакета SDK центра приложений, который вы используете в настоящее время.

[MSACAppCenter sdkVersion];

AppCenter.sdkVersion

Объем памяти

При использовании пакета SDK центра приложений журналы хранятся локально на устройстве. Большие журналы могут занимать много места, поэтому вы можете ограничить размер локальной базы данных. Это также полезно в сочетании pause с API и resume . Если предполагается, что она будет приостановлена в течение длительного времени, можно использовать базу данных большего размера для хранения дополнительных событий.

setMaxStorageSize Используйте API, чтобы задать размер локальной базы данных. API является асинхронным, и completionHandler вызывается при запуске служб Центра приложений. По этой причине setMaxStorageSize необходимо вызвать перед вызовом AppCenter.start. Api можно вызвать только один раз.

// Use 20 MB for storage.
[MSACAppCenter setMaxStorageSize:(20 * 1024 * 1024) completionHandler:^(BOOL success) {
    if (!success) {
        // The success parameter is false when the size can't be honored.
    }
}];
[MSACAppCenter start:@"{Your App Secret}", withServices:@[[MSACAnalytics class]]];

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024, completionHandler: { (success) in
    if !success {
        // The success parameter is false when the size can't be honored.
    }
})
AppCenter.start(withAppSecret: "{Your App Secret}", services:[Analytics.self])

Если не задать максимальный размер хранилища, пакет SDK использует максимальный размер по умолчанию 10 МБ. Минимальный размер, который вы можете задать, составляет 20 КБ.

Примечание

Фактический максимальный размер хранилища может быть немного больше выбранного значения. SQLite округляет размер до следующего, кратного размеру страницы. Пакет SDK центра приложений использует размер страницы 4 КБ.

Примечание

Журналы старше 25 дней будут удалены.

Неудачные вызовы API

Существует множество причин, по которым completionHandler вызов может возвращать значение false.

Указанный размер является недопустимым значением (менее 20 КБ или больше 140 ТБ).
Текущий размер базы данных больше указанного максимального размера.
API уже был вызван. Его можно настроить только один раз для каждого процесса.
API был вызван после AppCenter.start или AppCenter.configure.

Вы можете проверка предупреждения и ошибки в консоли с помощью тега AppCenter журнала для устранения неполадок с конфигурацией.

Поделиться через

Другие API tvOS

Настройка уровня журнала

Определение установок

Идентификация пользователей

Отключение всех служб во время выполнения

Запретить сетевые запросы

Изменение состояния службы в среде выполнения

Проверьте, включен ли Центр приложений

Проверка версии пакета SDK центра приложений во время выполнения

Объем памяти

Неудачные вызовы API

Дополнительные ресурсы