Поддержка Windows

Это важно

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

В настоящее время Центр приложений поддерживает диагностику приложений UWP, WPF и WinForms. В этом разделе описывается новый интерфейс для приложений UWP в рамках выпуска пакета SDK 2.5.0. Дополнительные сведения о приложениях WPF и WinForms см. в статье о функциях диагностики и пакете SDK WPF/WinForms.

Универсальная платформа Windows

Центр приложений поддерживает полный набор функций диагностики для установленных в обход Магазина приложений и приложений UWP Магазина Windows, используя SDK версии 2.5.0 или более поздней версии. Чтобы включить диагностику App Center для вашего приложения UWP, следуйте документации по пакету SDK UWP App Center для интеграции пакета SDK. Дополнительные сведения о полном наборе функций см. в документации по функциям диагностики.

Новый интерфейс диагностики

С выпуском пакета SDK 2.5.0 в октябре 2019 г. Центр приложений выпустил новый интерфейс диагностики. В этом разделе описываются улучшения и опыт перехода на новый релиз.

Какие улучшения были сделаны?

Новый и улучшенный интерфейс диагностики включает следующие дополнения:

• Полный функционал символикации, позволяющий загружать символы в App Center. Дополнительные сведения см. в разделе символьного обозначения ниже.
• Поддержка обрабатываемых исключений
• Число пользователей, затронутых на каждый сбой или группу ошибок
• Возможность добавления заметок для каждого сбоя или группы ошибок
• Возможность пометить группы сбоев и ошибок как открытые, закрытые или игнорируемые
• Возможность скачивания отчетов о сбоях и ошибках
• Возможность прикрепления, просмотра и скачивания одного двоичного и одного текстового файла к вашим отчетам о сбоях.
• Сведения о сбое и отчете об ошибках для каждого экземпляра сбоя, включая время запуска приложения, момент сбоя, а также страну или регион и язык используемого устройства.

Дополнительные сведения о каждой функции см. в документации по диагностике Центра приложений.

Что такое переход?

После обновления пакета SDK UWP для Центра приложений версии 2.5.0 вы увидите данные о сбоях и ошибках, поступающих на портал диагностики Центра приложений, в новом и улучшенном пользовательском интерфейсе. Для сбоев и ошибок, отображаемых в новом пользовательском интерфейсе диагностики, необходимо использовать API, перечисленные в разделе об ошибках. Узнайте больше о том, как старые API для аварий сопоставляются с новыми API для ошибок в документации по переходу API.

Символика

Отчеты о сбоях UWP показывают трассировку стека для потока, вызвавшего сбой. Если приложение использует .NET Native (обычно в сборках выпуска), трассировка стека может содержать адреса памяти вместо имен классов, методов, имен файлов и номеров строк, необходимых для чтения и понимания сбоев.

Несимболические сбои

Несимболические сбои отображаются в разделе диагностики Центра приложений, чтобы просмотреть некоторые сведения даже перед отправкой символов. Отсутствующие символы из этих сбоев будут отображаться на вкладке "несимволизированные". Если отсутствующие символы загружены, то несимволизированная группа сбоев будет заменена символизированной группой сбоев.

Отправка символов

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

Генерация символов локально

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

Символы для приложений, встроенных в сборку Центра приложений

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

Символы для приложений, опубликованных в Microsoft Store

При публикации приложения в хранилище компиляция .NET Native выполняется на стороне сервера. Таким образом, необходимо скачать символы из Центра партнеров.

