feat: add buildNumber change detection and getBuiltinBundleVersion API (#38)

* feat: add buildNumber change detection, getBuiltinBundleVersion API, and bump to 1.1.40

- Detect native buildNumber changes and clear hot-update bundle data to fall back to builtin bundle
- Add getNativeBuildNumber() and getBuiltinBundleVersion() TS interfaces with iOS/Android implementations
- Clear both nativeVersion and nativeBuildNumber prefs on version or buildNumber change
- Extract clearNativeVersionPrefs helper to avoid hardcoded strings
- Add BUNDLE_VERSION env var injection in example app (Android meta-data + iOS Info.plist)
- Add example buttons for new APIs in BundleUpdateTestPage

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* 1.1.40

* fix(ios): guard against empty stored buildNumber to match Android behavior

* chore: bump all @onekeyfe native packages to 1.1.41

* fix(android): use get().toString() for numeric meta-data in getBuiltinBundleVersion

* docs: update CHANGELOG for 1.1.41

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: huhuanming

CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.41] - 2026-03-17
+
+### Features
+- **bundle-update**: Add buildNumber change detection in `getJsBundlePath()` — clears hot-update bundle data and falls back to builtin JS bundle when native buildNumber changes
+- **bundle-update**: Add `getNativeBuildNumber()` and `getBuiltinBundleVersion()` APIs on both iOS and Android
+
+### Bug Fixes
+- **bundle-update (iOS)**: Guard against empty stored buildNumber to match Android behavior in build number change detection
+- **bundle-update (Android)**: Use `get().toString()` instead of `getString()` in `getBuiltinBundleVersion()` to handle numeric meta-data values that AAPT2 stores as Integer
+
+### Chores
+- Bump all native modules and views to 1.1.41
+
 ## [1.1.39] - 2026-03-17
 
 ### Features

example/react-native/android/app/build.gradle

@@ -88,6 +88,7 @@ android {
         targetSdkVersion rootProject.ext.targetSdkVersion
         versionCode 1
         versionName "1.0"
+        manifestPlaceholders += [BUNDLE_VERSION: System.getenv('BUNDLE_VERSION') ?: '1']
     }
     signingConfigs {
         debug {

example/react-native/android/app/src/main/AndroidManifest.xml

@@ -11,6 +11,9 @@
       android:theme="@style/AppTheme"
       android:usesCleartextTraffic="${usesCleartextTraffic}"
       android:supportsRtl="true">
+      <meta-data
+        android:name="BUNDLE_VERSION"
+        android:value="${BUNDLE_VERSION}" />
       <activity
         android:name=".MainActivity"
         android:label="@string/app_name"

example/react-native/ios/Podfile.lock

@@ -2839,7 +2839,7 @@ PODS:
     - ReactNativeNativeLogger
     - SocketRocket
     - Yoga
-  - ReactNativeBundleUpdate (1.1.39):
+  - ReactNativeBundleUpdate (1.1.40):
     - boost
     - DoubleConversion
     - fast_float
@@ -3609,7 +3609,7 @@ SPEC CHECKSUMS:
   ReactCodegen: 554b421c45b7df35ac791da1b734335470b55fcc
   ReactCommon: 424cc34cf5055d69a3dcf02f3436481afb8b0f6f
   ReactNativeAppUpdate: 07053378aecfdaaa23877f75c9c067fef7d58415
-  ReactNativeBundleUpdate: 752f40fd03fa3a6701318ab83de69f420d550053
+  ReactNativeBundleUpdate: 6b4bccc4975bd20ad6b2dfbca1f21da62d2b2e8d
   ReactNativeCheckBiometricAuthChanged: 3fbd6bdc758ccc059ad2feaf3214b871c0ccf31e
   ReactNativeDeviceUtils: cb1fa6e62e1ab4743fd9654f0124b23637ba62c5
   ReactNativeGetRandomValues: 7b24b5b17f6a676724bb673d76a8f9b0871aa4c7

example/react-native/ios/example/Info.plist

@@ -24,6 +24,8 @@
 	<string>????</string>
 	<key>CFBundleVersion</key>
 	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>BUNDLE_VERSION</key>
+	<string>$(BUNDLE_VERSION)</string>
 	<key>LSRequiresIPhoneOS</key>
 	<true/>
 	<key>NSAppTransportSecurity</key>

example/react-native/pages/BundleUpdateTestPage.tsx

@@ -497,6 +497,22 @@ H3bEFZ8=
       setUtilError(err instanceof Error ? err.message : 'Unknown error');
     }
   };
