使用 Visual Studio 在 Azure Microsoft上暂存 Office 加载项

最简单的 Office 加载项由清单文件和 HTML 页面组成。 清单文件描述加载项的特征,例如其名称、它可以在哪些 Office 桌面客户端中运行,以及加载项 HTML 页面的 URL。 HTML 页包含在一个 Web 应用中,用户在 Office 客户端应用程序中安装和运行外接程序时将与此 Web 应用进行交互。 可以将 Office 外接程序的 Web 应用托管在任意 Web 托管平台(包括 Azure)上。

本文介绍了如何将外接程序 Web 应用部署到 Azure 并旁加载外接程序以在 Office 客户端应用程序中进行测试。

重要

本文中所述的过程不适用于 Outlook 加载项。有关暂存 Outlook on Azure 加载项的说明,请参阅 使用 Visual Studio 在 Azure Microsoft暂存 Outlook 外接程序

先决条件

  1. 安装 Visual Studio 2022 并选择包含 Azure 开发 工作负载。

    注意

    如果以前已安装 Visual Studio 2022,请使用 Visual Studio 安装程序来确保已安装 Azure 开发工作负荷。

  2. 安装 Office。

    注意

    如果尚未安装 Office,可以注册 1 个月免费试用版

  3. 获取 Azure 订阅。

    注意

    如果还没有 Azure 订阅,可以通过 Visual Studio 订阅获取 Azure 订阅,也可以注册免费试用版

步骤 1:创建用于托管外接程序清单文件的共享文件夹

  1. 打开开发计算机的文件资源管理器。

  2. 右键单击 (或选择并按住 C:\ 驱动器) ,然后选择 “新建>文件夹”。

  3. 将新文件夹命名为 AddinManifests。

  4. 右键单击 (或选择并按住“AddinManifests”文件夹) ,然后选择“ >特定人员共享”。

  5. 在“文件共享”中,选择下拉箭头,再依次选择“所有人”>“添加”>“共享”

注意

在本演练中,你将使用本地文件共享作为受信任的目录,你将在其中存储外接程序清单文件。 在实际方案中,你可以改为选择 将清单文件部署到 SharePoint 目录 ,或 将外接程序发布到 AppSource

第 2 步:将文件共享添加到受信任的加载项目录

  1. 启动 Word 并创建文档。

    注意

    尽管此示例使用 Word,但你可以使用任何支持 Office 加载项的 Office 应用程序,例如 Excel、PowerPoint 或 Project。

  2. 选择“文件”>“选项”。

  3. 在“Word 选项”对话框中,选择“信任中心”,然后选择“信任中心设置”

  4. 在“ 信任中心 ”对话框中,选择“ 受信任的外接程序目录”。 输入之前创建的文件共享的通用命名约定 (UNC) 路径,例如,目录 URL (\\YourMachineName\AddinManifests) ,然后选择 “添加目录”。

  5. 选中“在菜单中显示”复选框。

    注意

    将外接程序清单文件存储在指定为受信任 Web 外接程序目录的共享上时,加载项将显示在从“主页>>加载项获取加载项”启动的 Office 外接程序对话框的“共享文件夹”下。

  6. 关闭 Word。

步骤 3:在 Visual Studio 中创建 Office 加载项

  1. 以管理员身份启动 Visual Studio。

  2. 选择“创建新项目”。

  3. 使用搜索框,输入“加载程序”。

  4. 选择“Word Web 外接程序”作为项目类型,然后选择“下一步”以接受默认设置。

Visual Studio 将创建基本的 Word 外接程序,你可以按原样发布,无需对其 Web 项目进行任何更改。 若要为其他 Office 应用程序(如 Excel)创建加载项,请重复这些步骤,并使用所需的 Office 应用程序选择项目类型。

步骤 4:将 Office 外接程序 Web 应用发布到 Azure

  1. 在 Visual Studio 中打开加载项项目后,右键单击 (或按住) Web 项目,然后选择 “发布”。

  2. 按照 发布 Web 应用中的说明进行操作。 跳过 “发布 Web 应用”前面的文章部分,但请确保在页面顶部选择了 “Visual Studio ”按钮。

    Visual Studio 会将 Office 外接程序的 Web 项目发布到 Azure Web 应用。 当 Visual Studio 完成 Web 项目的发布后,浏览器将打开并显示一个网页,其中包含文本“Web 应用正在运行并正在等待内容”。这是 Web 应用的当前默认页面。

  3. 复制根 URL (例如: https://YourDomain.azurewebsites.net) ;本文稍后编辑外接程序清单文件时需要它。

步骤 5:编辑和部署外接程序清单文件

  1. 在示例 Office 外接程序在“解决方案资源管理器”中打开的 Visual Studio 中,展开该解决方案以显示两个项目。

  2. 展开 Office 外接程序项目 (例如 WordWebAddIn) ,右键单击 (或选择并按住清单文件夹) ,然后选择 “打开”。 此时会打开外接程序清单文件。

  3. 在清单文件中,找到“~remoteAppUrl”的所有实例,并将其替换为 Azure 上外接程序 Web 应用的根 URL。 这是之前在将外接程序 Web 应用发布到 Azure 后复制的 URL, (例如: https://YourDomain.azurewebsites.net) 。

  4. 选择“文件”,然后选择“全部保存”。 接下来,复制外接程序清单文件 (例如 WordWebAddIn.xml) 。

  5. 使用“文件资源管理器”程序浏览到在第 1 步:创建共享文件夹中创建的网络文件共享,并将清单文件粘贴到此文件夹。

步骤 6:在 Office 客户端应用程序中插入并运行加载项

  1. 启动 Word 并创建文档。

  2. 选择“ 主页>加载项”,然后选择“ 获取外接程序”。

  3. “Office 加载项 ”对话框中,选择“ 共享文件夹”。 Word扫描在步骤 2:将文件共享添加到受信任的外接程序目录) 中列出的受信任外接程序目录 (的文件夹,并在对话框中显示加载项。 应会看到示例外接程序的图标。

  4. 选择加载项的图标,然后选择 “添加”。 加载项的 “显示任务窗格 ”按钮将添加到功能区。

  5. 在“ 开始 ”选项卡的功能区上,选择“ 显示任务窗格 ”按钮。 加载项将在当前文档右侧的任务窗格中打开。

  6. 选中文档中的某文本,并选择任务窗格中的“突出显示!”按钮,验证加载项是否正常运行。

部署更新

你将按照前面所述的相同方式将更新部署到 Web 应用程序。 对清单的更改需要将清单重新分发给用户。 执行此操作的过程取决于 发布方法。 有关更新加载项的详细信息,请参阅 维护 Office 外接程序

另请参阅