使用 Visual Studio 发布加载项

  • 项目

Office 加载项包包含 XML 清单文件，它可用于发布加载项。 你将不得不单独发布项目的 Web 应用程序文件。 本文介绍如何使用 Visual Studio 2019 部署 Web 项目并打包加载项。

注意

要了解如何发布使用 Yeoman 生成器创建并使用 Visual Studio Code 或任何其他编辑器开发的 Office 加载项，请参阅发布使用 Visual Studio Code 开发的加载项。

使用 Visual Studio 2019 部署 Web 项目

完成以下步骤以使用 Visual Studio 2019 部署 Web 项目。

  1. 从“生成”选项卡中，选择“发布 [加载项名称]”。

  2. 在“选取发布目标”窗口中，选择其中一个选项以发布到你的首选目标。 每个发布目标都要求你提供有关入门的详细信息，例如 Azure 虚拟机或文件夹位置。 指定发布位置并填写所有必需信息后，选择“发布”

    注意

    选择发布目标可指定要部署到的服务器、登录到服务器所需的凭据、要部署的数据库和其他部署选项。

  3. 有关每个发布目标选项的部署步骤的详细信息，请参阅初探 Visual Studio 中的部署。

使用 Visual Studio 2019 通过 IIS、FTP 或 Web 部署方法打包并发布加载项

完成以下步骤以使用 Visual Studio 2019 打包加载项。

  1. 从“生成”选项卡中，选择“发布 [加载项名称]”。

  2. 在“选取发布目标”窗口中，选择“IIS、FTP 等”，然后选择“配置”。 接下来，选择“发布”。

  3. 此时将显示一个向导，它将指导你完成该过程。 确保发布方法是你的首选方法，例如 Web 部署。

  4. 在“目标 URL”框中，输入托管加载项内容文件的网站的 URL，然后选择“下一步”。 如果计划将加载项提交到 AppSource，可以选择“验证连接”按钮，以发现任何可能会导致加载项遭拒的问题。 应先解决所有问题，再将加载项提交到 Microsoft Store。

  5. 确认所需的任何设置（包括“文件发布选项”），然后选择“保存”。

    重要

    强烈建议对加载项使用 HTTPS 终结点（尽管无需在所有加载项方案中都严格遵循此要求）。 不受 SSL (HTTPS) 保护的加载项会在使用期间生成不安全的内容警告和错误。 如果计划在 Office web 版 中运行加载项或将外接程序发布到 AppSource，则它必须受到 SSL 保护。 如果加载项访问外部数据和服务，它应受 SSL 保护，以保护传输中的数据。 自签名证书可用于开发和测试，但前提是证书在本地计算机上受信任。 Azure 网站自动提供 HTTPS 终结点。

现在，可以将 XML 清单上传到适当位置，以发布加载项。 XML 清单位于 OfficeAppManifests 文件夹的 app.publish 中。 例如：

%UserProfile%\Documents\Visual Studio 2019\Projects\MyApp\bin\Debug\app.publish\OfficeAppManifests

部署更新

在加载项中添加功能或修复 bug 时，需要部署更新。 如果外接程序由一个或多个管理员部署到其组织，则某些清单更改将要求管理员同意更新。 在授予同意之前，将阻止用户从外接程序中访问。 以下清单更改需要管理员再次同意。

注意

每当对清单进行更改时，都必须引发清单的版本号。

另请参阅