Edit

Collaborate on Teams project using Microsoft Teams Toolkit v4

  • Article

Important

We've introduced the Teams Toolkit v5 extension within Visual Studio Code. This version comes to you with many new app development features. We recommend that you use Teams Toolkit v5 for building your Teams app.

Teams Toolkit v4 extension will soon be deprecated.

Multiple developers can work together to debug, provision and deploy for the same TeamsFx project, but it requires manually setting the right permissions of Teams App and Microsoft Azure Active Directory (Azure AD). Teams Toolkit supports collaboration feature to allow developers and project owner to invite other developers or collaborators to the TeamsFx project to debug, provision, and deploy the same TeamsFx project.

Collaborate with other developers

The following sections guide us to understand the collaboration process as project owner or collaborator:

As project owner

Note

Before adding collaborators for an environment, project owner needs to Provision cloud resources the project first.

  1. Select Teams Toolkit in the activity bar.

    Select teams toolkit from activity bar

  2. In ENVIRONMENT section, select collaborators, that displays as option 1 Add Microsoft 365 Teams App (with Azure AD App) Owners and 2 List Microsoft 365 Teams App (with Azure AD App) Owners as shown in the following image:

    collaborators

  3. Select Add Microsoft 365 Teams App (with Azure AD App) Owners and add other Microsoft 365 account email address as collaborator. The account to be added must be on the same tenant as project owner for remote debug as shown in the image:

    Add project owner

  4. To view collaborators in current environment, select List Microsoft 365 Teams App (with Azure AD App) Owners, then you can see collaborators listed in the output channel as shown in following image:

    list

  5. Push the project to GitHub.

    Note

    The newly added collaborators do not receive any notification. The Project owner needs to notify collaborator.

As project collaborator

  1. Clone the project from GitHub.

  2. Log on to Microsoft 365 account.

  3. Log on to Azure account, it has contributor permission for all the Azure resources, which are used in the project.

  4. To preview your Teams app, deploy the project to remote.

  5. Launch remote to have a preview of the Teams app.

    Note

    Collaborators must log in using the account that project owner adds under the same tenant with project owner. For more information, see build and run your Teams app in remote environment.

Remove Collaborators

If you want to remove collaborators from Teams Toolkit extension, you need to remove manually as you can't remove them directly. Perform the following steps to remove collaborators manually:

  • Using Developer Portal

    • Go to Teams Developer Portal and select your Teams app by name or app ID.
    • Select Owners from left panel.
    • Select and remove the collaborator.

  • Using Azure Active Directory

    • Go to Azure Active Directory, select App registration from left panel, and find your Azure AD App.

    • Select Owners from left panel in Azure AD App management page.

    • Select and remove the collaborator.

      Note

      • Collaborator added to your project doesn't receive any notification. Project owner needs to notify collaborator offline.
      • Azure related permissions must be set manually by Azure subscription administrator on Azure portal.
      • Azure account must have contributor role for the subscription so that developers can work together to provision, and deploy TeamsFx project.

See also