适用于 Microsoft 365 的应用包
发布时间:2026-07-13 | 浏览:1
访问此页面需要授权。 可以尝试 登录 或 更改目录 。
访问此页面需要授权。 可以尝试 更改目录 。
Microsoft 365 应用的应用包是一个 zip 文件,其中包含一个清单文件、两个应用图标,以及可能的其他配置或本地化文件。 应用逻辑和数据存储托管在其他地方,并由 Microsoft 365 主机应用程序通过 HTTPS 进行访问。 你将向管理员提交应用包,以便发布到组织或合作伙伴中心,以发布到Microsoft市场。
应用清单 ( manifest.json ) ,其中描述了应用配置、功能、所需的资源和重要属性。
() (192 x 192 像素) 的大全彩图标 color.png ,用于在智能 Microsoft 365 Copilot 副驾驶® UI 和存储中显示代理。
小轮廓图标 ( outline.png ) ,32 x 32 像素,具有透明背景 (当前未在 Copilot 中使用,但需要通过验证) 。
应用包还可以包含声明性代理和 API 插件定义,以及适用于其他受支持语言的本地化文件。
Microsoft 365 的统一应用清单是一个 JSON 文件,用于描述加载项的功能和特征,例如:
外接程序的显示名称、说明、ID、版本和默认区域设置。
外接程序的显示名称、说明、ID、版本和默认区域设置。
如何将外接程序与 Office 集成。
如何将外接程序与 Office 集成。
加载项如何与 Copilot (预览版) 集成。
加载项如何与 Copilot (预览版) 集成。
外接程序的权限级别和数据访问要求。
外接程序的权限级别和数据访问要求。
有关清单的详细概述,请参阅 具有 Microsoft 365 统一应用清单的 Office 外接程序 。 有关参考文档,请参阅 Microsoft 365 应用清单架构参考 。
应用包必须同时包含应用图标的颜色和大纲版本,作为 .png 文件。 这些图标具有特定的大小要求,以便通过存储验证。 有关 Microsoft 365 应用包的颜色和大纲图标的详细设计指南,请参阅 外接程序购置和管理的设计图标 。
除了清单和两个图标文件外,应用包还可能包含以下一些文件。
清单的 属性中 "localizationInfo" 引用的本地化文件。
属性中 "copilotAgents" 引用的 Copilot 声明性代理文件。
任何第二级补充文件。 例如,Copilot 声明性代理配置文件有时引用第二级补充文件,例如 Copilot 插件配置文件。
此应用包文件通常由用于创建和测试 Microsoft 365 的应用的工具为你创建,但在某些情况下,你可以手动创建它。 为此,请使用任何 zip 实用工具创建包含以下文件的 zip 文件。
统一清单,位于 zip 文件的根目录中。
清单的 属性中 "icons" 引用的两个图像文件。
清单的 属性中 "localizationInfo" 引用的任何本地化文件。
属性中 "copilotAgents" 引用的任何声明性代理文件。
任何第二级补充文件。 例如,Copilot 声明性代理配置文件有时引用第二级补充文件,例如 Copilot 插件配置文件。 还应包括这些内容。
所有这些文件在 zip 文件中的相对路径必须与清单中指定的路径相同。 例如,如果两个图像文件的路径是 assets/color.png 和 assets/outline.png ,则必须在 zip 包中包含包含这两个文件的 assets 文件夹。 第二级文件(例如声明性代理的插件配置文件)在 zip 文件中的相对路径必须与在引用它们的第一级文件中具有相同的相对路径。 例如,如果清单中指定的声明性代理文件的相对路径是 agents/myAgent.json ,则必须在 zip 包中包含 代理 文件夹,并将 myAgent.json 文件放入其中。 如果声明性代理文件反过来为插件配置文件提供 插件/myPlugin.json 的相对路径,则必须在 agents 文件夹下包含 插件 子文件夹,并将 myPlugin.json 文件放入其中。
为了最大程度地提高与 Microsoft 365 开发工具的兼容性,建议将包中包含的文件保存在项目根目录中名为 appPackage 的文件夹中,并将包文件放在 appPackage 文件夹中名为 build 的子文件夹中。
下面是建议结构的示例。 \build\appPackage.zip 文件中的结构必须镜像 appPackage 文件夹的结构, 生成 文件夹本身除外。
在清单的 属性中引用的 "extensions.keyboardShortcuts.keyMappingFiles" JSON 文件 不包括 在应用包中。 它们随加载项的 Web 应用程序文件一起部署。 有关详细信息,请参阅支持外接程序 与 Microsoft 市场中统一清单的向后兼容性 。
想要尝试使用 Ask Learn 阐明或指导你完成本主题?
Last updated on 2026-03-24