+  const utilGetNativeBuildNumber = async () => {
+    clearUtil();
+    try {
+      setUtilResult({ nativeBuildNumber: await ReactNativeBundleUpdate.getNativeBuildNumber() });
+    } catch (err) {
+      setUtilError(err instanceof Error ? err.message : 'Unknown error');
+    }
+  };
+  const utilGetBuiltinBundleVersion = async () => {
+    clearUtil();
+    try {
+      setUtilResult({ builtinBundleVersion: await ReactNativeBundleUpdate.getBuiltinBundleVersion() });
+    } catch (err) {
+      setUtilError(err instanceof Error ? err.message : 'Unknown error');
+    }
+  };
   const utilGetFallbackData = async () => {
     clearUtil();
     try {
@@ -691,6 +707,8 @@ H3bEFZ8=
           <TestButton title="Get Web Embed Path" onPress={utilGetWebEmbedPath} />
           <TestButton title="Get JS Bundle Path" onPress={utilGetJsBundlePath} />
           <TestButton title="Get Native App Version" onPress={utilGetNativeAppVersion} />
+          <TestButton title="Get Native Build Number" onPress={utilGetNativeBuildNumber} />
+          <TestButton title="Get Builtin Bundle Version" onPress={utilGetBuiltinBundleVersion} />
           <TestButton title="Get Fallback Bundle Data" onPress={utilGetFallbackData} />
           <TestButton title="List Local Bundles" onPress={utilListLocal} />
           <TestButton title="List ASC Files" onPress={utilListAscFiles} />

native-modules/native-logger/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-native-logger",
-  "version": "1.1.39",
+  "version": "1.1.41",
   "description": "react-native-native-logger",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

native-modules/react-native-app-update/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-app-update",
-  "version": "1.1.39",
+  "version": "1.1.41",
   "description": "react-native-app-update",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

native-modules/react-native-background-thread/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-background-thread",
-  "version": "1.1.39",
+  "version": "1.1.41",
   "description": "react-native-background-thread",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

native-modules/react-native-bundle-update/android/src/main/java/com/margelo/nitro/reactnativebundleupdate/ReactNativeBundleUpdate.kt

@@ -95,7 +95,7 @@ P2Q5dClenjjjVA==
 object BundleUpdateStoreAndroid {
     private val bcProvider = BouncyCastleProvider()
     private const val PREFS_NAME = "BundleUpdatePrefs"
-    private const val NATIVE_VERSION_PREFS_NAME = "NativeVersionPrefs"
+    internal const val NATIVE_VERSION_PREFS_NAME = "NativeVersionPrefs"
     private const val CURRENT_BUNDLE_VERSION_KEY = "currentBundleVersion"
 
     fun getDownloadBundleDir(context: Context): String {
@@ -207,6 +207,47 @@ object BundleUpdateStoreAndroid {
         prefs.edit().putString("nativeVersion", nativeVersion).apply()
     }
 
+    fun getBuildNumber(context: Context): String {
+        return try {
+            val pm = context.packageManager
+            val pi = pm.getPackageInfo(context.packageName, 0)
+            if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.P) {
+                pi.longVersionCode.toString()
+            } else {
+                @Suppress("DEPRECATION")
+                pi.versionCode.toString()
+            }
+        } catch (e: Exception) {
+            OneKeyLog.error("BundleUpdate", "Error getting build number: ${e.message}")
+            ""
+        }
+    }
+
+    fun getNativeBuildNumber(context: Context): String {
+        val prefs = context.getSharedPreferences(NATIVE_VERSION_PREFS_NAME, Context.MODE_PRIVATE)
+        return prefs.getString("nativeBuildNumber", "") ?: ""
+    }
+
+    fun setNativeBuildNumber(context: Context, buildNumber: String) {
+        val prefs = context.getSharedPreferences(NATIVE_VERSION_PREFS_NAME, Context.MODE_PRIVATE)
+        prefs.edit().putString("nativeBuildNumber", buildNumber).apply()
+    }
+
+    fun clearNativeVersionPrefs(context: Context) {
+        val prefs = context.getSharedPreferences(NATIVE_VERSION_PREFS_NAME, Context.MODE_PRIVATE)
+        prefs.edit().remove("nativeVersion").remove("nativeBuildNumber").apply()
+    }
+
+    fun getBuiltinBundleVersion(context: Context): String {
+        return try {
+            val appInfo = context.packageManager.getApplicationInfo(context.packageName, android.content.pm.PackageManager.GET_META_DATA)
+            appInfo.metaData?.get("BUNDLE_VERSION")?.toString() ?: ""
+        } catch (e: Exception) {
+            OneKeyLog.error("BundleUpdate", "Error getting builtin bundle version: ${e.message}")
+            ""
+        }
+    }
+
     fun calculateSHA256(filePath: String): String? {
         return try {
             val digest = MessageDigest.getInstance("SHA-256")
@@ -513,6 +554,16 @@ object BundleUpdateStoreAndroid {
             if (currentAppVersion != prevNativeVersion) {
                 OneKeyLog.info("BundleUpdate", "currentAppVersion is not equal to prevNativeVersion $currentAppVersion $prevNativeVersion")
                 clearUpdateBundleData(context)
+                clearNativeVersionPrefs(context)
+                return null
+            }
+
+            val currentBuildNumber = getBuildNumber(context)
+            val prevBuildNumber = getNativeBuildNumber(context)
+            if (currentBuildNumber.isNotEmpty() && prevBuildNumber.isNotEmpty() && currentBuildNumber != prevBuildNumber) {
+                OneKeyLog.info("BundleUpdate", "buildNumber changed from $prevBuildNumber to $currentBuildNumber, clearing bundle data")
+                clearUpdateBundleData(context)
+                clearNativeVersionPrefs(context)
                 return null
             }
 
@@ -1008,6 +1059,8 @@ class ReactNativeBundleUpdate : HybridReactNativeBundleUpdateSpec() {
             BundleUpdateStoreAndroid.setCurrentBundleVersionAndSignature(context, folderName, signature)
             val nativeVersion = BundleUpdateStoreAndroid.getAppVersion(context) ?: ""
             BundleUpdateStoreAndroid.setNativeVersion(context, nativeVersion)
+            val buildNumber = BundleUpdateStoreAndroid.getBuildNumber(context)
+            BundleUpdateStoreAndroid.setNativeBuildNumber(context, buildNumber)
 
             // Manage fallback data
             try {
@@ -1097,6 +1150,7 @@ class ReactNativeBundleUpdate : HybridReactNativeBundleUpdateSpec() {
                 OneKeyLog.info("BundleUpdate", "clearAllJSBundleData: deleted bundle dir")
             }
             BundleUpdateStoreAndroid.clearUpdateBundleData(context)
+            BundleUpdateStoreAndroid.clearNativeVersionPrefs(context)
 
             OneKeyLog.info("BundleUpdate", "clearAllJSBundleData: completed successfully")
             TestResult(success = true, message = "Successfully cleared all JS bundle data")
@@ -1197,6 +1251,24 @@ class ReactNativeBundleUpdate : HybridReactNativeBundleUpdateSpec() {
         }
     }
 
+    override fun getNativeBuildNumber(): Promise<String> {
+        return Promise.async {
+            val context = getContext()
+            val buildNumber = BundleUpdateStoreAndroid.getBuildNumber(context)
+            OneKeyLog.info("BundleUpdate", "getNativeBuildNumber: $buildNumber")
+            buildNumber
+        }
+    }
+
+    override fun getBuiltinBundleVersion(): Promise<String> {
+        return Promise.async {
+            val context = getContext()
+            val version = BundleUpdateStoreAndroid.getBuiltinBundleVersion(context)
+            OneKeyLog.info("BundleUpdate", "getBuiltinBundleVersion: $version")
+            version
+        }
+    }
+
     override fun testVerification(): Promise<Boolean> {
         return Promise.async {
             val testSignature = """-----BEGIN PGP SIGNED MESSAGE-----