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

项目
08/17/2023

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

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

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

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

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

如果要旁加载 Outlook 加载项，请参阅旁加载 Outlook 加载项以进行测试一文。
如果使用 Office 加载项的 Yeoman 生成器创建了加载项，请参阅将 Yeoman 创建的加载项旁加载到Office web 版。
如果使用 Visual Studio 创建了加载项，请参阅使用 Visual Studio 时在 Web 上旁加载加载项。
对于所有其他情况，请参阅以下部分之一。
- 如果要使用 Microsoft 帐户旁加载到Office web 版，请参阅手动旁加载加载项到Office web 版。
- 如果要使用 Microsoft 365 租户中的帐户旁加载到Office web 版，请参阅将加载项旁加载到 Microsoft 365。

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

仅 Excel、OneNote、PowerPoint 和 Word 支持此过程。此示例项目假定你使用的是使用 Office 外接程序的 Yeoman 生成器创建的项目。

打开 Office web 版或 OneDrive。使用“创建”选项，在 Excel、OneNote、PowerPoint 或 Word 中创建文档。在此新文档中，选择“ 共享”，选择“ 复制链接”，然后复制 URL。
以管理员身份打开命令提示符。在从项目的根目录开始的命令行中，运行以下命令。将“{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 版。
首次使用此方法旁加载 Web 上的加载项时，会看到一个对话框，要求启用开发人员模式。选中“ 立即启用开发人员模式 ”复选框，然后选择 “确定”。
你将看到另一个对话框，询问是否要从计算机注册 Office 外接程序清单。选择“是”。
加载项已安装。如果它具有外接程序命令，则它应显示在功能区或上下文菜单上。如果它是任务窗格加载项，而没有任何外接程序命令，则任务窗格应显示。

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

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

在 Visual Studio 中，选择“ 查看>属性窗口”。
在解决方案资源管理器中，选择 Web 项目。这会在“属性”窗口中显示项目 的属性 。
在“属性”窗口中复制 SSL URL。
在加载项项目中，打开清单 XML 文件。请确保正在编辑源 XML。对于某些项目类型，Visual Studio 将打开 XML 的可视视图，该视图在下一步中不起作用。
使用刚复制的 SSL URL 来搜索和替换 ~remoteAppUrl/ 的所有实例。你将看到多个替换项，具体取决于项目类型，并且新 URL 将类似于 https://localhost:44300/Home.html。
保存 XML 文件。
例如，在解决方案资源管理器中，打开 Web 项目的上下文菜单 (右键单击它) 然后选择“调试>启动新实例”。这会在不启动 Office 的情况下运行 Web 项目。
从Office web 版，使用手动旁加载加载项到Office web 版中所述的步骤旁加载加载项。

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

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

打开Office web 版。在 Excel、OneNote、PowerPoint 或 Word 中打开文档。
选择“ 主页>加载项”，然后选择“ 更多加载项”。
在 “Office 加载项 ”对话框中，选择“ 我的外接程序 ”选项卡，选择“ 管理我的外接程序”，然后选择 “上传我的外接程序”。
转到加载项清单文件，再选择“上传”。
验证是否已安装外接程序。例如，如果它具有外接程序命令，则它应显示在功能区或上下文菜单上。如果它是没有外接程序命令的任务窗格加载项，则应显示任务窗格。

注意

若要使用 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

登录到 Microsoft 365 帐户。
打开工具栏左端的应用启动器，选择“Excel”、“OneNote”、“PowerPoint”或“Word”，然后创建新文档。
按照手动旁加载加载项到Office web 版部分的步骤 2 - 5 进行操作。

删除旁加载加载项

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