feat(device-utils): iOS cold-start local notification deep-link support (OK-55681) (#61)

huhuanming · web-flow · commit 101bf751ce6d · 2026-06-12T10:06:42.000+08:00
* feat(device-utils): add getAndClearColdStartLocalNotification for iOS cold-start deep-link (OK-55681)

LaunchOptionsStore gains an in-memory coldStartLocalNotification slot
(JSON userInfo of a tapped LOCAL notification) plus a read-once
takeColdStartLocalNotification(). The new Nitro method
getAndClearColdStartLocalNotification() returns it and clears it; the host
AppDelegate writes the slot via KVC on a killed-app notification tap.

In-memory only (no NSUserDefaults): a new process = fresh nil, so it is
launch-scoped and cannot replay a stale tap. Android returns "" (taps
arrive via Intent extras there). Run yarn nitrogen + yarn prepare before
publishing 3.0.54.

* chore: bump version to 3.0.55

* feat(chart-webview): warm-driver + offline chart instrumentation

- iOS/Android: warm-boot the shared offline page + route page-&gt;native
  callbacks to owner ?? warmDriver so bars-state/load-end aren't dropped
  while the host that owns the WebView is the offscreen prewarm
- source/bridge setters apply synchronously (drop scheduleReconcile, which
  caused an infinite reconcile loop on Android)
- add ChartWV diagnostics via OneKeyLog (depend on ReactNativeNativeLogger)
- fix Android compileReleaseKotlin: dispose() needs override

* feat(chart-webview): Android pause-when-idle + debug toggle + attach retries

- Android: pause the pooled WebView's renderer (onPause) when no host owns it and
  resume on claim — Android (unlike iOS WKWebView) never throttles an offscreen
  WebView, so the warm page burned a CPU core + grew RAM to OOM after leaving the
  chart. Per-instance onPause (NOT process-global pauseTimers).
- attachToContainer: retry reparent up to 12 frames instead of giving up after 1
  (a single retry stranded the WebView in the old container -&gt; blank chart slot)
- webviewDebuggingEnabled Nitro prop (iOS isInspectable / Android
  setWebContentsDebuggingEnabled) following the dev-mode toggle (Agent B)

* fix(chart-webview): parent-checked forceDetach on pooled dispose (Android re-entry white-screen/stuck-loading)

Pooled WebView re-parented across hosts left a stale parent on dispose, so
re-entering a chart showed a white screen / infinite loading (issues 1 &amp; 2).
- forceDetach(): endViewTransition + removeView, fallback removeViewInLayout +
  requestLayout, so the parent is cleared synchronously even on a dead container.
- detachFrom(): parent-checked, used by ChartWebview.dispose() for pooled hosts.
- attachToContainer(): uses forceDetach, retries via container.post.

Retains ChartDBG diagnostic counters (warmDriver/owner setters, throttled
per-3s msgIn/native-&gt;page RATE, pauseIfIdle SKIP/PAUSE/RESUME) for ongoing
on-device verification; to be removed before merge.

* chore(chart-webview): drop debug instrumentation, keep necessary native logs

Remove the ChartDBG diagnostic layer added for the Android root-cause work:
- DBG tag, owner/warmDriver transition logs, dbgId getter
- throttled msgIn/native-&gt;page rate counters + rateLogger handler
- pauseIfIdle SKIP verbose log

Keep only operational logs under the ChartWebviewPool tag: WebView
CREATED/DESTROYED (singleton verification), renderer PAUSE/RESUME, and the
attach-failed-after-retries warning. Logging-only change; behavior unchanged.

* chore: bump version to 3.0.56
diff --git a/native-modules/native-logger/package.json b/native-modules/native-logger/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-native-logger",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-native-logger",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-aes-crypto/package.json b/native-modules/react-native-aes-crypto/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-aes-crypto",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-aes-crypto",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-app-update/package.json b/native-modules/react-native-app-update/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-app-update",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-app-update",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-async-storage/package.json b/native-modules/react-native-async-storage/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-async-storage",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-async-storage",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-background-thread/package.json b/native-modules/react-native-background-thread/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-background-thread",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-background-thread",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-bundle-crypto/package.json b/native-modules/react-native-bundle-crypto/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-bundle-crypto",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-bundle-crypto",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-bundle-update/package.json b/native-modules/react-native-bundle-update/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-bundle-update",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-bundle-update",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-check-biometric-auth-changed/package.json b/native-modules/react-native-check-biometric-auth-changed/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-check-biometric-auth-changed",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-check-biometric-auth-changed",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-cloud-fs/package.json b/native-modules/react-native-cloud-fs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-cloud-fs",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-cloud-fs TurboModule for OneKey",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-cloud-kit-module/package.json b/native-modules/react-native-cloud-kit-module/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-cloud-kit-module",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-cloud-kit-module",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-device-utils/android/src/main/java/com/margelo/nitro/reactnativedeviceutils/ReactNativeDeviceUtils.kt b/native-modules/react-native-device-utils/android/src/main/java/com/margelo/nitro/reactnativedeviceutils/ReactNativeDeviceUtils.kt
@@ -907,6 +907,13 @@ class ReactNativeDeviceUtils : HybridReactNativeDeviceUtilsSpec(), LifecycleEven
         }
     }
 
