sp-dev-fx-webparts/samples/js-solution-editions
Hugo Bernier 68f7f67761 Changed from updated to modificationDateTime 2021-05-02 15:39:42 -04:00
..
assets Changed from updated to modificationDateTime 2021-05-02 15:39:42 -04:00
config Initial release (#304) 2017-09-08 08:55:11 +03:00
src/webparts/helloWorld Initial release (#304) 2017-09-08 08:55:11 +03:00
typings Initial release (#304) 2017-09-08 08:55:11 +03:00
.editorconfig Initial release (#304) 2017-09-08 08:55:11 +03:00
.gitattributes Initial release (#304) 2017-09-08 08:55:11 +03:00
.gitignore Initial release (#304) 2017-09-08 08:55:11 +03:00
.npmignore Initial release (#304) 2017-09-08 08:55:11 +03:00
.yo-rc.json Initial release (#304) 2017-09-08 08:55:11 +03:00
README.md URL dev.office.com to docs.microsoft.com 2020-06-09 09:09:22 +02:00
gulpfile.js Initial release (#304) 2017-09-08 08:55:11 +03:00
package-lock.json Initial release (#304) 2017-09-08 08:55:11 +03:00
package.json Initial release (#304) 2017-09-08 08:55:11 +03:00
tsconfig.json Initial release (#304) 2017-09-08 08:55:11 +03:00
tslint.json Add tslint at the root of each SPFx project (#394) 2018-01-08 15:58:48 +02:00

README.md

page_type products languages extensions
sample
office-sp
javascript
typescript
contentType technologies createdDate
samples
SharePoint Framework
9/1/2017 12:00:00 AM

Handling Multiple Editions of SPFx Solution

Summary

This sample shows a possible approach of handling multiple editions (e.g. trial, lite, full) of SharePoint Framework solution.

Used SharePoint Framework Version

drop

Applies to

Solution

Solution Author(s)
js-solution-editions Alex Terentiev (Sharepointalist Inc., AJIXuMuK)

Version history

Version Date Comments
1.0 August 23, 2017 Initial release

Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.

Description

Use Case

You are an ISV and developing some product that has multiple editions, let's say, trial, lite, full. You want to have a separate package file (.sppkg) for each edition and also reference different CDNs based on the edition.

Problems to address

Thinking about the use case in details we can point several problems that should be addressed:

  • When we're creating a new version we should create 3 separate .sppkg files
  • Each .sppkg file should contain manifest that references different CDN endpoints
  • It should be easy to upgrade customer from trial to lite and then to full; or directly from trial to full
  • You should know current edition in the code to execute the logic based on the edition's restrictions

Approach

This sample shows the approach that is based on a custom Gulp task that should be run before bundling and packaging the solution. The name of the task is change-build-edition. Parameter: edition. The task updates SPFx solution configuration files to contain edition-specific information:

  • deploy-azure-storage.json is updated to contain correct container value
  • package-solution.json is updated to contain correct solution.version and paths.zippedPackage values. In this sample I'm using version's revision - 4th digit - to specify the edition: 0 for trial, 1 for lite, 2 for full. It allows to easily update customers. zippedPackage path is modified to create sppkg in subfolder based on edition configuration.
  • write-manifests.json is updated to contain the correct CDN endpoint URL.

Additionally, the web part's source code folder contains custom-config.json file with edition property:

{
    "edition": "full"
}

This file is modified by a custom task as well to contain the correct edition. Later custom-config.json is referenced (require('./custom-config.json')) in web part code to provide custom logic based on current edition.

Use the following commands to build specific edition version:

gulp change-build-edition --edition lite
gulp bundle --ship
gulp package-solution --ship
gulp deploy-azure-storage

Resources

Handling Multiple Editions of SPFx Solution