用途:提供 Microsoft Teams 应用开发的完整模式参考,覆盖从应用包组织到打包、验证、预览的常见环节,适合开发 Teams 应用、Bot 与自适应卡片的场景。
主要能力:
- 应用包结构:appPackage/ 下包含 manifest.json、outline.png(32x32)、color.png(192x192),以及可选的 declarativeAgent.json。
- 清单必填字段:$schema、manifestVersion、version、id、name.short、name.full、description.short、description.full、icons.outline、icons.color、developer.*、validDomains。
- Bot 处理程序:以 TeamsActivityHandler 为基类,在构造函数中通过 onMessage 处理消息。
- 自适应卡片:以 AdaptiveCard 类型、version 1.5、body 与 actions 构成。
- Teams SDK:先 await microsoftTeams.app.initialize(),再通过 getContext() 获取上下文。
- SSO:通过 microsoftTeams.authentication.getAuthToken() 获取令牌。
- Toolkit 命令:npx teamsapp package --env local、npx teamsapp validate --package-file ...、npx teamsapp preview --env local。
常见问题:清单校验失败时检查 schema 版本;Bot 无响应时核对端点与隧道;旁加载失败时需在管理端启用自定义应用。
限制与提醒:Teams 平台演进较快,资料标注最后验证时间为 2026 年 2 月(TTK 5.x、Manifest v1.25),使用前应查阅 Teams 官方文档与 Teams Toolkit 获取最新信息。资料未提供具体收费、价格、平台支持范围与效果数据。