将 Office 加载项旁加载到Office web 版

旁加载加载项时,无需先将其放入外接程序目录中即可安装加载项。 这在测试和开发加载项时很有用,因为可以看到加载项的显示方式和功能。

在 Web 上旁加载加载项时,加载项清单存储在浏览器的本地存储中,因此,如果清除浏览器的缓存或切换到其他浏览器,则必须再次旁加载加载项。

在 Web 上旁加载加载项的步骤因以下因素而异。

  • 主机应用程序 (,例如 Excel、Word、Outlook)
  • 创建外接程序项目的工具 (例如 Visual Studio 和 Office 外接程序的 Yeoman 生成器,或者两者都没有)
  • 是使用Microsoft帐户还是Microsoft 365 租户中的帐户旁加载到Office web 版

在以下列表中,转到与方案匹配的部分或文章。 请注意,列表中的第一个方案适用于 Outlook 加载项。其余方案适用于非 Outlook 加载项。

将 Yeoman 创建的加载项旁加载到 Office web 版

ExcelOneNotePowerPointWord 支持此过程。 此示例项目假定你使用的是 使用 Office 外接程序的 Yeoman 生成器创建的项目。

  1. 打开 Office web 版 或 OneDrive。 使用“创建”选项,在 ExcelOneNotePowerPointWord 中创建文档。 在此新文档中,选择“ 共享”,选择“ 复制链接”,然后复制 URL。

  2. 以管理员身份打开命令提示符。 在从项目的根目录开始的命令行中,运行以下命令。 将“{url}”替换为复制的 URL。

    注意

    如果在 Mac 上进行开发,请将 括 {url} 在单引号中。 请勿在 Windows 上执行此操作。

    npm run start:web -- --document {url}
    

    示例如下。

    • npm run start:web -- --document https://contoso.sharepoint.com/:t:/g/EZGxP7ksiE5DuxvY638G798BpuhwluxCMfF1WZQj3VYhYQ?e=F4QM1R
    • npm run start:web -- --document https://1drv.ms/x/s!jkcH7spkM4EGgcZUgqthk4IK3NOypVw?e=Z6G1qp
    • npm run start:web -- --document https://contoso-my.sharepoint-df.com/:t:/p/user/EQda453DNTpFnl1bFPhOVR0BwlrzetbXvnaRYii2lDr_oQ?e=RSccmNP

    如果外接程序未在文档中旁加载,请按照手动旁加载加载项中的说明手动旁加载到Office web 版

  3. 首次使用此方法旁加载 Web 上的加载项时,会看到一个对话框,要求启用开发人员模式。 选中“ 立即启用开发人员模式 ”复选框,然后选择 “确定”。

  4. 你将看到另一个对话框,询问是否要从计算机注册 Office 外接程序清单。 选择“是”

  5. 加载项已安装。 如果它具有外接程序命令,则它应显示在功能区或上下文菜单上。 如果它是任务窗格加载项,而没有任何外接程序命令,则任务窗格应显示。

使用 Visual Studio 时在 Web 上旁加载加载项

如果使用 Visual Studio 开发外接程序,请按 F5桌面 Office 中打开 Office 文档,创建空白文档,然后旁加载加载项。 如果要旁加载到Office web 版,旁加载的过程类似于手动旁加载到 Web。 唯一的区别是,必须更新清单中 SourceURL 元素的值,并可能更新其他元素的值,以包括部署外接程序的完整 URL。

  1. 在 Visual Studio 中,选择“ 查看>属性窗口”。

  2. 解决方案资源管理器中,选择 Web 项目。 这会在“属性”窗口中显示项目 的属性

  3. 在“属性”窗口中复制 SSL URL

  4. 在加载项项目中,打开清单 XML 文件。 请确保正在编辑源 XML。 对于某些项目类型,Visual Studio 将打开 XML 的可视视图,该视图在下一步中不起作用。

  5. 使用刚复制的 SSL URL 来搜索和替换 ~remoteAppUrl/ 的所有实例。 你将看到多个替换项,具体取决于项目类型,并且新 URL 将类似于 https://localhost:44300/Home.html

  6. 保存 XML 文件。

  7. 例如,在解决方案资源管理器中,打开 Web 项目的上下文菜单 (右键单击它) 然后选择“调试>启动新实例”。 这会在不启动 Office 的情况下运行 Web 项目。

  8. 从Office web 版,使用手动旁加载加载项到Office web 版中所述的步骤旁加载加载项

将加载项手动旁加载到 Office web 版

此方法不使用命令行,只能在主机应用程序 ((如 Excel) )中使用命令来完成。

  1. 打开Office web 版。 在 ExcelOneNotePowerPointWord 中打开文档。

  2. 选择“ 主页>加载项”,然后选择“ 更多加载项”。

  3. “Office 加载项 ”对话框中,选择“ 我的外接程序 ”选项卡,选择“ 管理我的外接程序”,然后选择 “上传我的外接程序”。

    Office 加载项对话框的右上方有一个下拉列表,上面写着“管理我的外接程序”,下方有一个带有“上传我的加载项”选项的下拉列表。

  4. 转到加载项清单文件,再选择“上传”

    带浏览、上载和取消按钮的上载外接程序对话框。

  5. 验证是否已安装外接程序。 例如,如果它具有外接程序命令,则它应显示在功能区或上下文菜单上。 如果它是没有外接程序命令的任务窗格加载项,则应显示任务窗格。

注意

若要使用 EdgeHTML (Microsoft Edge 旧版) 测试 Office 加载项,需要执行其他配置步骤。 在 Windows 命令提示符中,运行以下行: npx office-addin-dev-settings appcontainer EdgeWebView --loopback --yes。 当 Office 使用基于Chromium的 Edge WebView2 时,这不是必需的。 有关详细信息,请参阅 Office 外接程序使用的浏览器和 Web 视图控件

重要

Mac 不支持 office-addin-dev-settings 工具。

将加载项旁加载到 Microsoft 365

  1. 登录到 Microsoft 365 帐户。

  2. 打开工具栏左端的应用启动器,选择“Excel”、“OneNote”、“PowerPoint”或“Word”,然后创建新文档。

  3. 按照手动旁加载加载项到Office web 版部分的步骤 2 - 5 进行操作。

删除旁加载加载项

如果运行了 npm start 命令,并且加载项已自动旁加载,请在准备好停止开发服务器并卸载加载项时运行 npm stop

否则,若要删除旁加载到Office web 版的加载项,只需清除浏览器的缓存。 例如,如果对加载项的清单进行更改 (更新图标的文件名或加载项命令的文本) ,则可能需要清除浏览器的缓存,然后使用更新的清单重新旁加载加载项。 这样做允许Office web 版呈现加载项,如更新的清单所述。

另请参阅