Using multiple manifest files¶
yoteams-build-core1.1.0 or later
Yo Teams supports having multiple manifests files. There are many scenarios where you would like to have multiple manifest files and Teams App packages generated, for instance:
- Having one application but multiple Teams Apps, such as one for users and one for admins, but still using the same hosting and solution
- Working with multiple environments and you want to build different manifests for different environments, including different icons
- Working with multiple developer environments where
validDomainsand Tab SSO App Id URI's are different.
How to use multiple manifests with Yo Teams¶
By default, the scaffolded project will contain one
manifest.json, located in
./src/manifest/. To add additional manifest files you either create a new
.json file and manually create the manifest, or copy the existing manifest into a new file in the same folder.
The build tasks
validate-manifest will now work cross all those defined manifest.json files and validate and create a separate package for each of them. The package name will be the name of the
packageName in the manifest and only referenced icons and localization files will be included in the package.
Add this feature to an existing project¶
If you scaffolded a project using Yo Teams v 3.0.x then you might need to update the build tools to support this feature. This is done using the following command
npm install yoteams-build-core@preview --save-dev
A word of caution¶
When working with multiple manifests there are a couple of things to keep in mind.
If you create a new manifest from a copy of an existing one it is important that you change the
packageName so that they are different - as that is used to create the package zip file.
If you intend to use the multiple packages in the same environment it is required that you have different
id's in your manifest files.