在开发人员门户中管理应用

创建或上传应用后,可以使用以下内容在开发人员门户中管理应用:

概述

“概述 ”部分中,可以看到用于管理应用的以下组件:

  • 仪表板

    • “概述”部分下的“仪表板”中,可以看到应用的以下组件:

      • Teams 应用商店验证:应用验证工具根据查看应用时Microsoft使用的测试用例检查应用包。
      • 公告:Teams 开发人员门户上应用的最新更新。
      • 活动用户 (预览版) :显示活动用户计数。
      • 基本信息:显示 应用 ID版本清单版本和其他基本信息。
      • 升级到 1.17:将应用清单升级到最新版本 1.17,从而支持将 Teams 应用扩展到 Outlook 和 Office。

      屏幕截图是一个示例,显示你在 Teams 开发人员门户中创建的应用的“概述”页。

  • 分析

    “概述”部分的“分析”部分中,可以大致了解应用的使用情况、参与度和其他见解。 有关详细信息,请参阅 如何分析应用的使用情况

配置

若要在 Teams 中安装和呈现应用,必须包含一组可由 Teams 识别的配置。 若要在 Teams 中上传应用,需要具有应用清单,其中包含在 Teams 中显示应用的所有应用详细信息。 这可以通过开发人员门户中提供的组件和工具来实现。

屏幕截图是一个示例,演示如何配置功能以管理和访问开发人员门户中的应用。

“配置” 部分中,可以看到用于管理和访问应用的以下组件:

  • 基本信息:本部分显示并允许编辑 应用名称应用 ID说明版本开发人员信息应用 URL应用程序 (客户端) ID,以及 Microsoft合作伙伴网络 ID (CCP ID) 。
  • 品牌打造:此部分允许你添加格式的.png“颜色”图标和“大纲”图标
  • 应用功能:此部分允许向应用添加以下功能:
    • 个人应用
    • Bot
    • Connector
    • 现场
    • 组和频道应用
    • 消息传递扩展
    • 会议扩展
    • 活动源通知

    注意

    连接器不适用于政府社区云 (GCC) 租户。

  • 权限:此部分允许你为应用授予 设备权限团队权限聊天/会议权限用户权限

    注意

    RSC 权限的最大限制为 16。

  • 单一登录:在 Microsoft Entra ID 上注册的机器人支持单一登录 (SSO) 。 如果在 Bot Framework 门户 (或在“机器人管理) ”下的开发人员门户中注册机器人,则机器人不支持 SSO,并且必须在 Microsoft Entra ID 上注册机器人才能支持 SSO。 对于在 Microsoft Entra ID 上注册的机器人,请添加应用程序 ID URI。 若要从Microsoft Entra ID获取应用程序 ID URI,请参阅如何使用机器人的 SSO 身份验证
  • 语言:本部分允许设置或更改应用的语言。
  • :此部分允许你添加域以在 Teams 客户端中加载应用,例如 *.example.com。

高级

