| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| platform | Include Saas Offer | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/deploy-and-publish/appsource/prepare/include-saas-offer.md | If you unlink a SaaS offer included in your Teams store listing, you must republ 1. Go to the [Developer Portal](https://dev.teams.microsoft.com/) and select **Apps**. 1. On the **Apps** page, select the app you're removing the offer from. 1. Go to the **Plans and pricing** page and select **Revert**.-1. Once the offer's unlinked, do the following to update your store listing: +1. After the offer is unlinked, do the following to update your store listing: 1. Select **Distribute > Publish to the Teams store**. 1. Select **Open Partner Center** to begin the process of republishing your app without the offer. If you unlink a SaaS offer included in your Teams store listing, you must republ | **Sample name** | **Description** | **Node.js** | **Manifest**| |--|--|-|-|-|-| Meeting stage view | This app helps to enable and configure your apps for Teams meetings. It also demonstrates use of share in meeting feature.|[View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/tab-app-monetization/nodejs)|[View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/tab-app-monetization/nodejs/demo-manifest/tab-app-monetization.zip)| +| Tab app monetization | This sample app demonstrates how to open a purchase dialog and trigger a purchase flow using Microsoft Teams JavaScript client library (TeamsJS).|[View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/tab-app-monetization/nodejs)|[View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/tab-app-monetization/nodejs/demo-manifest/tab-app-monetization.zip)| ## See also |
| platform | Teamsfx SDK | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/toolkit/TeamsFx-SDK.md | You need to install the following tools and set up your development environment: | | | | | | [Visual Studio Code](https://code.visualstudio.com/download) | JavaScript, TypeScript, or SharePoint Framework (SPFx) build environments. Use version 1.55 or later. | | | [Teams Toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)| A Microsoft Visual Studio Code extension that creates a project scaffolding for your app. Use 4.0.0 version. |- | | [Node.js](https://nodejs.org/en/download/) | Back-end JavaScript runtime environment. Use the latest v16 LTS release.| + | | [Node.js](https://nodejs.org/en/download/) | Back-end JavaScript runtime environment. For more information, see [Node.js version compatibility table for project type](tools-prerequisites.md#nodejs-version-compatibility-table-for-project-type). | | | [Microsoft Teams](https://www.microsoft.com/microsoft-teams/download-app) | Microsoft Teams to collaborate with everyone you work with through apps for chat, meetings, call and all in one place.| | | [Microsoft Edge](https://www.microsoft.com/edge) (recommended) or [Google Chrome](https://www.google.com/chrome/) | A browser with developer tools. | +For more information on Node.js version compatibility, see [Prerequisites for creating your Teams app](/microsoftteams/platform/toolkit/tools-prerequisites?branch=pr-en-us-8020) using Visual Studio Code. + > [!NOTE] > If your project has installed `botbuilder`related [packages](https://github.com/Microsoft/botbuilder-js#packages) as dependencies, ensure they are of the same version. There are three credential classes to simplify authentication. Here's the corres `TeamsUserCredential` represents Teams current user's identity. For the first time user's credentials are authenticated, then Teams SSO does the On-Behalf-Of flow for token exchange. SDK uses this credential when you choose user identity in the browser environment. -The following code is an an example to create `TeamsUserCredential`: +The following code is an example to create `TeamsUserCredential`: ```typescript const authConfig: TeamsUserCredentialAuthConfig = { const authConfig: TeamsUserCredentialAuthConfig = { const credential = new TeamsUserCredential(authConfig); ``` -Required configurations are `initiateLoginEndpoint` and `clientId` which can be found inside type `TeamsUserCredentialAuthConfig`. +Required configurations are `initiateLoginEndpoint` and `clientId` that's found inside type `TeamsUserCredentialAuthConfig`. </details> const oboAuthConfig: OnBehalfOfCredentialAuthConfig = { const oboCredential = new OnBehalfOfUserCredential(ssoToken, oboAuthConfig); ``` -Required configurations are `authorityHost`, `tenantId`, `clientId`, `clientSecret`, or `certificateContent` which can be found inside type `OnBehalfOfCredentialAuthConfig`. +Required configurations are `authorityHost`, `tenantId`, `clientId`, `clientSecret`, or `certificateContent` that's found inside type `OnBehalfOfCredentialAuthConfig`. </details> const appAuthConfig: AppCredentialAuthConfig = { const appCredential = new AppCredential(appAuthConfig); ``` -Required configurations are `authorityHost`, `tenantId`, `clientId`, `clientSecret`, or `certificateContent` which can be found inside type `AppCredentialAuthConfig` +Required configurations are `authorityHost`, `tenantId`, `clientId`, `clientSecret`, or `certificateContent` that's inside type `AppCredentialAuthConfig` </details> ### Bot SSO You can pass custom config when creating a new `TeamsFx` instance to override de For tab project </b> </summary> -If you've created tab project using Microsoft Visual Studio Code Toolkit, the following config values is used from pre-configured environment variables: +If you've created tab project using Microsoft Visual Studio Code Toolkit, the following config values are used from pre-configured environment variables: * authorityHost (REACT_APP_AUTHORITY_HOST) * tenantId (REACT_APP_TENANT_ID) If you've created tab project using Microsoft Visual Studio Code Toolkit, the fo For Azure Function or bot project </b></summary> -If you've created Azure Function or bot project using Visual Studio Code Toolkit, the following config values is used from pre-configured environment variables: +If you've created Azure Function or bot project using Visual Studio Code Toolkit, the following config values are used from pre-configured environment variables: * initiateLoginEndpoint (INITIATE_LOGIN_ENDPOINT) * authorityHost (M365_AUTHORITY_HOST) try { } ``` -If a credential instance is used in other library, such as Microsoft Graph, its possible that an error is caught and transformed. +If a credential instance is used in other library, such as Microsoft Graph, it's possible that an error is caught and transformed. ## Microsoft Graph Scenarios This section provides several code snippets for common scenarios that are relate <details> <summary><b>Use client secret authentication in Azure Function</b></summary> - This code snippet shows you how to use client secret application permission to get the token that can be used to call Graph API. + This code snippet shows you how to use client secret application permission to get the token that's used to call Graph API. 1. You can initialize the `authConfig` by providing a `client secret`. |
| platform | Debug Background Process | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/toolkit/debug-background-process.md | Title: Debug background processes description: In this module, learn how Visual Studio Code and Teams Toolkit work during local debug process. Also learn how to register and configure your Teams app.-+ ms.localizationpriority: high Last updated 03/03/2022 Teams Toolkit checks the following prerequisites during the debug process: |Bot | 14, 16 (recommended)| |Message extension | 14, 16 (recommended) | +For more information, see [Node.js version compatibility table for project type](tools-prerequisites.md#nodejs-version-compatibility-table-for-project-type). + * Teams Toolkit prompts you to sign-in to Microsoft 365 account, if you haven't signed in with your valid credentials. * Custom app uploading or sideloading for your developer tenant is turned on, to prevent local debug termination. * Teams Toolkit installs Ngrok npm package `ngrok@4.2.2` in `~/.fx/bin/ngrok`, if Ngrok isn't installed or the version doesn't match the requirement. Ngrok binary version 2.3 is applicable for bot and message extension. The Ngrok binary is managed by Ngrok npm package in `/.fx/bin/ngrok/node modules/ngrok/bin`. |
| platform | Tools Prerequisites | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/toolkit/tools-prerequisites.md | Before you create your Teams app project, ensure that the prerequisites are in p * [Install required tools to build your Teams app](#install-required-tools-to-build-your-teams-app) * [Prepare Accounts to build your Teams app](#accounts-to-build-your-teams-app)++* [Sideload permission](tools-prerequisites.md) ++## Basic requirements to build your Teams app ++Ensure the following requirements are met before you start building your Teams app: ++| | Basic requirements | For using| For environment type| + | | | | + | **Required** | | | | + | | Teams Toolkit| A Microsoft Visual Studio Code extension that creates a project scaffolding for your app. Use the latest version. | JavaScript and SharePoint Framework (SPFx)| + | | [Microsoft Teams](https://www.microsoft.com/microsoft-teams/download-app) | Collaborate with everyone you work with through apps for chat, meetings, and call - all in one place.| JavaScript and SPFx| + | | [Node.js](https://nodejs.org/en/download/) | Back-end JavaScript runtime environment. For more information, see [Node.js version compatibility](#nodejs-version-compatibility-table-for-project-type).| JavaScript and SPFx| + | |[Node Package Manager (NPM)](https://www.npmjs.com/package/@microsoft/teamsfx) | Install and manage packages for use in both Node.js and ASP.NET Core applications.| JavaScript and SPFx| + | | [Microsoft Edge](https://www.microsoft.com/edge) (recommended) or [Google Chrome](https://www.google.com/chrome/) | A browser with developer tools. | JavaScript and SPFx| + | | [Microsoft Visual Studio Code](https://code.visualstudio.com/download) | JavaScript, TypeScript, or SPFx build environments. Use version 1.55 or later. | JavaScript and SPFx| + | **Optional** | | | | + | | [Azure Tools for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) and [Azure CLI](/cli/azure/install-azure-cli) | Access stored data or deploy a cloud-based back-end for your Teams app in Azure. | JavaScript| + | | [React Developer Tools for Chrome](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi) or [React Developer Tools for Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/react-developer-tools/gpphkfbcpidddadnkolkpfckpihlkkil) | A browser DevTools extension for the open-source React JavaScript library. | JavaScript| + | | [Microsoft Graph Explorer](https://developer.microsoft.com/graph/graph-explorer) | A browser-based tool that lets you run a query from Microsoft Graph data. | JavaScript and SPFx| + | | [Developer Portal for Teams](https://dev.teams.microsoft.com/) | A web-based portal to configure, manage, and distribute your Teams app including to your organization or the Teams store.| JavaScript and SPFx| + * [Verify sideloading permission](#verify-sideloading-permission) ## Install required tools to build your Teams app Ensure that the following tools are installed on the device where youΓÇÖll creat It's recommended that you bookmark the Microsoft Graph Explorer to learn about Microsoft Graph services. This browser-based tool allows you to run a query and access the Microsoft Graph API. +### Node.js version compatibility table for project type ++|Teams Toolkit Version | Project Type | Supported Node.js Versions | +|||| +| 4.2.2 | Notify with http or timer trigger <br> Azure functions <br> SPFx <br> Other | 14, 16, 18 (Preview) <br> 14, 16, 18 (Preview) <br> 16 <br> 14, 16, 18 | +| 4.2.0 | SPFx | 16 | +| 4.0.3 | SPFx | 14, 16 | +| 4.0.0 | Non-SPFx | 14, 16 | +| 3.7.0 | SPFx | 12, 14 | +| <3.7.0 | SPFx <br> Azure functions <br> Other | 10, 12, 14 <br> 10, 12, 14 <br> 10, 12, 14, 16 | + ## Accounts to build your Teams app Ensure that you have the following accounts before you start building your Teams app: |