发布可跨 Microsoft 365 扩展的 Teams 应用的一般准则
若要开发和发布跨 Microsoft 365 客户端扩展的 Teams 应用,需要遵守一组特定要求。 本部分提供详细的指南,有助于使应用符合要求,并增加成功发布的可能性。
在本文中,你将找到有关以下准则的详细信息:
通用准则
设计用于跨 Microsoft 365 客户端扩展的 Teams 应用必须使用应用清单版本 1.13 或更高版本。
应用的支持 URL 必须跨 Microsoft 365 客户端携带与应用相关的内容,并且不能仅引用单个客户端。
应用 “入门”、“ 登录”、“ 注册”、“ 注销”、“ 帮助 页”或“转发方式”消息中提供的内容必须引用所有受支持的客户端。
应用必须在可扩展到的每个客户端中提供重要的价值。 例如,如果你在 Teams 中有一个仅限选项卡的应用,并且你希望你的应用可扩展到 Microsoft 365 和 Outlook,则必须确保该应用在 Microsoft 365 和 Outlook 客户端中提供合适的工作流。 你的应用必须提供与应用可扩展到的所有 Microsoft 客户端兼容的可行解决方案。
为了说明你的应用在所有可扩展客户端中向用户提供重要价值的要求,下面是一些方案,我们会看到 Contoso 应用扩展到 Microsoft 365 和 Outlook,为 Teams 中的用户提供重要价值,但在 Microsoft 365 和 Outlook 客户端中不提供可用的工作流。
Contoso 是一个全公司新闻聚合器应用,用于聚合在 Teams 中个人选项卡中在公司中传播的所有内部新闻和重要信息,以造福于最终用户。 Contoso 用户可以将 Contoso Teams 应用添加到其个人范围,并了解公司范围的实时新闻文章。 如果用户需要有关使用应用的全部潜力的指导,Contoso 还有一个“帮助”选项卡,其中包含功能的完整演练。 Contoso 支持在这些客户端上的个人选项卡中扩展到 Microsoft 365 和 Outlook。 但是,用户从 Microsoft 365 或 Outlook 应用商店添加 Contoso 应用后,用户只会看到“帮助”选项卡,但 Microsoft 365 和 Outlook 中不会显示包含聚合新闻内容的个人选项卡。 因此,Microsoft 365 和 Outlook 上的 Contoso 应用不提供可用软件解决方案,并且不满足这些客户端中的显著价值。
Outlook 中的 Contoso 应用:
Microsoft 365 中的 Contoso 应用:
建议:
为了提供重要的价值,Contoso 应用开发人员必须确保 Teams 中包含聚合新闻内容的“个人”选项卡也显示在 Microsoft 365 和 Outlook 客户端中。
兼容性指南
- 跨 Microsoft 365 客户端扩展的 Teams 应用必须在最新版本的 Microsoft Edge 和 Google Chrome 客户端上完全响应并正常运行。
- 用户必须能够调用并使用以下最新版本的个人选项卡或消息扩展:
- 桌面版、Web 版和 iOS 版 Outlook。
- 桌面版、Web 版、Android 版和 iOS 版 Microsoft 365。
移动体验指南
- 用户必须能够从 Microsoft 365 和移动版 Outlook 客户端中的操作浮出菜单启动应用,并且应用名称必须显示在操作栏中。
- 用户必须能够在移动版 Microsoft 365 客户端中的多个静态选项卡之间启动和切换,并且必须加载选项卡。 如果静态选项卡超过三个,则剩余的选项卡必须在 “更多 ”部分下可见。
- 如果应用使用单一登录 (SSO) ,则必须在首次启动应用的客户端中成功对用户进行身份验证,而无需在每个客户端上重新进行身份验证。
- 当用户从移动版 Microsoft 365 和 Outlook 客户端切换或注销时,应用必须关闭用户的实例。
- 用户必须能够返回到其以前的工作状态。 如果用户位于根页上,则后退导航必须在移动设备上的客户端中结束应用实例。
- 支持深层链接到工作流的应用必须能够将用户重定向到适当的登陆页面体验。
- 当应用加载时,必须显示进度指示器,并在应用完全加载后自动关闭。
- 当应用由于网络不连贯或中断、超时和身份验证失败而无法加载时,必须显示错误屏幕。