Partager via


Autres API tvOS

Important

La mise hors service de Visual Studio App Center est prévue pour le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à sa mise hors service complète, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager la migration.

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

Ajuster le niveau de journalisation

Vous pouvez contrôler la quantité de messages de journal qui s’affichent à partir d’App Center dans la console. Utilisez l’API setLogLevel:pour activer une journalisation supplémentaire lors du débogage. Par défaut, elle est définie sur LogLevelAssert pour l’environnement App Store et LogLevelWarning sinon.

Pour avoir autant de messages de journal que possible, utilisez MSACLogLevelVerbose/LogLevel.verbose.

[MSACAppCenter setLogLevel:MSACLogLevelVerbose];
AppCenter.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 nouvel identificateur est généré uniquement lorsque l’application est réinstallée. L’API suivante est utile à des fins de débogage.

NSUUID *installId = [MSACAppCenter  installId];
var installId = AppCenter.installId

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 en appelant :start:withServices: comme décrit dans le guide de prise en main du SDK App Center.
  2. Définissez un userID dans le Kit de développement logiciel (SDK) à l’aide du code suivant :
[MSACAppCenter setUserId:@"your-user-id"];
AppCenter.userId = "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 en savoir plus, consultez la documentation de recherche d’App Center.

Notes

La valeur de l’ID utilisateur est limitée à 256 caractères. Il s’affiche avec vos rapports d’incidents, 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 est utilisé. Vous devez définir vous-même l’ID utilisateur avant chaque lancement de l’application, car cette valeur n’est pas stockée par le 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.

[MSACAppCenter setEnabled:NO];
AppCenter.enabled = false

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

[MSACAppCenter setEnabled:YES];
AppCenter.enabled = true

L’état est conservé dans le stockage de l’appareil au cours des 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.

[MSACAppCenter setNetworkRequestsAllowed:false];
AppCenter.networkRequestsAllowed = false

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

[MSACAppCenter setNetworkRequestsAllowed:true];
AppCenter.networkRequestsAllowed = 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.

[MSACAppCenter isNetworkRequestsAllowed];
AppCenter.networkRequestsAllowed

Modifier l’état du service dans l’exécution

Activez ou désactivez les services au moment de l’exécution avec le code suivant :

[MSACAnalytics setEnabled:NO];
Analytics.enabled = false

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.

[MSACAppCenter isEnabled];
AppCenter.enabled

Notes

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

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.

[MSACAppCenter sdkVersion];
AppCenter.sdkVersion

Taille de stockage

Lorsque vous utilisez le Kit de développement logiciel (SDK) App Center, les journaux sont stockés localement sur l’appareil. Les journaux volumineux peuvent prendre beaucoup d’espace. Vous pouvez donc choisir de limiter la taille de la base de données locale. Il est également utile conjointement avec les pause API et resume . Si vous prévoyez d’être suspendu pendant une longue période, vous pouvez utiliser une plus grande taille de base de données pour stocker davantage d’événements.

Utilisez l’API setMaxStorageSize pour définir la taille de la base de données locale. L’API est asynchrone et est completionHandler appelée lorsque vous démarrez les services App Center. Pour cette raison, setMaxStorageSize doit être appelé avant votre appel à AppCenter.start. Vous ne pouvez appeler l’API qu’une seule fois.

// Use 20 MB for storage.
[MSACAppCenter setMaxStorageSize:(20 * 1024 * 1024) completionHandler:^(BOOL success) {
    if (!success) {
        // The success parameter is false when the size can't be honored.
    }
}];
[MSACAppCenter start:@"{Your App Secret}", withServices:@[[MSACAnalytics class]]];
// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024, completionHandler: { (success) in
    if !success {
        // The success parameter is false when the size can't be honored.
    }
})
AppCenter.start(withAppSecret: "{Your App Secret}", services:[Analytics.self])

Si vous ne définissez pas la taille de stockage maximale, le SDK utilise une taille maximale par défaut de 10 Mo. La taille minimale que vous êtes autorisé à définir est de 20 Ko.

Notes

La taille de stockage maximale réelle peut être légèrement supérieure à la valeur que vous avez choisie. SQLite arrondit la taille au multiple suivant de la taille de la page. Le Kit de développement logiciel (SDK) App Center utilise une taille de page de 4 Ko.

Notes

Les journaux de plus de 25 jours seront ignorés.

Appels d’API infructueux

Il existe de nombreuses raisons pour lesquelles l’appel completionHandler peut retourner false.

  • La taille spécifiée est une valeur non valide (inférieure à 20 Ko ou supérieure à 140 To).
  • La taille actuelle de la base de données est supérieure à la taille maximale spécifiée.
  • L’API a déjà été appelée. Vous ne pouvez le configurer qu’une seule fois par processus.
  • L’API a été appelée après AppCenter.start ou AppCenter.configure.

Vous pouvez case activée des avertissements et des erreurs dans la console à l’aide de la balise de AppCenter journal pour résoudre les problèmes de configuration.