Начало работы с Android

2025-01-16

Это важно

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

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

Вы можете найти сведения о данных, собранных Центром приложений по данным, собранным пакетами SDK для Центра приложений, общими правилами защиты данных и страницами часто задаваемых вопросов .

Давайте приступим к настройке пакета SDK для Android Для Центра приложений в приложении для использования аналитики Центра приложений и сбоев в Центре приложений. Чтобы добавить функцию App Center Distribute в ваше приложение, ознакомьтесь с документацией по App Center Distribute.

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

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

Проект Android настроен в Android Studio.
Вы нацелены на устройства под управлением Android версии 5.0 (уровень API 21) или более поздней версии.

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

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

Перейдите к appcenter.ms.
Зарегистрируйтесь или войдите и нажмите кнопку "Добавить новую " в правом верхнем углу страницы и выберите " Добавить новое приложение " в раскрывающемся меню.
Введите имя и необязательное описание приложения.
Выберите Android как операционную систему и Java как платформу.
Нажмите кнопку "Добавить новое приложение ".

После создания приложения вы можете получить секрет приложения на странице "Начало работы " под 2. Запустите пакет SDK. Вы также можете щелкнуть "Параметры" и в правом верхнем углу, щелкнуть тройную вертикальную точку и выбрать "Копировать секрет приложения ", чтобы получить секрет приложения.

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

Откройте файл build.gradle на уровне приложения проекта и добавьте следующие строки после app/build.gradle. Включите необходимые зависимости в проект. Каждый модуль SDK должен быть добавлен в качестве отдельной зависимости в этом разделе. Если вы хотите использовать Аналитику и сбои Центра приложений, добавьте следующие строки:

dependencies {
    def appCenterSdkVersion = '5.0.6'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

Замечание

Если версия подключаемого модуля Android Gradle ниже 3.0.0, необходимо заменить слово implementation на compile.

Замечание

Из-за прекращения поддержки jCenter все сборки были перенесены в репозиторий Maven Central. Следуйте этому руководству по миграции из jCenter в Maven Central. Обратите внимание, что Maven Central не содержит устаревших модулей. Убедитесь, что в проекте нет зависимостей устаревших модулей пакета SDK для Центра приложений.

Обязательно активируйте синхронизацию Gradle в Android Studio.

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

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

4.1 Добавление метода start()

Чтобы использовать Центр приложений, необходимо принять участие в модулях, которые вы хотите использовать. По умолчанию модули не запускаются, и при запуске пакета SDK необходимо явно вызывать каждый из них.
Вставьте следующую строку в основной класс активности вашего приложения в onCreateобратный вызов, чтобы использовать Аналитику Центра приложений и Сбои Центра приложений:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)

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

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

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

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

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics.class);
    AppCenter.start(Crashes.class);
}

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics::class.java);
    AppCenter.start(Crashes::class.java);
}

Если у вас есть несколько точек входа в приложение (например, активность по глубокой ссылке, служба или приемник широковещательной трансляции), вызовите start в пользовательском классе приложения или в каждой точке входа. В последнем случае проверьте, настроен ли Центр приложений перед вызовом start :

if (!AppCenter.isConfigured())) {
  AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);
}

if (!AppCenter.isConfigured()) {
  AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)
}

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

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

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

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

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

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

Например, если вы просто хотите подключиться к App Center Analytics, необходимо изменить start() вызов API следующим образом:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java)

Android Studio автоматически предлагает необходимые инструкции импорта после вставки start() метода, но если вы увидите ошибку, что имена классов не распознаны, добавьте следующие строки в инструкции импорта в классе действий:

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;

import com.microsoft.appcenter.AppCenter
import com.microsoft.appcenter.analytics.Analytics
import com.microsoft.appcenter.crashes.Crashes

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

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

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

5. Правила резервного копирования (только для Android)

Замечание

Приложения, предназначенные для Android 6.0 (уровень API 23) или более поздней версии, автоматически включают автоматическое резервное копирование.

Замечание

Если у вас уже есть пользовательский файл с правилом резервного копирования, перейдите на третий шаг.

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

5.1. Для Android 11 (уровень API 30) или ниже.

Создайте файлappcenter_backup_rule.xml в папке res/xml .

Откройте файл AndroidManifest.xml этого проекта. Добавьте атрибут android:fullBackupContent к элементу <application>. Он должен указывать на файл ресурсов appcenter_backup_rule.xml .

android:fullBackupContent="@xml/appcenter_backup_rule"

Добавьте следующие правила резервного копирования в файл appcenter_backup_rule.xml :

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Для Android 12 (уровень API 31) или более поздней версии.

Создайте файлappcenter_backup_rule.xml в папке res/xml .

Откройте файл AndroidManifest.xml этого проекта. Добавьте атрибут android:dataExtractionRules к элементу <application>. Он должен указывать на файл ресурсов appcenter_backup_rule.xml .

android:dataExtractionRules="@xml/appcenter_backup_rule"

Добавьте следующие правила резервного копирования в файл appcenter_backup_rule.xml :

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>

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

Начало работы с Android

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

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

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

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

4.1 Добавление метода start()

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

5. Правила резервного копирования (только для Android)

5.1. Для Android 11 (уровень API 30) или ниже.

5.2. Для Android 12 (уровень API 31) или более поздней версии.

Обратная связь

Дополнительные ресурсы