Adaptive Cards

Adaptive Cards为开发者提供了一种以统一和一致的方式交换内容的新方法。今天开始使用Adaptive Cards在Microsoft Teams、Outlook动态消息、Cortana技能或Windows时间线中，或者使用我们的SDK在您的应用中渲染卡片。

深入了解

• 文档
• 路线图
• 模式浏览器
• 示例卡片
• 设计师

安装和构建

Adaptive Cards旨在在每个用户所在的地方渲染。以下原生平台渲染器目前正在开发中。

PS：最新构建状态是与main分支相匹配。

平台	最新发布	源	文档	最新构建状态
JavaScript		源	文档
.NET		源	文档
.NET WPF		源	文档
.NET HTML		源	文档
Windows UWP		源	文档
Android		源	文档
iOS		源	文档
卡片设计师		源	文档

发布计划

我们假设有更新，每月第三周发布Adaptive Cards产品。请查看下表，获取最近和即将到来的发布日期。

注意：这些发布日期可能会根据产品和活动的开发情况而更改。

代码格式

本项目内的C++代码需遵循clang-format。如果您修改了它们，请确保您的更改文件格式正确。

请确保使用clang-format版本12.0.0及以上版本。

IDE集成

ClangFormat描述了一组基于LibFormat构建的工具。它可以通过独立工具和编辑器集成等不同方式支持您的 workflow。有关详细信息，请参阅https://clang.llvm.net.cn/docs/ClangFormat.html

使用脚本格式化

提供了两个脚本以帮助您格式化文件。

• 仅限Windows用户：使用FormatSource.ps1。此脚本使用默认安装在Visual Studio中的clang-format.exe。

  在项目根目录中执行以下命令

   PowerShell.exe -ExecutionPolicy Bypass scripts\FormatSource.ps1 -ModifiedOnly $False
  

如果是首次运行脚本，请确保输出中clang-format版本为12.0.0或更高版本。否则，您可能需要升级Visual Studio或使用自己的clang-format二进制文件。

[clang-format] Version is:
clang-format version 12.0.0

• Windows和MAC用户：使用clang-format npm包

  在source/nodejs中执行以下命令

   npm run format
  

确保已运行npm install。

使用Git pre-commit钩子

git pre-commit hook是一个可选的过程。当您运行git commit时，它会自动执行格式检查，并在检测到错误时自动修复格式。

首先确保clang-format二进制文件已安装在你的开发环境中。然后修改scripts/hooks/pre-commit，确保clangFormat指向正确的路径。最后设置git钩子。

设置钩子有两种方式

1. 将scripts/hooks/pre-commit复制到.git/hooks
2. git config --local core.hooksPath scripts/hooks

我们二进制包的终端用户许可协议

AdaptiveCards二进制包的消耗受Microsoft EULA（最终用户许可协议）的约束。请参阅以下列出的一些相关条款

• UWP/.NET
• Android/iOS

注意：此存储库中提供的所有源代码，以及我们的NPM包，继续受开源MIT许可证管理。

社区SDKs

以下SDK是由Adaptive Cards社区精心维护的。我们衷心感谢他们的贡献！🎉

平台	安装	存储库	维护者
ReactNative		GitHub	BigThinkCode
Pic2Card		GitHub	BigThinkCode
Vue.js		GitHub	Tim Cadenbach

贡献

有多种方式可以向 Adaptive Cards 贡献。

• 提交错误 并帮助我们在提交时验证修复。
• 审查 源代码更改。
• 在 StackOverflow 上与 Adaptive Cards 用户和开发者互动。
• 加入 Twitter 上的 #adaptivecards 讨论。
• 贡献错误修复.

本项目已采用 Microsoft 开源代码行为准则。有关更多信息，请参阅行为准则常见问题解答或联系 [email protected] 以获得任何其他问题或意见。

支持的功能