如何通过Teams Toolkit部署Outlook加载项项目

问题说明 #

• 用Teams Toolkit开发、调试Outlook加载项都正常，但搞不清部署流程
• 执行npm run build后，编译后的资源存到了文件夹里，但清单文件是manifest.json，不是Office加载项常用的manifest.xml
• 旁加载时弹出提示：

清单包已保存至 C:\Users\xxx\AppData\Local\Temp\manifest.zip；正在运行: npx @microsoft/teamsfx-cli@2.0.2-alpha.4f379e6ab.0 m365 sideloading --file-path C:\Users\xxx\AppData\Local\Temp\manifest.zip

解决办法 #

1. 清单文件格式问题 #

Teams Toolkit针对Office加载项做了自动处理，npm run build生成的manifest.json是工具内部格式，旁加载时工具会自动把它转换成符合Office要求的manifest.xml，并打包成你看到的临时manifest.zip文件，不用手动转格式。

2. 部署步骤 #

（1）本地旁加载验证

你看到的提示说明工具正在自动执行旁加载操作，等它跑完之后，打开Outlook客户端或者网页版，就能在对应的邮件/日历区域找到加载项。如果没出现，检查两点：

• 你的M365账号有旁加载权限（要么管理员开了组织内旁加载，要么你用的是开发者账号）
• Outlook客户端已经更到最新版本

（2）正式部署到生产环境

要是想部署到生产环境，有两种方式：

• 直接用Teams Toolkit里的「部署到Azure」功能，工具会自动搞定资源托管和清单发布的所有步骤
• 手动部署的话，先把npm run build生成的dist文件夹（或者项目里的输出目录）部署到静态托管服务（比如Azure Storage静态网站），然后到Office 365管理中心上传经过验证的清单文件——这个符合要求的xml清单，你可以在项目的.fx目录或者build时生成的临时文件里找到。

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