旁加载 Outlook 外接程序进行测试

旁加载 Outlook 加载项进行测试，无需先将其放入外接程序目录中。

重要

如果你的 Outlook 外接程序支持移动设备，请按照本文中针对 Web 版、Windows 或 Mac 版 Outlook 客户端的说明旁加载清单，然后按照 在移动设备上测试加载项中的指导进行操作。

旁加载使用 Microsoft 365 统一应用清单的加载项

旁加载使用 Microsoft 365 统一应用清单的加载项的过程因用于创建外接程序项目的工具而异。

• 对于使用 Teams 工具包创建的外接程序项目，请使用以下选项之一。
  • 使用 Teams 工具包在 Visual Studio Code 中旁加载
  • 使用系统提示、bash shell 或终端旁加载Visual Studio Code
• 对于使用 Office 外接程序的 Yeoman 生成器创建的外接程序项目，请在命令提示符下导航到项目的根目录。 然后，运行 npm run start:desktop。 项目生成并打开节点开发服务器窗口。 此过程可能需要几分钟才能打开 Outlook 桌面版。
• 对于未使用 Yeoman 生成器创建的 NodeJS 和 npm 项目，请使用以下选项之一。
  • 使用 Office-Addin-Debugging 工具旁加载
  • 使用 Teams 工具包 CLI (命令行界面) 旁加载

旁加载使用 XML 清单的加载项

使用 XML 清单的 Outlook 外接程序可以通过命令行自动旁加载，也可以通过“ Outlook 加载项”对话框手动旁加载。

自动旁加载

如果使用 Office 外接程序的 Yeoman 生成器创建了 Outlook 加载项，则旁加载最好通过命令行完成。 这将利用我们的工具，并允许你通过一个命令旁加载所有受支持的设备。

注意

如果要在 macOS 上进行开发，则必须在运行 npm start后手动旁加载加载项。 有关指导，请参阅本文的 手动旁加载 部分。

1. 打开命令提示符并导航到 Yeoman 生成的外接程序项目的根目录。 运行命令 npm start。

2. Outlook 加载项将自动旁加载到台式计算机上的 Outlook。 你将看到一个对话框，指出有人尝试旁加载加载项，其中列出了清单文件的名称和位置。 选择“ 确定”，这将注册清单。

   重要

   如果清单包含错误或清单路径无效，则会收到一条错误消息。

3. 如果清单不包含任何错误且路径有效，则加载项现在将旁加载并在桌面和Outlook 网页版中可用。 它还将安装在所有受支持的设备上。

手动旁加载

虽然我们强烈建议通过命令行自动旁加载，如上一部分所述，你也可以手动旁加载 Outlook 加载项。 使用 XML 清单的加载项通过 “Outlook 加载项”对话框手动旁加载。 以下步骤适用于Outlook 网页版、Windows (新) 和经典) 以及 Mac 上。

1. 在首选浏览器中，转到 https://aka.ms/olksideload。 Outlook 网页版打开，几秒钟后将显示“Outlook 加载项”对话框。

   提示

   • 如果邮箱工具栏如下图所示，则你使用的是经典版本的 Outlook 网页版。

     

     若要访问“Outlook 加载项”对话框，请打开Outlook 网页版。 然后，从工具栏右上角选择齿轮图标，然后选择 “管理加载项”。

     

     请注意，你的组织可能会在邮箱工具栏中包含其自己的徽标，因此你可能会看到与前面的图像中显示的略有不同的内容。

   • 在经典 Outlook on Windows 中，还可以通过选择“文件>信息>管理加载项”来访问“Outlook 加载项”对话框。这会在首选浏览器中打开Outlook 网页版，然后加载对话框。

   • 在 Outlook on Mac 中，从版本 16.85 (24051214) 开始， “获取外接程序 ”按钮不再打开 “Outlook 加载项 ”对话框。 相反，它会在默认浏览器中打开 AppSource 。 早期版本仍可以通过“获取加载项”按钮访问 Outlook 加载项对话框。 如果在 Outlook 版本中未显示 “获取加载项 ”，请从功能区中选择省略号按钮 (...) ，然后选择“ 获取加载项”。

     

2. 在“Outlook 外接程序”对话框中，选择“我的外接程序”。

   

3. 找到对话框底部的 “自定义加载项 ”部分。 选择“ 添加自定义外接程序 ”链接，然后选择“ 从文件添加”。

   

   注意

   “从 URL 添加”选项不再可用于旁加载自定义 Outlook 外接程序。 解决方法是，在首选浏览器中打开 URL 以下载清单文件，然后使用 “从文件添加” 选项旁加载加载项。

4. 找到自定义外接程序的清单文件，然后安装。 接受在安装期间看到的所有提示。

   注意

   在经典 Outlook on Windows 中，手动旁加载的加载项可能需要长达 24 小时才能显示在客户端中。 这是由于缓存。

查找旁加载的加载项

若要了解如何访问 Outlook 客户端中的旁加载加载项，请参阅 在 Outlook 中使用加载项。

删除旁加载加载项

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

否则，在所有版本的 Outlook 上，删除旁加载加载项的关键是“ Outlook 加载项”对话框，其中列出了已安装的加载项。若要访问 Outlook 客户端上的对话框，请使用本文上一部分中为 手动旁加载 列出的步骤。

若要从 Outlook 手动删除旁加载的加载项，请在“ Outlook 加载项 ”对话框中导航到 “自定义加载项” 部分。 选择加载项的省略号 (...) ，然后选择 “删除”。

另请参阅

• 移动设备上的 Outlook 加载项