“高级 ”部分中,可以看到以下组件用于在开发人员门户中管理应用:

  • Owners

    每个应用都包含一个 “所有者” 页面,你可以在其中与组织中的其他人共享应用注册。可以添加 管理员操作 角色,以管理谁可以更改应用设置。 操作角色具有权限,例如更新应用的配置。 管理员角色具有权限,例如更新应用配置、添加或删除所有者以及删除应用。 如果应用没有活动所有者,租户管理员可以通过在 Teams 开发人员门户中输入应用 ID 来拥有应用。

    若要添加所有者:

    1. “高级 ”部分中,选择“ 所有者”。
    2. 选择 “添加所有者”。
    3. 输入名称并从下拉列表中选择用户 ID。
    4. “角色”下,选择“ 操作” 或“ 管理员”。
    5. 选择“添加”。
  • 应用内容:可以使用以下功能配置应用:

    • 正在加载指示器:显示一个指示器,让用户知道托管的应用内容 (例如, (TeamsJS v1.x) ) 中称为任务模块的选项卡和对话框。
    • 全屏模式:显示不带应用标头的个人应用。 组织发布的应用支持它。
    • 支持的通道类型:Lists应用支持的非标准通道类型。
    • 默认组功能:对于支持多个组功能的应用(如团队、群组聊天或会议),请选择默认功能,以便在从 Microsoft Teams 应用商店添加应用时导航用户。
  • 环境

    你可以配置环境和全局变量,以帮助将应用从本地运行时过渡到生产环境。 全局变量将用于所有环境。

    若要设置环境,请执行以下步骤:

    1. 在开发人员门户中,选择正在使用 的应用
    2. 转到“高级”部分下的“环境”。
    3. 选择“ + 添加环境>添加”。
    • 全局变量

      1. 选择“ 添加全局变量 ”,为环境创建配置变量。

      若要使用全局变量,请:

      使用变量名称而不是硬编码值来设置应用配置。

      1. 在开发人员门户的任何字段中输入 {{。 此时会显示一个下拉列表,其中包含为所选环境创建的所有变量以及全局变量。
      2. 例如,在下载应用包 (之前,在准备好发布到 Teams 应用商店) 时,请选择要使用的环境。 你的应用配置会根据环境自动更新。
  • 计划和定价:可以链接在合作伙伴中心为应用创建的软件即服务 (SaaS) 产品/服务。

  • 管理员设置

    • 应用自定义:可以通过选择不同的属性(如 名称简短说明小图标和其他属性)来自定义应用。
    • 默认情况下阻止应用:可以默认阻止用户的应用,直到租户管理员选择启用它。

开发

“开发”部分中,可以在 Visual Studio Code 和 Visual Studio 的 Teams 工具包中打开和开发应用。 有关详细信息,请参阅 使用 Teams 工具包开发应用

发布

“发布 ”部分中,可以将应用发布到组织或 Teams 应用商店。

  • 应用包:应用包描述如何配置应用,其中包括清单中的应用功能、所需资源和其他重要属性。 应用定义是指与应用程序关联的配置和设置。 “图标”选项卡显示用于应用的图标。

  • 应用验证:根据Microsoft用于查看应用、应用清单、应用基本信息和机器人功能的测试用例评估应用包。 应用验证工具可识别应用包中的任何错误或警告,并提供解决方法指南。 有关Microsoft测试用例的详细信息,请参阅 Teams 应用商店验证指南和商业市场认证策略

    如果应用未通过任何测试用例,你可以查看指南,并根据Microsoft测试用例结果对应用包进行必要的更新。 还可以下载应用包和验证报告。

    注意

    只有具有机器人功能的应用才支持应用验证。


    验证应用包

    若要确保应用在 Teams 中按预期运行,请使用应用验证工具针对Microsoft的测试用例检查应用包:

    1. 在 Teams 开发人员门户中,从左窗格中选择“ 应用 ”,然后选择你的应用。

    2. 转到 发布>应用验证>入门

      屏幕截图显示了 Teams 开发人员门户中的应用验证。

    3. 选中 “验证确认” 下的所有复选框,然后选择 “开始验证”。

      屏幕截图显示了应用包的应用验证确认。

      注意

      • 在开始验证之前,请解决任何应用清单错误。
      • 在任何给定时间,只能为特定应用提交一个验证请求。 当前验证完成后,可以启动后续请求。

      Teams 开发人员门户现在开始验证应用包:

      屏幕截图显示正在进行的应用验证。

      应用验证状态更新如下:

      1. 创建:选择“ 开始验证”后。
      2. 正在进行:应用验证已启动。
      3. 已完成:已完成应用验证。

      可以选择“ 刷新状态” ,在验证状态为 “正在进行” 时检索最新验证状态。

      显示应用验证状态的屏幕截图。

    4. 验证后,它会显示应用已通过或失败的测试用例列表。 下面是可用的应用验证测试结果状态:

      状态 Validation 结果 说明
      Success 完成 通过 没有任何问题。
      警告 完成 通过 修复此问题是可选的,但建议这样做。
      错误 完成 失败 若要成功发布应用,需要修复此问题。
      已跳过 不完全的 不适用 我们无法继续验证检查。 这可能是暂时性的问题。 建议稍后重新运行测试。

      屏幕截图显示了应用验证工具结果。

    注意

    应用验证工具根据在提交到 Microsoft Teams 应用商店之前用于应用评审的测试用例Microsoft评估应用包。 在提交应用之前,请解决错误或警告并阅读应用 提交清单

  • 发布到组织

    1. 在开发人员门户中,选择正在使用 的应用
    2. 转到 “发布” 下的“ 发布到组织”。
    3. 选择 “发布应用”。
  • 发布到应用商店

    1. 在开发人员门户中,选择正在使用 的应用
    2. 转到 “发布” 下的“ 发布到应用商店”。
    3. 选择“发布”。

    可以通过从“发布到应用商店”页中选择“下载应用包”按钮来下载应用包。

直接在 Teams 中测试应用

开发人员门户提供用于测试和调试应用的选项:

  • 在“概述”页上,可以看到快照你的应用是否已配置并针对 Teams 应用商店测试用例进行验证。
  • “Teams 中的预览”按钮会在 Teams 客户端中快速启动应用,以便进行调试。

使用工具创建应用功能

开发人员门户还包括有助于构建 Teams 应用的关键功能的工具。 以下是工具:

  • 场景工作室在 Teams 会议中设计自定义的一起模式场景
  • 自适应卡片编辑器 (预览) :创建和预览要包含在应用中的自适应卡片。
  • 标识平台管理 (预览版) :使用 Microsoft Entra ID 注册应用,以帮助用户登录并提供对 API 的访问权限。
  • Teams 应用商店应用验证:根据Microsoft用于查看应用的测试用例检查应用包。 建议在 “发布 ”部分下的应用中使用最新的应用验证工具。
  • 机器人管理:向应用添加对话机器人,以便与用户通信、回答其问题,并主动通知他们更改和其他事件。

添加机器人:

  1. 在开发人员门户中,选择左窗格中的“ 工具 ”。

  2. 选择 “机器人管理”。

    屏幕截图是一个示例,其中显示了开发人员门户中的工具,可帮助你生成关键功能。

  3. 在“机器人管理”页中,选择“ + 新建机器人”。

  4. 输入名称,然后选择“ 添加”。

    使用机器人管理选项添加新的机器人。

在开发人员门户中,可以转到 Bot Framework 门户,将机器人配置为更新图标和其他属性。

注意

机器人 ID 不支持环境变量。

另请参阅