|
| 1 | +--- |
| 2 | +title: SharePoint Framework v1.18.1 preview release notes |
| 3 | +description: Release notes for the SharePoint Framework v1.18.1 preview release |
| 4 | +ms.date: 10/10/2023 |
| 5 | +ms.localizationpriority: high |
| 6 | +--- |
| 7 | +# SharePoint Framework v1.18.1 preview release notes |
| 8 | + |
| 9 | +This is a _minor release_ that introduces new properly targeting Adaptive Card Extensions for better mobile experience. |
| 10 | + |
| 11 | +[!INCLUDE [spfx-release-beta](../../includes/snippets/spfx-release-beta.md)] |
| 12 | + |
| 13 | +- beta.0 **Released**: October 10, 2023 |
| 14 | + |
| 15 | +[!INCLUDE [spfx-release-notes-common](../../includes/snippets/spfx-release-notes-common.md)] |
| 16 | + |
| 17 | +## Install the latest version |
| 18 | + |
| 19 | +Install the latest release of the SharePoint Framework (SPFx) by including the **@latest** tag: |
| 20 | + |
| 21 | +```console |
| 22 | +npm install @microsoft/generator-sharepoint@next --global |
| 23 | +``` |
| 24 | + |
| 25 | +## Upgrading projects from v1.18 to v1.18.1 |
| 26 | + |
| 27 | +In the project's **package.json** file, identify all SPFx packages. For each SPFx package: |
| 28 | + |
| 29 | +1. Uninstall the existing packages: |
| 30 | + |
| 31 | + ```console |
| 32 | + npm uninstall @microsoft/{spfx-package-name} |
| 33 | + ``` |
| 34 | + |
| 35 | +2. Install the new v1.18.1 package: |
| 36 | + |
| 37 | + ```console |
| 38 | + npm install @microsoft/{spfx-package-name}@next --save --save-exact |
| 39 | + ``` |
| 40 | + |
| 41 | +[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)] |
| 42 | + |
| 43 | +## New features and capabilities |
| 44 | + |
| 45 | +### Partial Support for Teams JS SDK in Adaptive Card Extensions (Mobile only) |
| 46 | + |
| 47 | +Developers can access **partial** Teams JS SDK in Adaptive Card Extensions via ACE's context (in the same way as in web parts). |
| 48 | + |
| 49 | +```typescript |
| 50 | +class AdaptiveCardExtensionContext { |
| 51 | + // ... |
| 52 | + public sdks: IPartialSDKs | undefined;cx |
| 53 | +} |
| 54 | + |
| 55 | +// Accessing the theme details using context |
| 56 | +this.setState({ |
| 57 | + theme: context.app.appInfo.theme |
| 58 | +}); |
| 59 | +//... |
| 60 | +``` |
| 61 | + |
| 62 | +> [!NOTE] |
| 63 | +> Currently availability of this SDK is limited to Viva Connections Mobile only. We are working on introducing the support for this feature also for deskot and web site in future releases. |
| 64 | +
|
| 65 | +> [!NOTE] |
| 66 | +> Currently we only provide access to the `theme` property of the `appInfo` object of the Teams' context for Adaptive Card Extensions. |
| 67 | +
|
| 68 | +See more details on the use cases with code samples from the following updated documentation |
| 69 | + |
| 70 | +* [Making Quick View compatible with dark mode in mobile devices](./viva/get-started/making-quickview-compatable-darkmode-mobile.md) |
| 71 | +* [Quick view design guidance](./viva/design/designing-quick-view.md) |
| 72 | + |
| 73 | +## Summary |
| 74 | + |
| 75 | +Version 1.18.1 is expected to be a small release with the limited new capabilities. If you find any issues or have other feedback on the provided capabilities, report them at the [SPFx issue list](https://aka.ms/spfx/issues). Thank you for your input advance. |
0 commit comments