从Visual Studio 2022发布自定义Teams应用到Azure及后续配置

核心修改文件及变量说明 #

1. manifest.json（Teams应用清单，必须修改） #

这是Teams识别应用配置的核心文件，空白页问题大多源于此文件配置错误：

• TEAMS_APP_ID：即你的Teams应用注册ID，这个值固定，和你之前上传manifest时使用的ID一致。如果是通过Teams Toolkit创建的应用，可在Azure AD的「应用注册」中找到对应应用，获取其Application (client) ID。
• TAB_ENDPOINT/staticTabs.contentUrl：替换为Azure Web应用的公网URL，格式为https://<你的Azure Web应用名称>.azurewebsites.net，可从Azure门户的Web应用「概览」页直接获取。
• validDomains：必须添加Azure Web应用的域名（即<你的Azure Web应用名称>.azurewebsites.net），否则Teams的安全策略会阻止页面加载，导致空白。

2. 环境变量配置（无需修改本地文件，直接在Azure配置） #

本地的.env.local是开发环境用的，发布到Azure后，直接在Azure App Service的「配置」→「应用程序设置」中配置以下变量即可：

• TAB_ENDPOINT：同manifest中的配置，设为Azure Web应用的公网URL
• TEAMS_APP_ID：与manifest中的应用注册ID一致
• TEAMSFX_ENV：设为生产环境标识，比如production或prod，用于区分部署环境
• TAB_DOMAIN：即Azure Web应用的域名，从Web应用概览页获取
• TEAMS_APP_TENANT_ID：你的Azure AD租户ID，可从Azure门户的「Azure Active Directory」→「概述」页获取

3. launchSettings.json #

这是本地开发的启动配置文件，Azure App Service不会使用它，因此发布后无需修改。

关键注意事项 #

• 修改manifest.json后，需重新将manifest和必要资源打包成zip文件，重新上传到Teams管理中心并获得管理员批准，用户需重新安装应用才能生效。
• 空白页的核心原因是Teams无法访问本地的contentUrl，替换为Azure公网URL并配置好validDomains后即可解决。

内容的提问来源于stack exchange，提问作者user26591380