Updates from: 04/23/2021 03:18:09
Service Microsoft Docs article Related commit history on GitHub Change details
platform Prepare Your O365 Tenant https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/concepts/build-and-test/prepare-your-o365-tenant.md
Microsoft 365 subscribers can develop apps for Microsoft Teams with one of the f
* Education, Education Plus, and Education E5 > [!NOTE]
-> For more information on Microsoft 365 subscriptions, see [plans](https://products.office.com/business/compare-more-office-365-for-business-plans).
->
-> Microsoft Teams is also available to customers who subscribed to E4 prior to its [retirement](https://support.office.com//article/important-information-for-office-365-enterprise-e4-customers-f9572348-43a2-43fa-a3d8-3b6c9c042147).
+> * For more information on Microsoft 365 subscriptions, see [plans](https://products.office.com/business/compare-more-office-365-for-business-plans).
+> * Teams is also available to customers who subscribed to E4 prior to its [retirement](https://support.office.com//article/important-information-for-office-365-enterprise-e4-customers-f9572348-43a2-43fa-a3d8-3b6c9c042147).
## Create your development environment
-If you do not have a Microsoft 365 account, you must sign up for a [Microsoft 365 Developer Program](https://developer.microsoft.com/microsoft-365/dev-program) subscription. The subscription is free for 90 days and continues to renew as long as you are using it for development activity. If you have a Visual Studio Enterprise or Professional subscription, both programs include a free Microsoft 365 [developer subscription](https://aka.ms/MyVisualStudioBenefits). It is active for as long as your Visual Studio subscription is active. For more inforamtion, see [Set up a Microsoft 365 developer subscription](https://docs.microsoft.com/office/developer-program/office-365-developer-program-get-started).
+If you do not have a Microsoft 365 account, you must sign up for a [Microsoft 365 Developer Program](https://developer.microsoft.com/microsoft-365/dev-program) subscription. The subscription is free for 90 days and continues to renew as long as you are using it for development activity. If you have a Visual Studio Enterprise or Professional subscription, both programs include a free Microsoft 365 [developer subscription](https://aka.ms/MyVisualStudioBenefits). It is active as long as your Visual Studio subscription is active. For more information, see [set up a Microsoft 365 developer subscription](https://docs.microsoft.com/office/developer-program/office-365-developer-program-get-started).
-## Enable Microsoft Teams for your organization
+## Enable Teams for your organization
-Enable Microsoft Teams for your organization and take a look at our detailed guidance for [enabling Teams for your organization](/microsoftteams/enable-features-office-365).
+Enable Teams for your organization and for more information, see [enabling Teams for your organization](/microsoftteams/enable-features-office-365).
## Enable custom Teams apps and turn on custom app uploading
Enable Microsoft Teams for your organization and take a look at our detailed gui
2. Select **Show All** > **Teams**.
- ![image of admin center menu](~/assets/images/prepare-test-tenant/admin-center.png)
+ ![Admin center menu](~/assets/images/prepare-test-tenant/admin-center.png)
> [!Note] > It can take up to 24 hours for the **Teams** option to appear. You can [upload your custom app to a Teams environment](/microsoftteams/upload-custom-apps#validate) for testing and validation in that time. 3. Navigate to **Teams apps** > **Setup Policies** > **Global**.
- ![turn on sideload view](~/assets/images/prepare-test-tenant/turn-on-sideload.png)
+ ![Turn on sideload view](~/assets/images/prepare-test-tenant/turn-on-sideload.png)
-4. Toggle **upload custom apps** to the **on** position.
+4. Toggle **Upload custom apps** to the **On** position.
-5. Select **Save**.
- Your test tenant can permit custom app sideloading.
+5. Select **Save**. Your test tenant can permit custom app sideloading.
> [!Note]
- > It can take up to 24 hours for the sideloading to be active. During interim, you can use **upload for \<your tenant>** to test your app.
+ > It can take up to 24 hours for the sideloading to be active. In the interim, you can use **upload for \<your tenant>** to test your app. To upload the .zip package file of the app, see [upload custom apps](/microsoftteams/upload-custom-apps#upload).
- ![updload app view](~/assets/images/prepare-test-tenant/upload-for-contoso.png)
+ ![Upload app view](~/assets/images/prepare-test-tenant/upload-for-contoso.png)
-For complete information on how these settings interact, see [Manage custom app policies and settings in Microsoft Teams](https://docs.microsoft.com/microsoftteams/teams-custom-app-policies-and-settings) and [Manage app setup policies in Microsoft Teams](https://docs.microsoft.com/microsoftteams/teams-app-setup-policies).
+For complete information on how these settings interact, see [manage custom app policies and settings in Teams](https://docs.microsoft.com/microsoftteams/teams-custom-app-policies-and-settings) and [manage app setup policies in Teams](https://docs.microsoft.com/microsoftteams/teams-app-setup-policies).
## Next step > [!div class="nextstepaction"] > [Choose a test setup](~/concepts/build-and-test/debug.md)
->
-
platform Add Default Install Scope https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/concepts/deploy-and-publish/add-default-install-scope.md
+
+ Title: Configure default install options for your app
+description: Describes how to specify your app's default install options.
+
+localization_priority: Normal
+++
+# Add a default install scope and group capability
+
+ItΓÇÖs common for an app to support multiple scenarios in Teams, but you may have designed it with a specific scope and capability in mind. For example, if your app is primarily for team or channel use, you can make sure that the first install option users see in the store is **Add to a team**.
+
+![Add an app](../../assets/images/compose-extensions/addanapp.png)
+
+If your app's primary capability is a bot, you can also make the bot the default capability when a user installs your app to a team.
+
+## Configure your app's default install scope
+
+Configure the default install scope for your app. You can set only one scope at a time.
+
+**To configure the default install scope in your app manifest**
+
+1. Open your app manifest and add the `defaultInstallScope` property.
+2. Set a value of `personal`, `team`, `groupchat`, or `meetings` (see an example below).
+
+ ```json
+ "defaultInstallScope": "meetings",
+ ```
+
+> [!NOTE]
+> For more information, see the [app manifest schema](~/resources/schem).
+
+## Configure the default capability for shared scopes
+
+Configure the default capability when your app is installed for a team, meeting, or chat.
+
+**To configure details in app manifest**
+
+1. Open your app manifest and add the `defaultGroupCapability` property to it.
+2. Save the updates.
+
+ Following is a JSON example:
+
+ ```json
+ "defaultGroupCapability": {
+ "team": "bot",
+ "groupchat": "bot",
+ "meetings": "tab"
+ }
+ ```
+> [!NOTE]
+> For information on full schema, see [manifest schema](~/resources/schem).
+
+## Next step
+
+> [!div class="nextstepaction"]
+> [Choose how to distribute your app](overview.md)
platform Apps Upload https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/concepts/deploy-and-publish/apps-upload.md
An uploaded app with a messaging extension automatically appears in the **More o
![Messaging extensions](../../assets/images/compose-extensions/cesampleapp.png)
-## Add a default install scope and group capability
-
-> [!NOTE]
-> The default install scope and group capability is currently available in developer preview only.
-
-Although installing an app in the personal scope works for most apps, some of the apps in Teams Store support both personal and team scopes.
-Some of these apps are intended to work in a team, meetings, or a groupchat, with personal app experience being secondary.
-The default install scope selection helps you to specify the `defaultInstallScope` for the apps that you publish. The app installation experience makes the default options available to the user, while the rest is moved under the chevron as highlighted in the image.
-
-![Add an app](../../assets/images/compose-extensions/addanapp.png)
-
-The `defaultInstallScope` property supports values, such as personal, team, groupchat, or meetings.
-
-> [!NOTE]
->`defaultGroupCapability` provides the default capability that is added to the team, groupchat or meetings. Choose a tab, bot, or connector as the default capability for your app, but you must ensure that you have provided the selected capability in your app definition.
## Remove or update your app
platform Manifest Schema Dev Preview https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/resources/schema/manifest-schema-dev-preview.md
For more information on the features available see: [Features in the Public Deve
"websiteUrl", "privacyUrl", "termsOfUseUrl"
- ]
+ ],
+ "defaultInstallScope": "meetings",
+ "defaultGroupCapability": {
+ "meetings": "tab",
+ "team": "bot",
+ "groupchat": "bot"
+ }
} ```
You can define any of the following properties:
* `privacyUrl`: It is the https:// URL to the developer's privacy policy. * `termsOfUseUrl`: It is the https:// URL to the developer's terms of use.
+## defaultInstallScope
+
+**Optional** - string
+
+Specifies the install scope defined for this app by default. The defined scope will be the option displayed on the button when a user tries to add the app. Options are:
+* `personal`
+* `team`
+* `groupchat`
+* `meetings`
+
+## defaultGroupCapability
+
+**Optional** - object
+
+When a group install scope is selected, it will define the default capability when the user installs the app. Options are:
+* `team`
+* `groupchat`
+* `meetings`
+
+|Name| Type| Maximum size | Required | Description|
+||||||
+|`team`|string|||When the install scope selected is `team`, this field specifies the default capability available. Options: `tab`, `bot`, or `connector`.|
+|`groupchat`|string|||When the install scope selected is `groupchat`, this field specifies the default capability available. Options: `tab`, `bot`, or `connector`.|
+|`meetings`|string|||When the install scope selected is `meetings`, this field specifies the default capability available. Options: `tab`, `bot`, or `connector`.|
platform Manifest Schema https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/resources/schema/manifest-schema.md
Define the properties your app uses to post a user activity feed.
***
+## defaultInstallScope
+
+**Optional** - string
+
+Specifies the install scope defined for this app by default. The defined scope will be the option displayed on the button when a user tries to add the app. Options are:
+* `personal`
+* `team`
+* `groupchat`
+* `meetings`
+
+## defaultGroupCapability
+
+**Optional** - object
+
+When a group install scope is selected, it will define the default capability when the user installs the app. Options are:
+* `team`
+* `groupchat`
+* `meetings`
+
+|Name| Type| Maximum size | Required | Description|
+||||||
+|`team`|string|||When the install scope selected is `team`, this field specifies the default capability available. Options: `tab`, `bot`, or `connector`.|
+|`groupchat`|string|||When the install scope selected is `groupchat`, this field specifies the default capability available. Options: `tab`, `bot`, or `connector`.|
+|`meetings`|string|||When the install scope selected is `meetings`, this field specifies the default capability available. Options: `tab`, `bot`, or `connector`.|
+
platform Whats New https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/whats-new.md
The change log lists changes to the Microsoft Teams platform and this document s
| **Date** | **Notes** | **Changed topics** | | -- | | | |04/08/2021| App customization feature is now available in developer preview.|[Design teams app overview](concepts/design/design-teams-app-overview.md#app-customization), [App studio overview](concepts/build-and-test/app-studio-overview.md#connectors), and [Manifest schema](resources/schem) |
-|03/18/2021|Notice: **Please update to version 4.10 or above of the Bot Framework SDK** as we've started with the deprecation process for `TeamsInfo.getMembers` and `TeamsInfo.GetMembersAsync`. | [Bot API Changes for Team/Chat Members](resources/team-chat-member-api-changes.md) |
+|03/18/2021|Notice: Update to version 4.10 or above of the Bot Framework SDK, as we've started with the deprecation process for `TeamsInfo.getMembers` and `TeamsInfo.GetMembersAsync`. | [Bot API Changes for Team/Chat Members](resources/team-chat-member-api-changes.md) |
|03/05/2021|Notice: Tabs will no longer have margins surrounding their experiences. Tab developers should review and update their apps. | [Removing tab margins](resources/removing-tab-margins.md) |
-|03/05/2021 | Default install scope and group capability is in developer preview.| [Default install scope and group capability](concepts/deploy-and-publish/apps-upload.md#add-a-default-install-scope-and-group-capability) |
+|03/05/2021|Default install scope and group capability is in developer preview.| [Default install scope and group capability](concepts/deploy-and-publish/add-default-install-scope.md) |
|03/05/2021|Reorder personal app tabs|[Reorder the chat tab in personal apps](tabs/how-to/create-tab-pages/content-page.md#reorder-static-personal-tabs)| |03/04/2021|Information masking in Adaptive cards is in developer preview.| [Information masking in Adaptive cards](task-modules-and-cards/cards/cards-format.md#information-masking-in-adaptive-cards) | |02/19/2021|New: Added location capabilities. <br/> Update: Location capabilities information is added in the device capabilities overview, native device permissions, integrate media capabilities and QR or barcode scanner capability files.|[Overview](concepts/device-capabilities/device-capabilities-overview.md), [Request device permissions](concepts/device-capabilities/native-device-permissions.md), [Integrate media capabilities](concepts/device-capabilities/mobile-camera-image-permissions.md), [Integrate QR or barcode scanner capability](concepts/device-capabilities/qr-barcode-scanner-capability.md), [Integrate location capabilities](concepts/device-capabilities/location-capability.md) |