+    // iOS-only: cold-start LOCAL notification deep-link payload. Android delivers
+    // notification taps through the launching Intent's extras, a separate path,
+    // so there is nothing to hand back here.
+    override fun getAndClearColdStartLocalNotification(): Promise<String> {
+        return Promise.resolved("")
+    }
+
     // MARK: - ExitModule
 
     override fun exitApp() {
diff --git a/native-modules/react-native-device-utils/ios/ReactNativeDeviceUtils.swift b/native-modules/react-native-device-utils/ios/ReactNativeDeviceUtils.swift
@@ -21,8 +21,26 @@ public class LaunchOptionsStore: NSObject {
     public var deviceToken: Data?
     public var startupTime: TimeInterval = 0
 
+    // Cold-start deep-link: the JSON `userInfo` of a LOCAL notification the user
+    // tapped to launch the (killed) app. The legacy `NotificationCenter` broadcast
+    // in AppDelegate is fire-and-forget and is lost on cold start because JS has
+    // not registered a listener yet; this slot is a pull buffer JS drains once it
+    // boots. In-memory ONLY (no NSUserDefaults): a new process = fresh `nil`, so
+    // it is naturally launch-scoped and cannot replay a stale tap on a later
+    // unrelated cold start. AppDelegate writes it via KVC
+    // (`setValue(_:forKey:"coldStartLocalNotification")`), same bridge as the
+    // properties above.
+    public var coldStartLocalNotification: String?
+
     private static let deviceTokenKey = "1k_device_token"
 
+    // Read-once: hand the payload to JS exactly once per launch.
+    public func takeColdStartLocalNotification() -> String {
+        let value = coldStartLocalNotification ?? ""
+        coldStartLocalNotification = nil
+        return value
+    }
+
     public func getDeviceTokenString() -> String {
         // Prefer the JS-saved token (persisted across launches)
         if let saved = UserDefaults.standard.string(forKey: LaunchOptionsStore.deviceTokenKey), !saved.isEmpty {
@@ -189,6 +207,12 @@ class ReactNativeDeviceUtils: HybridReactNativeDeviceUtilsSpec {
         }
     }
 
+    func getAndClearColdStartLocalNotification() throws -> Promise<String> {
+        return Promise.async {
+            return LaunchOptionsStore.shared.takeColdStartLocalNotification()
+        }
+    }
+
     // MARK: - ExitModule
 
     func exitApp() throws {
diff --git a/native-modules/react-native-device-utils/package.json b/native-modules/react-native-device-utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-device-utils",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-device-utils",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-device-utils/src/ReactNativeDeviceUtils.nitro.ts b/native-modules/react-native-device-utils/src/ReactNativeDeviceUtils.nitro.ts
@@ -59,6 +59,10 @@ export interface ReactNativeDeviceUtils
   saveDeviceToken(token: string): Promise<void>;
   registerDeviceToken(): Promise<boolean>;
   getStartupTime(): Promise<number>;
+  // Returns the JSON userInfo of a LOCAL notification the user tapped to launch
+  // the (killed) app, then clears it so it is delivered exactly once. Empty
+  // string when there is none. iOS-only meaningful; Android returns "".
+  getAndClearColdStartLocalNotification(): Promise<string>;
 
   // ExitModule
   exitApp(): void;
diff --git a/native-modules/react-native-dns-lookup/package.json b/native-modules/react-native-dns-lookup/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-dns-lookup",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-dns-lookup",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-get-random-values/package.json b/native-modules/react-native-get-random-values/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-get-random-values",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-get-random-values",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-keychain-module/package.json b/native-modules/react-native-keychain-module/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-keychain-module",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-keychain-module",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-lite-card/package.json b/native-modules/react-native-lite-card/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-lite-card",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "lite card",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-network-info/package.json b/native-modules/react-native-network-info/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-network-info",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-network-info",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-pbkdf2/package.json b/native-modules/react-native-pbkdf2/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-pbkdf2",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-pbkdf2",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-perf-memory/package.json b/native-modules/react-native-perf-memory/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-perf-memory",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-perf-memory",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-perf-stats/package.json b/native-modules/react-native-perf-stats/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-perf-stats",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-perf-stats",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-ping/package.json b/native-modules/react-native-ping/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-ping",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-ping TurboModule for OneKey",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-range-downloader/package.json b/native-modules/react-native-range-downloader/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-range-downloader",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-range-downloader",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-splash-screen/package.json b/native-modules/react-native-splash-screen/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-splash-screen",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-splash-screen",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-split-bundle-loader/package.json b/native-modules/react-native-split-bundle-loader/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-split-bundle-loader",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-split-bundle-loader",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-tcp-socket/package.json b/native-modules/react-native-tcp-socket/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-tcp-socket",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-tcp-socket",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-modules/react-native-zip-archive/package.json b/native-modules/react-native-zip-archive/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-zip-archive",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "react-native-zip-archive Nitro HybridObject for OneKey",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-views/react-native-auto-size-input/package.json b/native-views/react-native-auto-size-input/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-auto-size-input",
-  "version": "3.0.54",
+  "version": "3.0.56",
   "description": "Auto-sizing text input with font scaling, prefix and suffix support",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
diff --git a/native-views/react-native-chart-webview/ChartWebview.podspec b/native-views/react-native-chart-webview/ChartWebview.podspec
@@ -21,6 +21,9 @@ Pod::Spec.new do |s|
 
   s.dependency 'React-jsi'
   s.dependency 'React-callinvoker'
+  # DEBUG instrumentation: route native chart lifecycle logs into the shared
+  # OneKeyLog file (app-latest.log) via `import ReactNativeNativeLogger`.
+  s.dependency 'ReactNativeNativeLogger'
 
   load 'nitrogen/generated/ios/ChartWebview+autolinking.rb'
   add_nitrogen_files(s)
diff --git a/native-views/react-native-chart-webview/android/src/main/java/com/margelo/nitro/chartwebview/ChartWebview.kt b/native-views/react-native-chart-webview/android/src/main/java/com/margelo/nitro/chartwebview/ChartWebview.kt
diff --git a/native-views/react-native-chart-webview/android/src/main/java/com/margelo/nitro/chartwebview/PooledChartWebView.kt b/native-views/react-native-chart-webview/android/src/main/java/com/margelo/nitro/chartwebview/PooledChartWebView.kt
diff --git a/native-views/react-native-chart-webview/ios/ChartWebview.swift b/native-views/react-native-chart-webview/ios/ChartWebview.swift
diff --git a/native-views/react-native-chart-webview/package.json b/native-views/react-native-chart-webview/package.json
diff --git a/native-views/react-native-chart-webview/src/ChartWebview.nitro.ts b/native-views/react-native-chart-webview/src/ChartWebview.nitro.ts
diff --git a/native-views/react-native-pager-view/package.json b/native-views/react-native-pager-view/package.json
diff --git a/native-views/react-native-perp-depth-bar/package.json b/native-views/react-native-perp-depth-bar/package.json
diff --git a/native-views/react-native-scroll-guard/package.json b/native-views/react-native-scroll-guard/package.json
diff --git a/native-views/react-native-segment-slider/package.json b/native-views/react-native-segment-slider/package.json
diff --git a/native-views/react-native-skeleton/package.json b/native-views/react-native-skeleton/package.json
diff --git a/native-views/react-native-tab-view/package.json b/native-views/react-native-tab-view/package.json

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@onekeyfe/react-native-native-logger",`
`3`		`- "version": "3.0.54",`
	`3`	`+ "version": "3.0.56",`
`4`	`4`	`"description": "react-native-native-logger",`
`5`	`5`	`"main": "./lib/module/index.js",`
`6`	`6`	`"types": "./lib/typescript/src/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@onekeyfe/react-native-aes-crypto",`
`3`		`- "version": "3.0.54",`
	`3`	`+ "version": "3.0.56",`
`4`	`4`	`"description": "react-native-aes-crypto",`
`5`	`5`	`"main": "./lib/module/index.js",`
`6`	`6`	`"types": "./lib/typescript/src/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@onekeyfe/react-native-app-update",`
`3`		`- "version": "3.0.54",`
	`3`	`+ "version": "3.0.56",`
`4`	`4`	`"description": "react-native-app-update",`
`5`	`5`	`"main": "./lib/module/index.js",`
`6`	`6`	`"types": "./lib/typescript/src/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@onekeyfe/react-native-async-storage",`
`3`		`- "version": "3.0.54",`
	`3`	`+ "version": "3.0.56",`
`4`	`4`	`"description": "react-native-async-storage",`
`5`	`5`	`"main": "./lib/module/index.js",`
`6`	`6`	`"types": "./lib/typescript/src/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@onekeyfe/react-native-background-thread",`
`3`		`- "version": "3.0.54",`
	`3`	`+ "version": "3.0.56",`
`4`	`4`	`"description": "react-native-background-thread",`
`5`	`5`	`"main": "./lib/module/index.js",`
`6`	`6`	`"types": "./lib/typescript/src/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@onekeyfe/react-native-bundle-crypto",`
`3`		`- "version": "3.0.54",`
	`3`	`+ "version": "3.0.56",`
`4`	`4`	`"description": "react-native-bundle-crypto",`
`5`	`5`	`"main": "./lib/module/index.js",`
`6`	`6`	`"types": "./lib/typescript/src/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@onekeyfe/react-native-check-biometric-auth-changed",`
`3`		`- "version": "3.0.54",`
	`3`	`+ "version": "3.0.56",`
`4`	`4`	`"description": "react-native-check-biometric-auth-changed",`
`5`	`5`	`"main": "./lib/module/index.js",`
`6`	`6`	`"types": "./lib/typescript/src/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@onekeyfe/react-native-cloud-fs",`
`3`		`- "version": "3.0.54",`
	`3`	`+ "version": "3.0.56",`
`4`	`4`	`"description": "react-native-cloud-fs TurboModule for OneKey",`
`5`	`5`	`"main": "./lib/module/index.js",`
`6`	`6`	`"types": "./lib/typescript/src/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@onekeyfe/react-native-cloud-kit-module",`
`3`		`- "version": "3.0.54",`
	`3`	`+ "version": "3.0.56",`
`4`	`4`	`"description": "react-native-cloud-kit-module",`
`5`	`5`	`"main": "./lib/module/index.js",`
`6`	`6`	`"types": "./lib/typescript/src/index.d.ts",`