Résolution des problèmes du Kit de développement logiciel (SDK) macOS

Problèmes lors de l’installation

1. Dans la console, recherchez un journal Assert avec le message « Kit de développement logiciel (SDK) App Center configuré avec succès ». Cela vérifie que le Kit de développement logiciel (SDK) est correctement configuré.
2. Si vous utilisez Cocoapods pour intégrer App Center dans votre application macOS et rencontrer une erreur avec le message CocoaPods - Unable to find a specification for AppCenter, exécutez pod repo update pour mettre à jour votre dépôt Cocoapods local, puis réexécutez pod install .
3. Si vous intégrez manuellement les fichiers binaires du Kit de développement logiciel (SDK), vérifiez que vos modules sont activés pour votre projet.

Les données d’analyse ne s’affichent pas dans le portail.

1. Vérifiez que vous avez correctement intégré les modules du Kit de développement logiciel (SDK).

2. Assurez-vous que la clé secrète de l'application appropriée est incluse lors de l'appel de la méthode start:withServices:. Vous pouvez copier le code exact start:withServices:en ouvrant l’application dans le portail et en accédant à la page Prise en main .

3. Si vous souhaitez voir les journaux envoyés au back-end, remplacez le niveau de journal par Détaillé dans votre application et le SDK imprime les journaux dans la console. Insérez l’appel suivant avant le démarrage du Kit de développement logiciel (SDK) :

   [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
   

   AppCenter.logLevel = .verbose
   

   Assurez-vous que le « Kit de développement logiciel (SDK) App Center configuré correctement » s’affiche dans les journaux d’activité (au niveau du journal INFO ), puis vérifiez si vous voyez les journaux de requête HTTPS.

4. Vérifiez que votre appareil est en ligne et que l’application dispose d’un accès Internet.

   Remarque

   Si votre application utilise le bac à sable d’application, vous devez définir la possibilité d’autoriser les connexions entrantes (serveur) et sortantes (client) pour permettre à l’application d’avoir accès à Internet. Xcode 9 active le bac à sable d’application par défaut, mais les fonctionnalités des connexions entrantes et sortantes doivent être définies explicitement.

   Sélectionnez votre projet dans le navigateur du projet, sélectionnez l’onglet Fonctionnalités et, si votre application utilise le bac à sable, ajoutez les fonctionnalités pour les connexions entrantes et sortantes.

5. Parfois, les fichiers journaux peuvent prendre quelques minutes avant d'apparaître dans le portail. Attendez un certain temps si c’est le cas.

6. Pour vérifier si le back-end App Center a reçu vos données, accédez à la section Flux de journal dans le service Analytics . Vos événements doivent apparaître une fois qu’ils ont été envoyés.

Les blocages ne s’affichent pas dans le portail.

1. Vérifiez que vous avez correctement intégré les modules du Kit de développement logiciel (SDK).

2. Vérifiez que le secret d'application approprié est inclus lors de l'appel de la méthode start:withServices:. Vous pouvez copier le code exact start:withServices: en ouvrant l’application dans le portail et en accédant à la page Prise en main .

3. Redémarrez l’application après un incident. App Center Crashes transmettront le journal des incidents seulement après que l’application ait été redémarrée. En outre, le Kit de développement logiciel (SDK) ne transfère aucun journal d’incident si vous êtes attaché au débogueur. Vérifiez que le débogueur n’est pas attaché lorsque vous bloquez l’application.

4. Si vous souhaitez voir les journaux envoyés au back-end, remplacez le niveau de journal par Détaillé dans votre application et le SDK imprime les journaux dans la console. Insérez l’appel suivant avant le démarrage du Kit de développement logiciel (SDK) :

   [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
   

   AppCenter.logLevel = .verbose
   

   Assurez-vous que le « Kit de développement logiciel (SDK) App Center configuré correctement » s’affiche dans les journaux d’activité (au niveau du journal INFO ), puis vérifiez si vous voyez les journaux de requête HTTPS.

5. N’utilisez pas d’autres bibliothèques qui fournissent des fonctionnalités de rapport d’incident. Vous ne pouvez avoir qu’un seul SDK de création de rapports d’incident intégré dans votre application.

6. Vérifiez que votre appareil est en ligne et que l’application dispose d’un accès Internet.

   Remarque

   Si votre application utilise le bac à sable d’application, vous devez définir la possibilité d’autoriser les connexions entrantes (serveur) et sortantes (client) pour permettre à l’application d’avoir accès à Internet. Xcode 9 active le bac à sable d’application par défaut, mais les fonctionnalités des connexions entrantes et sortantes doivent être définies explicitement.

   Sélectionnez votre projet dans le navigateur du projet, sélectionnez l’onglet Fonctionnalités et, si votre application utilise le bac à sable, activez les connexions entrantes et sortantes.

7. Parfois, les journaux peuvent mettre quelques minutes pour apparaître dans le portail. Attendez un certain temps si c’est le cas.

8. Si vous souhaitez vérifier si le Kit de développement logiciel (SDK) a détecté l’incident au démarrage de l’application suivante, vous pouvez appeler l’API pour vérifier si l’application s’est bloquée lors de la dernière session et affiche une alerte. Vous pouvez également étendre le crash didSucceedSendingErrorReport callback pour voir s'il a été correctement envoyé au serveur.

9. Pour vérifier si le serveur principal d'App Center a reçu l'incident, accédez à la section Flux d'enregistrement dans le service Analytics. Vos incidents doivent apparaître là, une fois qu’il a été envoyé.

Protéger la valeur secrète de l'App Center

Il app_secret s’agit d’un identificateur de votre application, il est nécessaire de connaître l’application à laquelle le trafic s’applique et il ne peut pas être utilisé pour récupérer ou modifier des données existantes. Si votre app_secret est exposé, le plus grand risque est d’envoyer des données incorrectes à votre application, mais cela n’aura pas d’effet sur la sécurité des données.

Pour récupérer des données sensibles, vous devez fournir un jeton d’application/utilisateur, qui est généré côté client. Il n’existe aucun moyen de sécuriser complètement les données côté client.

Vous pouvez améliorer la sécurité de votre application à l’aide d’une variable d’environnement pour injecter le secret d’application dans votre code. Ainsi, le secret n’est pas visible dans votre code.