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

Начало работы с UWP/WinUI

Это важно

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

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

Давайте приступим к настройке пакета SDK Центра приложений в приложении для использования аналитики Центра приложений и сбоев Центра приложений.

1. Предварительные требования

Прежде чем приступить к работе, убедитесь, что у вас есть следующие необходимые компоненты.

Для проекта UWP:

  • Проект настроен в Visual Studio 2017 с обновлением 15.9 или более поздней версии.
  • Вы нацелены на устройства под управлением Windows 10 сборки 16299 или более поздней версии.
  • Проект ссылается на универсальную платформу Windows 6.2.8 или более поздней версии (этот пакет обычно ссылается неявно).
  • NuGet 4.3 или более поздней версии.

Для проекта WinUI:

  • Проект настроен в Visual Studio 2019 с обновлением 16.9 или более поздней версии.
  • Вы нацелены на устройства под управлением Windows 10 сборки 17763 или более поздней версии.
  • Проект ссылается на WinUI 3 0.8.0 или более поздней версии.

Замечание

Если вы хотите использовать Xamarin.Forms для UWP, следуйте руководству по началу работы Xamarin вместо этой документации.

2. Создание приложения на портале Центра приложений для получения секрета приложения

Если вы уже создали приложение на портале Центра приложений, этот шаг можно пропустить.

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

После создания приложения вы можете получить секрет приложения на странице "Параметры " на портале Центра приложений. В правом верхнем углу страницы "Параметры " щелкните тройную вертикальную точку и выберите Copy app secret , чтобы получить секрет приложения.

3. Добавление модулей пакета SDK центра приложений

Пакет SDK центра приложений можно интегрировать с помощью Visual Studio или консоли диспетчера пакетов.

Visual Studio

  • Откройте Visual Studio.
  • Нажмите кнопку"Открыть>" и выберите решение.
  • В обозревателе решения щелкните правой кнопкой мыши Ссылки и выберите пункт «Управление пакетами NuGet».
  • На вкладке "Обзор" найдите Центр приложений и установите пакеты Microsoft.AppCenter.Analytics и Microsoft.AppCenter.Crashes .

Консоль диспетчера пакетов

  • Откройте консоль в Visual Studio. Для этого выберите Инструменты>Диспетчер пакетов NuGet>Консоль диспетчера пакетов.
  • Введите следующие команды:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Теперь, когда вы интегрировали пакет SDK в приложении, пришло время запустить пакет SDK и использовать службы Центра приложений.

Замечание

Если вы используете пакет SDK Центра приложений в переносимом проекте (например, Xamarin.Forms), необходимо установить пакеты в каждом из проектов: переносимых, Android и iOS. Для этого вам следует открыть каждый вложенный проект и выполнить соответствующие действия, описанные в разделе Visual Studio.

4. Добавить Internet (Client) возможность

В обозревателе решений Visual Studio дважды щелкните файл Package.appxmanifest для приложения. Перейдите на вкладку "Возможности" , а затем проверьте возможности Интернета (клиента ).

5. Запустите пакет SDK

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

5.1. Добавьте директивы using

Добавьте соответствующие пространства имен, прежде чем использовать наши API.

using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

5.2 Добавление Start() метода

Добавьте следующий вызов конструктору приложения:

AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));

Предупреждение

Не рекомендуется внедрять секрет приложения в исходный код.

Если вам нужно запустить службы Центра приложений отдельно, необходимо:

  1. Настройте или запустите его с помощью секрета приложения.
  2. Если код можно вызывать несколько раз, проверьте, настроен ли центр приложений.
  3. Запустите необходимые службы без секрета приложения.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.3. Замените заполнитель секретом приложения

Обязательно замените {Your App Secret} текст фактическим значением приложения. Секрет приложения можно найти на странице "Начало работы " или на странице "Параметры " на портале Центра приложений.

Страница "Начало работы" содержит приведенный выше пример кода с секретом приложения в нем, вы можете скопировать весь пример.

В приведенном Start() выше примере показано, как использовать метод и включить аналитику Центра приложений.

Если вы явным образом не укажете каждую службу в качестве параметров в методе запуска, эту службу Центра приложений нельзя использовать. Кроме того, Start() API можно использовать только один раз в жизненном цикле приложения. Все остальные вызовы будут записывать предупреждение в консоль, и будут доступны только службы, включенные в первый вызов.

Отлично, теперь вы всё готово для визуализации аналитики на портале, который SDK собирает автоматически.

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

  • Last updated on