expo-widgets

Patch Changes

• Fix Android apps crashing at launch with constructor cannot be null when they use expo-widgets. The CustomNotification class now has a constructor that throws, because instances only come from CustomNotificationFactory.

• Fix the Android build failing with Unresolved reference 'jakex7'. Custom notifications now import the io.github.expo.peek packages that the peek-emittables dependency provides.

• [Android] Fix the layout registry script exiting without output when the package path contains a symlink, for example in a pnpm install.

Patch Changes

• [Android] Add custom notifications.

• [iOS] Rebuild the widgets JS bundle on every Xcode build so JS changes are picked up without a clean build.

Patch Changes

• [Android] Fix generateExpoWidgetsLayoutRegistry failing on Windows with RangeError: Maximum call stack size exceeded when a widget sets initialLayout. Absolute Windows paths (D:\...) are now resolved as files instead of being stubbed as empty modules.

• [Android] Fix minified release builds crashing on launch with Failed to create an instance of class androidx.work.impl.WorkDatabase.canonicalName. R8 stripped the no-arg constructor of WorkManager's Room database, which WorkManager creates by reflection; expo-widgets now ships consumer keep rules for it and for WorkManager's input mergers.

• [iOS] Show an empty widget, instead of an error, before the app has been launched. The widget layout is stored when the app first runs createWidget(), so a freshly installed or updated app that hasn't been opened yet has no layout. Widgets in this state, including previews in the widget gallery, rendered the "No layout found" red box. Because that view has no container background, iOS 17+ replaced it with the system's "Please adopt containerBackground API" placeholder. They now render an empty view with the system's tertiary fill until the app runs.

• [iOS] Fix widget layout errors being hidden behind the system's "Please adopt containerBackground API" placeholder on iOS 17+. The red box shown when a widget's layout fails to evaluate now declares a container background, so its error message is visible.

• [Android] Fix a release build failing checkReleaseDuplicateClasses when another dependency brings WorkManager 2.8 or newer, by pinning work-runtime-ktx forward from the 2.7.1 that Glance requests.

Patch Changes

• [Android] Fix update during active Glance sessions.

Patch Changes

• Add React hook and component helper stubs to prevent missing API errors when rendering widgets, including memo and forwardRef.

• [iOS] Stop linking WidgetKit into apps that use @expo/ui without widgets. The widgetURL, activityBackgroundTint, widgetAccentedRenderingMode, and containerBackground (widget placement) modifiers and the AccessoryWidgetBackground view now take effect only inside expo-widgets widgets and Live Activities.

Patch Changes

• Force-bump all packages, due to migration to changesets.

New features

• [iOS] Add support for Overlay, Background, and Mask in widgets and Live Activities.

Bug fixes

• [iOS] Preserve SwiftUI view identity across widget and Live Activity updates so system update animations can run.

• [Android] Fix Gradle build failure when no Android widget is configured.

Others

• Upgrade React Native to 0.88.0-rc.0

Breaking changes

• breaking

  Handle undefined props instead fallback to empty object.

New features

• [iOS] Expose stable ActivityKit identifiers on Live Activity instances.

• [Android] Create a JS bundle for widgets.

• [iOS] Expose ActivityKit's staleDate on LiveActivity.start() and LiveActivity.update().

• Add an initial layout registry for widgets.

• Add initialProps to widgets layout registry.

• [Android] Add Hermes runtime.

• [Android] Basic Android components.

• [Android] Implement widgets.

• [Android] Support interactions.

• [iOS][plugin] Fix extension CFBundleVersion sync.

• [iOS] Changing widget configuration at runtime.

• [Android] Refactor to Peek emittables.

• [Android] Support Material Colors inside widgets.

• [iOS] Expose ActivityKit's isStale on LiveActivityEnvironment.

Bug fixes

• [iOS] Localize widget gallery names and descriptions using the app's Localizable.strings files.

• [iOS] Fix widget and Live Activity Text modifiers being applied twice.

• Resolve deep react-native/* imports as empty modules when bundling widget layouts, fixing every widget failing with "Could not create context for layout evaluation" after @expo/ui 57.0.14 introduced such an import.

• [iOS] Fix XCFramework precompilation failing on the unguarded ActivityViewContext parameter of getLiveActivityEnvironment, which requires iOS 16.1.

• [iOS] Quote script-phase paths so iOS builds work from a project path containing a space.

• [iOS] Fix LiveActivityFactory.getInstances() returning live activities that belong to other factories or that have already ended.

• [iOS] Deliver the Live Activity start() URL to the Lock Screen banner, and scope it to the activity that set it instead of storing it globally per factory name.

• [Android] Add 16KB page size support.

• Make deprecated root-level widget config fields optional.

• [iOS][plugin] Only add the aps-environment entitlement when enablePushNotifications is enabled, and keep a pre-existing value.

• [Android] Fix modifiers type cast.

• Fix blank widget when JSX children mix a .map() array with sibling elements.

• [iOS] Restore push token observation when retrieving existing Live Activities.

• [iOS] Resolve autolinking relative to expo.

Others

• [iOS] Remove availability check for iOS 16.

• [Android] Migrate to Peek 0.2.0