1. Найдите приложение в списке и щелкните его.
2. Разверните меню управления продуктами на левой панели.
3. Щелкните "Управление пакетами".
4. Щелкните "Показать пакеты " в правом верхнем углу для представления (версии), для которого нужны символы.
5. Найдите пакет для нужной версии символов и щелкните ссылки для всех поддерживаемых архитектур, чтобы скачать все символы (например, ссылку "Скачать файл символов Windows 10" (x64).

Замечание

Приложение должно объявить зависимость от любой версии .NET Native для создания символов отладки. Эта декларация должна быть включена в <Dependencies> раздел вашего AppxManifest.xml. Пример:

<PackageDependency Name="Microsoft.NET.Native.Framework.2.2" MinVersion="2.2.29512.0" Publisher="CN=Microsoft Corporation, 0=Microsoft Corporation, L=Redmond, S=Washington, C=US"/>
<PackageDependency Name="Microsoft.NET.Native.Runtime.2.2" MinVersion="2 2.28604.0" Publisher="CN=Microsoft Corporation, 0=Microsoft Corporation, L=Redmond, S=Washington, C=US"/>

Портал Центра приложений

1. Войдите в Центр приложений и выберите свое приложение.
2. В меню слева перейдите к разделу "Диагностика " и выберите "Символы".
3. В правом верхнем углу щелкните "Отправить символы " и отправьте файл.
4. После индексирования символов в Центре приложений краши будут расшифрованы для вас.

API Центра приложений

Процесс отправки символов через API включает в себя ряд трех вызовов API: один для выделения пространства на серверной части, один для отправки файла и один для обновления состояния отправки. Текст первого вызова API должен иметь значение symbol_typeUWP.

1. POST Активируйте запрос к API symbol_uploads. Этот запрос выделяет пространство в серверной системе для вашего файла и возвращает свойства symbol_upload_id и upload_url.

curl -X POST 'https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/symbol_uploads' \
    -H 'accept: application/json' \
    -H 'X-API-Token: {API TOKEN}' \
    -H 'Content-Type: application/json' \
    -d '{JSON BODY}'

2. Используя свойство, возвращенное на первом шаге, выполните upload_url запрос с заголовком: PUT и укажите путь к вашему файлу на диске. Этот запрос отправляет файл на наши серверные учетные записи хранения. Узнайте больше о заголовках запросов PUT для BLOB.

curl -X PUT '{upload_url}' \
    -H 'x-ms-blob-type: BlockBlob' \
    --upload-file '{path to file}'

3. PATCH Выполните запрос к API symbol_uploads с помощью свойства symbol_upload_id возвращенного на первом этапе. В тексте запроса укажите, нужно ли задать состояние отправки committed (успешно завершено) процесса отправки или aborted (неудачно завершено).

curl -X PATCH 'https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/symbol_uploads/{symbol_upload_id}' \
    -H 'accept: application/json' \
    -H 'X-API-Token: {API TOKEN}' \
    -H 'Content-Type: application/json' \
    -d '{ "status": "committed" }'

Замечание

API отправки символов не работает для файлов, размер которых превышает 256 МБ. Используйте интерфейс командной строки Центра приложений для отправки этих файлов. Вы можете установить CLI App Center, следуя инструкциям в репозитории CLI App Center.

Интерфейс командной строки Центра приложений

Вы также можете использовать ИНТЕРФЕЙС командной строки для отправки файлов символов:

appcenter crashes upload-symbols --appxsym {symbol file}

Игнорировать символы

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

Если вы не можете отправить символы, их можно пометить как игнорируемые, выбрав строки в таблице и нажав кнопку "Игнорировать версии". Эта кнопка позволяет App Center обработать сбои и использовать символизацию в максимально возможной степени с доступными символами. После завершения обработки они будут отображаться на вкладке Сбои частично преобразованы в символы. Новые сбои, которые также зависят от тех же идентификаторов символов, помеченных как игнорируемые, обходят вкладку "Несимболизованная " по мере их ввода и прохождения по системе.

WinRT, Silverlight и другие платформы

Центр приложений не поддерживает другие платформы Windows, кроме UWP, WPF и WinForms. Если у вас есть приложение Windows с сбоями в нативном C++, вы можете отправить эти сбои в Центр приложений через API загрузки сбоев.