@revopush/react-native-code-push 2.5.1 → 2.5.2

package/android/src/main/java/com/microsoft/codepush/react/CodePushUpdateManager.java

@@ -43,6 +43,10 @@ public class CodePushUpdateManager {
         return appendPathComponent(getCodePushPath(), CodePushConstants.UNZIPPED_FOLDER_NAME);
     }
 
+    private BaseBundleStore getBaseBundleStore() {
+        return new BaseBundleStore(appendPathComponent(getCodePushPath(), CodePushConstants.BASES_FOLDER_NAME));
+    }
+
     private String getDocumentsDirectory() {
         return mDocumentsDirectory;
     }
@@ -94,22 +98,22 @@ public class CodePushUpdateManager {
     }
 
     public String getCurrentPackageBundlePath(String bundleFileName) {
-        String packageFolder = getCurrentPackageFolderPath();
-        if (packageFolder == null) {
+        return getPackageBundlePath(getCurrentPackageHash(), bundleFileName);
+    }
+
+    private String getPackageBundlePath(String packageHash, String bundleFileName) {
+        if (packageHash == null) {
             return null;
         }
 
-        JSONObject currentPackage = getCurrentPackage();
-        if (currentPackage == null) {
+        JSONObject packageMetadata = getPackage(packageHash);
+        if (packageMetadata == null) {
             return null;
         }
 
-        String relativeBundlePath = currentPackage.optString(CodePushConstants.RELATIVE_BUNDLE_PATH_KEY, null);
-        if (relativeBundlePath == null) {
-            return appendPathComponent(packageFolder, bundleFileName);
-        } else {
-            return appendPathComponent(packageFolder, relativeBundlePath);
-        }
+        String relativeBundlePath = packageMetadata.optString(CodePushConstants.RELATIVE_BUNDLE_PATH_KEY, null);
+        return appendPathComponent(getPackageFolderPath(packageHash),
+                relativeBundlePath != null ? relativeBundlePath : bundleFileName);
     }
 
     public String getPackageFolderPath(String packageHash) {
@@ -154,7 +158,47 @@ public class CodePushUpdateManager {
         }
     }
 
+    /** A base bundle on disk, and the package hash it is stored under. */
+    private static final class BaseBundle {
+        final File file;
+        final String packageHash;
+
+        BaseBundle(File file, String packageHash) {
+            this.file = file;
+            this.packageHash = packageHash;
+        }
+    }
+
+    /** The base named by basePackage: the saved copy, else that package's own bundle. */
+    private BaseBundle findBaseBundle(JSONObject updatePackage, String expectedBundleFileName) {
+        JSONObject basePackage = updatePackage.optJSONObject(CodePushConstants.BASE_PACKAGE_KEY);
+        if (basePackage == null) {
+            return null;
+        }
+        String packageHash = basePackage.optString(CODE_PUSH_PACKAGE_HASH, null);
+        if (packageHash == null || packageHash.isEmpty()) {
+            // Named a base with no hash: server and SDK disagree on the field name.
+            CodePushUtils.log("basePackage has no packageHash; patching against the binary.");
+            return null;
+        }
+        File bundle = getBaseBundleStore().lookup(packageHash);
+        if (bundle == null) {
+            String bundlePath = getPackageBundlePath(packageHash, expectedBundleFileName);
+            bundle = bundlePath == null ? null : new File(bundlePath);
+        }
+        if (bundle == null || !bundle.isFile()) {
+            CodePushUtils.log("Base " + packageHash + " not held; patching against the binary.");
+            return null;
+        }
+        return new BaseBundle(bundle, packageHash);
+    }
+
     public void downloadPackage(JSONObject updatePackage, String expectedBundleFileName, DownloadProgressCallback progressCallback, String stringPublicKey) throws IOException {
+        BaseBundle base = findBaseBundle(updatePackage, expectedBundleFileName);
+        if (base != null) {
+            getBaseBundleStore().save(base.file, base.packageHash);
+        }
+
         UpdatePackage updatePack = fromJson(updatePackage);
 
         String newUpdateFolderPath = getPackageFolderPath(updatePack.getNewUpdateHash());
@@ -164,7 +208,8 @@ public class CodePushUpdateManager {
                 expectedBundleFileName, // exp bundle filename
                 stringPublicKey, // pub key
                 updatePack.getNewUpdateHash(), // new update hash
-                getCurrentPackage() // current package
+                getCurrentPackage(), // current package
+                base == null ? null : base.file.getAbsolutePath() // base bundle
         );
 
 

package/android/src/main/java/com/microsoft/codepush/react/FileUtils.java

@@ -27,11 +27,13 @@ public class FileUtils {
     public static void deleteFileOrFolderSilently(File file) {
         if (file.isDirectory()) {
             File[] files = file.listFiles();
-            for (File fileEntry : files) {
-                if (fileEntry.isDirectory()) {
-                    deleteFileOrFolderSilently(fileEntry);
-                } else {
-                    fileEntry.delete();
+            if (files != null) {
+                for (File fileEntry : files) {
+                    if (fileEntry.isDirectory()) {
+                        deleteFileOrFolderSilently(fileEntry);
+                    } else {
+                        fileEntry.delete();
+                    }
                 }
             }
         }

package/docs/setup-android.md

@@ -18,7 +18,7 @@ In order to integrate CodePush into your Android project, please perform the fol
 
 2. Update the `MainApplication` file to use CodePush via the following changes:
 
-   For React Native 0.76 and above: update the `MainApplication.kt`
+   For React Native 0.76 - 0.82: update the `MainApplication.kt`
 
    **Important! : PackageList must be instantiated only one in application lifetime.**
 
@@ -45,6 +45,32 @@ In order to integrate CodePush into your Android project, please perform the fol
     }
     ```
 
+    For React Native 0.83 and above: update the `MainApplication.kt`
+
+    ```kotlin
+    ...
+    // 1. Import the plugin class.
+    import com.microsoft.codepush.react.CodePush
+
+    class MainApplication : Application(), ReactApplication {
+
+        override val reactHost: ReactHost by lazy {
+            getDefaultReactHost(
+            context = applicationContext,
+            packageList =
+                PackageList(this).packages.apply {
+                // Packages that cannot be autolinked yet can be added manually here, for example:
+                // add(MyReactNativePackage())
+                },
+            // 2. Override the jsBundleFilePath in order to let
+            // the CodePush runtime determine where to get the JS
+            // bundle location from on each app start
+            jsBundleFilePath = CodePush.getJSBundleFile(),
+            )
+        }
+    }
+    ```
+
 
 3. Add the Deployment key to `strings.xml`:
 

package/ios/CodePush/CodePush.h

@@ -136,6 +136,7 @@
                        error:(NSError **)error;
 
 + (NSString *)getPackageFolderPath:(NSString *)packageHash;
++ (NSString *)getCodePushPath;
 
 + (BOOL)installPackage:(NSDictionary *)updatePackage
    removePendingUpdate:(BOOL)removePendingUpdate
@@ -149,6 +150,19 @@
 
 @end
 
+/**
+ * Bundles kept as diff bases, named by the package hash of the release they came from.
+ * A base a package folder no longer holds is still findable here.
+ */
+@interface CodePushBaseBundleStore : NSObject
+
+/** Path of the retained bundle for this package hash, or nil if the store does not hold it. */
++ (NSString *)lookup:(NSString *)packageHash;
+
++ (BOOL)save:(NSString *)sourceBundlePath forPackageHash:(NSString *)packageHash;
+
+@end
+
 @interface CodePushTelemetryManager : NSObject
 
 + (NSDictionary *)getBinaryUpdateReport:(NSString *)appVersion;

package/ios/CodePush/CodePush.m

@@ -19,7 +19,7 @@
 
 #import "CodePush.h"
 
-@interface CodePush () <RCTBridgeModule, RCTFrameUpdateObserver>
+@interface CodePush () <RCTBridgeModule>
 @end
 
 @implementation CodePush {
@@ -32,8 +32,8 @@
 
     // Used to coordinate the dispatching of download progress events to JS.
     long long _latestExpectedContentLength;
-    long long _latestReceivedConentLength;
-    BOOL _didUpdateProgress;
+    long long _latestReceivedContentLength;
+    NSTimeInterval _lastProgressEmitTimestamp;
 
     BOOL _allowed;
     BOOL _restartInProgress;
@@ -263,18 +263,6 @@ static NSString *const LatestRollbackCountKey = @"count";
 #pragma mark - Private API methods
 
 @synthesize methodQueue = _methodQueue;
-@synthesize pauseCallback = _pauseCallback;
-@synthesize paused = _paused;
-
-- (void)setPaused:(BOOL)paused
-{
-    if (_paused != paused) {
-        _paused = paused;
-        if (_pauseCallback) {
-            _pauseCallback();
-        }
-    }
-}
 
 /*
  * This method is used to clear updates that are installed
@@ -340,7 +328,7 @@ static NSString *const LatestRollbackCountKey = @"count";
                        @"totalBytes" : [NSNumber
                            numberWithLongLong:_latestExpectedContentLength],
                        @"receivedBytes" : [NSNumber
-                           numberWithLongLong:_latestReceivedConentLength]
+                           numberWithLongLong:_latestReceivedContentLength]
                      }];
 }
 
@@ -404,7 +392,6 @@ static NSString *const LatestRollbackCountKey = @"count";
 #ifdef DEBUG
     [self clearDebugUpdates];
 #endif
-    self.paused = YES;
     NSUserDefaults *preferences = [NSUserDefaults standardUserDefaults];
     NSDictionary *pendingUpdate = [preferences objectForKey:PendingUpdateKey];
     if (pendingUpdate) {
@@ -546,7 +533,7 @@ static NSString *const LatestRollbackCountKey = @"count";
         // file (since Chrome wouldn't support it). Otherwise, update
         // the current bundle URL to point at the latest update
         if ([CodePush isUsingTestConfiguration] || ![super.bridge.bundleURL.scheme hasPrefix:@"http"]) {
-            [super.bridge setValue:[CodePush bundleURL] forKey:@"bundleURL"];
+            RCTReloadCommandSetBundleURL([CodePush bundleURL]);
         }
 
         RCTTriggerReloadCommandListeners(@"react-native-code-push: Restart");
@@ -727,10 +714,7 @@ RCT_EXPORT_METHOD(downloadUpdate:(NSDictionary*)updatePackage
     }
 
     if (notifyProgress) {
-        // Set up and unpause the frame observer so that it can emit
-        // progress events every frame if the progress is updated.
-        _didUpdateProgress = NO;
-        self.paused = NO;
+        _lastProgressEmitTimestamp = 0;
     }
 
     NSString * publicKey = [[CodePushConfig current] publicKey];
@@ -742,17 +726,21 @@ RCT_EXPORT_METHOD(downloadUpdate:(NSDictionary*)updatePackage
         operationQueue:_methodQueue
         // The download is progressing forward
         progressCallback:^(long long expectedContentLength, long long receivedContentLength) {
-            // Update the download progress so that the frame observer can notify the JS side
+            if (!notifyProgress) {
+                return;
+            }
+
             _latestExpectedContentLength = expectedContentLength;
-            _latestReceivedConentLength = receivedContentLength;
-            _didUpdateProgress = YES;
+            _latestReceivedContentLength = receivedContentLength;
 
-            // If the download is completed, stop observing frame
-            // updates and synchronously send the last event.
             if (expectedContentLength == receivedContentLength) {
-                _didUpdateProgress = NO;
-                self.paused = YES;
                 [self dispatchDownloadProgressEvent];
+            } else {
+                NSTimeInterval timestamp = [[NSDate date] timeIntervalSince1970];
+                if (timestamp - _lastProgressEmitTimestamp > 0.3) {
+                    _lastProgressEmitTimestamp = timestamp;
+                    [self dispatchDownloadProgressEvent];
+                }
             }
         }
         // The download completed
@@ -773,9 +761,6 @@ RCT_EXPORT_METHOD(downloadUpdate:(NSDictionary*)updatePackage
                 [self saveFailedUpdate:mutableUpdatePackage];
             }
 
-            // Stop observing frame updates if the download fails.
-            _didUpdateProgress = NO;
-            self.paused = YES;
             reject([NSString stringWithFormat: @"%lu", (long)err.code], err.localizedDescription, err);
         }];
 }
@@ -1128,16 +1113,4 @@ RCT_EXPORT_METHOD(saveStatusReportForRetry:(NSDictionary *)statusReport)
     [CodePushTelemetryManager saveStatusReportForRetry:statusReport];
 }
 
-#pragma mark - RCTFrameUpdateObserver Methods
-
-- (void)didUpdateFrame:(RCTFrameUpdate *)update
-{
-    if (!_didUpdateProgress) {
-        return;
-    }
-
-    [self dispatchDownloadProgressEvent];
-    _didUpdateProgress = NO;
-}
-
 @end

package/ios/CodePush/CodePushBaseBundleStore.m

@@ -0,0 +1,104 @@
+#import "CodePush.h"
+
+// CPLog
+#import <DiffUpdates/DiffUpdates.h>
+
+@implementation CodePushBaseBundleStore
+
+static NSString *const BasesFolderName = @"bases";
+static const NSUInteger MaxSavedBases = 3;
+
++ (NSString *)lookup:(NSString *)packageHash
+{
+    NSString *path = [self pathForPackageHash:packageHash];
+    return path && [[NSFileManager defaultManager] fileExistsAtPath:path] ? path : nil;
+}
+
+/**
+ * Copies the bundle into the store so it outlives its package folder: installPackage deletes the
+ * previous package on every install, but the server can still name that release as a diff base.
+ * Never fails an update - a base we could not save is simply one we do not hold.
+ */
++ (BOOL)save:(NSString *)sourceBundlePath forPackageHash:(NSString *)packageHash
+{
+    NSFileManager *fileManager = [NSFileManager defaultManager];
+    NSString *destinationPath = [self pathForPackageHash:packageHash];
+    if (!destinationPath || ![fileManager fileExistsAtPath:sourceBundlePath]) {
+        return NO;
+    }
+
+    if ([fileManager fileExistsAtPath:destinationPath]) {
+        [self touch:destinationPath];
+        return YES;
+    }
+
+    // Copied aside and renamed: a copy cut short by process death must not leave a truncated file
+    // under the hash, which lookup would then hand out forever.
+    NSString *tempPath = [destinationPath stringByAppendingPathExtension:@"tmp"];
+    [fileManager removeItemAtPath:tempPath error:nil];
+
+    NSError *error = nil;
+    if (![fileManager createDirectoryAtPath:[self basesFolderPath] withIntermediateDirectories:YES attributes:nil error:&error]
+            || ![fileManager copyItemAtPath:sourceBundlePath toPath:tempPath error:&error]
+            || ![fileManager moveItemAtPath:tempPath toPath:destinationPath error:&error]) {
+        CPLog(@"Could not save base bundle %@: %@", packageHash, error);
+        [fileManager removeItemAtPath:tempPath error:nil];
+        return NO;
+    }
+
+    [self touch:destinationPath];
+    [self evict];
+    return YES;
+}
+
++ (NSString *)basesFolderPath
+{
+    return [[CodePushPackage getCodePushPath] stringByAppendingPathComponent:BasesFolderName];
+}
+
+/** An entry is named by its hash alone, so a hash naming anything else is refused. */
++ (NSString *)pathForPackageHash:(NSString *)packageHash
+{
+    if (packageHash.length == 0
+            || [packageHash isEqualToString:@".."]
+            || ![packageHash isEqualToString:packageHash.lastPathComponent]) {
+        return nil;
+    }
+
+    return [[self basesFolderPath] stringByAppendingPathComponent:packageHash];
+}
+
+// A copy keeps the source's timestamp and reuse has to count as use, so the store stamps every
+// save itself. evict orders by this.
++ (void)touch:(NSString *)path
+{
+    [[NSFileManager defaultManager] setAttributes:@{NSFileModificationDate: [NSDate date]}
+                                     ofItemAtPath:path
+                                            error:nil];
+}
+
+/** Keeps the MaxSavedBases most recently saved entries. */
++ (void)evict
+{
+    NSFileManager *fileManager = [NSFileManager defaultManager];
+    NSArray<NSURL *> *entries = [fileManager contentsOfDirectoryAtURL:[NSURL fileURLWithPath:[self basesFolderPath]]
+                                          includingPropertiesForKeys:@[NSURLContentModificationDateKey]
+                                                             options:0
+                                                               error:nil];
+    if (entries.count <= MaxSavedBases) {
+        return;
+    }
+
+    NSArray<NSURL *> *oldestFirst = [entries sortedArrayUsingComparator:^(NSURL *a, NSURL *b) {
+        NSDate *dateA = nil, *dateB = nil;
+        [a getResourceValue:&dateA forKey:NSURLContentModificationDateKey error:nil];
+        [b getResourceValue:&dateB forKey:NSURLContentModificationDateKey error:nil];
+        return [dateA compare:dateB];
+    }];
+
+    for (NSUInteger i = 0; i < oldestFirst.count - MaxSavedBases; i++) {
+        [fileManager removeItemAtURL:oldestFirst[i] error:nil];
+    }
+}
+
+@end

package/ios/CodePush/CodePushPackage.m

@@ -90,12 +90,26 @@ static NSString *const UnzippedFolderName = @"unzipped";
     NSString *singleUrl = updatePackage[@"downloadUrl"] ?: updatePackage[@"download_url"];
 
     __block BOOL cameFromDiffHandler = (bundleDiffUrl.length > 0);
-
+    __block BOOL fallbackStarted = NO;
+    // Assigned below. commonDone reaches back into it to retry a diff that verified badly.
+    __block void (^startFullDownload)(void) = nil;
 
     void (^commonDone)(BOOL) = ^(BOOL isZip) {
         NSError *error = nil;
         NSString * unzippedFolderPath = [CodePushPackage getUnzippedFolderPath];
         NSMutableDictionary * mutableUpdatePackage = [updatePackage mutableCopy];
+
+        // A diff patched against the wrong base still produces a well-formed folder, just one
+        // holding the wrong bytes. Retry as a full download rather than failing the update.
+        BOOL (^recoverFromIntegrityFailure)(void) = ^BOOL {
+            if (!cameFromDiffHandler || fallbackStarted || singleUrl.length == 0) {
+                return NO;
+            }
+            CPLog(@"Falling back to a full download.");
+            startFullDownload();
+            return YES;
+        };
+
         if (isZip) {
             if ([[NSFileManager defaultManager] fileExistsAtPath:unzippedFolderPath]) {
                 // This removes any unzipped download data that could have been left
@@ -257,6 +271,9 @@ static NSString *const UnzippedFolderName = @"unzipped";
                                                   expectedHash:newUpdateHash
                                                          error:&error]) {
                         CPLog(@"The update contents failed the data integrity check.");
+                        if (recoverFromIntegrityFailure()) {
+                            return;
+                        }
                         if (!error) {
                             error = [CodePushErrorUtils errorWithMessage:@"The update contents failed the data integrity check."];
                         }
@@ -305,6 +322,9 @@ static NSString *const UnzippedFolderName = @"unzipped";
                                                   expectedHash:newUpdateHash
                                                          error:&error]) {
                         CPLog(@"The update contents failed the data integrity check.");
+                        if (recoverFromIntegrityFailure()) {
+                            return;
+                        }
                         if (!error) {
                             error = [CodePushErrorUtils errorWithMessage:@"The update contents failed the data integrity check."];
                         }
@@ -347,15 +367,16 @@ static NSString *const UnzippedFolderName = @"unzipped";
         }
     };
 
-    __block BOOL fallbackStarted = NO;
-
-    void (^startFullDownload)(void) = ^{
+    startFullDownload = ^{
         if (fallbackStarted) return;
         fallbackStarted = YES;
 
         NSError *cleanupErr = nil;
         [[NSFileManager defaultManager] removeItemAtPath:downloadFilePath error:&cleanupErr];
         [[NSFileManager defaultManager] removeItemAtPath:[CodePushPackage getUnzippedFolderPath] error:nil];
+        // A diff that got as far as the integrity check already assembled this folder. Whatever it
+        // left behind is wrong, and copyEntriesInFolder overlays rather than replaces.
+        [[NSFileManager defaultManager] removeItemAtPath:newUpdateFolderPath error:nil];
 
         CodePushDownloadHandler *downloadHandler = [[CodePushDownloadHandler alloc]
             init:downloadFilePath
@@ -378,8 +399,12 @@ static NSString *const UnzippedFolderName = @"unzipped";
 
 
     if (cameFromDiffHandler) {
-        NSString *assetsUrl = updatePackage[@"assetDownloadUrl"] ?: updatePackage[@"asset_download_url"];
-        NSString *assetHash = updatePackage[@"assetHash"] ?: updatePackage[@"asset_hash"];
+        // Retained now: this is the last moment we know the release naming it is still on disk.
+        NSString *baseHash = [self basePackageHash:updatePackage];
+        NSString *baseBundlePath = [self findBaseBundleForPackageHash:baseHash];
+        if (baseBundlePath) {
+            [CodePushBaseBundleStore save:baseBundlePath forPackageHash:baseHash];
+        }
 
         NSError *pkgErr = nil;
         NSDictionary *currentPackage = [CodePushPackage getCurrentPackage:&pkgErr];
@@ -396,10 +421,13 @@ static NSString *const UnzippedFolderName = @"unzipped";
 
         CPLog(@"Diff download handler");
 
-        [diffHandler downloadWithDiffUrl:bundleDiffUrl assetsUrl:assetsUrl assetHash:assetHash nativeAssetHash:nativeAssetHash currentPackage:currentPackage];
+        [diffHandler downloadWithDiffUrl:bundleDiffUrl
+                               assetsUrl:assetsUrl
+                               assetHash:assetHash
+                         nativeAssetHash:nativeAssetHash
+                          currentPackage:currentPackage
+                          baseBundlePath:baseBundlePath];
     } else {
-        NSString *singleUrl = updatePackage[@"downloadUrl"] ?: updatePackage[@"download_url"];
-
         CodePushDownloadHandler *downloadHandler = [[CodePushDownloadHandler alloc]
                 init:downloadFilePath
                 operationQueue:operationQueue
@@ -540,6 +568,51 @@ static NSString *const UnzippedFolderName = @"unzipped";
     return [[self getCodePushPath] stringByAppendingPathComponent:packageHash];
 }
 
+/** The package hash the server named as the diff base, or nil if it named none we can use. */
++ (NSString *)basePackageHash:(NSDictionary *)updatePackage
+{
+    NSDictionary *basePackage = updatePackage[@"basePackage"];
+    if (![basePackage isKindOfClass:NSDictionary.class]) {
+        return nil;
+    }
+
+    NSString *packageHash = basePackage[@"packageHash"];
+    if (packageHash.length == 0) {
+        // Named a base with no hash: server and SDK disagree on the field name.
+        CPLog(@"basePackage has no packageHash. Patching against the binary.");
+        return nil;
+    }
+
+    return packageHash;
+}
+
+/**
+ * The bundle to patch against: the retained copy of that release, else the release's own bundle
+ * while its package folder still exists. nil means patch against the binary's bundle instead.
+ */
++ (NSString *)findBaseBundleForPackageHash:(NSString *)packageHash
+{
+    if (packageHash.length == 0) {
+        return nil;
+    }
+
+    NSString *bundlePath = [CodePushBaseBundleStore lookup:packageHash];
+    if (bundlePath) {
+        return bundlePath;
+    }
+
+    NSString *relativeBundlePath = [self getPackage:packageHash error:nil][RelativeBundlePathKey];
+    bundlePath = relativeBundlePath.length > 0
+            ? [[self getPackageFolderPath:packageHash] stringByAppendingPathComponent:relativeBundlePath]
+            : nil;
+    if (bundlePath && [[NSFileManager defaultManager] fileExistsAtPath:bundlePath]) {
+        return bundlePath;
+    }
+
+    CPLog(@"Base %@ not held. Patching against the binary.", packageHash);
+    return nil;
+}
+
 + (NSDictionary *)getPreviousPackage:(NSError **)error
 {
     NSString *packageHash = [self getPreviousPackageHash:error];

package/ios/CodePush.xcodeproj/project.pbxproj

@@ -81,6 +81,7 @@
 		6463C82E1EBA0CFB0095B8CD /* CodePush.m in Sources */ = {isa = PBXBuildFile; fileRef = 13BE3DED1AC21097009241FE /* CodePush.m */; };
 		6463C82F1EBA0CFB0095B8CD /* CodePushConfig.m in Sources */ = {isa = PBXBuildFile; fileRef = 81D51F391B6181C2000DA084 /* CodePushConfig.m */; };
 		6463C8321EBA0CFB0095B8CD /* CodePushPackage.m in Sources */ = {isa = PBXBuildFile; fileRef = 810D4E6C1B96935000B397E9 /* CodePushPackage.m */; };
+		BA5EB00D0000000000000003 /* CodePushBaseBundleStore.m in Sources */ = {isa = PBXBuildFile; fileRef = BA5EB00D0000000000000001 /* CodePushBaseBundleStore.m */; };
 		6463C8331EBA0CFB0095B8CD /* CodePushTelemetryManager.m in Sources */ = {isa = PBXBuildFile; fileRef = 5421FE301C58AD5A00986A55 /* CodePushTelemetryManager.m */; };
 		6463C8341EBA0CFB0095B8CD /* CodePushUpdateUtils.m in Sources */ = {isa = PBXBuildFile; fileRef = 540D20111C7684FE00D6EF41 /* CodePushUpdateUtils.m */; };
 		6463C8351EBA0CFB0095B8CD /* RCTConvert+CodePushInstallMode.m in Sources */ = {isa = PBXBuildFile; fileRef = 1B23B9131BF9267B000BB2F0 /* RCTConvert+CodePushInstallMode.m */; };
@@ -88,6 +89,7 @@
 		6463C8451EBA0D1F0095B8CD /* CodePush.h in CopyFiles */ = {isa = PBXBuildFile; fileRef = 13BE3DEC1AC21097009241FE /* CodePush.h */; };
 		6463C8471EBA0D290095B8CD /* CodePush.h in Headers */ = {isa = PBXBuildFile; fileRef = 13BE3DEC1AC21097009241FE /* CodePush.h */; };
 		810D4E6D1B96935000B397E9 /* CodePushPackage.m in Sources */ = {isa = PBXBuildFile; fileRef = 810D4E6C1B96935000B397E9 /* CodePushPackage.m */; };
+		BA5EB00D0000000000000002 /* CodePushBaseBundleStore.m in Sources */ = {isa = PBXBuildFile; fileRef = BA5EB00D0000000000000001 /* CodePushBaseBundleStore.m */; };
 		81D51F3A1B6181C2000DA084 /* CodePushConfig.m in Sources */ = {isa = PBXBuildFile; fileRef = 81D51F391B6181C2000DA084 /* CodePushConfig.m */; };
 		8482F84C1E24C58300F793DB /* CodePush.h in CopyFiles */ = {isa = PBXBuildFile; fileRef = 13BE3DEC1AC21097009241FE /* CodePush.h */; };
 		8482F84E1E24C66300F793DB /* CodePush.h in Headers */ = {isa = PBXBuildFile; fileRef = 13BE3DEC1AC21097009241FE /* CodePush.h */; };
@@ -210,6 +212,7 @@
 		540D20111C7684FE00D6EF41 /* CodePushUpdateUtils.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = CodePushUpdateUtils.m; path = CodePush/CodePushUpdateUtils.m; sourceTree = "<group>"; };
 		5421FE301C58AD5A00986A55 /* CodePushTelemetryManager.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = CodePushTelemetryManager.m; path = CodePush/CodePushTelemetryManager.m; sourceTree = "<group>"; };
 		810D4E6C1B96935000B397E9 /* CodePushPackage.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = CodePushPackage.m; path = CodePush/CodePushPackage.m; sourceTree = "<group>"; };
+		BA5EB00D0000000000000001 /* CodePushBaseBundleStore.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = CodePushBaseBundleStore.m; path = CodePush/CodePushBaseBundleStore.m; sourceTree = "<group>"; };
 		81D51F391B6181C2000DA084 /* CodePushConfig.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = CodePushConfig.m; path = CodePush/CodePushConfig.m; sourceTree = "<group>"; };
 		F85736731F4F03BF00C9C00A /* MF_Base64Additions.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = MF_Base64Additions.h; sourceTree = "<group>"; };
 		F85736741F4F03BF00C9C00A /* MF_Base64Additions.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = MF_Base64Additions.m; sourceTree = "<group>"; };
@@ -370,6 +373,7 @@
 				13BE3DED1AC21097009241FE /* CodePush.m */,
 				81D51F391B6181C2000DA084 /* CodePushConfig.m */,
 				810D4E6C1B96935000B397E9 /* CodePushPackage.m */,
+				BA5EB00D0000000000000001 /* CodePushBaseBundleStore.m */,
 				5421FE301C58AD5A00986A55 /* CodePushTelemetryManager.m */,
 				540D20111C7684FE00D6EF41 /* CodePushUpdateUtils.m */,
 				1B23B9131BF9267B000BB2F0 /* RCTConvert+CodePushInstallMode.m */,
@@ -763,6 +767,7 @@
 				F88664511F4AD1EE0036D01B /* JWTAlgorithmNone.m in Sources */,
 				3221E4612C8ABE1300268379 /* mz_zip_rw.c in Sources */,
 				810D4E6D1B96935000B397E9 /* CodePushPackage.m in Sources */,
+				BA5EB00D0000000000000002 /* CodePushBaseBundleStore.m in Sources */,
 				3221E4552C8ABE1300268379 /* mz_strm_pkcrypt.c in Sources */,
 				F88664531F4AD1EE0036D01B /* JWTAlgorithmESBase.m in Sources */,
 				3221E4532C8ABE1300268379 /* mz_strm_os_posix.c in Sources */,
@@ -783,6 +788,7 @@
 				6463C82F1EBA0CFB0095B8CD /* CodePushConfig.m in Sources */,
 				3221E46E2C8ABE1300268379 /* mz_crypt.c in Sources */,
 				6463C8321EBA0CFB0095B8CD /* CodePushPackage.m in Sources */,
+				BA5EB00D0000000000000003 /* CodePushBaseBundleStore.m in Sources */,
 				6463C8331EBA0CFB0095B8CD /* CodePushTelemetryManager.m in Sources */,
 				6463C8341EBA0CFB0095B8CD /* CodePushUpdateUtils.m in Sources */,
 				3221E45C2C8ABE1300268379 /* mz_strm_zlib.c in Sources */,

package/ios/Frameworks/DiffUpdates.xcframework/ios-arm64/DiffUpdates.framework/Headers/DiffUpdates.h

@@ -8,6 +8,12 @@ FOUNDATION_EXPORT const unsigned char DiffUpdatesVersionString[];
 
 // In this header, you should import all the public headers of your framework using statements like #import <DiffUpdates/PublicHeader.h>
 
+#if __has_include(<DiffUpdates/hpatch_objc.h>)
+#import <DiffUpdates/hpatch_objc.h>
+#else
+#import "hpatch_objc.h"
+#endif
+
 @interface CodePushDownloadHandler : NSObject <NSURLConnectionDelegate>
 
 @property (strong) NSOutputStream *outputFileStream;
@@ -43,6 +49,18 @@ FOUNDATION_EXPORT const unsigned char DiffUpdatesVersionString[];
        doneCallback:(void (^)(BOOL))doneCallback
        failCallback:(void (^)(NSError *err))failCallback;
 
+/**
+ * Patches against baseBundlePath, or against the binary's own bundle when it is nil.
+ * The patched bundle always keeps the binary bundle's file name, whatever the base was.
+ */
+- (void)downloadWithDiffUrl:(NSString *)diffUrl
+                  assetsUrl:(NSString * _Nullable)assetsUrl
+                  assetHash:(NSString * _Nullable)assetHash
+            nativeAssetHash:(NSString * _Nullable)nativeAssetHash
+             currentPackage:(NSDictionary * _Nullable)currentPackage
+             baseBundlePath:(NSString * _Nullable)baseBundlePath;
+
+/** Patches against the binary's own bundle. Kept so an older SDK links against a newer framework. */
 - (void)downloadWithDiffUrl:(NSString *)diffUrl
                   assetsUrl:(NSString * _Nullable)assetsUrl
                   assetHash:(NSString * _Nullable)assetHash