Другие API UWP и WinUI
Важно!
Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio, пока он не будет полностью выведен из эксплуатации, существует несколько рекомендуемых вариантов, на которые вы можете рассмотреть возможность миграции.
Узнайте больше о сроках поддержки и альтернативных вариантах.
Вы можете управлять количеством сообщений журнала, отображаемых в Центре приложений в консоли. Используйте API, LogLevel
чтобы включить дополнительное ведение журнала во время отладки. По умолчанию для App Store сред задано значение ASSERT
и WARN
в противном случае.
Чтобы иметь как можно больше сообщений журнала, используйте LogLevel.Verbose
.
AppCenter.LogLevel = LogLevel.Verbose;
Пакет SDK центра приложений создает UUID для каждого устройства после установки приложения. Этот идентификатор остается прежним для устройства при обновлении приложения, а новый идентификатор создается только при повторной установке приложения. Следующий API полезен для отладки.
System.Guid? installId = await AppCenter.GetInstallIdAsync();
Пакет SDK центра приложений поддерживает настройку идентификатора пользователя , который используется для дополнения отчетов о сбоях. Чтобы использовать эту возможность, выполните следующие действия.
- Настройте пакет SDK центра приложений, вызвав метод
AppCenter.Start(...)
, как описано в руководстве по началу работы с пакетом SDK центра приложений. userID
Задайте в пакете SDK с помощью следующего кода:
AppCenter.SetUserId("your-user-id");
Задав идентификатор пользователя, вы можете использовать функцию поиска в Центре приложений для поиска конкретных отчетов о сбоях для идентификатора. Дополнительные сведения см. в документации по поиску в Центре приложений.
Примечание
Значение идентификатора пользователя ограничено 256 символами. Он будет отображаться вместе с отчетами о сбоях, но не будет использоваться для агрегирования или количества затронутых пользователей. Если вы задали идентификатор пользователя несколько раз, будет использоваться только последний идентификатор пользователя. Необходимо самостоятельно задавать идентификатор пользователя перед каждым запуском приложения, так как это значение не хранится в пакете SDK между запусками.
Если вы хотите отключить все службы Центра приложений Enabled
одновременно, используйте свойство . Если он отключен, пакет SDK не будет пересылать какие-либо сведения в Центр приложений.
AppCenter.SetEnabledAsync(false);
Чтобы снова включить все службы, используйте тот же API, но передайте true
в качестве параметра.
AppCenter.SetEnabledAsync(true);
Вам не нужно ожидать этого вызова, чтобы обеспечить согласованность других вызовов API (например, IsEnabledAsync
).
Состояние сохраняется в хранилище устройства при запуске приложений.
Включите или отключите службы в среде выполнения с помощью следующего кода:
Analytics.SetEnabledAsync(false);
В пакете SDK центра приложений сетевые запросы разрешены по умолчанию. Если вы хотите отправлять данные, собираемые пакетом SDK центра приложений пользователем, вы можете запретить автоматическую отправку данных.
AppCenter.IsNetworkRequestsAllowed = false;
В этом случае пакет SDK центра приложений продолжает собирать данные, но они будут отправляться только в том случае, если будут разрешены сетевые запросы.
AppCenter.IsNetworkRequestsAllowed = true;
Примечание
Это значение сохраняется между запусками.
В любое время можно проверка, разрешена ли отправка данных в пакете SDK центра приложений.
AppCenter.IsNetworkRequestsAllowed;
Вы также можете проверка, включен ли Центр приложений.
bool enabled = await AppCenter.IsEnabledAsync();
Вы можете получить версию пакета SDK центра приложений, который вы используете в настоящее время.
AppCenter.SdkVersion;
При использовании пакета SDK центра приложений журналы хранятся локально на устройстве. Большие журналы могут занимать много места, поэтому вы можете ограничить размер локальной базы данных.
С помощью SetMaxStorageSizeAsync
API можно задать размер локальной базы данных. API является асинхронным, и обратный вызов вызывается при запуске служб Центра приложений. По этой причине SetMaxStorageSizeAsync
необходимо вызвать перед вызовом AppCenter.Start(...)
. Api можно вызвать только один раз.
// Use 20 MB for storage.
AppCenter.SetMaxStorageSizeAsync(20 * 1024 * 1024).ContinueWith((storageTask) => {
// The storageTask.Result is false when the size cannot be honored.
});
AppCenter.Start("{Your App Secret}", typeof(Analytics));
Если не задать максимальный размер хранилища, пакет SDK использует максимальный размер по умолчанию 10 МБ. Минимальный размер, который вы можете задать, составляет 20 КБ.
Примечание
Фактический максимальный размер хранилища может быть выше выбранного значения. SQLite округляет размер до следующего, кратного размеру страницы. Пакет SDK центра приложений использует размер страницы 4 КБ.
Примечание
Журналы старше 25 дней будут удалены.