Teams开发者门户Manifest 1.16版本提交报错：插件包无法识别

我们在Teams开发者门户创建个人应用，提交到「发布到商店」页面时，反复遇到报错：

Provided add-in package was not understood. Please, make sure that the file being submitted is a valid Office add-in package.

不管是创建全新未配置应用，还是导入门户提供的示例应用，都会触发这个错误。之前用Manifest 1.15版本时一切正常，现在这个问题直接卡住了商店提交流程。附出错的manifest 1.16版本代码：

{
  "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
  "version": "1.0.0",
  "manifestVersion": "1.16",
  "id": "57a782c0-8316-4922-a1da-e20c7a1f92b0",
  "packageName": "com.package.name",
  "name": {
    "short": "Test",
    "full": "Booking portal"
  },
  "developer": {
    "name": "ibi",
    "mpnId": "",
    "websiteUrl": "https://example.com/",
    "privacyUrl": "https://example.com/",
    "termsOfUseUrl": "https://example.com/"
  },
  "description": {
    "short": "test description",
    "full": "long long text"
  },
  "icons": {
    "outline": "outline.png",
    "color": "color.png"
  },
  "accentColor": "#FFFFFF",
  "staticTabs": [
    {
      "entityId": "2fc3eb14-4f86-474b-974e-1d9edaa2c47e",
      "name": "home",
      "contentUrl": "https://example.com/",
      "scopes": [
        "personal"
      ],
      "context": [
        "personalTab"
      ]
    },
    {
      "entityId": "about",
      "scopes": [
        "personal"
      ]
    }
  ],
  "validDomains": [
    "example.com"
  ]
}

排查与解决步骤： #

• 回退Manifest版本
  目前商店提交流程对1.16版本可能存在兼容性问题，暂时回退到1.15版本：将manifestVersion改为1.15，同时把$schema地址替换为1.15对应的Schema链接，重新打包提交。

• 修正Manifest必填项缺失
  针对你提供的1.16版本manifest，有两处不符合规范：

  1. 第二个staticTabs项缺少name和contentUrl字段，个人应用的静态Tab必须包含这两个必填项，修正后示例：

     {
       "entityId": "about",
       "name": "About",
       "contentUrl": "https://example.com/about",
       "scopes": [
         "personal"
       ]
     }
     

  2. developer字段中的mpnId不能为空，需要填写有效的微软合作伙伴网络ID（未注册的话先到合作伙伴中心完成注册）。

• 规范应用包打包方式
  确保应用包仅包含manifest.json和所有引用的图标文件，文件路径与manifest中定义完全一致；打包用标准ZIP格式，不要嵌套多余文件夹层级（比如不要把文件放在子目录里）。

• 清除门户缓存
  用无痕浏览器打开Teams开发者门户，重新创建或导入应用，避免浏览器缓存导致的校验逻辑异常。

• 确认账号关联状态
  检查Teams开发者门户账号是否已正确绑定微软合作伙伴中心账号，商店提交流程要求两者关联，未绑定可能触发无效包校验错误。

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