验证 Office 加载项的清单
应验证加载项的清单文件,以确保它正确且完整。 当你尝试旁加载加载项时,验证还可以识别导致错误“你的加载项清单无效”的问题。 本文介绍了验证清单文件的多种方法。 除非另有指定,否则它们适用于 Microsoft 365 的统一清单和仅外接程序清单。
注意
有关使用运行时日志记录功能来解决加载项清单问题的详细信息,请参阅使用运行时日志记录功能调试加载项。
使用 validate 命令验证清单
如果使用 Office 外接程序的 Teams 工具包 或 Yeoman 生成器 来创建外接程序,则可以在项目的根目录中使用以下命令验证项目的清单文件。
npm run validate
Microsoft 365 和 Copilot 存储验证
该 validate
命令还执行Microsoft 365 和 Copilot 存储验证,但允许开发人员信息(如 localhost URL)。 如果要运行生产级Microsoft 365 和 Copilot 存储验证,请运行以下命令。
npm run validate -- -p
如果在使用该命令时遇到问题,请尝试以下 (将 替换为 MANIFEST_FILE
清单文件的名称) 。
npx office-addin-manifest validate -p MANIFEST_FILE
使用 office-addin-manifest 验证清单
如果未使用 Office 外接程序的 Teams 工具包 或 Yeoman 生成器 来创建外接程序,则可以使用 office-addin-manifest 验证清单。
安装 Node.js。
打开命令提示符,并使用以下命令安装验证程序。
npm install -g office-addin-manifest
在包含清单文件的项目文件夹中运行以下命令, (替换为
MANIFEST_FILE
清单文件的名称) 。office-addin-manifest validate MANIFEST_FILE
注意
如果此命令不起作用,请改为运行以下命令,强制使用最新版本的 office-addin-manifest 工具, (替换为
MANIFEST_FILE
清单文件) 的名称。npx office-addin-manifest validate MANIFEST_FILE
在 Teams 工具包的 UI 中验证清单
如果你正在使用 Teams 工具包并使用统一清单,则可以使用工具包的验证选项。 有关说明,请参阅 验证应用程序。