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


Другие API React Native

Это важно

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

Настройте уровень журнала

Вы можете контролировать количество сообщений журнала, отображаемых в Центре приложений. Сообщения журнала отображаются в консоли в iOS и LogCat в Android. Используйте setLogLevel API для включения дополнительного ведения логов во время отладки. Уровень по умолчанию — это LogLevel.ASSERT для среды iOS App Store и выпускных сборок Android. В противном случае для него задано значение LogLevel.WARNING.

Чтобы вывести все сообщения журнала, используйте LogLevel.VERBOSE.

import AppCenter from 'appcenter';

await AppCenter.setLogLevel(AppCenter.LogLevel.VERBOSE);

Замечание

JavaScript API не может усилить ведение журнала для кода запуска приложения перед загрузкой JavaScript setLogLevel.

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

В iOS вызовите [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; перед вызовом [AppCenterReactNative register]; (или AppCenterReactNativeAnalytics или AppCenterReactNativeCrashes или AppCenterReactNativePush) в файле AppDelegate.m проекта. Необходимо добавить @import AppCenter; , если отсутствует в этом файле.

В Android сначала вызовите AppCenter.setLogLevel(android.util.Log.VERBOSE);, затем SoLoader.init в обратном вызове onCreate внутри MainApplication.java.

Определение установок

Пакет SDK центра приложений создает идентификатор UUID для каждого устройства после установки приложения. Этот идентификатор остается неизменным для устройства при обновлении приложения, а новый создается только при повторной установке приложения или пользователь вручную удаляет все данные приложения в Android. Следующий API полезен для отладки.

import AppCenter from 'appcenter';

const installId = await AppCenter.getInstallId();   // Returned as a string

Идентификация пользователей

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

  1. Настройте пакет SDK Центра приложений, как описано в руководстве по началу работы с пакетом SDK для Центра приложений.
  2. Установите userID в SDK, используя следующий код:
AppCenter.setUserId("your-user-id");

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

Замечание

Значение идентификатора пользователя ограничено 256 символами. Он будет отображаться с отчетами о сбоях, но не используется для агрегирования или подсчета затронутых пользователей. Если вы несколько раз задали идентификатор пользователя, будет использоваться только последний идентификатор пользователя. Перед каждым запуском приложения необходимо задать идентификатор пользователя, так как это значение не хранится пакетом SDK между запусками.

Отключите все службы во время выполнения

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

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

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

await AppCenter.setEnabled(true);

Состояние сохраняется в хранилище устройства во время запуска приложения.

Запретить сетевые запросы

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

await AppCenter.setNetworkRequestsAllowed(false);

В этом случае пакет SDK центра приложений продолжает собирать данные, но он будет отправляться только в том случае, если будут разрешены сетевые запросы.

await AppCenter.setNetworkRequestsAllowed(true);

Замечание

Это значение сохраняется между запусками.

В любое время можно проверить, разрешена ли отправка данных в пакете SDK центра приложений.

await AppCenter.isNetworkRequestsAllowed();

Замечание

Значение, сохраненное в SharedPreferences, игнорируется, пока AppCenter не будет запущено на платформе Android. Он вернет последний набор значений, используя setNetworkRequestsAllowed или true если значение не было изменено до запуска AppCenter.

Изменение состояния службы в режиме реального времени

Вы можете включить или отключить службу во время выполнения с помощью следующего кода:

await AppCenter.Analytics.setEnabled(false);

Проверьте, включен ли Центр приложений

Вы также можете проверить, включен ли Центр приложений или нет.

const enabled = await AppCenter.isEnabled();

Проверка версии пакета SDK для Центра приложений во время выполнения

Вы можете получить версию пакета SDK центра приложений, которую вы используете в настоящее время.

AppCenter.getSdkVersion();