管理 Office 外接程序的统一清单和仅外接程序清单版本

项目
06/12/2024

Microsoft 正在对 Microsoft 365 开发人员平台进行大量改进。这些改进为 Microsoft 365 的所有扩展类型（包括 Office 加载项）的开发、部署、安装和管理提供了更高的一致性。

我们正在研究的一个重要改进是能够使用相同的清单格式为所有Microsoft 365 扩展创建单个分发单元： Microsoft 365 的 JSON 格式统一清单。

提示

有关将现有外接程序转换为使用统一清单的信息，请参阅转换外接程序以使用 Microsoft 365 的统一清单。

创建使用统一清单的外接程序版本后，必须链接现有加载项和使用统一清单生成的应用，以确保用户在 Outlook 中看不到外接程序 UI 的两个副本。

注意

在用户计算机上安装新版本后，下面所述的配置在最多 24 小时内不会生效。在此期间，两个版本的 UI 都可见。例如，如果这两个版本都有一个自定义功能区按钮，则这两个按钮都显示在功能区上。

使用以下步骤。

打开“extensions”数组中的扩展对象。
创建一个“alternatives”数组属性（如果还没有）。
在“alternatives”数组中，创建具有“hide”属性的“alternate”对象。
如果现有加载项是通过 AppSource 销售的，请为“hide”对象提供“storeOfficeAddin”属性。否则，请跳到步骤 6。
为“storeOfficeAddin”对象提供两个属性：
- 将旧加载项的 GUID 作为其值的“officeAddinId”。
- 将 AppSource 资产 ID 作为其值的“assetId”。
示例如下：
```
"extensions": [
    ...
    {
        ...
        "alternates": [
            ...
            {
                ...
                "hide": {
                    "storeOfficeAddin": {
                        "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4",
                        "assetId": "WA999999999"
                    }
                }
            }
        ]
    }
]
```
注意
- 统一清单中加载项的资产 ID 必须与合作伙伴中心卖家帐户发布的现有加载项匹配。如果在统一清单中链接的加载项的资产 ID 与卖家帐户发布的现有产品/服务不匹配，统一清单提交将失败。需要更新清单以使用正确的外接程序资产 ID 并重新提交统一清单。
- 现有外接程序只能由单个统一清单隐藏。目前，不能使用多个统一清单来隐藏同一加载项。如果尝试使用其他统一清单隐藏已链接的加载项，提交将失败。需要删除链接并重新提交统一清单。
如果旧加载项不是通过 AppSource 分发的，则为“hide”对象提供“customOfficeAddin”属性。

为“customOfficeAddin”对象提供一个“officeAddinId”属性，并将旧加载项的 GUID 作为其值。示例如下。

"extensions": [
    ...
    {
        ...
        "alternates": [
            ...
            {
                ...
                "hide": {
                    "customOfficeAddin": {
                        "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4"
                    }
                }
            }
        ]
    }
]

不要从 AppSource 或 Microsoft 365 管理中心中删除现有加载项，否则早期版本的 Office 将无法再使用加载项。

在近期内维护这两个版本

通常，使用统一清单的加载项只能在 Microsoft 365 版本 2307 (内部版本 16626.20132) 及更高版本上安装。但是，有两个例外，允许在旧版 Microsoft 365 和 Office 的永久许可证版本上安装这些加载项。

用户的Microsoft 365 管理员为所有用户部署加载项。
用户在版本 2307 的另一个 Microsoft 365 客户端应用上安装外接程序 (内部版本 16626.20132) 及更高版本。这使加载项在同一用户的其他 Office 客户端（包括旧版或永久许可证）上可用。

如果你的用户使用的是旧版或永久许可证版本，但这些例外不适用，则需要维护加载项的这两个版本。当所有用户都在使用支持统一清单的 Office 版本时，可以从部署中删除 XML 版本。

在某些情况下，你可能希望将这两个版本的加载项长时间保留。例如，统一清单不支持加载项的两项功能，因为它们很少被使用或弃用。可以选择维护使用这些功能的加载项版本。以下是统一清单中不支持的功能。

不支持 Outlook 模块。但是，可以通过在单个应用中将 Teams 选项卡与加载项一起，使用统一清单提供几乎相同的体验。
不支持 Outlook 上下文加载项 (也称为“激活规则”) 。但可以使用统一清单和基于事件的激活提供类似的体验。

使两个版本可用的关键要求是确保其中两个版本在 Outlook UI 中显得不同。

为新版本指定与现有加载项不同的名称。
为新版本创建和使用不同的图标。
请确保新版本中统一清单的“id”属性与现有外接程序的仅外接程序清单中的 Id> 元素不同<。

注意

如果使用相同的名称和图标，则旧解决方案和新解决方案在加载项安装的 Outlook UI 中显示为无法区分。

通过

管理 Office 外接程序的统一清单和仅外接程序清单版本

在近期内维护这两个版本

其他资源