SharePoint Framework v1.18.1 release notes

This is a minor release that introduces a new property targeting Adaptive Card Extensions for a better mobile experience with the Microsoft Viva Connections.

Released: November 7, 2023

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.

Install the latest version

Install the latest release of the SharePoint Framework (SPFx) by including the @latest tag:

npm install @microsoft/generator-sharepoint@latest --global

Upgrading projects from v1.18 to v1.18.1

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

  1. Uninstall the existing packages:

    npm uninstall @microsoft/{spfx-package-name}
    
  2. Install the new v1.18.1 package:

    npm install @microsoft/{spfx-package-name}@1.18.1 --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.

New features and capabilities

Partial Support for Teams JS SDK in Adaptive Card Extensions (Mobile only)

Developers can access partial Teams JS SDK in Adaptive Card Extensions via ACE's context (in the same way as in web parts). This enables the Adaptive Card Extensions to reflect the user interface based on the Microsoft Teams mobile theme setting.

class AdaptiveCardExtensionContext {
  // ...
  public sdks: IPartialSDKs | undefined;
}

// Accessing the theme details using context
this.setState({
    theme: context.app.appInfo.theme
});
//...

Note

Currently availability of this SDK is limited to Viva Connections Mobile only. We are working on introducing the support for this feature for the desktop and web clients in future releases.

Note

Currently we only provide access to the theme property of the appInfo object of the Teams' context for Adaptive Card Extensions.

See more details on the use cases with code samples from the following updated documentation

Summary

Version 1.18.1 is a small release with a limited new capabilities. If you find any issues or have other feedback on the provided capabilities, report them at the SPFx issue list. Thank you for your input advance.