Update Widget

There are two ways to update a widget once it is added on the home screen.

updatePeriodMillis

Schedule updates using android:updatePeriodMillis (or updatePeriodMillis with Expo)

When using this option, the widgetTaskHandler function will be called with widgetAction = 'WIDGET_UPDATE', and you can use it to update the widget.

widget-task-handler.tsx

export async function widgetTaskHandler(props: WidgetTaskHandlerProps) {

  switch (props.widgetAction) {
    ...

    case 'WIDGET_UPDATE':
      props.renderWidget(<Widget />);
      break;

    ...
  }
}

Note

Updates requested with updatePeriodMillis will not be delivered more than once every 30 minutes.

More details about updatePeriodMillis on the official documentation.

requestWidgetUpdate

You can call requestWidgetUpdate any time when your app is open as a result of some user action, and request a widget update.