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>

Author: huhuanming

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/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?.getString("BUNDLE_VERSION") ?: ""
+        } 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-----

native-modules/react-native-bundle-update/ios/ReactNativeBundleUpdate.swift

@@ -67,6 +67,7 @@ P2Q5dClenjjjVA==
 public class BundleUpdateStore: NSObject {
     private static let bundlePrefsKey = "currentBundleVersion"
     private static let nativeVersionKey = "nativeVersion"
+    private static let nativeBuildNumberKey = "nativeBuildNumber"
 
     public static func documentDirectory() -> String {
         NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true)[0]
@@ -178,6 +179,29 @@ public class BundleUpdateStore: NSObject {
         UserDefaults.standard.synchronize()
     }
 
+    public static func getCurrentNativeBuildNumber() -> String {
+        Bundle.main.infoDictionary?["CFBundleVersion"] as? String ?? ""
+    }
+
+    public static func getNativeBuildNumber() -> String? {
+        UserDefaults.standard.string(forKey: nativeBuildNumberKey)
+    }
+
+    public static func setNativeBuildNumber(_ buildNumber: String) {
+        UserDefaults.standard.set(buildNumber, forKey: nativeBuildNumberKey)
+        UserDefaults.standard.synchronize()
+    }
+
+    public static func clearNativeVersionPrefs() {
+        let ud = UserDefaults.standard
+        ud.removeObject(forKey: nativeVersionKey)
+        ud.removeObject(forKey: nativeBuildNumberKey)
+    }
+
+    public static func getBuiltinBundleVersion() -> String {
+        Bundle.main.infoDictionary?["BUNDLE_VERSION"] as? String ?? ""
+    }
+
     public static func getMetadataFilePath(_ currentBundleVersion: String) -> String? {
         let path = (bundleDir() as NSString)
             .appendingPathComponent(currentBundleVersion)
@@ -402,6 +426,21 @@ public class BundleUpdateStore: NSObject {
                 deleteSignatureFile(cbv)
                 ud.removeObject(forKey: "currentBundleVersion")
             }
+            clearNativeVersionPrefs()
+            ud.synchronize()
+            return nil
+        }
+
+        let currentBuildNumber = getCurrentNativeBuildNumber()
+        let prevBuildNumber = getNativeBuildNumber()
+        if !currentBuildNumber.isEmpty && prevBuildNumber != nil && currentBuildNumber != prevBuildNumber {
+            OneKeyLog.info("BundleUpdate", "buildNumber changed from \(prevBuildNumber ?? "") to \(currentBuildNumber), clearing bundle data")
+            let ud = UserDefaults.standard
+            if let cbv = ud.string(forKey: "currentBundleVersion") {
+                deleteSignatureFile(cbv)
+                ud.removeObject(forKey: "currentBundleVersion")
+            }
+            clearNativeVersionPrefs()
             ud.synchronize()
             return nil
         }
@@ -972,6 +1011,8 @@ class ReactNativeBundleUpdate: HybridReactNativeBundleUpdateSpec {
             }
             let currentNativeVersion = BundleUpdateStore.getCurrentNativeVersion()
             BundleUpdateStore.setNativeVersion(currentNativeVersion)
+            let currentBuildNumber = BundleUpdateStore.getCurrentNativeBuildNumber()
+            BundleUpdateStore.setNativeBuildNumber(currentBuildNumber)
             ud.synchronize()
 
             // Manage fallback data
@@ -1059,7 +1100,7 @@ class ReactNativeBundleUpdate: HybridReactNativeBundleUpdateSpec {
                 ud.removeObject(forKey: "currentBundleVersion")
                 OneKeyLog.info("BundleUpdate", "clearAllJSBundleData: removed currentBundleVersion=\(cbv)")
             }
-            ud.removeObject(forKey: "nativeVersion")
+            BundleUpdateStore.clearNativeVersionPrefs()
             ud.synchronize()
 
             OneKeyLog.info("BundleUpdate", "clearAllJSBundleData: completed successfully")
@@ -1157,6 +1198,22 @@ class ReactNativeBundleUpdate: HybridReactNativeBundleUpdateSpec {
         }
     }
 
+    func getNativeBuildNumber() throws -> Promise<String> {
+        return Promise.async {
+            let buildNumber = BundleUpdateStore.getCurrentNativeBuildNumber()
+            OneKeyLog.info("BundleUpdate", "getNativeBuildNumber: \(buildNumber)")
+            return buildNumber
+        }
+    }
+
+    func getBuiltinBundleVersion() throws -> Promise<String> {
+        return Promise.async {
+            let version = BundleUpdateStore.getBuiltinBundleVersion()
+            OneKeyLog.info("BundleUpdate", "getBuiltinBundleVersion: \(version)")
+            return version
+        }
+    }
+
     func testVerification() throws -> Promise<Bool> {
         return Promise.async {
             let testSignature = """

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

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

native-modules/react-native-bundle-update/src/ReactNativeBundleUpdate.nitro.ts

@@ -109,6 +109,8 @@ export interface ReactNativeBundleUpdate
   getJsBundlePath(): string;
   getJsBundlePathAsync(): Promise<string>;
   getNativeAppVersion(): Promise<string>;
+  getNativeBuildNumber(): Promise<string>;
+  getBuiltinBundleVersion(): Promise<string>;
 
   // Verification & testing
   testVerification(): Promise<boolean>;