Déboguer pour mobile
Lorsque vous créez une application Microsoft Teams qui inclut un onglet, un bot ou une extension de message, vous devez déboguer votre application pour savoir comment l’application fonctionne sur les clients mobiles Microsoft Teams Android et iOS. Pour plus d’informations, consultez Déboguer votre application Teams localement.
Regardez la vidéo suivante pour découvrir comment déboguer votre application Teams dans des clients mobiles :
Déboguer votre application d’onglet
Pour déboguer votre application d’onglet, procédez comme suit :
Vous pouvez afficher les dossiers et fichiers du projet sous Explorer dans Microsoft Visual Studio Code.
Ajoutez
Start local tunnel
aprèsValidate prerequisites
dans letask.json
fichier pour rendre l’application d’onglet accessible sur le client mobile.Ajoutez le code suivant après la propriété
dependsOrder
dans letask.json
fichier .{ "version": "2.0.0", "tasks": [ { "label": "Start Teams App Locally", "dependsOn": [ "Validate prerequisites", "Start local tunnel", // Add this line "Provision", "Deploy", "Start application" ], "dependsOrder": "sequence" }, { // Add this task "label": "Start local tunnel", "type": "teamsfx", "command": "debug-start-local-tunnel", "args": { "type": "dev-tunnel", "ports": [ { "portNumber": 53000, "protocol": "https", "access": "private", "writeToEnvironmentFile": { "endpoint": "TAB_ENDPOINT", "domain": "TAB_DOMAIN" } } ], "env": "local" }, "isBackground": true, "problemMatcher": "$teamsfx-local-tunnel-watch" } ] }
Remarque
- Pour afficher un aperçu de l’application onglet uniquement dans le client mobile, définissez la valeur de la propriété sur
access
private
. - Lorsque la valeur d’accès du tunnel de développement est définie sur
private
, l’application d’onglet ne peut pas être affichée dans un iframe sur le client web. La page de connexion est hébergée sur login.microsoftonline.com, dont l’en-têteX-FRAME-Options
est défini sur DENY. - Pour afficher un aperçu de l’application onglet sur le client mobile et la déboguer sur des clients web, définissez la valeur d’accès sur
public
. Tout utilisateur disposant de l’URL de l’application peut accéder à l’onglet.
- Pour afficher un aperçu de l’application onglet uniquement dans le client mobile, définissez la valeur de la propriété sur
Supprimez
TAB_DOMAIN
etTAB_ENDPOINT
duteamsapp.local.yml
fichier.- uses: script with: run: echo "::set-teamsfx-env TAB_DOMAIN=localhost:53000"; echo "::set-teamsfx-env TAB_ENDPOINT=https://localhost:53000";
Si vous utilisez React, ajoutez la configuration
WDS_SOCKET_PORT=0
dansteamsapp.local.yml
le fichier pour activer le rechargement à chaud lors du débogage dans React après avoir utilisé le service de tunnel.- uses: file/createOrUpdateEnvironmentFile with: target: ./.localConfigs envs: BROWSER: none HTTPS: true PORT: 53000 SSL_CRT_FILE: ${{SSL_CRT_FILE}} SSL_KEY_FILE: ${{SSL_KEY_FILE}} REACT_APP_CLIENT_ID: ${{AAD_APP_CLIENT_ID}} REACT_APP_START_LOGIN_PAGE_URL: ${{TAB_ENDPOINT}}/auth-start.html WDS_SOCKET_PORT: 0
Exécuter l’application déployée
- Ouvrez le panneau de débogage (Ctrl+Maj+D ou Afficher > l’exécution) à partir de Visual Studio Code.
- Sélectionnez Lancer à distance dans Teams (Edge) dans la liste déroulante de configuration de lancement.
- Sélectionnez le bouton Démarrer le débogage (F5).
Vous serez invité à charger une application personnalisée dans Teams. Sélectionnez Ajouter.
L’application s’ouvre sous la forme d’un onglet personnel.
Tester votre application d’onglet sur le client mobile
Pour rechercher l’application d’aperçu, ouvrez Teams sur votre appareil mobile, puis sélectionnez Plus.
Remarque
Si vous avez débogué l’application précédemment, il est recommandé d’effacer le cache sur l’appareil mobile pour garantir une synchronisation immédiate de l’application. Après avoir nettoyé le cache, la synchronisation de l’application prend un certain temps.
Pour effacer les données de l’application Teams, accédez à Paramètres>Teams>Effacer les données de l’application.
Si vous accédez au tunnel de développement pour la première fois, connectez-vous au compte Microsoft 365 et sélectionnez Continuer.
Remarque
Vous ne devez vous connecter qu’une seule fois par appareil, et chaque fois que vous installez l’application, vous devez confirmer la page anti-hameçonnage.
Votre première application d’onglet mobile est créée.
Pour les appareils Android, utilisez DevTools pour déboguer votre onglet pendant son exécution.
Tester votre application bot sur un client mobile
Pour tester votre bot dans le client mobile, suivez les étapes décrites dans Tester votre application d’onglet sur le client mobile pour votre bot.
Remarque
Si vous avez débogué l’application bot précédemment et que le fichier manifeste de l’application (précédemment appelé manifeste d’application Teams) est modifié, nous vous recommandons d’effacer le cache sur l’appareil mobile pour garantir la synchronisation immédiate de l’application. Après avoir nettoyé le cache, la synchronisation de l’application prend un certain temps.
Pour effacer les données de l’application Teams, accédez à Paramètres>Teams>Effacer les données de l’application.
Votre première application de bot mobile est créée.