- [Changelog](#changelog)
- [5.0.0 - May 16, 2023](#500---may-16-2023)
- [4.2.4 - Feb 28, 2023](#424---feb-28-2023)
- [4.2.2 - Feb 7, 2023](#422---feb-7-2023)
- [4.2.0 - Dec 20, 2022](#420---dec-20-2022)
- [4.1.3 - Nov 17, 2022](#413---nov-17-2022)
- [4.1.1 - Nov 02, 2022](#411---nov-02-2022)
- [4.1.0 - Oct 17, 2022](#410---oct-17-2022)
- [4.0.6 - Sep 23, 2022](#406---sep-23-2022)
- [4.0.5 - Aug 22, 2022](#405---aug-22-2022)
- [4.0.4 - Aug 09, 2022](#404---aug-09-2022)
- [4.0.3 - Jul 26, 2022](#403---jul-26-2022)
- [4.0.2 - Jul 12, 2022](#402---jul-12-2022)
- [4.0.1 - Jun 16, 2022](#401---jun-16-2022)
- [4.0.0 - May 24, 2022](#400---may-24-2022)
- [3.8.0 - Apr 22, 2022](#380---apr-22-2022)
- [3.7.0 - Apr 06, 2022](#370---apr-06-2022)
- [3.6.0 - Mar 21, 2022](#360---mar-21-2022)
- [3.5.0 - Mar 07, 2022](#350---mar-07-2022)
- [3.4.0 - Feb 21, 2022](#340---feb-21-2022)
- [3.3.0 - Feb 07, 2022](#330---feb-07-2022)
- [3.2.0 - Jan 10, 2022](#320---jan-10-2022)
- [3.1.1 - Dec 27, 2021](#311---dec-27-2021)
- [3.1.0 - Dec 13, 2021](#310---dec-13-2021)
- [3.0.0 - Nov 29, 2021](#300---nov-29-2021)
- [2.10.0 - Nov 15, 2021](#2100---nov-15-2021)
- [2.9.0 - Nov 01, 2021](#290---nov-01-2021)
- [2.8.0 - Oct 18 2021](#280---oct-18-2021)
- [2.7.0 - Sep 17 2021](#270---sep-17-2021)
# Changelog
## 5.0.0 - May 16, 2023
This major version update of Teams Toolkit addresses your top feedback requests with new features and bug fixes, including a new way to customize the automation with composable actions, integrated tunneling support for debugging using Dev Tunnels, simpler project structure and template options, and much more. We previously shared these incremental changes in the prerelease version and through a series of blog posts:
- [February Prerelease](https://devblogs.microsoft.com/microsoft365dev/teams-toolkit-for-visual-studio-code-v5-0-prerelease/): Update the fundamental new design for Teams Toolkit that allows you to use existing cloud resources, integrate Teams Toolkit with existing projects and customize Teams Toolkit to fit your needs.
- [March Prerelease](https://devblogs.microsoft.com/microsoft365dev/teams-toolkit-for-visual-studio-code-update-march-2023/): Create, debug and deploy an Outlook Add-in project with Teams Toolkit.
- [April Prerelease](https://devblogs.microsoft.com/microsoft365dev/teams-toolkit-for-visual-studio-code-update-april-2023/): Switch to an integrated and secure tunneling for bot and message extension apps. Introduced GitHub Codespaces for a new getting started experience.
We've listened to your feedback and included these additional new features, enhancements, and bug fixes to this release.
New features:
- Added a how-to guide with instructions for running and debugging apps on mobile clients.
- Simplified the Basic Tab project template by removing the dependency on React, single sign-on, and complicated example code. Use this template like an empty starting point for Tab apps.
- You can customize which version of Azure Functions Core Tools is used with the `devTool/install` action. If not specified, the default version used is `4.0.4670` and [supports Node.js 18](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=v4&pivots=programming-language-typescript#languages).
- We've re-categorized the project templates to use familiar terminology that matches the documentation and platform.
Enhancements:
- Removed SPFx version selection when adding additional web parts.
- Updated the `Tab App with Azure Backend` sample to use an on-behalf-of flow for authentication.
- Added a warning message if you're using Node.js 14 because it's [no longer actively supported](https://nodejs.dev/en/about/releases/).
Sample additions:
- `Dice Roller in meeting`: The dice roller example is a simple app that allows multiple users to roll a dice and see the results. This sample is a great way to get started with Live Share and Fluid.
- `Set signature using Outlook add-in`: An Outlook add-in that demonstrates how to set an email signature.
Bug fixes:
- Fixed an issue with `xml2js` package versions that may cause security vulnerabilities. ([#8390](https://github.com/OfficeDev/TeamsFx/pull/8390))
- Fixed an issue where `manifest-file-path` will be asked twice even if it was specified in the parameter for `teamsfx update aad-app` command. ([#8435](https://github.com/OfficeDev/TeamsFx/pull/8435))
- Fixed an issue where the `Validate Application` continues with errors. ([#8467](https://github.com/OfficeDev/TeamsFx/pull/8467))
- Fixed an issue where `teamsfx validate` command will default to `dev` environment even for multi-environment projects in non-interactive cli mode when not specifying `--env` parameters. ([#8499](https://github.com/OfficeDev/TeamsFx/pull/8499))
- Fixed an issue where sometimes Teams Toolkit tree view will not show up if project upgrade detects error.([#8538](https://github.com/OfficeDev/TeamsFx/pull/8538))
## 4.2.4 - Feb 28, 2023
Incremental version for Teams Toolkit with an enhancement.
- Updated SharePoint Framework from `1.16.0` to `1.16.1`.
## 4.2.2 - Feb 7, 2023
Enhancements:
- Updated pre-requisite checker, applicable app templates and samples to support Node.js 18.
- Updated comments on Notification bot template for how to send notifications to an individual person.
- Updated TeamsFx-React SDK to support React 17.
- Updated TeamsFx SDK, relevant bot app templates and samples to use [CloudAdapter](https://learn.microsoft.com/javascript/api/botbuilder/cloudadapter).
- Updated app templates to use TeamsJS SDK v2.7.1.
## 4.2.0 - Dec 20, 2022
New features:
- Use the new Dashboard tab template to create a personal and collaborative canvas in Teams. Learn more about this new template in the [documentation](https://aka.ms/teamsfx-dashboard-app).
Enhancements:
- Step-by-step guidance in Visual Studio Code to assist you while creating a free Microsoft 365 testing tenant.
- Scaffolds that use SharePoint Framework (SPFx) have been updated to use [SharePoint Framework version 1.16](https://learn.microsoft.com/sharepoint/dev/spfx/release-1.16) which introduces the ability to build experiences for Outlook and Office.com (Microsoft 365 app) in addition to Teams.
## 4.1.3 - Nov 17, 2022
Enhancements:
- Bump up version of [@microsoft/teamsfx](https://www.npmjs.com/package/@microsoft/teamsfx) used in templates and samples to `2.0.0` that depends on [@microsoft/teams-js](https://www.npmjs.com/package/@microsoft/teams-js) version `2.0.0` and above. Starting from this version, it enables [Teams app to run in Outlook and Office.com](https://learn.microsoft.com/microsoftteams/platform/m365-apps/overview)
- A/B testing on in-product documentation to display tutorial articles inside Visual Studio Code.
## 4.1.1 - Nov 02, 2022
Enhancements:
- Improved experience to obtain a Microsoft Graph client in [@microsoft/teamsfx](https://www.npmjs.com/package/@microsoft/teamsfx) with separated configration interfaces for different authentication flows.
- Included `useTeams` hook in [@microsoft/teamsfx-react](https://www.npmjs.com/package/@microsoft/teamsfx-react) package. Thanks to its original author [Wictor Wilén](https://github.com/wictorwilen) who first developed this hook in [msteams-react-base-component](https://github.com/wictorwilen/msteams-react-base-component) package.
- Upgraded [@microsoft/teamsfx](https://www.npmjs.com/package/@microsoft/teamsfx) to `2.0.0` that's compatible with [@microsoft/teamjs](https://www.npmjs.com/package/@microsoft/teams-js) `2.0.0` and above.
- Added a shortcut to debug and preview your Teams application from left side tree view under `DEVELOPMENT` section.
## 4.1.0 - Oct 17, 2022
New features:
- Use the new Workflow bot template to create sequential workflows where Adaptive Cards can be returned in response to user input. Learn more about this new template in the [documentation](https://aka.ms/teamsfx-card-action-response).
- Configure each step of the debugging experience in Teams Toolkit by customizing the `.vscode/tasks.json` file, which now [surfaces parameters for finer-tuned control](https://aka.ms/teamsfx-debug-tasks).
- Use the new Add SSO command for a simple way to [configure single sign-on for Message extension and Command bot projects](https://aka.ms/teamsfx-add-sso).
- SPFx developers can now combine web parts as a [multi-Tab Teams app](https://learn.microsoft.com/sharepoint/dev/spfx/build-for-teams-me-experience#build-a-multi-tab-personal-teams-app) using the Add Feature menu.
Enhancements:
- You can now send notifications to a specific channel or person with TeamsFx SDK. Checkout [code snippets](https://aka.ms/teamsfx-send-notification#send-notifications-to-a-specific-channel) here.
- We've changed which windows are shown by default when an app starts debugging so you'll no longer see red error messages coming from the browser that are mistaken as errors for your app.
## 4.0.6 - Sep 23, 2022
Incremental version for Teams Toolkit with multiple bugs fix, enhancements and new features.
New sample:
- Stock Update: Keep up to date with the latest stock price in Microsoft Teams
SDK:
- Simplified single sign-on implementation for message extension with TeamsFx SDK. Take a look at the [sample code](https://aka.ms/teamsfx-me-sso-sample).
- Simplified single sign-on implementation for command bot with TeamsFx SDK. Take a look at the [sample code](https://aka.ms/teamsfx-command-bot-sso).
## 4.0.5 - Aug 22, 2022
Incremental version for Teams Toolkit with multiple bugs fix, enhancements and a new feature to allow switch Microsoft 365 tenant and Azure subscription for local debugging and cloud provision.
## 4.0.4 - Aug 09, 2022
Incremental version for Teams Toolkit with multiple bugs fix, enhancements and new additions to sample application gallery.
New samples:
- Proactive Messaging: Save users' conversation reference to send proactive reminder messages using bots.
- One Productivity Hub: View calendar events, to-do tasks and files in Teams tab.
Enhancement:
- Enhanced experience of building Teams tab application with SharePoint Framework v1.15.0
## 4.0.3 - Jul 26, 2022
Incremental version for Teams Toolkit with multiple bugs fix and enhancements.
Enhancement:
- User can now switch Azure account or Azure subscription to provision cloud resource.
- Now support SPFx version to v1.15.0.
## 4.0.2 - Jul 12, 2022
Incremental version for Teams Toolkit with multiple bugs fix and enhancements.
## 4.0.1 - Jun 16, 2022
Incremental version for Teams Toolkit with multiple bugs fix and enhancements.
## 4.0.0 - May 24, 2022
Major version for Teams Toolkit with new features to support more Teams app scenario like notification bot and command bot. What's more, this version adds support to extend Teams app across Microsoft 365 platform like Office.com and Outlook.
New Features:
- User can create more business-oriented Teams app template using Teams Toolkit. For example, user can now create not only bot app but also notification bot or command bot. User can see more options are there to choose when create a new Teams app.
- User can create Teams app that can launch and preview in other Microsoft 365 platform like Office.com and Outlook. The options are offered when user create a new Teams app.
- User can incrementally add features to their Teams app using `Add features` in Teams Toolkit during the development process. For example, adding additional Teams extending capability, adding Azure resources like SQL Database or Azure Function etc., adding Single Sign on or API connections and so on.
- User can preview the Teams manifest file and only deploy the manifest file without deploy the whole project.
- User can customized Azure AD manifest file.
- Add tutorials in the Teams Toolkit, user can find them by typing the command `Teams: View Guided Tutorials` in the command palette (Ctrl+Shift+P).
- A new sample which use Graph Connector get on board to the Sample Gallery. Click `View Samples` in Teams Toolkit to browse Sample Gallery.
Enhancement:
- UI improvement of `Create a new Teams app` and `Start from a sample`.
- UI improvement of the Teams Toolkit menus in the sidebar.
- Optimize and simplify the Sample apps. Improve the experience of Sample apps.
- Improved the experience of TeamsFx CLI tool.
## 3.8.0 - Apr 22, 2022
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
Enhancement:
- Optimize the configuration schema and manifest template of project created by Teams Toolkit.
- Support to use CodeLens to preview variables value in manifest template file.
- Optimize the In-meeting Sample App in sample gallery, shorten the time to run the sample.
- Improved "Start from a sample" UI, show more information of each sample.
## 3.7.0 - Apr 06, 2022
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
New Features:
- Provide multiple entry points of creating testing tenant/accounts to unblock user from Microsoft 365 account issues, like Microsoft 365 account does not have sideloading permission or user does not have Microsoft 365 account at all. These entry points include:
a). an Add(+) button besides ACCOUNTS in sidebar
b). an new "Create an account" option in `Teams: Accounts` Command
c). improved Get Started page
Enhancement:
- Improved SPFx Project scaffolding experience by using Yeoman Generator.
## 3.6.0 - Mar 21, 2022
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
New Features:
- Optimized Get Started page for Teams Toolkit. User can check environment prerequisites from Get started now.
- User can use Teams Toolkit to create workflow automation templates for Github, Azure DevOps and Jenkins.
Enhancement:
- Enhance TeamsFx SDK.
## 3.5.0 - Mar 07, 2022
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
New Features:
- New sample app - Teams tab app without SSO.
Enhancement:
- Teams tab app generated from "create a new Teams app" can now use graph toolkit to retrieve user data.
## 3.4.0 - Feb 21, 2022
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
Enhancement:
- Improved local debug experience, more light weighted and more graceful.
## 3.3.0 - Feb 07, 2022
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
New Features:
- "Add cloud resources" feature now supports adding multiple instances of the same cloud resource type. For example, add multiple instance of SQL DB at the same time.
Enhancement:
- Teams Tab project created by Teams Toolkit now is updated to use Auth Code Flow with PKCE for SPA authentication. You can find more details [here](https://aka.ms/teamsfx-auth-code-flow). Please be noted that Tab project created by Teams Toolkit of this version will not be supported by previous versions of Teams Toolkit.
## 3.2.0 - Jan 10, 2022
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
New Features:
- Use Service Principle to login Azure account in CICD template.
- Support building React Tab app by different environment variables for multiple environments.
Enhancement:
- Provide guidance to install development certificate on WSL. See guidance [here](https://github.com/OfficeDev/TeamsFx/blob/dev/docs/fx-core/localdebug-help.md#how-to-manually-install-the-development-certificate-for-windows-subsystem-for-linux-wsl-users)
- Support .NET SDK 6.0.
- Improve the experience to preview manifest file and update manifest file to Developer Portal.
- Improve CICD template by reducing dependency on project metadata file.
## 3.1.1 - Dec 27, 2021
This is a hotfix version.
The Azure App service is upgraded and does not support some older NodeJs versions in some regions any more. This hotfix solves the problem that Azure App service is not working in those regions which does not support older NodeJs versions.
## 3.1.0 - Dec 13, 2021
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
New Features:
- Integrate with Azure Key Vault to secure your application secrets at runtime.
- View state file and edit environment configurations from manifest with code lens.
## 3.0.0 - Nov 29, 2021
Major version for Teams Toolkit with new features to support cloud resources customization, multiple cloud environments, collaborations and some bug fix.
New Features:
- Adopt ARM templates to provision Azure cloud resources, support customization of cloud resources. Refer to [Provision cloud resources](https://aka.ms/provision-doc) for more information.
- Developers can create and manage multiple cloud environments with different customizations for each environment. Refer to [Manage multiple environment](https://aka.ms/multi-env-doc) for more information.
- Developers can collaborate with others on the same project. Refer to [Collaborations in Teams Toolkit](https://aka.ms/ttk-collaboration-doc) for more information.
- Support manifest customization for both local and remote environment. Refer to [Customize manifest](https://aka.ms/customize-manifest-doc) for more information.
- Provide flexibility to add cloud resources to your project using ARM template. Refer to [Add cloud resources](https://aka.ms/add-resources-doc) for more information.
- Add more Teams Sample Apps which support local run with no need to manually set up environment.
Enhancement:
- Improve UI: In sample gallery, add time and effort estimation for each sample.
- Improve UI: multiple enhancement to the Tree View. For example, provide documents links in Tree View, and enrich the tooltip descriptions.
- Reduce the required user inputs in order to create new project.
- Enhance the status and messages showed in Teams Toolkit.
- Upgrade samples to adopt new features in Teams Toolkit.
## 2.10.0 - Nov 15, 2021
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
New Features:
- Enable developers with the capability to extend Teams apps to run across Microsoft 365. Developers can invoke two important commands from VS Code Command Palette to upgrade their Teams app to Microsoft 365 custom app. Get detail instructions from our [documentation](https://aka.ms/teamsfx-extend-m365).
- Provide Teams sample apps which can run across Microsoft 365. Users can get a initial experience of running Teams apps in Microsoft 365 by playing with samples first. Developers can get the samples from sample gallery, or click `Create a new Teams app` -> `Start from a sample`, and select sample apps for Microsoft 365.
## 2.9.0 - Nov 01, 2021
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
Preview Features:
- Enable CI/CD for multiple environments scenario.
- Insider Preview features in 2.8.0 release are still in preview. Refer to [Enable insider preview featuers](https://github.com/OfficeDev/TeamsFx/wiki/Enable-Preview-Features-in-Teams-Toolkit) for how to use.
- Upgrade existing projects to support preview features, refer to [Upgrade existing project to use latest features](https://github.com/OfficeDev/TeamsFx/wiki/Upgrade-project-to-use-latest-Toolkit-features) for more information.
Enhancement:
- Improve UI: more friendly user experience to create a new Teams project.
- Improve UI: add links to source code for samples.
- Support one-click deployment of SharePoint framework based Teams app.
- Integrate Adaptive Card Studio with previewing and debugging Adaptive Card in VS Code.
## 2.8.0 - Oct 18 2021
Incremental version for Teams Toolkit with multiple bugs fixes and the following updates:
Preview Features:
- Support management of multiple environments.
- Support project collaborations among multiple developers.
- Improve the experience to customize Azure resource provision using ARM(Azure Resource Manager).
The picture below shows how to enable preview features, more details refer to the [preview guidance](https://github.com/OfficeDev/TeamsFx/wiki/Enable-Preview-Features-in-Teams-Toolkit)
Enhancement:
- Improve UI: making the Tree View and Command Pallete text consistent.
- UX A/B testing:
- Your Tree View(sidebar) may include or exclude quick start page.
- You may or may not be invited to do local debug after create new project.
## 2.7.0 - Sep 17 2021
Incremental version for Teams Toolkit with multiple bugs fixed and the following updates：
Enhancement:
- Improved version upgrade experience by adding "What is New?" info.
- Simplified welcome view when clicking the Toolkit logo on the sidebar.