SharePoint Framework v1.8.2 release notes

This is a minor patch release that mostly focuses on build and tooling issues, with some changes to the scaffolded projects and APIs.

Released: May 7, 2019

Important

This page addresses details related to a specific SPFx release version. This page doesn't include additional SPFx prerequisites that must be installed in order to develop SPFx solutions, including Node.js, Yeoman, and other tools.

To learn more about these prerequisites, see Set up your SharePoint Framework development environment.

Upgrading projects from v1.8.1 to v1.8.2

In the project's package.json file, identify all SPFx v1.8.1 packages. For each SPFx package:

  1. Uninstall the existing v1.8.1 package:

    npm uninstall @microsoft/{spfx-package-name}@1.8.1
    
  2. Install the refreshed v1.8.2 package:

    npm install @microsoft/{spfx-package-name}@1.8.2.0 --save --save-exact
    

Tip

The CLI for Microsoft 365 provides an easy step-by-step guidance to upgrade your solutions to latest SharePoint Framework version.

Changes in this release

  • Released the context.microsoftTeams property to generally available (GA).
  • Fixed the issue with out of memory exceptions during the webPack phase of a build. We've bumped the tools to use the latest version of WebPack 3
  • Updated the build tools to use versions that result in a smaller combined size of the node_modules folder. Expect a reduction of 50-150 MB in size.
  • Updated the generator to use the updated tooling, SPFx version 1.8.2, and rush-stack-compiler-2.9. Feel free to use a different version of rush-stack-compiler if you need a different typescript version. The number after the final '-' is the version of typescript that will be used. Remember to update your tsconfig.json file to reference the correct rush-stack-compiler.
  • For the React-scaffolded projects, we now explicitly add office-ui-fabric-react (OUIFR) v6 to package.json. We were finding a common pattern where people weren't adding OUIFR to package.json, but were using it.
    • OUIFR would end up in the node_modules folder because of downstream dependencies. While the solution would compile, it could cause issues in the future such as when the solution was upgraded to use a different version of the framework. In this case, a different version of OUIFR would get used.
    • In general, using packages in this pattern (via shadow dependencies) is a bad thing. You're more than welcome to remove the reference in package.json if you aren't using OUIFR in your solution, or change the version if needed. We also updated the type declarations for the React packages to match the versions of React / React DOM referenced in the release.
  • Added .ms-SPLegacyFabricBlock CSS class to SPFx solutions that load the Office UI Fabric core stylesheets on demand (see Safely use legacy Office UI Fabric Styles (after SPFx v1.8.2) for more detail)
  • Support for Node.js 10. Node.js v8 is still supported, but will be removed in a future release.

Updates added to SharePoint Online

Updates rolling into SharePoint Online (ongoing)

  • We continue to fix issues around extensions in modern lists and libraries. We realize that we need to improve the stability in this application.
  • Improvements to the authentication of WebAPIs, both for performance and stability (particularly around the multiple accounts).
  • Improvements to isolated web parts (working in Teams, issues around authentication problems when using multiple isolated domains).
  • Improvements to the SharePoint administration API management page (avoiding duplicate and redundant rows).
  • Fix an issue where the DynamicDataSharedDepth property wouldn't work with v1.8.1