验证 Office 加载项的清单

  • 项目

应验证加载项的清单文件，以确保它正确且完整。 当你尝试旁加载加载项时，验证还可以识别导致错误“你的加载项清单无效”的问题。 本文介绍了验证清单文件的多种方法。 除非另有指定，否则它们适用于 Microsoft 365 的统一清单和 XML 清单。

注意

有关使用运行时日志记录功能来解决加载项清单问题的详细信息，请参阅使用运行时日志记录功能调试加载项。

使用 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 验证清单。

  1. 安装 Node.js。

  2. 打开命令提示符，并使用以下命令安装验证程序。

    npm install -g office-addin-manifest

  3. 在包含清单文件的项目文件夹中运行以下命令， (替换为MANIFEST_FILE清单文件的名称) 。

    office-addin-manifest validate MANIFEST_FILE

    注意

    如果此命令不起作用，请改为运行以下命令，强制使用最新版本的 office-addin-manifest 工具， (替换为 MANIFEST_FILE 清单文件) 的名称。

    npx office-addin-manifest validate MANIFEST_FILE

在 Teams 工具包的 UI 中验证清单

如果你正在使用 Teams 工具包并使用统一清单，则可以使用工具包的验证选项。 有关说明，请参阅 验证应用程序。

另请参阅