| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| platform | Manage Your Apps In Developer Portal | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/build-and-test/manage-your-apps-in-developer-portal.md | In the **Develop** section, you can open and develop your app in Teams Toolkit i In the **Publish** section, you can publish your app to your org or to the Teams Store. +* **App package**: The app package describes how your app is configured that includes app features, required resources, and other important attributes in manifest. The app definition refers to the configuration and settings associated with the application. The Icon tab shows the icon used for your app. ++* **App validation**: Evaluate your app package based on the test cases that Microsoft uses to review your app, app manifest, basic information of your app, and bot capability. The **App validation** tool identifies any errors or warnings in your app package and provides guidelines for resolution. For more information on Microsoft test cases, see [Teams Store validation guidelines](../deploy-and-publish/appsource/prepare/teams-store-validation-guidelines.md) and [Commercial marketplace certification policies](/legal/marketplace/certification-policies). ++ If your app fails any test case, you can review the guidelines and make necessary updates to your app package based on the Microsoft test case results. You can also download your app package and validation report. ++ > [!NOTE] + > App validation is supported only for the apps with bot capability. ++ <br> + <details> + <summary><b>Validate your app package</b></summary><br> ++ To ensure that your app functions as expected in Teams, use the **App validation** tool to check your app package against Microsoft's test cases: ++ 1. In Teams Developer Portal, select **Apps** from the left pane and select your app. + 1. Go to **Publish** > **App validation** > **Get Started**. ++ :::image type="content" source="../../assets/images/tdp/app-validation-home.png" alt-text="Screenshot shows you the App validation in Teams developer portal." lightbox="../../assets/images/tdp/app-validation-get-started.png"::: ++ 1. Select all the checkboxes under **Validation Acknowledgment** and select the **Start Validation**. ++ :::image type="content" source="../../assets/images/tdp/app-validation.png" alt-text="Screenshot shows you the App validation acknowledgment of your app package." lightbox="../../assets/images/tdp/app-validation-start.png"::: ++ > [!NOTE] + > * Before you start validation, resolve any app manifest errors. + > * You can start validation for only one app at a time. ++ Teams Developer Portal now starts to validate your app package: ++ :::image type="content" source="../../assets/images/tdp/app-validation-in-progress.png" alt-text="Screenshot shows you the App validation in progress."::: ++ The app validation status is updated as follows: ++ 1. **Created**: After you select **Start Validation**. + 1. **In progress**: App validation is initiated. + 1. **Completed**: App validation is completed. ++ You can select **Refresh Status** to retrieve latest validation status when the validation is **In progress** status. ++ :::image type="content" source="../../assets/images/tdp/app-validation-refresh.png" alt-text="Screenshot shows the app validation status."::: ++ 1. After validation, it shows a list of test cases your app has passed or failed. The following are the app validation test result status available:<br> ++ |Status|Validation|Result|Description| + |-|-|-|-| + |**Success**| Complete | Pass | No issues. | + |**Warning** | Complete | Pass | Fixing this issue is optional but recommended. | + |**Error** | Complete | Fail | Fixing the issue is required to successfully publish the app. | + |**Skipped**|Incomplete |NA | We weren't able to continue the validation check. This may be a temporary issue. We recommend you rerun the test later.| ++ :::image type="content" source="../../assets/images/tdp/app-validation-result.png" alt-text="Screenshot shows you the app validation tool result."::: ++ </details> + * **Publish to org**: 1. In the Developer Portal, select the **Apps** that you're working. 1. Go to **Publish to org** under **Publish**. 1. Select **Publish your App**. -* **Publish to store**: +* **Publish to Store**: 1. In the Developer Portal, select the **Apps** that you're working.- 1. Go to **Publish to store** under **Publish**. + 1. Go to **Publish to Store** under **Publish**. 1. Select **Publish**. > [!NOTE] > The app validation tool checks your app package against the test cases that Microsoft uses to review your app. Resolve errors or warnings and read the **App submission checklist** before submitting your app. - You can download the app package by selecting **Download app package** button from the **Publish to store** page. --* **App package**: The app package describes how your app is configured that includes app features, required resources, and other important attributes in manifest. The app definition refers to the configuration and settings associated with the application. The Icon tab shows the icon used for your app. + You can download the app package by selecting the **Download app package** button from the **Publish to store** page. ## Test your app directly in Teams The Developer Portal also includes tools to help you build key features of Teams * **Scene studio**: Design [custom Together Mode scenes in Teams](../../apps-in-teams-meetings/teams-together-mode.md) for Teams meetings. * **Adaptive Cards editor (Preview)**: Create and preview Adaptive Cards to include with your apps. * **Identity platform management (Preview)**: Register your apps with Microsoft Entra ID to help users sign in and provide access to APIs.-* **Teams store app validation**: Check your app package against the test cases that Microsoft uses to review your app. +* **Teams Store app validation**: Check your app package against the test cases that Microsoft uses to review your app. We recommend you to use latest app validation tool in your app under [**Publish**](#publish) section. * **Bot management**: Add conversational bots to your app that communicate with users, respond to their questions, and proactively notify them about changes and other events. To add a bot: From the Developer Portal, you can go to Bot Framework portal and configure your * [Teams Toolkit Overview](../../toolkit/teams-toolkit-fundamentals.md) * [Include a SaaS offer with your Microsoft Teams app](~/concepts/deploy-and-publish/appsource/prepare/include-saas-offer.md)+* [Teams Store validation guidelines](../deploy-and-publish/appsource/prepare/teams-store-validation-guidelines.md) +* [Commercial marketplace certification policies](/legal/marketplace/certification-policies) |
| platform | Common Reasons For App Validation Failure | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/deploy-and-publish/appsource/common-reasons-for-app-validation-failure.md | For more information, see [Teams Store validation guidelines for apps with AI-ge * [Distribute your Microsoft Teams app](../apps-publish-overview.md) * [Publish your app to the Microsoft Teams Store](publish.md) * [Microsoft Teams Store validation guidelines](prepare/teams-store-validation-guidelines.md)-* [Commercial marketplace certification policies](/legal/marketplace/certification-policies) * [Microsoft Trademark and Brand Guidelines](https://www.microsoft.com/legal/intellectualproperty/trademarks)+* [Validate your app in Developer Portal for Teams](../../build-and-test/manage-your-apps-in-developer-portal.md#publish) |
| platform | Teams Store Validation Guidelines | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/deploy-and-publish/appsource/prepare/teams-store-validation-guidelines.md | The long description of an app must clearly call out the following: ## See also * [Test and debug your app](~/concepts/build-and-test/debug.md)-* [Distribute your app](~/concepts/deploy-and-publish/apps-publish-overview.md) * [Prepare your Teams Store submission](~/concepts/deploy-and-publish/appsource/prepare/submission-checklist.md) * [Include a SaaS offer with your Teams app](include-saas-offer.md) * [Strategize and execute growth for your app](../post-publish/app-growth/overview-app-growth.md)+* [Validate your app in Developer Portal for Teams](../../../build-and-test/manage-your-apps-in-developer-portal.md#publish) |
| platform | Whats New | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/whats-new.md | Teams platform features that are available to all app developers. **2024 July** +* ***July 31, 2024***: [Use app validation tool to validate your Teams app in Developer Portal for Teams.](concepts/build-and-test/manage-your-apps-in-developer-portal.md#publish) * ***July 03, 2024***: [Screen share content to the meeting Stage simplifies app content sharing during meetings and provides a seamless multi-player viewing experience.](apps-in-teams-meetings/build-apps-for-teams-meeting-stage.md#screen-share-content-to-meetings)- * ***July 02, 2024***: [You can extend bot-based message extension plugins to Teams meetings.](messaging-extensions/build-bot-based-plugin.md#enable-message-extension-as-a-plugin-for-copilot-for-meetings) :::column-end::: Developer preview is a public program that provides early access to unreleased T |02/11/2023| Introduced Adaptive Card Previewer in public developer preview. | Tools > [Adaptive Card Previewer](concepts/build-and-test/adaptive-card-previewer.md)| |25/10/2023| Introduced the `extensions` property in public developer preview app manifest schema. | App manifest > [Public developer preview](resources/schem#extensions)| |25/10/2023| Build message extensions using API (API-based) to interact directly with third-party data, apps, and services. | Build message extensions > [Build message extensions using API](messaging-extensions/api-based-overview.md)|+|28/09/2023| Configure your bot during installation or after installation from the team or group chat where the bot is installed. | Build bots > [Bot configuration experience](bots/how-to/bot-configuration-experience.md)| |31/08/2023| The new Teams client supports light theme for apps in Teams meetings. | Build tabs > [Get context for your tab](tabs/how-to/access-teams-context.md#handle-theme-change)| |28/08/2023| Teams app manifest is now referred to as app manifest. | App manifest > [App manifest schema](resources/schem)| |21/08/2023| Introduced the new Microsoft Teams client to provide better experience for your apps and users | Resources > [Introducing the new Microsoft Teams client](resources/teams-updates.md)| |