在本地调试 Teams 应用

Microsoft Teams 工具包可帮助你在本地调试和预览 Microsoft Teams 应用。 在调试过程中，Teams 工具包会自动启动应用服务、启动调试器并上传 Teams 应用。 调试后，可以在 Teams Web 客户端本地预览 Teams 应用。

在本地调试 Teams 应用以Visual Studio Code

Microsoft Visual Studio Code 中的 Teams 工具包提供了在本地自动调试 Teams 应用的功能。 Visual Studio Code允许调试选项卡、机器人和消息扩展。 在调试应用之前，需要设置 Teams 工具包。

设置 Teams 工具包进行调试

以下步骤可帮助你在启动调试过程之前设置 Teams 工具包：

npm run prepare-storage:teamsapp

调试应用

完成初始设置过程后，Teams 工具包将启动以下过程：

• 启动应用服务
• 启动调试配置
• 上传 Teams 应用

启动应用服务

运行 中 .vscode/tasks.json定义的任务。 默认情况下，任务名称为 "Start application"。 如果项目包含多个组件，则会有更多依赖任务。

// .vscode/tasks.json
{
    "label": "Start application",
    "dependsOn": [
        "Start Frontend", // Tab
        "Start Backend", // Azure Functions
        "Start Bot" // Bot or message extensions
    ]
}

下图显示了运行选项卡、机器人或消息扩展以及Azure Functions时Visual Studio Code的“输出”和“终端”选项卡中的任务名称。

启动本地隧道

使用开发隧道作为本地隧道服务，使本地机器人消息终结点公开。

开发隧道

若要从 v4 项目手动迁移本地隧道任务，请更新 文件中的 .vscode/tasks.json 以下代码：

{
      "label": "Start local tunnel",
      "type": "teamsfx",
      "command": "debug-start-local-tunnel",
      "args": {
          "type": "dev-tunnel",
          "ports": [
              {
                  "portNumber": 3978,
                  "protocol": "http",
                  "access": "public",
                  "writeToEnvironmentFile": {
                      "endpoint": "BOT_ENDPOINT",
                      "domain": "BOT_DOMAIN"
                  }
              }
        ],
          "env": "local"
      },
      "isBackground": true,
      "problemMatcher": "$teamsfx-local-tunnel-watch"
    },

若要将另一个端口用于本地机器人服务，请更改 portNumber 文件中的 .vscode/tasks.json ，同时更改 portNumber 或 index.ts 文件中的 index.js 。

下表列出了所需的参数：

参数 ports 必须是对象的数组，每个对象指定特定端口的配置。 每个对象必须包含以下字段：

对象 writeToEnvironmentFile 包含两个字段：

当包含 时 writeToEnvironmentFile ，指定的环境变量将写入 .env 文件。 省略字段时，不会将环境变量写入文件。

启动调试配置

启动中 .vscode/launch.json定义的调试配置。

下表列出了选项卡、机器人或消息扩展应用以及Azure Functions项目的调试配置名称和类型：

下表列出了具有机器人应用、Azure Functions和不带选项卡应用的项目的调试配置名称和类型：

上传 Teams 应用

配置“附加到前端”或“启动应用”Microsoft Edge 或 Chrome 浏览器实例启动，以在网页中加载 Teams 客户端。 加载 Teams 客户端后，上传由启动配置Microsoft Teams 中定义的上传 URL 控制的 Teams 应用。

当 Teams 客户端在 Web 浏览器中打开时，请执行以下步骤：

1. 选择“ 添加 ”以在 Teams 中上传应用。

   

2. 选择“ 打开 ”以在个人范围内打开应用。

   或者，可以搜索并选择所需的范围，或者从列表中选择频道或聊天，然后在对话框中移动以选择“ 转到”。

   

   你的应用已添加到 Teams！

后续步骤

另请参阅

• Teams 工具包概述
• Azure Functions简介
• 使用 Teams 工具包预配云资源
• 将操作指南添加到 Teams 应用
• 部署到云
• 在 Teams 工具包中管理多个环境