Partager via

Autres API MAUI et Xamarin

  • Article

Important

Visual Studio App Center doit être mis hors service le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à ce qu’il soit entièrement mis hors service, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager de migrer.

En savoir plus sur les chronologies et les alternatives de support.

Ajuster le niveau du journal

Vous pouvez contrôler la quantité de messages de journal qui s’affichent à partir d’App Center dans la console. Utilisez l’API LogLevelpour activer la journalisation supplémentaire lors du débogage. Par défaut, il est défini sur ASSERT pour les environnements App Store et WARN sinon.

Pour avoir autant de messages de journal que possible, utilisez LogLevel.Verbose.

AppCenter.LogLevel = LogLevel.Verbose;

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’un nouveau est généré uniquement lorsque l’application est réinstallée. L’API suivante est utile à des fins de débogage.

System.Guid? installId = await AppCenter.GetInstallIdAsync();

Notes

Sur Android, cette méthode ne doit être utilisée qu’une fois AppCenter qu’elle a été démarrée. Elle sera toujours retournée null avant le démarrage.

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’incidents. Pour utiliser cette fonctionnalité :

  1. Configurez le Kit de développement logiciel (SDK) App Center en appelant AppCenter.Start(...) comme décrit dans le guide de prise en main.
  2. Définissez un userID dans le Kit de développement logiciel (SDK) à l’aide du 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. Pour plus d’informations, consultez la documentation de recherche d’App Center.

Notes

La valeur de l’ID utilisateur est limitée à 256 caractères. Il sera affiché avec vos rapports d’incidents, mais 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 est utilisé. Vous devez définir l’ID utilisateur vous-même avant chaque lancement de l’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 en même temps, utilisez la Enabled propriété . Lorsqu’il est désactivé, le KIT de développement logiciel (SDK) ne transfère aucune information à App Center.

AppCenter.SetEnabledAsync(false);

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

AppCenter.SetEnabledAsync(true);

Vous n’avez pas besoin d’attendre cet appel pour rendre d’autres appels d’API (tels que IsEnabledAsync) cohérents.

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

Notes

Cette méthode ne doit être utilisée qu’après AppCenter le démarrage.

Interdire les requêtes 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 que le Kit de développement logiciel (SDK) App Center collecte par l’utilisateur, vous pouvez interdire l’envoi automatique de données.

AppCenter.IsNetworkRequestsAllowed = false;

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

AppCenter.IsNetworkRequestsAllowed = true;

Notes

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

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

AppCenter.IsNetworkRequestsAllowed;

Notes

La valeur enregistrée précédemment dans SharedPreferences est ignorée jusqu’à ce qu’elle AppCenter soit démarrée sur la plateforme Android. Il retourne la dernière valeur définie à l’aide AppCenter.IsNetworkRequestsAllowed = allowed de 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 :

Analytics.SetEnabledAsync(true);

Notes

Cette méthode ne doit être utilisée qu’après Analytics le démarrage.

Vérifier si App Center est activé

Vous pouvez également case activée si App Center est activé ou non.

bool enabled = await AppCenter.IsEnabledAsync();

Notes

Cette méthode ne doit être utilisée qu’après AppCenter avoir démarré. Elle sera toujours retournée false avant le début.

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.SdkVersion;