Другие API React Native

Важно!

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

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

• Android
• iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• tvOS
• Cordova

Настройка уровня журнала

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

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

import AppCenter from 'appcenter';

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

Примечание

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

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

В iOS вызовите [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; перед любым вызовом [AppCenterReactNative register]; (или AppCenterReactNativeAnalytics или AppCenterReactNativeCrashesAppCenterReactNativePush) в 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();