如何阻止Excel加载项在Excel Web中加载？现有配置失效求助

当前方案的问题 #

我曾在加载项清单的<Requirements>节点中添加对OpenBrowserWindowApi（最低版本1.1）的需求配置，代码如下：

<Requirements>
    <Sets DefaultMinVersion="1.1">
        <Set Name="SharedRuntime" MinVersion="1.1"/>
        <Set Name="OpenBrowserWindowApi" MinVersion="1.1"/>
    </Sets>
</Requirements>

操作流程：

• 将加载项设为全组织可用
• 在Excel桌面版本地安装加载项
• 打开Excel桌面版，加载该加载项后将文档保存至云端
• 在Excel Web中打开该文档

实际结果：加载项在Web端可见功能区但无法使用，提示“加载项不可用”，不符合预期（预期是完全不加载）。

可行的替代方法 #

方法1：通过清单<Hosts>节点限制宿主 #

直接在清单中指定仅允许桌面版Excel作为宿主，Web端会自动忽略该加载项：

<Hosts>
    <Host Name="Workbook" />
    <Host Name="Desktop" />
</Hosts>

方法2：初始化时检测环境并主动退出 #

在加载项的初始化代码中，通过Office.js判断当前环境，若为Web端则直接隐藏加载项：

Office.onReady().then(() => {
    if (Office.context.platform === Office.PlatformType.Web) {
        Office.addin.hide();
        return;
    }
    // 桌面端正常初始化逻辑
});

这种方式能确保Web端完全看不到加载项的功能区。

方法3：使用桌面专属API的版本要求 #

选择一个明确仅桌面版支持的API集，在<Requirements>中添加对应版本要求，让Web端因不满足条件而不加载：

<Requirements>
    <Sets DefaultMinVersion="1.1">
        <Set Name="SharedRuntime" MinVersion="1.1"/>
        <Set Name="ExcelApi" MinVersion="1.9"/>
    </Sets>
</Requirements>

需确认所选API版本确实为Web端不支持的，可通过Office官方兼容性说明核对。

内容的提问来源于stack exchange，提问作者user1532809