Partager via


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.

  1. Ajoutez Start local tunnel après Validate prerequisites dans le task.json fichier pour rendre l’application d’onglet accessible sur le client mobile.

  2. Ajoutez le code suivant après la propriété dependsOrder dans le task.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 accessprivate.
    • 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ête X-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.
  3. Supprimez TAB_DOMAIN et TAB_ENDPOINT du teamsapp.local.yml fichier.

    - uses: script 
      with:
        run:
          echo "::set-teamsfx-env TAB_DOMAIN=localhost:53000";
          echo "::set-teamsfx-env TAB_ENDPOINT=https://localhost:53000";
    
  4. Si vous utilisez React, ajoutez la configuration WDS_SOCKET_PORT=0 dans teamsapp.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 
    
  5. Exécuter l’application déployée

    1. Ouvrez le panneau de débogage (Ctrl+Maj+D ou Afficher > l’exécution) à partir de Visual Studio Code.
    2. Sélectionnez Lancer à distance dans Teams (Edge) dans la liste déroulante de configuration de lancement.
    3. Sélectionnez le bouton Démarrer le débogage (F5).

    Capture d’écran montrant comment lancer l’application à distance.

    1. Vous serez invité à charger une application personnalisée dans Teams. Sélectionnez Ajouter.

      Capture d’écran montrant une application en cours d’installation.

      L’application s’ouvre sous la forme d’un onglet personnel.

      Capture d’écran montrant la page de l’application d’onglet personnel.

Tester votre application d’onglet sur le client mobile

  1. Pour rechercher l’application d’aperçu, ouvrez Teams sur votre appareil mobile, puis sélectionnez Plus.

    Capture d’écran montrant l’option plus dans le client mobile Teams.

    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.

Capture d’écran montrant comment effacer les données de l’application dans le client mobile iOS pour l’onglet.

  1. Si vous accédez au tunnel de développement pour la première fois, connectez-vous au compte Microsoft 365 et sélectionnez Continuer.

    Capture d’écran montrant la page de connexion Microsoft 365.

    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.

  2. Votre première application d’onglet mobile est créée.

    Capture d’écran montrant l’application d’onglet mobile.

  3. Pour les appareils Android, utilisez DevTools pour déboguer votre onglet pendant son exécution.

Tester votre application bot sur un client mobile

  1. 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.

Capture d’écran montrant comment effacer les données de l’application dans le client mobile iOS pour le bot.

  1. Votre première application de bot mobile est créée.

    Capture d’écran montrant l’application bot dans le client mobile.