react-native-live-widgets 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +13 -0
- package/LICENSE +21 -0
- package/README.md +221 -2
- package/android/build.gradle +49 -0
- package/android/src/main/AndroidManifest.xml +38 -0
- package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityModule.kt +440 -0
- package/android/src/main/java/com/reactnativeliveactivity/bridge/LiveActivityPackage.kt +17 -0
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityHeadlessTaskService.kt +24 -0
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityNotifier.kt +410 -0
- package/android/src/main/java/com/reactnativeliveactivity/liveactivity/LiveActivityReceiver.kt +67 -0
- package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicNodeRegistry.kt +64 -0
- package/android/src/main/java/com/reactnativeliveactivity/renderer/DynamicWidgetCanvasRenderer.kt +1223 -0
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetImageCache.kt +120 -0
- package/android/src/main/java/com/reactnativeliveactivity/storage/DynamicWidgetStateStore.kt +281 -0
- package/android/src/main/java/com/reactnativeliveactivity/widgets/DynamicHomeScreenWidgetProvider.kt +229 -0
- package/android/src/main/res/layout/rn_live_widget_host.xml +113 -0
- package/android/src/main/res/xml/rn_live_widget_info.xml +14 -0
- package/assets/dashboard_features.png +0 -0
- package/assets/dynamic_island_expanded.png +0 -0
- package/assets/home_widget_interactive.png +0 -0
- package/assets/lock_screen_live_activity.png +0 -0
- package/cli/setup.js +94 -0
- package/docs/GUIDE-EN.md +804 -0
- package/docs/GUIDE-VI.md +802 -0
- package/docs/widgets.md +52 -0
- package/ios/Bridge/LiveActivityModule.m +105 -0
- package/ios/Bridge/LiveActivityModule.swift +957 -0
- package/ios/Intents/DynamicWidgetActionIntent.swift +38 -0
- package/ios/Models/DynamicActivityAttributes.swift +22 -0
- package/ios/Models/DynamicLayoutModels.swift +243 -0
- package/ios/Renderer/ColorHexExtension.swift +49 -0
- package/ios/Renderer/DynamicNodeRegistry.swift +54 -0
- package/ios/Renderer/DynamicNodeView.swift +1060 -0
- package/ios/Storage/DynamicWidgetImageCache.swift +137 -0
- package/ios/Storage/DynamicWidgetStateStore.swift +162 -0
- package/ios/Widgets/DynamicHomeScreenWidget.swift +435 -0
- package/ios/Widgets/DynamicLiveActivityWidget.swift +79 -0
- package/lib/builder.d.ts +60 -0
- package/lib/builder.d.ts.map +1 -0
- package/lib/builder.js +296 -0
- package/lib/builder.js.map +1 -0
- package/lib/dispatcher.d.ts +16 -0
- package/lib/dispatcher.d.ts.map +1 -0
- package/lib/dispatcher.js +23 -0
- package/lib/dispatcher.js.map +1 -0
- package/lib/index.d.ts +199 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +634 -0
- package/lib/index.js.map +1 -0
- package/lib/types.d.ts +489 -0
- package/lib/types.d.ts.map +1 -0
- package/lib/types.js +10 -0
- package/lib/types.js.map +1 -0
- package/package.json +68 -4
- package/react-native-live-widgets.podspec +38 -0
- package/src/builder.ts +409 -0
- package/src/dispatcher.ts +25 -0
- package/src/index.ts +681 -0
- package/src/types.ts +595 -0
|
@@ -0,0 +1,435 @@
|
|
|
1
|
+
import SwiftUI
|
|
2
|
+
import WidgetKit
|
|
3
|
+
|
|
4
|
+
public struct DynamicWidgetEntry: TimelineEntry {
|
|
5
|
+
public let date: Date
|
|
6
|
+
public let layoutJson: String?
|
|
7
|
+
|
|
8
|
+
public init(date: Date, layoutJson: String?) {
|
|
9
|
+
self.date = date
|
|
10
|
+
self.layoutJson = layoutJson
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
public struct DynamicWidgetProvider: TimelineProvider {
|
|
15
|
+
let widgetKey: String
|
|
16
|
+
let appGroup: String
|
|
17
|
+
|
|
18
|
+
public init(widgetKey: String, appGroup: String = "") {
|
|
19
|
+
self.widgetKey = widgetKey
|
|
20
|
+
self.appGroup = appGroup
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
public func placeholder(in context: Context) -> DynamicWidgetEntry {
|
|
24
|
+
DynamicWidgetEntry(date: Date(), layoutJson: readLayoutJson())
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
public func getSnapshot(in context: Context, completion: @escaping (DynamicWidgetEntry) -> Void) {
|
|
28
|
+
let json = readLayoutJson()
|
|
29
|
+
completion(DynamicWidgetEntry(date: Date(), layoutJson: json))
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
public func getTimeline(in context: Context, completion: @escaping (Timeline<DynamicWidgetEntry>) -> Void) {
|
|
33
|
+
let wKey = widgetKey
|
|
34
|
+
let group = appGroup
|
|
35
|
+
|
|
36
|
+
// 1. Kiểm tra xem có cấu hình Timeline nhiều mốc thời gian không (widget_timeline_<key>)
|
|
37
|
+
if let timelineRaw = Self.readSharedString(forKey: "widget_timeline_\(wKey)", appGroup: group),
|
|
38
|
+
let data = timelineRaw.data(using: .utf8),
|
|
39
|
+
let timelineDTO = try? JSONDecoder().decode(WidgetTimelineConfigDTO.self, from: data),
|
|
40
|
+
!timelineDTO.entries.isEmpty {
|
|
41
|
+
var entries: [DynamicWidgetEntry] = []
|
|
42
|
+
for item in timelineDTO.entries {
|
|
43
|
+
let entryDate: Date
|
|
44
|
+
if item.date > 10_000_000_000 {
|
|
45
|
+
entryDate = Date(timeIntervalSince1970: item.date / 1000.0)
|
|
46
|
+
} else {
|
|
47
|
+
entryDate = Date(timeIntervalSince1970: item.date)
|
|
48
|
+
}
|
|
49
|
+
let layoutJson: String
|
|
50
|
+
if let encoded = try? JSONEncoder().encode(item.layout),
|
|
51
|
+
let str = String(data: encoded, encoding: .utf8) {
|
|
52
|
+
layoutJson = str
|
|
53
|
+
} else {
|
|
54
|
+
layoutJson = ""
|
|
55
|
+
}
|
|
56
|
+
entries.append(DynamicWidgetEntry(date: entryDate, layoutJson: layoutJson))
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
entries.sort { $0.date < $1.date }
|
|
60
|
+
|
|
61
|
+
let policy: TimelineReloadPolicy
|
|
62
|
+
switch timelineDTO.policy {
|
|
63
|
+
case "never":
|
|
64
|
+
policy = .never
|
|
65
|
+
case "afterDate":
|
|
66
|
+
if let after = timelineDTO.afterDate {
|
|
67
|
+
let afterDate = after > 10_000_000_000 ? Date(timeIntervalSince1970: after / 1000.0) : Date(timeIntervalSince1970: after)
|
|
68
|
+
policy = .after(afterDate)
|
|
69
|
+
} else {
|
|
70
|
+
policy = .atEnd
|
|
71
|
+
}
|
|
72
|
+
default:
|
|
73
|
+
policy = .atEnd
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
completion(Timeline(entries: entries, policy: policy))
|
|
77
|
+
return
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
// 2. Chạy cơ chế đơn mốc mặc định (Layout snapshot hiện tại)
|
|
81
|
+
let rawLayout = Self.readSharedString(forKey: "widget_layout_\(wKey)", appGroup: group)
|
|
82
|
+
let hasTemplateVars = rawLayout?.contains("{{") == true
|
|
83
|
+
let hasRemoteConfig = Self.readSharedString(forKey: "widget_remote_config_\(wKey)", appGroup: group) != nil
|
|
84
|
+
let state = DynamicWidgetStateStore.loadState()
|
|
85
|
+
let secondsSinceLastUpdate = Date().timeIntervalSince1970 - (state.updatedAt ?? 0)
|
|
86
|
+
let needsRemoteSync = hasRemoteConfig && hasTemplateVars && (state.lastSyncTime == nil || secondsSinceLastUpdate >= 20)
|
|
87
|
+
let needsImagePrefetch = rawLayout.map { DynamicWidgetImageCache.hasUncachedUrls(in: $0) } ?? false
|
|
88
|
+
|
|
89
|
+
// Trả Timeline ngay lập tức để chuyển đổi giữa các mẫu Widget mượt mà tức thì
|
|
90
|
+
let json = readLayoutJson()
|
|
91
|
+
let entry = DynamicWidgetEntry(date: Date(), layoutJson: json)
|
|
92
|
+
let intervalMins = readRefreshIntervalMinutes()
|
|
93
|
+
let nextUpdate = Calendar.current.date(byAdding: .minute, value: intervalMins, to: Date())!
|
|
94
|
+
completion(Timeline(entries: [entry], policy: .after(nextUpdate)))
|
|
95
|
+
|
|
96
|
+
// Tác vụ đồng bộ ngầm và tải trước ảnh URL nếu cần
|
|
97
|
+
if needsRemoteSync || needsImagePrefetch {
|
|
98
|
+
Task {
|
|
99
|
+
if needsRemoteSync {
|
|
100
|
+
await DynamicWidgetStateStore.performRemoteSync(widgetKey: wKey)
|
|
101
|
+
}
|
|
102
|
+
if let json = json, needsImagePrefetch {
|
|
103
|
+
await DynamicWidgetImageCache.prefetchUrls(in: json)
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
private func readRefreshIntervalMinutes() -> Int {
|
|
110
|
+
let configKey = "widget_remote_config_\(widgetKey)"
|
|
111
|
+
if let json = Self.readSharedString(forKey: configKey, appGroup: appGroup),
|
|
112
|
+
let data = json.data(using: .utf8),
|
|
113
|
+
let config = try? JSONDecoder().decode(WidgetRemoteConfigDTO.self, from: data),
|
|
114
|
+
let mins = config.refreshIntervalMinutes, mins >= 1 {
|
|
115
|
+
return mins
|
|
116
|
+
}
|
|
117
|
+
return 15
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
private func readLayoutJson() -> String? {
|
|
121
|
+
let key = "widget_layout_\(widgetKey)"
|
|
122
|
+
var raw: String? = Self.readSharedString(forKey: key, appGroup: appGroup)
|
|
123
|
+
if raw == nil && widgetKey != "main" {
|
|
124
|
+
raw = Self.readSharedString(forKey: "widget_layout_main", appGroup: appGroup)
|
|
125
|
+
}
|
|
126
|
+
guard var raw = raw else {
|
|
127
|
+
return nil
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
let state = DynamicWidgetStateStore.loadState()
|
|
131
|
+
let syncTime = state.lastSyncTime ?? {
|
|
132
|
+
let f = DateFormatter()
|
|
133
|
+
f.dateFormat = "HH:mm:ss"
|
|
134
|
+
return f.string(from: Date())
|
|
135
|
+
}()
|
|
136
|
+
raw = raw.replacingOccurrences(of: "{{_lastSyncTime}}", with: syncTime)
|
|
137
|
+
|
|
138
|
+
if let vars = state.remoteVariables {
|
|
139
|
+
for (k, v) in vars {
|
|
140
|
+
let escaped = v.replacingOccurrences(of: "\"", with: "\\\"")
|
|
141
|
+
raw = raw.replacingOccurrences(of: "{{\(k)}}", with: escaped)
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
if let selectedConfig = Self.readSharedString(forKey: "widget_selected_config_\(widgetKey)", appGroup: appGroup) {
|
|
146
|
+
raw = raw.replacingOccurrences(of: "{{_selectedConfigId}}", with: selectedConfig)
|
|
147
|
+
raw = raw.replacingOccurrences(of: "{{selectedConfigId}}", with: selectedConfig)
|
|
148
|
+
}
|
|
149
|
+
return raw
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
public static func readSharedString(forKey key: String, appGroup: String) -> String? {
|
|
153
|
+
let resolvedGroup = resolveAppGroup(appGroup)
|
|
154
|
+
|
|
155
|
+
if let fileURL = sharedFileURL(key: key, appGroup: appGroup),
|
|
156
|
+
let fileVal = try? String(contentsOf: fileURL, encoding: .utf8),
|
|
157
|
+
!fileVal.isEmpty {
|
|
158
|
+
return fileVal
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
if !resolvedGroup.isEmpty,
|
|
162
|
+
let groupDefaults = UserDefaults(suiteName: resolvedGroup),
|
|
163
|
+
let val = groupDefaults.string(forKey: key),
|
|
164
|
+
!val.isEmpty {
|
|
165
|
+
return val
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
#if targetEnvironment(simulator)
|
|
169
|
+
let simPath = "/tmp/rn_live_widgets_\(key).json"
|
|
170
|
+
if let simVal = try? String(contentsOfFile: simPath, encoding: .utf8), !simVal.isEmpty {
|
|
171
|
+
return simVal
|
|
172
|
+
}
|
|
173
|
+
#endif
|
|
174
|
+
|
|
175
|
+
return UserDefaults.standard.string(forKey: key)
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
public static func writeSharedString(_ value: String, forKey key: String, appGroup: String) {
|
|
179
|
+
let resolvedGroup = resolveAppGroup(appGroup)
|
|
180
|
+
if let fileURL = sharedFileURL(key: key, appGroup: appGroup) {
|
|
181
|
+
try? value.write(to: fileURL, atomically: true, encoding: .utf8)
|
|
182
|
+
}
|
|
183
|
+
if !resolvedGroup.isEmpty, let groupDefaults = UserDefaults(suiteName: resolvedGroup) {
|
|
184
|
+
groupDefaults.set(value, forKey: key)
|
|
185
|
+
groupDefaults.synchronize()
|
|
186
|
+
}
|
|
187
|
+
#if targetEnvironment(simulator)
|
|
188
|
+
let simPath = "/tmp/rn_live_widgets_\(key).json"
|
|
189
|
+
try? value.write(toFile: simPath, atomically: true, encoding: .utf8)
|
|
190
|
+
#endif
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
public static func sharedFileURL(key: String, appGroup: String) -> URL? {
|
|
194
|
+
let resolvedGroup = resolveAppGroup(appGroup)
|
|
195
|
+
guard !resolvedGroup.isEmpty,
|
|
196
|
+
let containerURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: resolvedGroup) else {
|
|
197
|
+
return nil
|
|
198
|
+
}
|
|
199
|
+
return containerURL.appendingPathComponent("rn_live_widgets_\(key).json")
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
public static func resolveAppGroup(_ explicit: String) -> String {
|
|
203
|
+
if !explicit.isEmpty { return explicit }
|
|
204
|
+
guard let bundleId = Bundle.main.bundleIdentifier else { return "" }
|
|
205
|
+
if Bundle.main.bundlePath.hasSuffix(".appex"),
|
|
206
|
+
let dotIndex = bundleId.lastIndex(of: ".") {
|
|
207
|
+
let hostBundleId = String(bundleId[..<dotIndex])
|
|
208
|
+
return "group.\(hostBundleId)"
|
|
209
|
+
}
|
|
210
|
+
return "group.\(bundleId)"
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
public struct DynamicHomeScreenWidgetView: View {
|
|
215
|
+
@Environment(\.widgetFamily) var family
|
|
216
|
+
@Environment(\.colorScheme) var colorScheme
|
|
217
|
+
let entry: DynamicWidgetEntry
|
|
218
|
+
|
|
219
|
+
public init(entry: DynamicWidgetEntry) {
|
|
220
|
+
self.entry = entry
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
private var parsedPayload: WidgetMultiPagePayloadDTO? {
|
|
224
|
+
guard let json = entry.layoutJson,
|
|
225
|
+
let data = json.data(using: .utf8),
|
|
226
|
+
let payload = try? JSONDecoder().decode(WidgetMultiPagePayloadDTO.self, from: data) else {
|
|
227
|
+
return nil
|
|
228
|
+
}
|
|
229
|
+
return payload
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
private var rootDeepLink: String? {
|
|
233
|
+
parsedPayload?.rootDeepLink
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
private var containerGradientColors: [String]? {
|
|
237
|
+
parsedPayload?.containerBackground?.gradientColors
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
private var activeNode: LayoutNodeDTO? {
|
|
241
|
+
guard let payload = parsedPayload else {
|
|
242
|
+
return nil
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
if let pages = payload.pages, !pages.isEmpty {
|
|
246
|
+
let state = DynamicWidgetStateStore.loadState()
|
|
247
|
+
let defaultOrder = payload.pageOrder ?? Array(pages.keys).sorted()
|
|
248
|
+
let activePageId: String = {
|
|
249
|
+
if let saved = state.activePage, pages[saved] != nil {
|
|
250
|
+
return saved
|
|
251
|
+
}
|
|
252
|
+
if let initial = payload.initialPage, pages[initial] != nil {
|
|
253
|
+
return initial
|
|
254
|
+
}
|
|
255
|
+
return defaultOrder.first ?? ""
|
|
256
|
+
}()
|
|
257
|
+
|
|
258
|
+
if let pageConfig = pages[activePageId] {
|
|
259
|
+
return selectFamilyNode(
|
|
260
|
+
small: pageConfig.small ?? payload.small,
|
|
261
|
+
medium: pageConfig.medium ?? payload.medium,
|
|
262
|
+
large: pageConfig.large ?? payload.large,
|
|
263
|
+
accessoryRectangular: pageConfig.accessoryRectangular ?? payload.accessoryRectangular,
|
|
264
|
+
accessoryCircular: pageConfig.accessoryCircular ?? payload.accessoryCircular,
|
|
265
|
+
accessoryInline: pageConfig.accessoryInline ?? payload.accessoryInline
|
|
266
|
+
)
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
return selectFamilyNode(
|
|
271
|
+
small: payload.small,
|
|
272
|
+
medium: payload.medium,
|
|
273
|
+
large: payload.large,
|
|
274
|
+
accessoryRectangular: payload.accessoryRectangular,
|
|
275
|
+
accessoryCircular: payload.accessoryCircular,
|
|
276
|
+
accessoryInline: payload.accessoryInline
|
|
277
|
+
)
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
private func selectFamilyNode(
|
|
281
|
+
small: LayoutNodeDTO?,
|
|
282
|
+
medium: LayoutNodeDTO?,
|
|
283
|
+
large: LayoutNodeDTO?,
|
|
284
|
+
accessoryRectangular: LayoutNodeDTO? = nil,
|
|
285
|
+
accessoryCircular: LayoutNodeDTO? = nil,
|
|
286
|
+
accessoryInline: LayoutNodeDTO? = nil
|
|
287
|
+
) -> LayoutNodeDTO? {
|
|
288
|
+
if #available(iOS 16.0, *) {
|
|
289
|
+
switch family {
|
|
290
|
+
case .accessoryRectangular:
|
|
291
|
+
return accessoryRectangular ?? small
|
|
292
|
+
case .accessoryCircular:
|
|
293
|
+
return accessoryCircular
|
|
294
|
+
case .accessoryInline:
|
|
295
|
+
return accessoryInline
|
|
296
|
+
default:
|
|
297
|
+
break
|
|
298
|
+
}
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
switch family {
|
|
302
|
+
case .systemSmall:
|
|
303
|
+
return small ?? medium ?? large
|
|
304
|
+
case .systemMedium:
|
|
305
|
+
return medium ?? small ?? large
|
|
306
|
+
case .systemLarge, .systemExtraLarge:
|
|
307
|
+
return large ?? medium ?? small
|
|
308
|
+
default:
|
|
309
|
+
return small ?? medium ?? large
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
|
|
313
|
+
private var isAccessoryFamily: Bool {
|
|
314
|
+
if #available(iOS 16.0, *) {
|
|
315
|
+
return family == .accessoryRectangular || family == .accessoryCircular || family == .accessoryInline
|
|
316
|
+
}
|
|
317
|
+
return false
|
|
318
|
+
}
|
|
319
|
+
|
|
320
|
+
private var rootBackgroundColor: Color {
|
|
321
|
+
if isAccessoryFamily {
|
|
322
|
+
return Color.clear
|
|
323
|
+
}
|
|
324
|
+
if let bgCodable = parsedPayload?.containerBackground?.backgroundColor,
|
|
325
|
+
let color = Color.resolve(from: bgCodable, colorScheme: colorScheme) {
|
|
326
|
+
return color
|
|
327
|
+
}
|
|
328
|
+
if let bgCodable = activeNode?.props?["backgroundColor"],
|
|
329
|
+
let color = Color.resolve(from: bgCodable, colorScheme: colorScheme) {
|
|
330
|
+
return color
|
|
331
|
+
}
|
|
332
|
+
return Color(.systemBackground)
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
public var body: some View {
|
|
336
|
+
Group {
|
|
337
|
+
if let node = activeNode {
|
|
338
|
+
DynamicNodeView(node: node)
|
|
339
|
+
.frame(
|
|
340
|
+
maxWidth: .infinity,
|
|
341
|
+
maxHeight: .infinity,
|
|
342
|
+
alignment: isAccessoryFamily ? .center : .topLeading
|
|
343
|
+
)
|
|
344
|
+
} else {
|
|
345
|
+
fallbackView()
|
|
346
|
+
}
|
|
347
|
+
}
|
|
348
|
+
.applyWidgetURL(rootDeepLink)
|
|
349
|
+
.applyWidgetBackground(rootBackgroundColor, gradientColors: containerGradientColors, isAccessory: isAccessoryFamily)
|
|
350
|
+
}
|
|
351
|
+
|
|
352
|
+
@ViewBuilder
|
|
353
|
+
private func fallbackView() -> some View {
|
|
354
|
+
if isAccessoryFamily {
|
|
355
|
+
if family == .accessoryCircular {
|
|
356
|
+
Image(systemName: "clock.badge.checkmark.fill")
|
|
357
|
+
.font(.system(size: 22, weight: .bold))
|
|
358
|
+
.foregroundColor(.white)
|
|
359
|
+
} else {
|
|
360
|
+
VStack(alignment: .leading, spacing: 2) {
|
|
361
|
+
Text("Live Widgets")
|
|
362
|
+
.font(.caption2.weight(.bold))
|
|
363
|
+
Text("Chưa có dữ liệu")
|
|
364
|
+
.font(.system(size: 9))
|
|
365
|
+
.foregroundColor(.secondary)
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
} else {
|
|
369
|
+
VStack(spacing: 6) {
|
|
370
|
+
Text("Live Widgets")
|
|
371
|
+
.font(.headline)
|
|
372
|
+
Text("Chọn 1 mẫu UI trong app để hiển thị")
|
|
373
|
+
.font(.caption)
|
|
374
|
+
.foregroundColor(.secondary)
|
|
375
|
+
.multilineTextAlignment(.center)
|
|
376
|
+
}
|
|
377
|
+
.padding(12)
|
|
378
|
+
}
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
|
|
382
|
+
extension View {
|
|
383
|
+
@ViewBuilder
|
|
384
|
+
func applyWidgetURL(_ urlString: String?) -> some View {
|
|
385
|
+
if let urlStr = urlString, let url = URL(string: urlStr) {
|
|
386
|
+
self.widgetURL(url)
|
|
387
|
+
} else {
|
|
388
|
+
self
|
|
389
|
+
}
|
|
390
|
+
}
|
|
391
|
+
|
|
392
|
+
/// Tương thích iOS 17+ / iOS 18+: Bắt buộc dùng `containerBackground(for: .widget)`
|
|
393
|
+
@ViewBuilder
|
|
394
|
+
func applyWidgetBackground(
|
|
395
|
+
_ color: Color,
|
|
396
|
+
gradientColors: [String]? = nil,
|
|
397
|
+
isAccessory: Bool = false
|
|
398
|
+
) -> some View {
|
|
399
|
+
if #available(iOS 17.0, *) {
|
|
400
|
+
if isAccessory {
|
|
401
|
+
self.containerBackground(for: .widget) {
|
|
402
|
+
Color.clear
|
|
403
|
+
}
|
|
404
|
+
} else {
|
|
405
|
+
self.containerBackground(for: .widget) {
|
|
406
|
+
if let grad = gradientColors, grad.count >= 2 {
|
|
407
|
+
LinearGradient(
|
|
408
|
+
colors: grad.compactMap { Color(hex: $0) },
|
|
409
|
+
startPoint: .topLeading,
|
|
410
|
+
endPoint: .bottomTrailing
|
|
411
|
+
)
|
|
412
|
+
} else {
|
|
413
|
+
color
|
|
414
|
+
}
|
|
415
|
+
}
|
|
416
|
+
}
|
|
417
|
+
} else {
|
|
418
|
+
if isAccessory {
|
|
419
|
+
self
|
|
420
|
+
} else {
|
|
421
|
+
if let grad = gradientColors, grad.count >= 2 {
|
|
422
|
+
self.padding().background(
|
|
423
|
+
LinearGradient(
|
|
424
|
+
colors: grad.compactMap { Color(hex: $0) },
|
|
425
|
+
startPoint: .topLeading,
|
|
426
|
+
endPoint: .bottomTrailing
|
|
427
|
+
)
|
|
428
|
+
)
|
|
429
|
+
} else {
|
|
430
|
+
self.padding().background(color)
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
}
|
|
434
|
+
}
|
|
435
|
+
}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import ActivityKit
|
|
2
|
+
import SwiftUI
|
|
3
|
+
import WidgetKit
|
|
4
|
+
|
|
5
|
+
@available(iOS 16.1, *)
|
|
6
|
+
public struct DynamicLiveActivityWidget: Widget {
|
|
7
|
+
public init() {}
|
|
8
|
+
|
|
9
|
+
public var body: some WidgetConfiguration {
|
|
10
|
+
ActivityConfiguration(for: DynamicActivityAttributes.self) { context in
|
|
11
|
+
// Render Lock Screen
|
|
12
|
+
let payload = parsePayload(json: context.state.payloadJson)
|
|
13
|
+
if let lockScreen = payload?.lockScreen {
|
|
14
|
+
DynamicNodeView(node: lockScreen)
|
|
15
|
+
.activityBackgroundTint(.black.opacity(0.8))
|
|
16
|
+
.activitySystemActionForegroundColor(.white)
|
|
17
|
+
} else {
|
|
18
|
+
Text("Live Activity")
|
|
19
|
+
}
|
|
20
|
+
} dynamicIsland: { context in
|
|
21
|
+
let payload = parsePayload(json: context.state.payloadJson)
|
|
22
|
+
let island = payload?.dynamicIsland
|
|
23
|
+
|
|
24
|
+
return DynamicIsland {
|
|
25
|
+
// Expanded Regions với Safe Padding & Smart Fallback tránh tình trạng Dynamic Island bị đen trống rỗng
|
|
26
|
+
DynamicIslandExpandedRegion(.leading) {
|
|
27
|
+
if let leading = island?.expanded?.leading ?? island?.compactLeading {
|
|
28
|
+
DynamicNodeView(node: leading)
|
|
29
|
+
.padding(.leading, 6)
|
|
30
|
+
.padding(.top, 4)
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
DynamicIslandExpandedRegion(.trailing) {
|
|
34
|
+
if let trailing = island?.expanded?.trailing ?? island?.compactTrailing {
|
|
35
|
+
DynamicNodeView(node: trailing)
|
|
36
|
+
.padding(.trailing, 6)
|
|
37
|
+
.padding(.top, 4)
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
DynamicIslandExpandedRegion(.bottom) {
|
|
41
|
+
if let bottom = island?.expanded?.bottom ?? payload?.lockScreen {
|
|
42
|
+
DynamicNodeView(node: bottom)
|
|
43
|
+
.padding(.horizontal, 8)
|
|
44
|
+
.padding(.bottom, 6)
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
DynamicIslandExpandedRegion(.center) {
|
|
48
|
+
if let center = island?.expanded?.center {
|
|
49
|
+
DynamicNodeView(node: center)
|
|
50
|
+
.padding(.top, 4)
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
} compactLeading: {
|
|
54
|
+
if let leading = island?.compactLeading {
|
|
55
|
+
DynamicNodeView(node: leading)
|
|
56
|
+
.fixedSize(horizontal: true, vertical: false)
|
|
57
|
+
.padding(.leading, 2)
|
|
58
|
+
}
|
|
59
|
+
} compactTrailing: {
|
|
60
|
+
if let trailing = island?.compactTrailing {
|
|
61
|
+
DynamicNodeView(node: trailing)
|
|
62
|
+
.fixedSize(horizontal: true, vertical: false)
|
|
63
|
+
.padding(.trailing, 2)
|
|
64
|
+
}
|
|
65
|
+
} minimal: {
|
|
66
|
+
if let minimal = island?.minimal ?? island?.compactLeading {
|
|
67
|
+
DynamicNodeView(node: minimal)
|
|
68
|
+
.fixedSize(horizontal: true, vertical: false)
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
private func parsePayload(json: String) -> DynamicPayloadDTO? {
|
|
75
|
+
guard let data = json.data(using: .utf8) else { return nil }
|
|
76
|
+
return try? JSONDecoder().decode(DynamicPayloadDTO.self, from: data)
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
|
package/lib/builder.d.ts
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { BadgeNode, ButtonNode, ChartNode, ContainerProps, CustomNode, DividerNode, EqualizerNode, EqualizerProps, GaugeNode, GridNode, GridProps, HStackNode, ImageNode, LayoutNode, LinkNode, LinkProps, ProgressNode, SpacerNode, StyleProp, TextNode, TextStyle, TimerNode, ToggleNode, VStackNode, ZStackNode, ZStackProps } from './types';
|
|
2
|
+
export declare function flattenStyle<T extends object>(...styles: StyleProp<T>[]): T | undefined;
|
|
3
|
+
export type AnyWidgetStyle = TextStyle | ContainerProps | Record<string, any>;
|
|
4
|
+
export type NamedStyles<T> = {
|
|
5
|
+
[P in keyof T]: AnyWidgetStyle;
|
|
6
|
+
};
|
|
7
|
+
export declare const StyleSheet: {
|
|
8
|
+
create: <T extends NamedStyles<T> | NamedStyles<any>>(styles: T & NamedStyles<any>) => T;
|
|
9
|
+
flatten: typeof flattenStyle;
|
|
10
|
+
};
|
|
11
|
+
/**
|
|
12
|
+
* Các hàm helper tạo node cây giao diện trực quan cho TypeScript/JavaScript
|
|
13
|
+
*/
|
|
14
|
+
export declare const UI: {
|
|
15
|
+
StyleSheet: {
|
|
16
|
+
create: <T extends NamedStyles<T> | NamedStyles<any>>(styles: T & NamedStyles<any>) => T;
|
|
17
|
+
flatten: typeof flattenStyle;
|
|
18
|
+
};
|
|
19
|
+
VStack: (propsOrChildren?: StyleProp<ContainerProps> | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => VStackNode;
|
|
20
|
+
HStack: (propsOrChildren?: StyleProp<ContainerProps> | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => HStackNode;
|
|
21
|
+
Text: (text: string, ...styles: StyleProp<TextStyle>[]) => TextNode;
|
|
22
|
+
Timer: (targetTimestamp: number, options?: {
|
|
23
|
+
mode?: "countdown" | "countup";
|
|
24
|
+
color?: string;
|
|
25
|
+
fontSize?: number;
|
|
26
|
+
fontWeight?: "regular" | "medium" | "semibold" | "bold";
|
|
27
|
+
prefix?: string;
|
|
28
|
+
suffix?: string;
|
|
29
|
+
}) => TimerNode;
|
|
30
|
+
Progress: (valueOrOptions: number | ProgressNode["props"], options?: Omit<ProgressNode["props"], "value">) => ProgressNode;
|
|
31
|
+
Image: (urlOrOptions: string | ImageNode["props"], options?: Omit<ImageNode["props"], "url">) => ImageNode;
|
|
32
|
+
Spacer: (minLength?: number) => SpacerNode;
|
|
33
|
+
Button: (titleOrProps: string | ButtonNode["props"], options?: Omit<ButtonNode["props"], "title">) => ButtonNode;
|
|
34
|
+
/**
|
|
35
|
+
* Tạo nút bấm kèm logic hàm TypeScript trực tiếp.
|
|
36
|
+
* Thư viện tự động sinh ActionId và kết nối bộ lắng nghe Native -> hàm async TypeScript của bạn!
|
|
37
|
+
*/
|
|
38
|
+
ActionButton: (title: string, onPress: (payload?: any) => Promise<any> | any, options?: Omit<ButtonNode["props"], "title" | "actionId" | "onPress">) => ButtonNode;
|
|
39
|
+
ZStack: (propsOrChildren?: ZStackProps | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => ZStackNode;
|
|
40
|
+
Grid: (propsOrChildren?: GridProps | LayoutNode | LayoutNode[], ...children: LayoutNode[]) => GridNode;
|
|
41
|
+
Divider: (options?: DividerNode["props"]) => DividerNode;
|
|
42
|
+
Gauge: (valueOrOptions: number | GaugeNode["props"], options?: Omit<GaugeNode["props"], "value">) => GaugeNode;
|
|
43
|
+
Chart: (valuesOrOptions: number[] | ChartNode["props"], options?: Omit<ChartNode["props"], "values">) => ChartNode;
|
|
44
|
+
Toggle: (labelOrOptions: string | ToggleNode["props"], options?: Omit<ToggleNode["props"], "label">) => ToggleNode;
|
|
45
|
+
Badge: (textOrOptions: string | BadgeNode["props"], options?: Omit<BadgeNode["props"], "text">) => BadgeNode;
|
|
46
|
+
Link: (props: LinkProps, ...children: LayoutNode[]) => LinkNode;
|
|
47
|
+
/**
|
|
48
|
+
* Khởi tạo một Component Native tùy chỉnh đã được đăng ký qua:
|
|
49
|
+
* - iOS (Swift): `DynamicNodeRegistry.shared.register("MyComponent") { node in ... }`
|
|
50
|
+
* - Android (Kotlin): `DynamicNodeRegistry.register("MyComponent", ...)`
|
|
51
|
+
*/
|
|
52
|
+
Custom: (componentName: string, props?: Record<string, any>, ...children: LayoutNode[]) => CustomNode;
|
|
53
|
+
/**
|
|
54
|
+
* Component sóng nhạc chuyển động (Equalizer / Sound Visualizer):
|
|
55
|
+
* Tự động chạy animation nhịp sóng nhạc mượt mà trên Dynamic Island và Lock Screen (iOS)
|
|
56
|
+
* và hiển thị trực quan trên Android.
|
|
57
|
+
*/
|
|
58
|
+
Equalizer: (options?: EqualizerProps) => EqualizerNode;
|
|
59
|
+
};
|
|
60
|
+
//# sourceMappingURL=builder.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
|