@microsoft/teamsfx-core 2.0.0-alpha.df941b6ed.0 → 2.0.0-alpha.e49547890.0

package/templates/core/v3Migration/js.ts.app.yml

@@ -1,90 +1,151 @@
+# yaml-language-server: $schema=https://aka.ms/teams-toolkit/1.0.0/yaml.schema.json
+# Visit https://aka.ms/teamsfx-v5.0-guide for details on this file
+# Visit https://aka.ms/teamsfx-actions for details on actions
 version: 1.0.0
 
 projectId: {{projectId}}
 
 environmentFolderPath: ./ {{~environmentFolder}}
 
+# Triggered when 'teamsfx provision' is executed
 provision:
 {{#if activePlugins.fx-resource-aad-app-for-teams}}
-  - uses: aadApp/create # Creates a new Azure Active Directory (AAD) app to authenticate users if the environment variable that stores clientId is empty
+  # Creates a new Azure Active Directory (AAD) app to authenticate users if
+  # the environment variable that stores clientId is empty
+  - uses: aadApp/create
     with:
-      name: {{aadAppName}} # Note: when you run aadApp/update, the AAD app name will be updated based on the definition in manifest. If you don't want to change the name, make sure the name in AAD manifest is the same with the name defined here.
-      generateClientSecret: true # If the value is false, the action will not generate client secret for you
-      signInAudience: "AzureADMyOrg" # Authenticate users with a Microsoft work or school account in your organization's Azure AD tenant (for example, single tenant).
-    writeToEnvironmentFile: # Write the information of created resources into environment file for the specified environment variable(s).
+      # Note: when you run aadApp/update, the AAD app name will be updated
+      # based on the definition in manifest. If you don't want to change the
+      # name, make sure the name in AAD manifest is the same with the name
+      # defined here.
+      name: {{aadAppName}}
+      # If the value is false, the action will not generate client secret for you
+      generateClientSecret: true
+      # Authenticate users with a Microsoft work or school account in your
+      # organization's Azure AD tenant (for example, single tenant).
+      signInAudience: "AzureADMyOrg"
+    # Write the information of created resources into environment file for the
+    # specified environment variable(s).
+    writeToEnvironmentFile:
       clientId: AAD_APP_CLIENT_ID
-      clientSecret: SECRET_AAD_APP_CLIENT_SECRET # Environment variable that starts with `SECRET_` will be stored to the .env.{envName}.user environment file
+      # Environment variable that starts with `SECRET_` will be stored to the
+      # .env.{envName}.user environment file
+      clientSecret: SECRET_AAD_APP_CLIENT_SECRET
       objectId: AAD_APP_OBJECT_ID
       tenantId: AAD_APP_TENANT_ID
       authority: AAD_APP_OAUTH_AUTHORITY
       authorityHost: AAD_APP_OAUTH_AUTHORITY_HOST
 {{/if}}
-  - uses: teamsApp/create # Creates a Teams app
+  # Creates a Teams app
+  - uses: teamsApp/create
     with:
-      name: {{teamsAppName}} # Teams app name
+      # Teams app name
+      name: {{teamsAppName}}
+    # Write the information of created resources into environment file for
+    # the specified environment variable(s).
     writeToEnvironmentFile:
       teamsAppId: TEAMS_APP_ID
 {{#if activePlugins.fx-resource-bot}}
-  - uses: botAadApp/create # Creates a new AAD app for Bot Registration.
+  # Create or reuse an existing Azure Active Directory application for bot.
+  - uses: botAadApp/create
     with:
+      # The Azure Active Directory application's display name
       name: {{appName}}bt$\{{RESOURCE_SUFFIX}}
     writeToEnvironmentFile:
+      # The Azure Active Directory application's client id created for bot.
       botId: BOT_ID
+      # The Azure Active Directory application's client secret created for bot.
       botPassword: SECRET_BOT_PASSWORD
 {{/if}}
-  - uses: arm/deploy # Deploy given ARM templates parallelly.
+  - uses: arm/deploy  # Deploy given ARM templates parallelly.
     with:
-      subscriptionId: $\{{AZURE_SUBSCRIPTION_ID}} # The AZURE_SUBSCRIPTION_ID is a built-in environment variable. TeamsFx will ask you select one subscription if its value is empty. You're free to reference other environment varialbe here, but TeamsFx will not ask you to select subscription if it's empty in this case.
-      resourceGroupName: $\{{AZURE_RESOURCE_GROUP_NAME}} # The AZURE_RESOURCE_GROUP_NAME is a built-in environment variable. TeamsFx will ask you to select or create one resource group if its value is empty. You're free to reference other environment varialbe here, but TeamsFx will not ask you to select or create resource grouop if it's empty in this case.
+      # AZURE_SUBSCRIPTION_ID is a built-in environment variable,
+      # if its value is empty, TeamsFx will prompt you to select a subscription.
+      # Referencing other environment variables with empty values
+      # will skip the subscription selection prompt.
+      subscriptionId: $\{{AZURE_SUBSCRIPTION_ID}}
+      # AZURE_RESOURCE_GROUP_NAME is a built-in environment variable,
+      # if its value is empty, TeamsFx will prompt you to select or create one
+      # resource group.
+      # Referencing other environment variables with empty values
+      # will skip the resource group selection prompt.
+      resourceGroupName: $\{{AZURE_RESOURCE_GROUP_NAME}}
       templates:
-       - path: ./templates/azure/main.bicep # Relative path to this file
-         parameters: ./templates/azure/azure.parameters.$\{{TEAMSFX_ENV}}.json # Relative path to this file. Placeholders will be replaced with corresponding environment variable before ARM deployment.
-         deploymentName: teams_toolkit_deployment # Required when deploy ARM template
-      bicepCliVersion: v0.4.613 # Teams Toolkit will download this bicep CLI version from github for you, will use bicep CLI in PATH if you remove this config.
+        - path: ./templates/azure/main.bicep  # Relative path to this file
+          # Relative path to this yaml file.
+          # Placeholders will be replaced with corresponding environment
+          # variable before ARM deployment.
+          parameters: ./templates/azure/azure.parameters.$\{{TEAMSFX_ENV}}.json
+          # Required when deploying ARM template
+          deploymentName: teams_toolkit_deployment
+      # Teams Toolkit will download this bicep CLI version from github for you,
+      # will use bicep CLI in PATH if you remove this config.
+      bicepCliVersion: v0.4.613
 {{#if activePlugins.fx-resource-frontend-hosting}}
   - uses: azureStorage/enableStaticWebsite
     with:
       storageResourceId: $\{{ {{~placeholderMappings.[state.fx-resource-frontend-hosting.storageResourceId]~}} }}
       indexPage: index.html
       errorPage: error.html
-    # Output: N/A
 {{/if}}
 {{#if activePlugins.fx-resource-aad-app-for-teams}}
-  - uses: aadApp/update # Apply the AAD manifest to an existing AAD app. Will use the object id in manifest file to determine which AAD app to update.
+  # Apply the AAD manifest to an existing AAD app. Will use the object id in
+  # manifest file to determine which AAD app to update.
+  - uses: aadApp/update
     with:
-      manifestPath: ./aad.manifest.json # Relative path to this file. Environment variables in manifest will be replaced before apply to AAD app
+      # Relative path to this file. Environment variables in manifest will
+      # be replaced before apply to AAD app
+      manifestPath: ./aad.manifest.json
       outputFilePath : ./build/aad.manifest.$\{{TEAMSFX_ENV}}.json
 {{/if}}
-  - uses: teamsApp/validateManifest # Validate using manifest schema
+  # Validate using manifest schema
+  - uses: teamsApp/validateManifest
     with:
-      manifestPath: ./appPackage/manifest.json # Path to manifest template
-  - uses: teamsApp/zipAppPackage # Build Teams app package with latest env value
+      # Path to manifest template
+      manifestPath: ./appPackage/manifest.json
+  # Build Teams app package with latest env value
+  - uses: teamsApp/zipAppPackage
     with:
-      manifestPath: ./appPackage/manifest.json # Path to manifest template
+      # Path to manifest template
+      manifestPath: ./appPackage/manifest.json
       outputZipPath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
       outputJsonPath: ./build/appPackage/manifest.$\{{TEAMSFX_ENV}}.json
-  - uses: teamsApp/update # Apply the Teams app manifest to an existing Teams app. Will use the app id in manifest file to determine which Teams app to update.
+  # Validate app package using validation rules
+  - uses: teamsApp/validateAppPackage
     with:
-      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip # Relative path to this file. This is the path for built zip file.
-    writeToEnvironmentFile:
-      teamsAppId: TEAMS_APP_ID
+      # Relative path to this file. This is the path for built zip file.
+      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
+  # Apply the Teams app manifest to an existing Teams app in
+  # Teams Developer Portal.
+  # Will use the app id in manifest file to determine which Teams app to update.
+  - uses: teamsApp/update
+    with:
+      # Relative path to this file. This is the path for built zip file.
+      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
 {{#if isM365}}
-  - uses: m365Title/acquire # Upload your app to Outlook and the Microsoft 365 app
+  # Extend your Teams app to Outlook and the Microsoft 365 app
+  - uses: teamsApp/extendToM365
     with:
-      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip # Relative path to the built app package.
-    writeToEnvironmentFile: # Write the information of created resources into environment file for the specified environment variable(s).
+      # Relative path to the build app package.
+      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
+    # Write the information of created resources into environment file for
+    # the specified environment variable(s).
+    writeToEnvironmentFile:
       titleId: M365_TITLE_ID
       appId: M365_APP_ID
 {{/if}}
 
+# Triggered when 'teamsfx deploy' is executed
 deploy:
 {{#if activePlugins.fx-resource-frontend-hosting}}
-  - uses: cli/runNpmCommand # Run npm command
+  # Run npm command
+  - uses: cli/runNpmCommand
     name: install tab dependencies
     with:
       workingDirectory: tabs
       args: install
-  - uses: cli/runNpmCommand # Run npm command
+  # Run npm command
+  - uses: cli/runNpmCommand
     name: build tab app
     {{#if activePlugins.fx-resource-aad-app-for-teams}}
     env:
@@ -104,7 +165,10 @@ deploy:
       workingDirectory: tabs
       # Deploy base folder. This folder includes manifest files for AAD app and Teams app that should be ignored using the ignoreFile.
       artifactFolder: build
-      # The resource id of the cloud resource to be deployed to. This key will be generated by arm/deploy action automatically. You can replace it with your existing Azure Resource id or add it to your environment variable file.
+      # The resource id of the cloud resource to be deployed to. 
+      # This key will be generated by arm/deploy action automatically. 
+      # You can replace it with your existing Azure Resource id 
+      # or add it to your environment variable file.
       resourceId: $\{{ {{~placeholderMappings.[state.fx-resource-frontend-hosting.storageResourceId]~}} }}
 {{/if}}
 {{#if activePlugins.fx-resource-bot}}
@@ -122,45 +186,56 @@ deploy:
       args: run build --if-present
     {{/if}}
   # Deploy your application to Azure Functions using the zip deploy feature.
-  # For additional details, please refer to https://aka.ms/zip-deploy-to-azure-functions
+  # For additional details, see at https://aka.ms/zip-deploy-to-azure-functions
   - uses: azureFunctions/zipDeploy
     with:
       workingDirectory: bot
       # Deploy base folder
       artifactFolder: .
-      # Can be changed to any ignore file location, leave blank will ignore nothing
+      # Ignore file location, leave blank will ignore nothing
       ignoreFile: .funcignore
-      # The resource id of the cloud resource to be deployed to. This key will be generated by arm/deploy action automatically. You can replace it with your existing Azure Resource id or add it to your environment variable file.
+      # The resource id of the cloud resource to be deployed to. 
+      # This key will be generated by arm/deploy action automatically. 
+      # You can replace it with your existing Azure Resource id 
+      # or add it to your environment variable file.
       resourceId: $\{{ {{~botResourceId~}} }}
   {{else}}
-  - uses: cli/runNpmCommand # Run npm command
+  # Run npm command
+  - uses: cli/runNpmCommand
     name: install bot dependencies
     with:
       workingDirectory: bot
       args: install
     {{#if isTypescript}}
-  - uses: cli/runNpmCommand # Run npm command
+  # Run npm command
+  - uses: cli/runNpmCommand
     name: build bot app
     with:
       workingDirectory: bot
       args: run build --if-present
     {{/if}}
   # Deploy your application to Azure App Service using the zip deploy feature.
-  # For additional details, please refer to https://aka.ms/zip-deploy-to-app-services.
+  # For additional details, refer to https://aka.ms/zip-deploy-to-app-services.
   - uses: azureAppService/zipDeploy
     with:
       workingDirectory: bot
       # Deploy base folder.
       artifactFolder: .
-      # The resource id of the cloud resource to be deployed to. This key will be generated by arm/deploy action automatically. You can replace it with your existing Azure Resource id or add it to your environment variable file.
+      # The resource id of the cloud resource to be deployed to. 
+      # This key will be generated by arm/deploy action automatically. 
+      # You can replace it with your existing Azure Resource id 
+      # or add it to your environment variable file.
       resourceId: $\{{ {{~botResourceId~}} }}
   {{/if}}
 {{/if}}
 {{#if activePlugins.fx-resource-function}}
-  - uses: prerequisite/install # Install dependencies
+  # Install development tool(s)
+  - uses: devTool/install
     with:      
       dotnet: true
-    writeToEnvironmentFile: # Write the information of installed dependencies into environment file for the specified environment variable(s).
+    # Write the information of installed development tool(s) into environment
+    # file for the specified environment variable(s).
+    writeToEnvironmentFile:
       dotnetPath: DOTNET_PATH
   - uses: cli/runNpmCommand
     name: install api dependencies
@@ -171,7 +246,7 @@ deploy:
     with:
       workingDirectory: api
       args: build extensions.csproj -o bin --ignore-failed-sources
-      execPath: $\{{ {{~dotnetPath~}} }} # Use dotnet installed by prerequisite/install action
+      execPath: $\{{ {{~dotnetPath~}} }} # Use dotnet installed by devTool/install action
     {{#if isTypescript}}
   - uses: cli/runNpmCommand
     name: build api app
@@ -180,34 +255,54 @@ deploy:
       args: run build --if-present
     {{/if}}
   # Deploy your application to Azure Functions using the zip deploy feature.
-  # For additional details, please refer to https://aka.ms/zip-deploy-to-azure-functions
+  # For additional details, see at https://aka.ms/zip-deploy-to-azure-functions
   - uses: azureFunctions/zipDeploy
     with:
       workingDirectory: api
       # Deploy base folder
       artifactFolder: .
-      # Can be changed to any ignore file location, leave blank will ignore nothing
+      # Ignore file location, leave blank will ignore nothing
       ignoreFile: .funcignore
-      # The resource id of the cloud resource to be deployed to. This key will be generated by arm/deploy action automatically. You can replace it with your existing Azure Resource id or add it to your environment variable file.
+      # The resource id of the cloud resource to be deployed to. 
+      # This key will be generated by arm/deploy action automatically. 
+      # You can replace it with your existing Azure Resource id 
+      # or add it to your environment variable file.
       resourceId: $\{{ {{~placeholderMappings.[state.fx-resource-function.functionAppResourceId]~}} }}
 {{/if}}
 
+# Triggered when 'teamsfx publish' is executed
 publish:
-  - uses: teamsApp/validateManifest # Validate using manifest schema
+  # Validate using manifest schema
+  - uses: teamsApp/validateManifest
     with:
-      manifestPath: ./appPackage/manifest.json # Path to manifest template
+      # Path to manifest template
+      manifestPath: ./appPackage/manifest.json
+  # Build Teams app package with latest env value
   - uses: teamsApp/zipAppPackage
     with:
-      manifestPath: ./appPackage/manifest.json # Path to manifest template
+      # Path to manifest template
+      manifestPath: ./appPackage/manifest.json
       outputZipPath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
       outputJsonPath: ./build/appPackage/manifest.$\{{TEAMSFX_ENV}}.json
-  - uses: teamsApp/update # Apply the Teams app manifest to an existing Teams app in Teams Developer Portal. Will use the app id in manifest file to determine which Teams app to update.
+  # Validate app package using validation rules
+  - uses: teamsApp/validateAppPackage
     with:
-      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip # Relative path to this file. This is the path for built zip file.
-    writeToEnvironmentFile:
-      teamsAppId: TEAMS_APP_ID
-  - uses: teamsApp/publishAppPackage # Publish the app to Teams Admin Center (https://admin.teams.microsoft.com/policies/manage-apps) for review and approval
+      # Relative path to this file. This is the path for built zip file.
+      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
+  # Apply the Teams app manifest to an existing Teams app in
+  # Teams Developer Portal.
+  # Will use the app id in manifest file to determine which Teams app to update.
+  - uses: teamsApp/update
+    with:
+      # Relative path to this file. This is the path for built zip file.
+      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
+  # Publish the app to
+  # Teams Admin Center (https://admin.teams.microsoft.com/policies/manage-apps)
+  # for review and approval
+  - uses: teamsApp/publishAppPackage
     with:
       appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
+    # Write the information of created resources into environment file for
+    # the specified environment variable(s).
     writeToEnvironmentFile:
       publishedAppId: TEAMS_APP_PUBLISHED_APP_ID

package/templates/core/v3Migration/spfx.app.yml

@@ -1,27 +1,59 @@
+# yaml-language-server: $schema=https://aka.ms/teams-toolkit/1.0.0/yaml.schema.json
+# Visit https://aka.ms/teamsfx-v5.0-guide for details on this file
+# Visit https://aka.ms/teamsfx-actions for details on actions
 version: 1.0.0
 
+projectId: {{projectId}}
+
 environmentFolderPath: ./ {{~environmentFolder}}
 
+# Triggered when 'teamsfx provision' is executed
 provision:
-  - uses: teamsApp/create # Creates a Teams app
+  # Creates a Teams app
+  - uses: teamsApp/create
     with:
-      name: {{teamsAppName}} # Teams app name
+      # Teams app name
+      name: {{teamsAppName}}
+    # Write the information of created resources into environment file for
+    # the specified environment variable(s).
     writeToEnvironmentFile:
       teamsAppId: TEAMS_APP_ID
-  - uses: teamsApp/validateManifest # Validate using manifest schema
+  # Validate using manifest schema
+  - uses: teamsApp/validateManifest
     with:
-      manifestPath: ./appPackage/manifest.json # Path to manifest template
-  - uses: teamsApp/zipAppPackage # Build Teams app package with latest env value
+      # Path to manifest template
+      manifestPath: ./appPackage/manifest.json
+  # Build Teams app package with latest env value
+  - uses: teamsApp/zipAppPackage
     with:
-      manifestPath: ./appPackage/manifest.json # Path to manifest template
+      # Path to manifest template
+      manifestPath: ./appPackage/manifest.json
       outputZipPath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
       outputJsonPath: ./build/appPackage/manifest.$\{{TEAMSFX_ENV}}.json
-  - uses: teamsApp/update # Apply the Teams app manifest to an existing Teams app. Will use the app id in manifest file to determine which Teams app to update.
+  # Validate app package using validation rules
+  - uses: teamsApp/validateAppPackage
+    with:
+      # Relative path to this file. This is the path for built zip file.
+      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
+  # Apply the Teams app manifest to an existing Teams app in
+  # Teams Developer Portal.
+  # Will use the app id in manifest file to determine which Teams app to update.
+  - uses: teamsApp/update
+    with:
+      # Relative path to this file. This is the path for built zip file.
+      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
+  # Extend your Teams app to Outlook and the Microsoft 365 app
+  - uses: teamsApp/extendToM365
     with:
-      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip # Relative path to this file. This is the path for built zip file.
+      # Relative path to the build app package.
+      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
+    # Write the information of created resources into environment file for
+    # the specified environment variable(s).
     writeToEnvironmentFile:
-      teamsAppId: TEAMS_APP_ID
+      titleId: M365_TITLE_ID
+      appId: M365_APP_ID
 
+# Triggered when 'teamsfx deploy' is executed
 deploy:
   - uses: cli/runNpmCommand
     with:
@@ -40,26 +72,38 @@ deploy:
       createAppCatalogIfNotExist: false
       packageSolutionPath: ./SPFx/config/package-solution.json
 
+# Triggered when 'teamsfx publish' is executed
 publish:
-  - uses: teamsApp/validateManifest # Validate using manifest schema
+  # Validate using manifest schema
+  - uses: teamsApp/validateManifest
     with:
-      manifestPath: ./appPackage/manifest.json # Path to manifest template
+      # Path to manifest template
+      manifestPath: ./appPackage/manifest.json
+  # Build Teams app package with latest env value
   - uses: teamsApp/zipAppPackage
     with:
-      manifestPath: ./appPackage/manifest.json # Path to manifest template
+      # Path to manifest template
+      manifestPath: ./appPackage/manifest.json
       outputZipPath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
       outputJsonPath: ./build/appPackage/manifest.$\{{TEAMSFX_ENV}}.json
   - uses: teamsApp/copyAppPackageToSPFx
     with:
       appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
       spfxFolder: ./SPFx
-  - uses: teamsApp/update # Apply the Teams app manifest to an existing Teams app in Teams Developer Portal. Will use the app id in manifest file to determine which Teams app to update.
+  # Apply the Teams app manifest to an existing Teams app in
+  # Teams Developer Portal.
+  # Will use the app id in manifest file to determine which Teams app to update.
+  - uses: teamsApp/update
     with:
-      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip # Relative path to this file. This is the path for built zip file.
-    writeToEnvironmentFile:
-      teamsAppId: TEAMS_APP_ID
-  - uses: teamsApp/publishAppPackage # Publish the app to Teams Admin Center (https://admin.teams.microsoft.com/policies/manage-apps) for review and approval
+      # Relative path to this file. This is the path for built zip file.
+      appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
+  # Publish the app to
+  # Teams Admin Center (https://admin.teams.microsoft.com/policies/manage-apps)
+  # for review and approval
+  - uses: teamsApp/publishAppPackage
     with:
       appPackagePath: ./build/appPackage/appPackage.$\{{TEAMSFX_ENV}}.zip
+    # Write the information of created resources into environment file for
+    # the specified environment variable(s).
     writeToEnvironmentFile:
       publishedAppId: TEAMS_APP_PUBLISHED_APP_ID

package/templates/core/v3Migration/upgradeReport.md

@@ -15,6 +15,7 @@ There's no immediate action required from you. This part illustrates what's chan
 2. You need to take some manual steps when creating or provisioning new environments for your old project. [Learn More](https://aka.ms/teams-toolkit-5.0-upgrade#environment-management)
 3. You need to manually update `.vscode/launch.json` when launching your app for a certain environment if your current project contains it. [Learn More](https://aka.ms/teams-toolkit-5.0-upgrade#launch-your-app)
 4. You need to provide values to `APIM__PUBLISHEREMAIL` and `APIM__PUBLISHERNAME` environment variable if your current project uses APIM. [Learn More](https://aka.ms/teams-toolkit-5.0-upgrade#provision-apim-service)
+5. You need to manually update `Start local tunnel` task in `.vscode/task.json` if you have customized this task. Teams Toolkit now uses Dev Tunnel as default tunnel solution. [Learn More](https://aka.ms/teams-toolkit-5.0-upgrade#start-tunnel-service)
 
 You can visit this [wiki](https://aka.ms/teams-toolkit-5.0-upgrade#feature-changes-that-impact-your-development-flow) to learn more changes to Teams Toolkit.
 
@@ -35,9 +36,10 @@ For more detailed changes, please refer to this [wiki](https://aka.ms/teams-tool
 
 1. If your project only contains a bot, you may meet error that complains `STATE__FX_RESOURCE_FRONTEND_HOSTING__ENDPOINT` is missing when executing commands. Replace this placeholder with a valid URL in `appPackage/manifest.json` to fix it. [Learn More](https://aka.ms/teams-toolkit-5.0-upgrade#state__fx_resource_frontend_hosting__endpoint-missing-error-in-some-projects)
 
-2. If your project is created with Viusal Studio version < 17.4, you may see error `InvalidParameter: Following parameter is missing or invalid for aadApp/create action: name` when executing commands. Please follow [the steps](#how-to-roll-back) to roll back, install VS 17.4 and run upgrade first.
+2. If your project is created with Visual Studio version < 17.4, you may see error `InvalidParameter: Following parameter is missing or invalid for aadApp/create action: name` when executing commands. Please follow [the steps](#how-to-roll-back) to roll back, install VS 17.4 and run upgrade first.
 
-3. If your tab app is created with Teams Toolkit 3.2.0 or earlier version, you may see error `simpleAuthEndpoint in configuration is invalid` when remote debugging your app. Please follow this [wiki]( `https://aka.ms/teams-toolkit-5.0-upgrade#simpleauthendpoint-in-configuration-is-invalid`) to learn how to mitigate this error.
+3. If your tab app is created with Teams Toolkit 3.2.0 or earlier version, you may see error `simpleAuthEndpoint in configuration is invalid` when remote debugging your app. Please follow this [wiki](https://aka.ms/teams-toolkit-5.0-upgrade#simpleauthendpoint-in-configuration-is-invalid) to learn how to mitigate this error.
+4. If your project can be provisioned successfully before, but after upgrade it cannot be provisioned or published by `teamsApp/validateAppPackage` actione, please use the [validation](https://dev.teams.microsoft.com/validation) to check your appPackage zip file and fix the error. [Learn More](https://aka.ms/teams-toolkit-5.0-upgrade#teamsappvalidateapppackage-failed-error)
 
 ## How to roll back
 

package/templates/plugins/resource/aad/auth/V3/Bot/SSO/SsoOperations.cs

@@ -1,22 +1,37 @@
 using Microsoft.Bot.Builder;
 using Microsoft.Graph;
+using Microsoft.Kiota.Abstractions.Authentication;
 using Microsoft.TeamsFx.Configuration;
 
 namespace {{YOUR_NAMESPACE}}.SSO;
 
+public class TokenProvider : IAccessTokenProvider
+{
+  private string token { get; set; }
+
+  public TokenProvider(String token)
+  {
+    this.token = token;
+  }
+
+  public Task<string> GetAuthorizationTokenAsync(Uri uri, Dictionary<string, object> additionalAuthenticationContext = default,
+      CancellationToken cancellationToken = default)
+  {
+    // get the token and return it
+    return Task.FromResult(this.token);
+  }
+
+  public AllowedHostsValidator AllowedHostsValidator { get; }
+}
+
 public static class SsoOperations
 {
     public static async Task ShowUserInfo(ITurnContext stepContext, string token, BotAuthenticationOptions botAuthOptions)
     {
         await stepContext.SendActivityAsync("Retrieving user information from Microsoft Graph ...");
-        var authProvider = new DelegateAuthenticationProvider((request) =>
-        {
-            request.Headers.Authorization =
-                new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", token);
-            return Task.CompletedTask;
-        });
-        var graphClient = new GraphServiceClient(authProvider);
-        var profile = await graphClient.Me.Request().GetAsync();
+        var tokenCredential = new BaseBearerTokenAuthenticationProvider(new TokenProvider(token));
+        var graphClient = new GraphServiceClient(tokenCredential);
+        var profile = await graphClient.Me.GetAsync();
         await stepContext.SendActivityAsync($"You're logged in as {profile.DisplayName}");
     }
 }

package/templates/plugins/resource/aad/auth/V3/Tab/GetUserProfile.razor

@@ -1,6 +1,7 @@
 @using System.IO
 @using Azure.Core
 @using Microsoft.Graph
+@using Microsoft.Graph.Models
 @inject TeamsFx teamsfx
 @inject TeamsUserCredential teamsUserCredential
 
@@ -45,7 +46,7 @@
         IsLoading = true;
         var graph = GetGraphServiceClient();
 
-        Profile = await graph.Me.Request().GetAsync();
+        Profile = await graph.Me.GetAsync();
 
         IsLoading = false;
         ErrorMessage = string.Empty;

package/build/component/driver/aad/error/invalidParameterUserError.d.ts

@@ -1,5 +0,0 @@
-import { UserError } from "@microsoft/teamsfx-api";
-export declare class InvalidParameterUserError extends UserError {
-    constructor(actionName: string, invalidParameters: string | string[], helpLink: string);
-}
-//# sourceMappingURL=invalidParameterUserError.d.ts.map

package/build/component/driver/aad/error/invalidParameterUserError.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"invalidParameterUserError.d.ts","sourceRoot":"","sources":["../../../../../src/component/driver/aad/error/invalidParameterUserError.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAMnD,qBAAa,yBAA0B,SAAQ,SAAS;gBAC1C,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM;CAevF"}

package/build/component/driver/aad/error/invalidParameterUserError.js

@@ -1,29 +0,0 @@
-"use strict";
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidParameterUserError = void 0;
-const teamsfx_api_1 = require("@microsoft/teamsfx-api");
-const localizeUtils_1 = require("../../../../common/localizeUtils");
-const errorCode = "InvalidParameter";
-const messageKey = "driver.aadApp.error.invalidParameter";
-class InvalidParameterUserError extends teamsfx_api_1.UserError {
-    constructor(actionName, invalidParameters, helpLink) {
-        let parameterList;
-        if (Array.isArray(invalidParameters)) {
-            parameterList = invalidParameters.join(", ");
-        }
-        else {
-            parameterList = invalidParameters;
-        }
-        super({
-            source: actionName,
-            name: errorCode,
-            message: localizeUtils_1.getDefaultString(messageKey, actionName, parameterList),
-            displayMessage: localizeUtils_1.getLocalizedString(messageKey, actionName, parameterList),
-            helpLink: helpLink,
-        });
-    }
-}
-exports.InvalidParameterUserError = InvalidParameterUserError;
-//# sourceMappingURL=invalidParameterUserError.js.map

package/build/component/driver/aad/error/invalidParameterUserError.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"invalidParameterUserError.js","sourceRoot":"","sources":["../../../../../src/component/driver/aad/error/invalidParameterUserError.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,wDAAmD;AACnD,oEAAwF;AAExF,MAAM,SAAS,GAAG,kBAAkB,CAAC;AACrC,MAAM,UAAU,GAAG,sCAAsC,CAAC;AAE1D,MAAa,yBAA0B,SAAQ,uBAAS;IACtD,YAAY,UAAkB,EAAE,iBAAoC,EAAE,QAAgB;QACpF,IAAI,aAAa,CAAC;QAClB,IAAI,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE;YACpC,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC9C;aAAM;YACL,aAAa,GAAG,iBAAiB,CAAC;SACnC;QACD,KAAK,CAAC;YACJ,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,gCAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC;YAChE,cAAc,EAAE,kCAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC;YACzE,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;IACL,CAAC;CACF;AAhBD,8DAgBC"}

package/build/component/driver/aad/error/unhandledError.d.ts

@@ -1,8 +0,0 @@
-import { SystemError, UserError } from "@microsoft/teamsfx-api";
-export declare class UnhandledUserError extends UserError {
-    constructor(actionName: string, detail: string, helpLink: string);
-}
-export declare class UnhandledSystemError extends SystemError {
-    constructor(actionName: string, detail: string);
-}
-//# sourceMappingURL=unhandledError.d.ts.map

package/build/component/driver/aad/error/unhandledError.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"unhandledError.d.ts","sourceRoot":"","sources":["../../../../../src/component/driver/aad/error/unhandledError.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EAEX,SAAS,EAEV,MAAM,wBAAwB,CAAC;AAMhC,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAKjE;AAED,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI/C"}

package/build/component/driver/aad/error/unhandledError.js

@@ -1,33 +0,0 @@
-"use strict";
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnhandledSystemError = exports.UnhandledUserError = void 0;
-const teamsfx_api_1 = require("@microsoft/teamsfx-api");
-const localizeUtils_1 = require("../../../../common/localizeUtils");
-const errorCode = "UnhandledError";
-const messageKey = "error.common.UnhandledError";
-class UnhandledUserError extends teamsfx_api_1.UserError {
-    constructor(actionName, detail, helpLink) {
-        const errorOptions = generateErrorOptions(actionName, detail);
-        errorOptions.helpLink = helpLink;
-        super(errorOptions);
-    }
-}
-exports.UnhandledUserError = UnhandledUserError;
-class UnhandledSystemError extends teamsfx_api_1.SystemError {
-    constructor(actionName, detail) {
-        const errorOptions = generateErrorOptions(actionName, detail);
-        super(errorOptions);
-    }
-}
-exports.UnhandledSystemError = UnhandledSystemError;
-function generateErrorOptions(actionName, detail) {
-    return {
-        source: actionName,
-        name: errorCode,
-        message: localizeUtils_1.getDefaultString(messageKey, actionName, detail),
-        displayMessage: localizeUtils_1.getLocalizedString(messageKey, actionName, detail),
-    };
-}
-//# sourceMappingURL=unhandledError.js.map