expo-widgets 56.0.16 → 56.0.18

package/CHANGELOG.md

@@ -10,6 +10,24 @@
 
 ### 💡 Others
 
+## 56.0.18 — 2026-06-10
+
+_This version does not introduce any user-facing changes._
+
+## 56.0.17 — 2026-06-05
+
+### 🎉 New features
+
+- Expose shared directory for images. ([#46339](https://github.com/expo/expo/pull/46339) by [@jakex7](https://github.com/jakex7))
+
+### 🐛 Bug fixes
+
+- [Android] Fix widget strings file location. ([#46538](https://github.com/expo/expo/pull/46538) by [@jakex7](https://github.com/jakex7))
+
+### 💡 Others
+
+- Temporarily make the Android config plugin opt-in with `enableAndroid`. ([#46463](https://github.com/expo/expo/pull/46463) by [@jakex7](https://github.com/jakex7))
+
 ## 56.0.16 — 2026-05-29
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -13,7 +13,7 @@ apply plugin: 'expo-module-gradle-plugin'
 apply plugin: 'org.jetbrains.kotlin.plugin.compose'
 
 group = 'expo.modules.widgets'
-version = '56.0.16'
+version = '56.0.18'
 
 expoModule {
   canBePublished false
@@ -23,7 +23,7 @@ android {
   namespace "expo.modules.widgets"
   defaultConfig {
     versionCode 1
-    versionName '56.0.16'
+    versionName '56.0.18'
   }
 
   buildFeatures {

package/build/ExpoWidgets.d.ts

@@ -1,6 +1,7 @@
 import type { EventSubscription } from 'expo-modules-core';
 import type { ExpoWidgetsEvents, NativeLiveActivity, NativeLiveActivityFactory, NativeWidgetObject } from './Widgets.types';
 declare const ExpoWidgetsModule: {
+    widgetsDirectory: string;
     reloadAllWidgets(): void;
     Widget: typeof NativeWidgetObject;
     LiveActivityFactory: typeof NativeLiveActivityFactory;

package/build/ExpoWidgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoWidgets.d.ts","sourceRoot":"","sources":["../src/ExpoWidgets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAyCzB,QAAA,MAAM,iBAAiB;wBACD,IAAI;YACF,OAAO,kBAAkB;yBACC,OAAO,yBAAyB;kBAC9C,OAAO,kBAAkB;gBAC/C,SAAS,SAAS,MAAM,iBAAiB,cACvC,SAAS,aACV,iBAAiB,CAAC,SAAS,CAAC,GACtC,iBAAiB;CAGrB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"ExpoWidgets.d.ts","sourceRoot":"","sources":["../src/ExpoWidgets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAyCzB,QAAA,MAAM,iBAAiB;;wBAED,IAAI;YACF,OAAO,kBAAkB;yBACC,OAAO,yBAAyB;kBAC9C,OAAO,kBAAkB;gBAC/C,SAAS,SAAS,MAAM,iBAAiB,cACvC,SAAS,aACV,iBAAiB,CAAC,SAAS,CAAC,GACtC,iBAAiB;CAGrB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/build/ExpoWidgets.ios.d.ts

@@ -1,6 +1,7 @@
 import { NativeModule } from 'expo';
 import type { ExpoWidgetsEvents, NativeLiveActivity, NativeLiveActivityFactory, NativeWidgetObject } from './Widgets.types';
 declare class ExpoWidgetsModule extends NativeModule<ExpoWidgetsEvents> {
+    widgetsDirectory: string;
     reloadAllWidgets(): void;
     readonly Widget: typeof NativeWidgetObject;
     readonly LiveActivityFactory: typeof NativeLiveActivityFactory;

package/build/ExpoWidgets.ios.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoWidgets.ios.d.ts","sourceRoot":"","sources":["../src/ExpoWidgets.ios.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,OAAO,iBAAkB,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IACrE,gBAAgB,IAAI,IAAI;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,OAAO,yBAAyB,CAAC;IAC/D,QAAQ,CAAC,YAAY,EAAE,OAAO,kBAAkB,CAAC;CAClD;;AAED,wBAAqE"}
+{"version":3,"file":"ExpoWidgets.ios.d.ts","sourceRoot":"","sources":["../src/ExpoWidgets.ios.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,OAAO,iBAAkB,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IACrE,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,IAAI,IAAI;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,OAAO,yBAAyB,CAAC;IAC/D,QAAQ,CAAC,YAAY,EAAE,OAAO,kBAAkB,CAAC;CAClD;;AAED,wBAAqE"}

package/build/ExpoWidgets.ios.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoWidgets.ios.js","sourceRoot":"","sources":["../src/ExpoWidgets.ios.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAgBzD,eAAe,mBAAmB,CAAoB,aAAa,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from 'expo';\n\nimport type {\n  ExpoWidgetsEvents,\n  NativeLiveActivity,\n  NativeLiveActivityFactory,\n  NativeWidgetObject,\n} from './Widgets.types';\n\ndeclare class ExpoWidgetsModule extends NativeModule<ExpoWidgetsEvents> {\n  reloadAllWidgets(): void;\n  readonly Widget: typeof NativeWidgetObject;\n  readonly LiveActivityFactory: typeof NativeLiveActivityFactory;\n  readonly LiveActivity: typeof NativeLiveActivity;\n}\n\nexport default requireNativeModule<ExpoWidgetsModule>('ExpoWidgets');\n"]}
+{"version":3,"file":"ExpoWidgets.ios.js","sourceRoot":"","sources":["../src/ExpoWidgets.ios.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAiBzD,eAAe,mBAAmB,CAAoB,aAAa,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from 'expo';\n\nimport type {\n  ExpoWidgetsEvents,\n  NativeLiveActivity,\n  NativeLiveActivityFactory,\n  NativeWidgetObject,\n} from './Widgets.types';\n\ndeclare class ExpoWidgetsModule extends NativeModule<ExpoWidgetsEvents> {\n  widgetsDirectory: string;\n  reloadAllWidgets(): void;\n  readonly Widget: typeof NativeWidgetObject;\n  readonly LiveActivityFactory: typeof NativeLiveActivityFactory;\n  readonly LiveActivity: typeof NativeLiveActivity;\n}\n\nexport default requireNativeModule<ExpoWidgetsModule>('ExpoWidgets');\n"]}

package/build/ExpoWidgets.js

@@ -29,6 +29,7 @@ class LiveActivityFactoryStub {
     }
 }
 const ExpoWidgetsModule = {
+    widgetsDirectory: '',
     reloadAllWidgets() { },
     Widget: WidgetStub,
     LiveActivityFactory: LiveActivityFactoryStub,

package/build/ExpoWidgets.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoWidgets.js","sourceRoot":"","sources":["../src/ExpoWidgets.ts"],"names":[],"mappings":"AAUA,MAAM,gBAAgB,GAAsB,EAAE,MAAM,KAAI,CAAC,EAAE,CAAC;AAE5D,MAAM,UAAU;IACd,qEAAqE;IACrE,YAAY,KAAa,EAAE,OAAe,IAAG,CAAC;IAC9C,MAAM,KAAU,CAAC;IACjB,cAAc,CAAC,QAA6B,IAAS,CAAC;IACtD,KAAK,CAAC,WAAW;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,MAAM,gBAAgB;IACpB,KAAK,CAAC,MAAM,CAAC,MAAc,IAAkB,CAAC;IAC9C,KAAK,CAAC,GAAG,CACP,gBAAyB,EACzB,UAAmB,EACnB,MAAe,EACf,YAAqB,IACL,CAAC;IACnB,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,WAAW,CAAC,UAAkB,EAAE,SAAuC;QACrE,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,uBAAuB;IAC3B,qEAAqE;IACrE,YAAY,KAAa,EAAE,OAAe,IAAG,CAAC;IAC9C,KAAK,CAAC,MAAc,EAAE,IAAa;QACjC,OAAO,IAAI,gBAAgB,EAAwB,CAAC;IACtD,CAAC;IACD,YAAY;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,MAAM,iBAAiB,GAAG;IACxB,gBAAgB,KAAU,CAAC;IAC3B,MAAM,EAAE,UAAuC;IAC/C,mBAAmB,EAAE,uBAA2D;IAChF,YAAY,EAAE,gBAA6C;IAC3D,WAAW,CACT,UAAqB,EACrB,SAAuC;QAEvC,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF,CAAC;AAEF,eAAe,iBAAiB,CAAC","sourcesContent":["import type { EventSubscription } from 'expo-modules-core';\n\nimport type {\n  ExpoTimelineEntry,\n  ExpoWidgetsEvents,\n  NativeLiveActivity,\n  NativeLiveActivityFactory,\n  NativeWidgetObject,\n} from './Widgets.types';\n\nconst noopSubscription: EventSubscription = { remove() {} };\n\nclass WidgetStub {\n  // eslint-disable-next-line @typescript-eslint/no-useless-constructor\n  constructor(_name: string, _layout: string) {}\n  reload(): void {}\n  updateTimeline(_entries: ExpoTimelineEntry[]): void {}\n  async getTimeline(): Promise<ExpoTimelineEntry[]> {\n    return [];\n  }\n}\n\nclass LiveActivityStub {\n  async update(_props: string): Promise<void> {}\n  async end(\n    _dismissalPolicy?: string,\n    _afterDate?: number,\n    _state?: string,\n    _contentDate?: number\n  ): Promise<void> {}\n  async getPushToken(): Promise<string | null> {\n    return null;\n  }\n  addListener(_eventName: string, _listener: (...args: unknown[]) => void): EventSubscription {\n    return noopSubscription;\n  }\n}\n\nclass LiveActivityFactoryStub {\n  // eslint-disable-next-line @typescript-eslint/no-useless-constructor\n  constructor(_name: string, _layout: string) {}\n  start(_props: string, _url?: string): NativeLiveActivity {\n    return new LiveActivityStub() as NativeLiveActivity;\n  }\n  getInstances(): NativeLiveActivity[] {\n    return [];\n  }\n}\n\nconst ExpoWidgetsModule = {\n  reloadAllWidgets(): void {},\n  Widget: WidgetStub as typeof NativeWidgetObject,\n  LiveActivityFactory: LiveActivityFactoryStub as typeof NativeLiveActivityFactory,\n  LiveActivity: LiveActivityStub as typeof NativeLiveActivity,\n  addListener<EventName extends keyof ExpoWidgetsEvents>(\n    _eventName: EventName,\n    _listener: ExpoWidgetsEvents[EventName]\n  ): EventSubscription {\n    return noopSubscription;\n  },\n};\n\nexport default ExpoWidgetsModule;\n"]}
+{"version":3,"file":"ExpoWidgets.js","sourceRoot":"","sources":["../src/ExpoWidgets.ts"],"names":[],"mappings":"AAUA,MAAM,gBAAgB,GAAsB,EAAE,MAAM,KAAI,CAAC,EAAE,CAAC;AAE5D,MAAM,UAAU;IACd,qEAAqE;IACrE,YAAY,KAAa,EAAE,OAAe,IAAG,CAAC;IAC9C,MAAM,KAAU,CAAC;IACjB,cAAc,CAAC,QAA6B,IAAS,CAAC;IACtD,KAAK,CAAC,WAAW;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,MAAM,gBAAgB;IACpB,KAAK,CAAC,MAAM,CAAC,MAAc,IAAkB,CAAC;IAC9C,KAAK,CAAC,GAAG,CACP,gBAAyB,EACzB,UAAmB,EACnB,MAAe,EACf,YAAqB,IACL,CAAC;IACnB,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,WAAW,CAAC,UAAkB,EAAE,SAAuC;QACrE,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,uBAAuB;IAC3B,qEAAqE;IACrE,YAAY,KAAa,EAAE,OAAe,IAAG,CAAC;IAC9C,KAAK,CAAC,MAAc,EAAE,IAAa;QACjC,OAAO,IAAI,gBAAgB,EAAwB,CAAC;IACtD,CAAC;IACD,YAAY;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,MAAM,iBAAiB,GAAG;IACxB,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,KAAU,CAAC;IAC3B,MAAM,EAAE,UAAuC;IAC/C,mBAAmB,EAAE,uBAA2D;IAChF,YAAY,EAAE,gBAA6C;IAC3D,WAAW,CACT,UAAqB,EACrB,SAAuC;QAEvC,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF,CAAC;AAEF,eAAe,iBAAiB,CAAC","sourcesContent":["import type { EventSubscription } from 'expo-modules-core';\n\nimport type {\n  ExpoTimelineEntry,\n  ExpoWidgetsEvents,\n  NativeLiveActivity,\n  NativeLiveActivityFactory,\n  NativeWidgetObject,\n} from './Widgets.types';\n\nconst noopSubscription: EventSubscription = { remove() {} };\n\nclass WidgetStub {\n  // eslint-disable-next-line @typescript-eslint/no-useless-constructor\n  constructor(_name: string, _layout: string) {}\n  reload(): void {}\n  updateTimeline(_entries: ExpoTimelineEntry[]): void {}\n  async getTimeline(): Promise<ExpoTimelineEntry[]> {\n    return [];\n  }\n}\n\nclass LiveActivityStub {\n  async update(_props: string): Promise<void> {}\n  async end(\n    _dismissalPolicy?: string,\n    _afterDate?: number,\n    _state?: string,\n    _contentDate?: number\n  ): Promise<void> {}\n  async getPushToken(): Promise<string | null> {\n    return null;\n  }\n  addListener(_eventName: string, _listener: (...args: unknown[]) => void): EventSubscription {\n    return noopSubscription;\n  }\n}\n\nclass LiveActivityFactoryStub {\n  // eslint-disable-next-line @typescript-eslint/no-useless-constructor\n  constructor(_name: string, _layout: string) {}\n  start(_props: string, _url?: string): NativeLiveActivity {\n    return new LiveActivityStub() as NativeLiveActivity;\n  }\n  getInstances(): NativeLiveActivity[] {\n    return [];\n  }\n}\n\nconst ExpoWidgetsModule = {\n  widgetsDirectory: '',\n  reloadAllWidgets(): void {},\n  Widget: WidgetStub as typeof NativeWidgetObject,\n  LiveActivityFactory: LiveActivityFactoryStub as typeof NativeLiveActivityFactory,\n  LiveActivity: LiveActivityStub as typeof NativeLiveActivity,\n  addListener<EventName extends keyof ExpoWidgetsEvents>(\n    _eventName: EventName,\n    _listener: ExpoWidgetsEvents[EventName]\n  ): EventSubscription {\n    return noopSubscription;\n  },\n};\n\nexport default ExpoWidgetsModule;\n"]}

package/build/Widgets.d.ts

@@ -111,4 +111,9 @@ export declare function addUserInteractionListener(listener: ExpoWidgetsEvents['
  * @return An event subscription that can be used to remove the listener.
  */
 export declare function addPushToStartTokenListener(listener: ExpoWidgetsEvents['onExpoWidgetsPushToStartTokenReceived']): EventSubscription;
+/**
+ * A directory that can be used to store shared images for widgets.
+ * The contents of this directory are accessible by both the main app and widgets.
+ */
+export declare const widgetsDirectory: string;
 //# sourceMappingURL=Widgets.d.ts.map

package/build/Widgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Widgets.d.ts","sourceRoot":"","sources":["../src/Widgets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Widgets.d.ts","sourceRoot":"","sources":["../src/Widgets.ts"],"names":[],"mappings":"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"}

package/build/Widgets.js

@@ -155,4 +155,9 @@ export function addUserInteractionListener(listener) {
 export function addPushToStartTokenListener(listener) {
     return ExpoWidgetsModule.addListener('onExpoWidgetsPushToStartTokenReceived', listener);
 }
+/**
+ * A directory that can be used to store shared images for widgets.
+ * The contents of this directory are accessible by both the main app and widgets.
+ */
+export const widgetsDirectory = ExpoWidgetsModule.widgetsDirectory;
 //# sourceMappingURL=Widgets.js.map

package/build/Widgets.js.map

@@ -1 +1 @@
-{"version":3,"file":"Widgets.js","sourceRoot":"","sources":["../src/Widgets.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from 'expo-modules-core';\n\nimport ExpoWidgetsModule from './ExpoWidgets';\nimport type {\n  ExpoWidgetsEvents,\n  LiveActivityComponent,\n  LiveActivityDismissalPolicy,\n  NativeLiveActivity,\n  NativeLiveActivityFactory,\n  NativeWidgetObject,\n  PushTokenEvent,\n  WidgetEnvironment,\n  WidgetTimelineEntry,\n} from './Widgets.types';\n\n/**\n * Represents a widget instance. Provides methods to manage the widget's timeline.\n */\nexport class Widget<\n  PropsType extends object = object,\n  ConfigurationType extends object | undefined = undefined,\n> {\n  /** @hidden */\n  private nativeWidgetObject: NativeWidgetObject;\n  constructor(\n    name: string,\n    layout: (\n      props: PropsType,\n      environment: WidgetEnvironment<ConfigurationType>\n    ) => React.JSX.Element\n  ) {\n    this.nativeWidgetObject = new ExpoWidgetsModule.Widget(name, layout as unknown as string);\n  }\n\n  /**\n   * Force reloads the widget, causing it to refresh its content and timeline.\n   */\n  reload() {\n    this.nativeWidgetObject.reload();\n  }\n\n  /**\n   * Schedules a series of updates for the widget's content and reloads the widget.\n   * @param entries Timeline entries, each specifying a date and the props to display at that time.\n   */\n  updateTimeline(entries: WidgetTimelineEntry<PropsType>[]) {\n    this.nativeWidgetObject.updateTimeline(\n      entries.map((entry) => ({ timestamp: entry.date.getTime(), props: entry.props }))\n    );\n  }\n\n  /**\n   * Sets the widget's content to the given props immediately, without scheduling a timeline.\n   * @param props The properties to display in the widget.\n   */\n  updateSnapshot(props: PropsType) {\n    this.nativeWidgetObject.updateTimeline([{ timestamp: Date.now(), props }]);\n  }\n\n  /**\n   * Returns the current timeline entries for the widget, including past and future entries.\n   */\n  async getTimeline(): Promise<WidgetTimelineEntry<PropsType>[]> {\n    return (await this.nativeWidgetObject.getTimeline()).map((entry) => ({\n      date: new Date(entry.timestamp),\n      props: entry.props as PropsType,\n    }));\n  }\n}\n\n/**\n * Represents a Live Activity instance. Provides methods to update its content and end it.\n */\nexport class LiveActivity<T extends object = object> {\n  /** @hidden */\n  private nativeLiveActivity: NativeLiveActivity;\n  constructor(nativeLiveActivity: NativeLiveActivity) {\n    this.nativeLiveActivity = nativeLiveActivity;\n  }\n\n  /**\n   * Updates the Live Activity's content. The UI reflects the new properties immediately.\n   * @param props The updated content properties.\n   */\n  update(props: T): Promise<void> {\n    return this.nativeLiveActivity.update(JSON.stringify(props));\n  }\n\n  /**\n   * Ends the Live Activity.\n   * @param dismissalPolicy Controls when the Live Activity is removed from the Lock Screen after ending.\n   * Can be `'default'`, `'immediate'`, or `after(date)`.\n   * @param props Final content properties to update after the activity ends.\n   * @param contentDate The time the data in the payload was generated. If this is older than a previous update or push payload, the system ignores this update.\n   */\n  end(dismissalPolicy?: LiveActivityDismissalPolicy, props?: T, contentDate?: Date): Promise<void> {\n    const serializedProps = props ? JSON.stringify(props) : undefined;\n    if (\n      typeof dismissalPolicy === 'object' &&\n      dismissalPolicy !== null &&\n      'after' in dismissalPolicy\n    ) {\n      return this.nativeLiveActivity.end(\n        'after',\n        dismissalPolicy.after?.getTime(),\n        serializedProps,\n        contentDate?.getTime()\n      );\n    }\n    return this.nativeLiveActivity.end(\n      dismissalPolicy,\n      undefined,\n      serializedProps,\n      contentDate?.getTime()\n    );\n  }\n\n  /**\n   * Returns the push token for this Live Activity, used to send push notification updates via APNs.\n   * Returns `null` if push notifications are not enabled or the token is not yet available.\n   */\n  getPushToken(): Promise<string | null> {\n    return this.nativeLiveActivity.getPushToken();\n  }\n\n  /**\n   * Adds a listener for push token update events on this Live Activity instance.\n   * The token can be used to send content updates to this specific activity via APNs.\n   * @param listener Callback invoked when a new push token is available.\n   * @returns An event subscription that can be used to remove the listener.\n   */\n  addPushTokenListener(listener: (event: PushTokenEvent) => void): EventSubscription {\n    return this.nativeLiveActivity.addListener('onExpoWidgetsTokenReceived', listener);\n  }\n}\n\n/**\n * Manages Live Activity instances of a specific type. Use it to start new activities and retrieve currently active ones.\n */\nexport class LiveActivityFactory<T extends object = object> {\n  /** @hidden */\n  private nativeLiveActivityFactory: NativeLiveActivityFactory;\n  constructor(name: string, layout: LiveActivityComponent<T>) {\n    this.nativeLiveActivityFactory = new ExpoWidgetsModule.LiveActivityFactory(\n      name,\n      layout as unknown as string\n    );\n  }\n\n  /**\n   * Starts a new Live Activity with the given properties.\n   * @param props The initial content properties for the Live Activity.\n   * @param url An optional URL to associate with the Live Activity, used for deep linking.\n   * @returns The new Live Activity instance.\n   */\n  start(props: T, url?: string) {\n    return new LiveActivity<T>(this.nativeLiveActivityFactory.start(JSON.stringify(props), url));\n  }\n\n  /**\n   * Returns all currently active instances of this Live Activity type.\n   */\n  getInstances() {\n    return this.nativeLiveActivityFactory\n      .getInstances()\n      .map((instance) => new LiveActivity<T>(instance));\n  }\n}\n\n/**\n * Creates a dismissal policy that removes the Live Activity at the specified time within a four-hour window.\n * @param date The date after which the Live Activity should be removed from the Lock Screen.\n * @hidden\n */\nexport function after(date: Date): { after: Date } {\n  return { after: date };\n}\n\n/**\n * Creates a Widget instance.\n * @param name The widget name. Must match the `'name'` field in your widget configuration in the app config.\n * @param widget The widget component, marked with the `'widget'` directive.\n */\nexport function createWidget<\n  PropsType extends object = object,\n  ConfigurationType extends object | undefined = undefined,\n>(\n  name: string,\n  widget: (props: PropsType, context: WidgetEnvironment<ConfigurationType>) => React.JSX.Element\n): Widget<PropsType, ConfigurationType> {\n  return new Widget<PropsType, ConfigurationType>(name, widget);\n}\n\n/**\n * Creates a Live Activity Factory for managing Live Activities of a specific type.\n * @param name The Live Activity name. Must match the `'name'` field in your widget configuration in the app config.\n * @param liveActivity The Live Activity component, marked with the `'widget'` directive.\n */\nexport function createLiveActivity<T extends object = object>(\n  name: string,\n  liveActivity: LiveActivityComponent<T>\n): LiveActivityFactory<T> {\n  return new LiveActivityFactory<T>(name, liveActivity);\n}\n\n/**\n * Adds a listener for widget interaction events (for example, button taps).\n * @param listener Callback function to handle user interaction events.\n * @return An event subscription that can be used to remove the listener.\n */\nexport function addUserInteractionListener(\n  listener: ExpoWidgetsEvents['onExpoWidgetsUserInteraction']\n): EventSubscription {\n  return ExpoWidgetsModule.addListener('onExpoWidgetsUserInteraction', listener);\n}\n\n/**\n * Adds a listener for push-to-start token events.\n * This token can be used to start live activities remotely via APNs.\n * @param listener Callback function to handle push-to-start token events.\n * @return An event subscription that can be used to remove the listener.\n */\nexport function addPushToStartTokenListener(\n  listener: ExpoWidgetsEvents['onExpoWidgetsPushToStartTokenReceived']\n): EventSubscription {\n  return ExpoWidgetsModule.addListener('onExpoWidgetsPushToStartTokenReceived', listener);\n}\n"]}
+{"version":3,"file":"Widgets.js","sourceRoot":"","sources":["../src/Widgets.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from 'expo-modules-core';\n\nimport ExpoWidgetsModule from './ExpoWidgets';\nimport type {\n  ExpoWidgetsEvents,\n  LiveActivityComponent,\n  LiveActivityDismissalPolicy,\n  NativeLiveActivity,\n  NativeLiveActivityFactory,\n  NativeWidgetObject,\n  PushTokenEvent,\n  WidgetEnvironment,\n  WidgetTimelineEntry,\n} from './Widgets.types';\n\n/**\n * Represents a widget instance. Provides methods to manage the widget's timeline.\n */\nexport class Widget<\n  PropsType extends object = object,\n  ConfigurationType extends object | undefined = undefined,\n> {\n  /** @hidden */\n  private nativeWidgetObject: NativeWidgetObject;\n  constructor(\n    name: string,\n    layout: (\n      props: PropsType,\n      environment: WidgetEnvironment<ConfigurationType>\n    ) => React.JSX.Element\n  ) {\n    this.nativeWidgetObject = new ExpoWidgetsModule.Widget(name, layout as unknown as string);\n  }\n\n  /**\n   * Force reloads the widget, causing it to refresh its content and timeline.\n   */\n  reload() {\n    this.nativeWidgetObject.reload();\n  }\n\n  /**\n   * Schedules a series of updates for the widget's content and reloads the widget.\n   * @param entries Timeline entries, each specifying a date and the props to display at that time.\n   */\n  updateTimeline(entries: WidgetTimelineEntry<PropsType>[]) {\n    this.nativeWidgetObject.updateTimeline(\n      entries.map((entry) => ({ timestamp: entry.date.getTime(), props: entry.props }))\n    );\n  }\n\n  /**\n   * Sets the widget's content to the given props immediately, without scheduling a timeline.\n   * @param props The properties to display in the widget.\n   */\n  updateSnapshot(props: PropsType) {\n    this.nativeWidgetObject.updateTimeline([{ timestamp: Date.now(), props }]);\n  }\n\n  /**\n   * Returns the current timeline entries for the widget, including past and future entries.\n   */\n  async getTimeline(): Promise<WidgetTimelineEntry<PropsType>[]> {\n    return (await this.nativeWidgetObject.getTimeline()).map((entry) => ({\n      date: new Date(entry.timestamp),\n      props: entry.props as PropsType,\n    }));\n  }\n}\n\n/**\n * Represents a Live Activity instance. Provides methods to update its content and end it.\n */\nexport class LiveActivity<T extends object = object> {\n  /** @hidden */\n  private nativeLiveActivity: NativeLiveActivity;\n  constructor(nativeLiveActivity: NativeLiveActivity) {\n    this.nativeLiveActivity = nativeLiveActivity;\n  }\n\n  /**\n   * Updates the Live Activity's content. The UI reflects the new properties immediately.\n   * @param props The updated content properties.\n   */\n  update(props: T): Promise<void> {\n    return this.nativeLiveActivity.update(JSON.stringify(props));\n  }\n\n  /**\n   * Ends the Live Activity.\n   * @param dismissalPolicy Controls when the Live Activity is removed from the Lock Screen after ending.\n   * Can be `'default'`, `'immediate'`, or `after(date)`.\n   * @param props Final content properties to update after the activity ends.\n   * @param contentDate The time the data in the payload was generated. If this is older than a previous update or push payload, the system ignores this update.\n   */\n  end(dismissalPolicy?: LiveActivityDismissalPolicy, props?: T, contentDate?: Date): Promise<void> {\n    const serializedProps = props ? JSON.stringify(props) : undefined;\n    if (\n      typeof dismissalPolicy === 'object' &&\n      dismissalPolicy !== null &&\n      'after' in dismissalPolicy\n    ) {\n      return this.nativeLiveActivity.end(\n        'after',\n        dismissalPolicy.after?.getTime(),\n        serializedProps,\n        contentDate?.getTime()\n      );\n    }\n    return this.nativeLiveActivity.end(\n      dismissalPolicy,\n      undefined,\n      serializedProps,\n      contentDate?.getTime()\n    );\n  }\n\n  /**\n   * Returns the push token for this Live Activity, used to send push notification updates via APNs.\n   * Returns `null` if push notifications are not enabled or the token is not yet available.\n   */\n  getPushToken(): Promise<string | null> {\n    return this.nativeLiveActivity.getPushToken();\n  }\n\n  /**\n   * Adds a listener for push token update events on this Live Activity instance.\n   * The token can be used to send content updates to this specific activity via APNs.\n   * @param listener Callback invoked when a new push token is available.\n   * @returns An event subscription that can be used to remove the listener.\n   */\n  addPushTokenListener(listener: (event: PushTokenEvent) => void): EventSubscription {\n    return this.nativeLiveActivity.addListener('onExpoWidgetsTokenReceived', listener);\n  }\n}\n\n/**\n * Manages Live Activity instances of a specific type. Use it to start new activities and retrieve currently active ones.\n */\nexport class LiveActivityFactory<T extends object = object> {\n  /** @hidden */\n  private nativeLiveActivityFactory: NativeLiveActivityFactory;\n  constructor(name: string, layout: LiveActivityComponent<T>) {\n    this.nativeLiveActivityFactory = new ExpoWidgetsModule.LiveActivityFactory(\n      name,\n      layout as unknown as string\n    );\n  }\n\n  /**\n   * Starts a new Live Activity with the given properties.\n   * @param props The initial content properties for the Live Activity.\n   * @param url An optional URL to associate with the Live Activity, used for deep linking.\n   * @returns The new Live Activity instance.\n   */\n  start(props: T, url?: string) {\n    return new LiveActivity<T>(this.nativeLiveActivityFactory.start(JSON.stringify(props), url));\n  }\n\n  /**\n   * Returns all currently active instances of this Live Activity type.\n   */\n  getInstances() {\n    return this.nativeLiveActivityFactory\n      .getInstances()\n      .map((instance) => new LiveActivity<T>(instance));\n  }\n}\n\n/**\n * Creates a dismissal policy that removes the Live Activity at the specified time within a four-hour window.\n * @param date The date after which the Live Activity should be removed from the Lock Screen.\n * @hidden\n */\nexport function after(date: Date): { after: Date } {\n  return { after: date };\n}\n\n/**\n * Creates a Widget instance.\n * @param name The widget name. Must match the `'name'` field in your widget configuration in the app config.\n * @param widget The widget component, marked with the `'widget'` directive.\n */\nexport function createWidget<\n  PropsType extends object = object,\n  ConfigurationType extends object | undefined = undefined,\n>(\n  name: string,\n  widget: (props: PropsType, context: WidgetEnvironment<ConfigurationType>) => React.JSX.Element\n): Widget<PropsType, ConfigurationType> {\n  return new Widget<PropsType, ConfigurationType>(name, widget);\n}\n\n/**\n * Creates a Live Activity Factory for managing Live Activities of a specific type.\n * @param name The Live Activity name. Must match the `'name'` field in your widget configuration in the app config.\n * @param liveActivity The Live Activity component, marked with the `'widget'` directive.\n */\nexport function createLiveActivity<T extends object = object>(\n  name: string,\n  liveActivity: LiveActivityComponent<T>\n): LiveActivityFactory<T> {\n  return new LiveActivityFactory<T>(name, liveActivity);\n}\n\n/**\n * Adds a listener for widget interaction events (for example, button taps).\n * @param listener Callback function to handle user interaction events.\n * @return An event subscription that can be used to remove the listener.\n */\nexport function addUserInteractionListener(\n  listener: ExpoWidgetsEvents['onExpoWidgetsUserInteraction']\n): EventSubscription {\n  return ExpoWidgetsModule.addListener('onExpoWidgetsUserInteraction', listener);\n}\n\n/**\n * Adds a listener for push-to-start token events.\n * This token can be used to start live activities remotely via APNs.\n * @param listener Callback function to handle push-to-start token events.\n * @return An event subscription that can be used to remove the listener.\n */\nexport function addPushToStartTokenListener(\n  listener: ExpoWidgetsEvents['onExpoWidgetsPushToStartTokenReceived']\n): EventSubscription {\n  return ExpoWidgetsModule.addListener('onExpoWidgetsPushToStartTokenReceived', listener);\n}\n\n/**\n * A directory that can be used to store shared images for widgets.\n * The contents of this directory are accessible by both the main app and widgets.\n */\nexport const widgetsDirectory = ExpoWidgetsModule.widgetsDirectory;\n"]}

package/ios/WidgetsModule.swift

@@ -45,6 +45,20 @@ public final class WidgetsModule: Module {
       pushToStartTokenObserverTask = nil
     }
 
+    Constant("widgetsDirectory") { () -> String? in
+      guard let appGroupIdentifier = WidgetsStorage.appGroupIdentifier,
+            let containerUrl = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: appGroupIdentifier) else {
+        return nil
+      }
+      let directoryUrl = containerUrl.appendingPathComponent("ExpoWidgets", isDirectory: true)
+      do {
+        try FileManager.default.createDirectory(at: directoryUrl, withIntermediateDirectories: true)
+        return directoryUrl.absoluteString
+      } catch {
+        return nil
+      }
+    }
+
     Function("reloadAllWidgets") {
       WidgetCenter.shared.reloadAllTimelines()
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-widgets",
-  "version": "56.0.16",
+  "version": "56.0.18",
   "description": "Widgets.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -22,7 +22,7 @@
   "homepage": "https://docs.expo.dev/versions/latest/sdk/widgets/",
   "dependencies": {
     "@expo/plist": "^0.7.0",
-    "@expo/ui": "~56.0.15"
+    "@expo/ui": "~56.0.17"
   },
   "devDependencies": {
     "@expo/spawn-async": "^1.8.0",
@@ -30,8 +30,8 @@
     "@types/react": "~19.2.0",
     "react-native": "0.85.3",
     "resolve-workspace-root": "^2.0.0",
-    "expo": "56.0.7",
-    "expo-module-scripts": "56.0.2"
+    "expo": "56.0.10",
+    "expo-module-scripts": "56.0.3"
   },
   "peerDependencies": {
     "expo": "*",
@@ -44,7 +44,7 @@
       "./scripts/xcode-build-bundle.sh"
     ]
   },
-  "gitHead": "a7adc95c1747db1e92655feba56d0e62660098db",
+  "gitHead": "b1e94a5c1c5b19472a42ca25752a3533699bc46a",
   "scripts": {
     "build": "expo-module build",
     "build:plugin": "expo-module build plugin",

package/plugin/build/android/withAndroidWidgetFiles.js

@@ -50,7 +50,7 @@ const withAndroidWidgetFiles = (config, widgets) => {
             const packageDirectory = path.join(projectRoot, 'app/src/main/java', ...androidPackage.split('.'));
             const xmlDirectory = path.join(projectRoot, 'app/src/main/res/xml');
             const valuesDirectory = path.join(projectRoot, 'app/src/main/res/values');
-            const widgetsXmlPath = path.join(xmlDirectory, 'expo_widgets.xml');
+            const widgetsXmlPath = path.join(valuesDirectory, 'expo_widgets.xml');
             fs.mkdirSync(packageDirectory, { recursive: true });
             fs.mkdirSync(xmlDirectory, { recursive: true });
             fs.mkdirSync(valuesDirectory, { recursive: true });

package/plugin/build/withWidgets.d.ts

@@ -5,6 +5,11 @@ export type ExpoWidgetsConfigPluginProps = {
     groupIdentifier?: string;
     enablePushNotifications?: boolean;
     frequentUpdates?: boolean;
+    /**
+     * Enable the Android config plugin. Defaults to false.
+     * This option will be removed and Android widget will be enabled by default in the future.
+     */
+    enableAndroid?: boolean;
     widgets?: WidgetConfig[];
 };
 declare const _default: ConfigPlugin<ExpoWidgetsConfigPluginProps | undefined>;

package/plugin/build/withWidgets.js

@@ -8,10 +8,9 @@ const withAndroidWidgets_1 = __importDefault(require("./android/withAndroidWidge
 const withIosWidgets_1 = __importDefault(require("./ios/withIosWidgets"));
 const pkg = require('../../package.json');
 const withWidgets = (config, props) => {
+    const enableAndroid = props?.enableAndroid ?? false;
     const widgets = props?.widgets ?? [];
-    return (0, config_plugins_1.withPlugins)(config, [
-        [withAndroidWidgets_1.default, { widgets }],
-        [withIosWidgets_1.default, { ...(props ?? {}), widgets }],
-    ]);
+    const nextConfig = enableAndroid ? (0, withAndroidWidgets_1.default)(config, { widgets }) : config;
+    return (0, withIosWidgets_1.default)(nextConfig, { ...props, widgets });
 };
 exports.default = (0, config_plugins_1.createRunOncePlugin)(withWidgets, pkg.name, pkg.version);

package/plugin/src/android/withAndroidWidgetFiles.ts

@@ -32,7 +32,7 @@ const withAndroidWidgetFiles: ConfigPlugin<WidgetConfig[]> = (config, widgets) =
       );
       const xmlDirectory = path.join(projectRoot, 'app/src/main/res/xml');
       const valuesDirectory = path.join(projectRoot, 'app/src/main/res/values');
-      const widgetsXmlPath = path.join(xmlDirectory, 'expo_widgets.xml');
+      const widgetsXmlPath = path.join(valuesDirectory, 'expo_widgets.xml');
 
       fs.mkdirSync(packageDirectory, { recursive: true });
       fs.mkdirSync(xmlDirectory, { recursive: true });

package/plugin/src/withWidgets.ts

@@ -1,4 +1,4 @@
-import { ConfigPlugin, createRunOncePlugin, withPlugins } from 'expo/config-plugins';
+import { ConfigPlugin, createRunOncePlugin } from 'expo/config-plugins';
 
 import withAndroidWidgets from './android/withAndroidWidgets';
 import withIosWidgets from './ios/withIosWidgets';
@@ -15,16 +15,20 @@ export type ExpoWidgetsConfigPluginProps = {
   enablePushNotifications?: boolean;
   // Enable frequent updates for widgets. Defaults to false.
   frequentUpdates?: boolean;
+  /**
+   * Enable the Android config plugin. Defaults to false.
+   * This option will be removed and Android widget will be enabled by default in the future.
+   */
+  enableAndroid?: boolean;
   widgets?: WidgetConfig[];
 };
 
 const withWidgets: ConfigPlugin<ExpoWidgetsConfigPluginProps | undefined> = (config, props) => {
+  const enableAndroid = props?.enableAndroid ?? false;
   const widgets = props?.widgets ?? [];
 
-  return withPlugins(config, [
-    [withAndroidWidgets, { widgets }],
-    [withIosWidgets, { ...(props ?? {}), widgets }],
-  ]);
+  const nextConfig = enableAndroid ? withAndroidWidgets(config, { widgets }) : config;
+  return withIosWidgets(nextConfig, { ...props, widgets });
 };
 
 export default createRunOncePlugin(withWidgets, pkg.name, pkg.version);

package/src/ExpoWidgets.ios.ts

@@ -8,6 +8,7 @@ import type {
 } from './Widgets.types';
 
 declare class ExpoWidgetsModule extends NativeModule<ExpoWidgetsEvents> {
+  widgetsDirectory: string;
   reloadAllWidgets(): void;
   readonly Widget: typeof NativeWidgetObject;
   readonly LiveActivityFactory: typeof NativeLiveActivityFactory;

package/src/ExpoWidgets.ts

@@ -48,6 +48,7 @@ class LiveActivityFactoryStub {
 }
 
 const ExpoWidgetsModule = {
+  widgetsDirectory: '',
   reloadAllWidgets(): void {},
   Widget: WidgetStub as typeof NativeWidgetObject,
   LiveActivityFactory: LiveActivityFactoryStub as typeof NativeLiveActivityFactory,

package/src/Widgets.ts

@@ -225,3 +225,9 @@ export function addPushToStartTokenListener(
 ): EventSubscription {
   return ExpoWidgetsModule.addListener('onExpoWidgetsPushToStartTokenReceived', listener);
 }
+
+/**
+ * A directory that can be used to store shared images for widgets.
+ * The contents of this directory are accessible by both the main app and widgets.
+ */
+export const widgetsDirectory = ExpoWidgetsModule.widgetsDirectory;