Partager via

Autres API React Native

Important

Visual Studio App Center a été mis hors service le 31 mars 2025, à l’exception des fonctionnalités d’analyse et de diagnostic, qui continueront d’être prises en charge jusqu’au 30 juin 2026. En savoir plus.

Ajuster le niveau de journalisation

Vous pouvez contrôler la quantité de messages de journal qui s’affichent à partir d’App Center. Les messages de journal s'affichent sur la console pour iOS et sur LogCat pour Android. Utilisez l'API setLogLevel pour activer la journalisation supplémentaire lors du débogage. Le niveau par défaut LogLevel.ASSERT s'applique à l'environnement App Store iOS et aux builds de version Android. Sinon, elle est définie sur LogLevel.WARNING.

Pour générer tous les messages de journal, utilisez LogLevel.VERBOSE.

import AppCenter from 'appcenter';

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

Remarque

L’API JavaScript setLogLevel ne peut pas augmenter la journalisation du code de démarrage de l’application avant le chargement de JavaScript.

Si vous souhaitez augmenter la journalisation pour le démarrage de l'application, utilisez les API natives setLogLevel d'App Center.

Dans iOS, appelez [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; avant tout appel à [AppCenterReactNative register]; (ou AppCenterReactNativeAnalytics, AppCenterReactNativeCrashes ou AppCenterReactNativePush) dans AppDelegate.m du projet. Vous devez ajouter @import AppCenter; s'il manque dans ce fichier.

Dans Android, appelez AppCenter.setLogLevel(android.util.Log.VERBOSE); avant SoLoader.init lors du rappel dans onCreate.

Identifier les installations

Le Kit de développement logiciel (SDK) App Center crée un UUID pour chaque appareil une fois l’application installée. Cet identificateur reste le même pour un appareil lorsque l’application est mise à jour et qu’une nouvelle est générée uniquement lorsque l’application est réinstallée ou que l’utilisateur supprime manuellement toutes les données d’application sur Android. L’API suivante est utile à des fins de débogage.

import AppCenter from 'appcenter';

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

Identifier les utilisateurs

Le Kit de développement logiciel (SDK) App Center prend en charge la définition d’un ID utilisateur utilisé pour augmenter les rapports d’incident. Pour utiliser cette fonctionnalité :

  1. Configurez le Kit de développement logiciel (SDK) App Center comme décrit dans le guide de prise en main du Kit de développement logiciel (SDK) App Center.
  2. Pour définir un userID dans le SDK, utilisez le code suivant :
AppCenter.setUserId("your-user-id");

Après avoir défini un ID utilisateur, vous pouvez utiliser la fonctionnalité de recherche d’App Center pour rechercher des rapports d’incident spécifiques pour l’ID. En savoir plus dans la documentation de recherche d’App Center.

Remarque

La valeur de l’ID utilisateur est limitée à 256 caractères. Il s’affiche avec vos rapports d’incident, mais n’est pas utilisé pour l’agrégation ou le nombre d’utilisateurs affectés. Si vous définissez l’ID utilisateur plusieurs fois, seul le dernier ID utilisateur sera utilisé. Vous devez définir l’ID utilisateur vous-même avant le lancement de chaque application, car cette valeur n’est pas stockée par le Kit de développement logiciel (SDK) entre les lancements.

Désactiver tous les services au moment de l’exécution

Si vous souhaitez désactiver tous les services App Center à la fois, utilisez l’API setEnabled() . Lorsqu’il est désactivé, le Kit de développement logiciel (SDK) ne transfère aucune information à App Center.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

Pour activer à nouveau tous les services, utilisez la même API, mais passez true en tant que paramètre.

await AppCenter.setEnabled(true);

L’état est conservé dans le stockage de l’appareil dans les lancements d’application.

Interdire les demandes réseau

Dans le Kit de développement logiciel (SDK) App Center, les demandes réseau sont autorisées par défaut. Si vous souhaitez envoyer des données collectées par le SDK App Center par l’utilisateur, vous pouvez interdire l’envoi automatique de données.

await AppCenter.setNetworkRequestsAllowed(false);

Dans ce cas, le Kit de développement logiciel (SDK) App Center continue de collecter des données, mais il ne sera envoyé que lorsque les demandes réseau seront autorisées.

await AppCenter.setNetworkRequestsAllowed(true);

Remarque

Cette valeur est conservée entre les démarrages.

À tout moment, vous pouvez vérifier si l’envoi de données dans le Kit de développement logiciel (SDK) App Center est autorisé ou non.

await AppCenter.isNetworkRequestsAllowed();

Remarque

La valeur enregistrée dans SharedPreferences est ignorée jusqu’à ce que AppCenter soit démarré sur la plateforme Android. Elle retourne le dernier jeu de valeurs à l’aide setNetworkRequestsAllowed ou true si la valeur n’a pas été modifiée avant le début d’AppCenter.

Modifier l’état du service dans le runtime

Vous pouvez activer ou désactiver le service au moment de l’exécution avec le code suivant :

await AppCenter.Analytics.setEnabled(false);

Vérifier si App Center est activé

Vous pouvez également vérifier si App Center est activé ou non.

const enabled = await AppCenter.isEnabled();

Vérifier la version du Kit de développement logiciel (SDK) App Center au moment de l’exécution

Vous pouvez obtenir la version du Kit de développement logiciel (SDK) App Center que vous utilisez actuellement.

AppCenter.getSdkVersion();
  • Last updated on