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

  • Статья

Важно!

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

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

Пакет 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, вы не сможете использовать эту службу Центра приложений. Кроме того, Start() API можно использовать только один раз в жизненном цикле приложения. Все остальные вызовы будут записывать предупреждение в консоль, и будут доступны только службы, включенные в первый вызов.

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

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