6 getInstances() {
7 return [];
8 }
9+ dismissEnded() {}
10 }
11 class CustomNotificationStub {
12 getId() {
18 * @platform ios
19 */
20 getInstances(): LiveActivity<T>[];
21+ /** Dismisses ended instances that iOS still shows on the Lock Screen. */
22+ dismissEnded(): void;
23 }
24 /**
25 * Creates a dismissal policy that removes the Live Activity at the specified time within a four-hour window.
31 */ getInstances() {
32 return this.nativeLiveActivityFactory.getInstances().map((instance)=>new LiveActivity(instance));
33 }
34+ dismissEnded() {
35+ this.nativeLiveActivityFactory.dismissEnded();
36+ }
37 }
38 /**
39 * Creates a dismissal policy that removes the Live Activity at the specified time within a four-hour window.
45 * @platform ios
46 */
47 colorScheme: 'light' | 'dark';
48+ /** The rendering mode supplied by WidgetKit for this presentation. */
49+ widgetRenderingMode?: WidgetRenderingMode;
50+ /** Whether the presentation OS supports Liquid Glass. @platform iOS 26+ */
51+ isLiquidGlassAvailable?: boolean;
52 /**
53 * Whether the activity is displayed in a context with reduced luminance.
54 * @platform iOS 16+
56 constructor(name: string, layout: string);
57 start(props?: string, url?: string, staleDate?: number): NativeLiveActivity;
58 getInstances(): NativeLiveActivity[];
59+ dismissEnded(): void;
60 }
61 export declare class NativeLiveActivity extends SharedObject<LiveActivityEvents> {
62 getId(): string;
68 WidgetsStorage.set(layout, forKey: "__expo_widgets_live_activity_\(name)_layout")
69 }
71+ // iOS ends an activity after 8 hours but leaves it frozen on the Lock Screen for up to
72+ // 4 more. getInstances() can't see it, so dismiss the ended ones directly.
73+ func dismissEnded() {
74+ for activity in Activity<LiveActivityAttributes>.activities
75+ where activity.content.state.name == name && activity.activityState == .ended {
76+ Task { await activity.end(nil, dismissalPolicy: .immediate) }
77+ }
78+ }
79+
80 func start(props: String?, url: URL?, staleDate: Date?) throws -> LiveActivity {
81 guard ActivityAuthorizationInfo().areActivitiesEnabled else {
82 throw LiveActivitiesNotSupportedException()
83 }
85+ // A replacement started beside an ended card would leave both visible.
86+ dismissEnded()
87+
88 do {
89 let initialState = LiveActivityAttributes.ContentState(name: name, props: props)
90 let activity = try Activity.request(
96 "isStale": context.isStale
97 ]
99+ if #available(iOS 26.0, *) {
100+ env["isLiquidGlassAvailable"] = true
101+ }
102+ env["widgetRenderingMode"] = environment.widgetRenderingMode.description
103 if #available(iOS 18.0, *) {
104 env["isActivityUpdateReduced"] = environment.isActivityUpdateReduced
105 env["activityFamily"] = "\(environment.activityFamily)"
111 }
113 public struct WidgetLiveActivity: Widget {
114- @Environment(\.self) var env
115-
116 let widgetContext: AppContext = AppContext()
118 public init() {}
120 public var body: some WidgetConfiguration {
121 ActivityConfiguration(for: LiveActivityAttributes.self) { context in
122- let nodes = getLiveActivityNodes(
123- forName: context.state.name,
124- props: context.state.props,
125- environment: getLiveActivityEnvironment(for: env, in: context)
126- )
127 // Only apply widgetURL when the activity has one: a hierarchy with more than one
128 // widgetURL modifier is undefined behavior, and layouts can set their own through
129 // the widgetURL modifier from @expo/ui.
130- let banner = LiveActivityBannerView(context: context, nodes: nodes)
131+ let banner = LiveActivityBannerView(context: context)
132 if let url = context.attributes.url.flatMap(URL.init(string:)) {
133 banner.widgetURL(url)
134 } else {
135 banner
136 }
137 } dynamicIsland: { context in
138- let nodes = getLiveActivityNodes(
139- forName: context.state.name,
140- props: context.state.props,
141- environment: getLiveActivityEnvironment(for: env, in: context)
142- )
143 let island = DynamicIsland {
144 DynamicIslandExpandedRegion(.center) {
145- LiveActivitySectionView(context: context, nodes: nodes, sectionName: "expandedCenter")
146+ LiveActivitySectionView(context: context, sectionName: "expandedCenter")
147 }
148 DynamicIslandExpandedRegion(.leading) {
149- LiveActivitySectionView(context: context, nodes: nodes, sectionName: "expandedLeading")
150+ LiveActivitySectionView(context: context, sectionName: "expandedLeading")
151 }
152 DynamicIslandExpandedRegion(.trailing) {
153- LiveActivitySectionView(context: context, nodes: nodes, sectionName: "expandedTrailing")
154+ LiveActivitySectionView(context: context, sectionName: "expandedTrailing")
155 }
156 DynamicIslandExpandedRegion(.bottom) {
157- LiveActivitySectionView(context: context, nodes: nodes, sectionName: "expandedBottom")
158+ LiveActivitySectionView(context: context, sectionName: "expandedBottom")
159 }
160 } compactLeading: {
161- LiveActivitySectionView(context: context, nodes: nodes, sectionName: "compactLeading")
162+ LiveActivitySectionView(context: context, sectionName: "compactLeading")
163 } compactTrailing: {
164- LiveActivitySectionView(context: context, nodes: nodes, sectionName: "compactTrailing")
165+ LiveActivitySectionView(context: context, sectionName: "compactTrailing")
166 } minimal: {
167- LiveActivitySectionView(context: context, nodes: nodes, sectionName: "minimal")
168+ LiveActivitySectionView(context: context, sectionName: "minimal")
169 }
170 if let url = context.attributes.url.flatMap(URL.init(string:)) {
171 return island.widgetURL(url)
173 }
175 private struct LiveActivitySectionView: View {
176+ @Environment(\.self) var env
177 let context: ActivityViewContext<LiveActivityAttributes>
178- let nodes: [String: Any]
179 let sectionName: String
181 var body: some View {
182+ let nodes = getLiveActivityNodes(
183+ forName: context.state.name,
184+ props: context.state.props,
185+ environment: getLiveActivityEnvironment(for: env, in: context)
186+ )
187 if let node = nodes[sectionName] as? [String: Any] {
188 WidgetsDynamicView(name: context.activityID, kind: .liveActivity, node: node)
189 } else {
191 }
193 private struct LiveActivityBannerView: View {
194+ // Read inside the rendered view: Widget-level values do not include the
195+ // presentation's color scheme, rendering mode, or reduced-luminance state.
196+ @Environment(\.self) var env
197 var context: ActivityViewContext<LiveActivityAttributes>
198- let nodes: [String: Any]
200 var body: some View {
201+ let nodes = getLiveActivityNodes(
202+ forName: context.state.name,
203+ props: context.state.props,
204+ environment: getLiveActivityEnvironment(for: env, in: context)
205+ )
206 if #available(iOS 18.0, *) {
207 LiveActivityBanner(context: context, nodes: nodes)
208 } else if let node = nodes["banner"] as? [String: Any] {
214 Function("getInstances") { (liveActivity: LiveActivityFactory) in
215 try liveActivity.getInstances()
216 }
217+
218+ Function("dismissEnded") { (liveActivity: LiveActivityFactory) in
219+ liveActivity.dismissEnded()
220+ }
221 }
227 getInstances(): NativeLiveActivity[] {
228 return [];
229 }
230+ dismissEnded(): void {}
231 }
237 .getInstances()
238 .map((instance) => new LiveActivity<T>(instance));
239 }
240+
241+ /** Dismisses ended instances that iOS still shows on the Lock Screen. */
242+ dismissEnded(): void {
243+ this.nativeLiveActivityFactory.dismissEnded();
244+ }
245 }
251 * @platform ios
252 */
253 colorScheme: 'light' | 'dark';
254+ /** The rendering mode supplied by WidgetKit for this presentation. */
255+ widgetRenderingMode?: WidgetRenderingMode;
256+ /** Whether the presentation OS supports Liquid Glass. @platform iOS 26+ */
257+ isLiquidGlassAvailable?: boolean;
258 /**
259 * Whether the activity is displayed in a context with reduced luminance.
260 * @platform iOS 16+
262 constructor(name: string, layout: string);
263 start(props?: string, url?: string, staleDate?: number): NativeLiveActivity;
264 getInstances(): NativeLiveActivity[];
265+ dismissEnded(): void;
266 }