Другие API macOS
Важно!
Прекращение поддержки Центра приложений 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 центра приложений, которую вы используете в настоящее время.
[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 дней будут удалены.
Существует множество причин, по которым completionHandler
вызов может возвращать значение false.
- Указанный размер является недопустимым значением (менее 20 КБ или больше 140 ТБ).
- Текущий размер базы данных превышает указанный максимальный размер.
- API уже был вызван. Ее можно настроить только один раз для каждого процесса.
- API был вызван после
AppCenter.start
илиAppCenter.configure
.
Вы можете проверка предупреждения и ошибки в консоли с помощью тега AppCenter
log для устранения неполадок с конфигурацией.