Düzenle

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

Warning

Upgrading from a previous minor version requires changes across package versions, build configuration files, and toolchain settings that vary depending on your source version. Manually updating package.json alone will result in build failures.

Tip

To upgrade this project, run:

npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.18.1 --output md

This analyzes your project and outputs all required changes, including a single script to apply them in one go.

Note

The CLI for Microsoft 365 is an open-source solution with active community providing support for it. There is no SLA for the open-source tool support from Microsoft.

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.

  • Last updated on