如何使用Adaptive Cards 1.3 App Studio中查看1.3版本卡片报错如何解决

基础使用规范 #

Adaptive Cards 1.3的使用需遵循以下核心规则，避免基础配置错误：

• 必须在卡片JSON的根节点明确声明版本信息，$schema和version为必填字段，正确配置示例如下：

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card-1.3.json",
  "type": "AdaptiveCard",
  "version": "1.3",
  "body": [
    // 此处填写卡片主体内容
  ],
  "actions": [
    // 此处填写卡片操作按钮配置
  ]
}

• 仅使用1.3版本支持的组件和属性：不要使用1.4及更高版本新增的特性，例如Input.ChoiceSet的isMultiSelect扩展配置、CardElement的rtl属性等，不确定特性归属版本时可以对照官方版本特性清单排查。
• 数据绑定语法严格适配1.3规则：不要使用后续版本新增的绑定语法糖，所有${}格式的绑定表达式要符合1.3的解析逻辑。

App Studio报错排查方案 #

你遇到的报错截图如下：

可以按照以下顺序排查问题：

• 检查版本声明是否匹配：确认$schema字段对应1.3版本的schema地址，同时version字段值为1.3，避免出现schema版本和声明版本不一致的问题。
• 检查组件属性合法性：1.3版本对部分属性的取值范围有明确限制，例如Container的style属性不能使用1.4才新增的accent等值，需要对照1.3的属性列表逐一核对所有配置项。
• 处理App Studio兼容性问题：如果配置确认无误仍报错，先清空App Studio本地缓存后重新加载卡片，部分旧版本App Studio对1.3的支持存在已知bug，更新到最新版App Studio即可解决。
• 适配运行平台规则：如果卡片要在Teams中使用，需要额外确认Teams对1.3版本组件的支持范围，部分组件比如Media在Teams桌面端和移动端的支持度存在差异，需要提前做兼容处理。

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