PAYATHON 2026

Word 加载项如何仅面向桌面版 Word?

数据小许

结论

根据题目提供的要求集说明,WordApiDesktop 不能作为激活要求写入 manifest.xml,因此无法通过将它添加到 <Requirements> 中排除 Word for Web。题目中的 WordApi 1.9 要求同样适用于 Word for Web,不能用于筛选桌面平台。

题目给出的配置是:

<Requirements>
  <Sets>
    <Set Name="WordApi" MinVersion="1.9"/>
  </Sets>
</Requirements>

发布时限定支持的平台

认证团队反馈,如果加载项不支持 Web,应从 Metadata 中移除对应的客户端版本。根据这条反馈,应检查提交信息里的客户端或平台支持设置,只保留实际支持的 Word 桌面客户端,并移除 Word for Web。平台限制应通过发布 Metadata 设置,而不是把 WordApiDesktop 填入 manifest。

运行时处理

除了筛选平台,还应在运行时确认当前环境是否支持所需功能;如果不支持,就不要访问 context.document.shapes。题目提供的资料没有给出具体检测代码或完整的 API 名称,因此不宜补充未经确认的调用示例。可以在启动时检查相应的桌面能力;如果检查失败,应显示明确提示,并停止依赖 shapes 的操作。

如果无法通过发布 Metadata 限定客户端,运行时检查只能妥善处理不兼容的环境,无法让 Word for Web 获得仅桌面版支持的功能。可参考题目提到的 WordApiDesktop 要求集说明 和 Word 要求集说明。

备注:内容仅供参考。