@capawesome/capacitor-live-update 8.4.2 → 8.4.3

package/README.md

@@ -55,9 +55,10 @@ The Live Update plugin is typically used to ship changes to users without going
 
 - [Getting Started with Capawesome Cloud Live Updates](https://capawesome.io/docs/cloud/live-updates/setup/)
 - [Capacitor Live Updates: The Complete OTA Guide](https://capawesome.io/blog/capacitor-live-updates-guide/)
-- [Best OTA Update Tools for Capacitor (2026)](https://capawesome.io/blog/best-ota-update-tools-for-capacitor/)
+- [Best Live Update Tools for Capacitor (2026)](https://capawesome.io/blog/best-ota-update-tools-for-capacitor/)
 - [Capacitor Live Updates: Signing vs Encryption](https://capawesome.io/blog/capacitor-live-updates-end-to-end-encryption/)
 - [Capacitor Live Updates: Reliability & Uptime](https://capawesome.io/blog/capacitor-live-updates-reliability-and-uptime/)
+- [Capawesome vs. Capgo: Which Is More Reliable?](https://capawesome.io/blog/capawesome-cloud-vs-capgo-reliability/)
 - [Migrating from Ionic Appflow to Capawesome Cloud](https://capawesome.io/blog/migrating-from-ionic-appflow-to-capawesome-cloud/)
 - [Migrating from App Center to Capawesome Cloud](https://capawesome.io/blog/migrating-from-app-center-to-capawesome-cloud/)
 - [Live Updates for Nuxt Capacitor Apps](https://capawesome.io/blog/live-updates-for-nuxt-capacitor/)

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/LiveUpdate.java

@@ -104,6 +104,7 @@ public class LiveUpdate {
     private final SharedPreferences.Editor webViewSettingsEditor;
 
     private final String bundlesDirectory = "_capacitor_live_update_bundles"; // DO NOT CHANGE!
+    private final String downloadsDirectory = "capawesome_capacitor_live_update_downloads";
     private final Handler rollbackHandler = new Handler(Looper.getMainLooper());
     private final String manifestFileName = "capawesome-live-update-manifest.json"; // DO NOT CHANGE!
 
@@ -125,6 +126,9 @@ public class LiveUpdate {
         // Set the device ID on the HTTP client (after any potential config reset)
         this.httpClient.setDeviceId(getDeviceId());
 
+        // Delete the leftovers of downloads that were interrupted by a process kill
+        tryDeleteDownloadsDirectory();
+
         // Start the rollback timer to rollback to the default bundle
         // if the app is not ready after a certain time
         startRollbackTimer();
@@ -536,7 +540,10 @@ public class LiveUpdate {
 
         // Move the bundle directory to the bundles directory
         File bundleDirectory = buildBundleDirectoryFor(bundleId);
-        indexHtmlFile.getParentFile().renameTo(bundleDirectory);
+        boolean moved = indexHtmlFile.getParentFile().renameTo(bundleDirectory);
+        if (!moved) {
+            throw new Exception(LiveUpdatePlugin.ERROR_BUNDLE_MOVE_FAILED);
+        }
     }
 
     private void addBundleOfTypeManifest(@NonNull String bundleId, @NonNull File directory) throws Exception {
@@ -545,7 +552,7 @@ public class LiveUpdate {
 
     private void addBundleOfTypeZip(@NonNull String bundleId, @NonNull File zipFile) throws Exception {
         // Unzip the file to the bundle directory
-        File unzippedDirectory = unzipFile(zipFile);
+        File unzippedDirectory = unzipDownloadedBundle(zipFile);
         // Add the bundle
         addBundle(bundleId, unzippedDirectory);
     }
@@ -558,14 +565,8 @@ public class LiveUpdate {
         return new File(plugin.getContext().getFilesDir(), bundlesDirectory + "/" + bundleId);
     }
 
-    private File buildTemporaryDirectory() {
-        String fileName = UUID.randomUUID().toString();
-        return new File(plugin.getContext().getCacheDir(), fileName);
-    }
-
-    private File buildTemporaryZipFile() {
-        String fileName = UUID.randomUUID().toString() + ".zip";
-        return new File(plugin.getContext().getCacheDir(), fileName);
+    private File buildDownloadsDirectory() {
+        return new File(plugin.getContext().getCacheDir(), downloadsDirectory);
     }
 
     private void copyCurrentBundleFile(@NonNull ManifestItem fileToCopy, @NonNull File destinationDirectory) throws IOException {
@@ -652,10 +653,10 @@ public class LiveUpdate {
         }
     }
 
-    private File createTemporaryDirectory() {
-        File file = buildTemporaryDirectory();
-        file.mkdir();
-        return file;
+    private File createTemporaryDownloadDirectory() {
+        File temporaryDirectory = new File(buildDownloadsDirectory(), UUID.randomUUID().toString());
+        temporaryDirectory.mkdirs();
+        return temporaryDirectory;
     }
 
     private void deleteBundleById(@NonNull String bundleId) {
@@ -681,6 +682,23 @@ public class LiveUpdate {
         file.delete();
     }
 
+    @NonNull
+    private EmptyCallback deleteTemporaryDirectoryOnCompletion(@NonNull File temporaryDirectory, @NonNull EmptyCallback callback) {
+        return new EmptyCallback() {
+            @Override
+            public void success() {
+                deleteFileRecursively(temporaryDirectory);
+                callback.success();
+            }
+
+            @Override
+            public void error(@NonNull Exception exception) {
+                deleteFileRecursively(temporaryDirectory);
+                callback.error(exception);
+            }
+        };
+    }
+
     private void deleteUnusedBundles() {
         String[] bundleIds = getDownloadedBundleIds();
         for (String bundleId : bundleIds) {
@@ -851,10 +869,10 @@ public class LiveUpdate {
         @NonNull String downloadUrl,
         @NonNull EmptyCallback completionCallback
     ) {
+        // Create a temporary directory that is deleted once the download completed or failed
+        File temporaryDirectory = createTemporaryDownloadDirectory();
+        EmptyCallback callback = deleteTemporaryDirectoryOnCompletion(temporaryDirectory, completionCallback);
         try {
-            // Create a temporary directory
-            File temporaryDirectory = createTemporaryDirectory();
-
             // Download the latest manifest
             downloadBundleFile(
                 downloadUrl,
@@ -904,31 +922,31 @@ public class LiveUpdate {
                                         try {
                                             // Add the bundle
                                             addBundleOfTypeManifest(bundleId, temporaryDirectory);
-                                            completionCallback.success();
+                                            callback.success();
                                         } catch (Exception e) {
-                                            completionCallback.error(e);
+                                            callback.error(e);
                                         }
                                     }
 
                                     @Override
                                     public void error(@NonNull Exception exception) {
-                                        completionCallback.error(exception);
+                                        callback.error(exception);
                                     }
                                 }
                             );
                         } catch (Exception e) {
-                            completionCallback.error(e);
+                            callback.error(e);
                         }
                     }
 
                     @Override
                     public void error(@NonNull Exception exception) {
-                        completionCallback.error(exception);
+                        callback.error(exception);
                     }
                 }
             );
         } catch (Exception e) {
-            completionCallback.error(e);
+            callback.error(e);
         }
     }
 
@@ -939,39 +957,42 @@ public class LiveUpdate {
         @NonNull String downloadUrl,
         @NonNull EmptyCallback completionCallback
     ) {
-        File file = buildTemporaryZipFile();
-        // Download the bundle
-        downloadAndVerifyFile(
-            downloadUrl,
-            file,
-            checksum,
-            signature,
-            (downloadedBytes, totalBytes) -> {
-                DownloadBundleProgressEvent event = new DownloadBundleProgressEvent(bundleId, downloadedBytes, totalBytes);
-                notifyDownloadBundleProgressListeners(event);
-            },
-            new EmptyCallback() {
-                @Override
-                public void success() {
-                    try {
-                        // Add the bundle
-                        addBundleOfTypeZip(bundleId, file);
-                        // Delete the temporary file
-                        file.delete();
-                        completionCallback.success();
-                    } catch (Exception e) {
-                        completionCallback.error(e);
+        // Create a temporary directory that is deleted once the download completed or failed
+        File temporaryDirectory = createTemporaryDownloadDirectory();
+        EmptyCallback callback = deleteTemporaryDirectoryOnCompletion(temporaryDirectory, completionCallback);
+        File zipFile = new File(temporaryDirectory, "bundle.zip");
+        try {
+            // Download the bundle
+            downloadAndVerifyFile(
+                downloadUrl,
+                zipFile,
+                checksum,
+                signature,
+                (downloadedBytes, totalBytes) -> {
+                    DownloadBundleProgressEvent event = new DownloadBundleProgressEvent(bundleId, downloadedBytes, totalBytes);
+                    notifyDownloadBundleProgressListeners(event);
+                },
+                new EmptyCallback() {
+                    @Override
+                    public void success() {
+                        try {
+                            // Add the bundle
+                            addBundleOfTypeZip(bundleId, zipFile);
+                            callback.success();
+                        } catch (Exception e) {
+                            callback.error(e);
+                        }
                     }
-                }
 
-                @Override
-                public void error(@NonNull Exception exception) {
-                    // Delete the temporary file on error
-                    file.delete();
-                    completionCallback.error(exception);
+                    @Override
+                    public void error(@NonNull Exception exception) {
+                        callback.error(exception);
+                    }
                 }
-            }
-        );
+            );
+        } catch (Exception e) {
+            callback.error(e);
+        }
     }
 
     private void fetchLatestBundleInternal(
@@ -1437,8 +1458,12 @@ public class LiveUpdate {
         }
     }
 
-    private File unzipFile(@NonNull File zipFile) throws IOException {
-        File destination = buildTemporaryDirectory();
+    private void tryDeleteDownloadsDirectory() {
+        deleteFileRecursively(buildDownloadsDirectory());
+    }
+
+    private File unzipDownloadedBundle(@NonNull File zipFile) throws IOException {
+        File destination = new File(zipFile.getParentFile(), "bundle");
         String destinationPath = destination.getPath();
         ZipFile zip = new ZipFile(zipFile);
         // Clear stored Unix permissions to prevent EACCES errors on newer Android versions

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/LiveUpdatePlugin.java

@@ -37,12 +37,13 @@ import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
 public class LiveUpdatePlugin extends Plugin {
 
     public static final String TAG = "LiveUpdate";
-    public static final String VERSION = "8.4.2";
+    public static final String VERSION = "8.4.3";
     public static final String SHARED_PREFERENCES_NAME = "CapawesomeLiveUpdate"; // DO NOT CHANGE
     public static final String ERROR_APP_ID_MISSING = "appId must be configured.";
     public static final String ERROR_BUNDLE_EXISTS = "bundle already exists.";
     public static final String ERROR_BUNDLE_ID_MISSING = "bundleId must be provided.";
     public static final String ERROR_BUNDLE_INDEX_HTML_MISSING = "The bundle does not contain an index.html file.";
+    public static final String ERROR_BUNDLE_MOVE_FAILED = "Bundle could not be moved.";
     public static final String ERROR_BUNDLE_NOT_FOUND = "bundle not found.";
     public static final String ERROR_CHECKSUM_CALCULATION_FAILED = "Failed to calculate checksum.";
     public static final String ERROR_CHECKSUM_MISMATCH = "Checksum mismatch.";

package/ios/Plugin/LiveUpdate.swift

@@ -13,6 +13,7 @@ import CommonCrypto
     private let config: LiveUpdateConfig
     private let defaultWebAssetDir = "public" // DO NOT CHANGE! (See https://dub.sh/Buvz4yj)
     private let defaultServerPathKey = "serverBasePath" // DO NOT CHANGE! (See https://dub.sh/ceDl0zT)
+    private let downloadsDirectory = "capawesome_capacitor_live_update_downloads"
     private let httpClient: LiveUpdateHttpClient
     private let libraryDirectoryUrl = FileManager.default.urls(for: .libraryDirectory, in: .userDomainMask).first!
     private let manifestFileName = "capawesome-live-update-manifest.json" // DO NOT CHANGE!
@@ -37,6 +38,9 @@ import CommonCrypto
         // Set the device ID on the HTTP client (after any potential config reset)
         self.httpClient.setDeviceId(getDeviceId())
 
+        // Delete the leftovers of downloads that were interrupted by a process kill
+        tryDeleteDownloadsDirectory()
+
         // Start the rollback timer to rollback to the default bundle
         // if the app is not ready after a certain time
         startRollbackTimer()
@@ -355,7 +359,7 @@ import CommonCrypto
 
     private func addBundleOfTypeZip(bundleId: String, zipFile: URL) async throws {
         // Unzip the bundle
-        let unzippedDirectory = try self.unzipFile(zipFile: zipFile)
+        let unzippedDirectory = try self.unzipDownloadedBundle(zipFile: zipFile)
         // Add the bundle
         try self.addBundle(bundleId: bundleId, directory: unzippedDirectory)
     }
@@ -379,6 +383,10 @@ import CommonCrypto
         return url
     }
 
+    private func buildDownloadsDirectoryUrl() -> URL {
+        return cachesDirectoryUrl.appendingPathComponent(downloadsDirectory)
+    }
+
     private func copyCurrentBundleFile(fileToCopy: ManifestItem, toDirectory: URL) throws {
         let currentBundleId = getCurrentBundleId()
         let destination = toDirectory.appendingPathComponent(fileToCopy.href)
@@ -428,8 +436,8 @@ import CommonCrypto
         }
     }
 
-    private func createTemporaryDirectory() throws -> URL {
-        let temporaryDirectory = cachesDirectoryUrl.appendingPathComponent(UUID().uuidString)
+    private func createTemporaryDownloadDirectory() throws -> URL {
+        let temporaryDirectory = buildDownloadsDirectoryUrl().appendingPathComponent(UUID().uuidString)
         try FileManager.default.createDirectory(at: temporaryDirectory, withIntermediateDirectories: true, attributes: nil)
         return temporaryDirectory
     }
@@ -537,8 +545,9 @@ import CommonCrypto
     }
 
     private func downloadBundleOfTypeManifest(bundleId: String, url: String) async throws {
-        // Create a temporary directory
-        let temporaryDirectory = try createTemporaryDirectory()
+        // Create a temporary directory that is deleted once the download completed or failed
+        let temporaryDirectory = try createTemporaryDownloadDirectory()
+        defer { tryDeleteDirectory(temporaryDirectory) }
         // Download the latest manifest
         let latestManifestFile = try await downloadBundleFile(baseUrl: url, href: manifestFileName, directory: temporaryDirectory, callback: nil)
         let latestManifest = try loadManifest(file: latestManifestFile)
@@ -569,15 +578,17 @@ import CommonCrypto
     }
 
     private func downloadBundleOfTypeZip(bundleId: String, checksum: String?, signature: String?, url: String) async throws {
-        let timestamp = String(Int(Date().timeIntervalSince1970))
-        let temporaryZipFileUrl = self.cachesDirectoryUrl.appendingPathComponent(timestamp + ".zip")
+        // Create a temporary directory that is deleted once the download completed or failed
+        let temporaryDirectory = try createTemporaryDownloadDirectory()
+        defer { tryDeleteDirectory(temporaryDirectory) }
+        let zipFile = temporaryDirectory.appendingPathComponent("bundle.zip")
         // Download the bundle
-        try await downloadAndVerifyFile(url: url, file: temporaryZipFileUrl, checksum: checksum, signature: signature, callback: { progress in
+        try await downloadAndVerifyFile(url: url, file: zipFile, checksum: checksum, signature: signature, callback: { progress in
             let event = DownloadBundleProgressEvent(bundleId: bundleId, downloadedBytes: progress.completedUnitCount, totalBytes: progress.totalUnitCount)
             self.notifyDownloadBundleProgressListeners(event)
         })
         // Add the bundle
-        try await addBundleOfTypeZip(bundleId: bundleId, zipFile: temporaryZipFileUrl)
+        try await addBundleOfTypeZip(bundleId: bundleId, zipFile: zipFile)
     }
 
     private func fetchLatestBundle(_ options: FetchLatestBundleOptions) async throws -> GetLatestBundleResponse? {
@@ -963,8 +974,23 @@ import CommonCrypto
         }
     }
 
-    private func unzipFile(zipFile: URL) throws -> URL {
-        let destinationDirectory = zipFile.deletingPathExtension()
+    private func tryDeleteDirectory(_ url: URL) {
+        guard FileManager.default.fileExists(atPath: url.path) else {
+            return
+        }
+        do {
+            try FileManager.default.removeItem(at: url)
+        } catch {
+            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to delete directory: \(url.path)")
+        }
+    }
+
+    private func tryDeleteDownloadsDirectory() {
+        tryDeleteDirectory(buildDownloadsDirectoryUrl())
+    }
+
+    private func unzipDownloadedBundle(zipFile: URL) throws -> URL {
+        let destinationDirectory = zipFile.deletingLastPathComponent().appendingPathComponent("bundle")
         try FileManager.default.createDirectory(at: destinationDirectory, withIntermediateDirectories: true, attributes: nil)
         try FileManager.default.unzipItem(at: zipFile, to: destinationDirectory)
         return destinationDirectory

package/ios/Plugin/LiveUpdatePlugin.swift

@@ -8,7 +8,7 @@ import Capacitor
 @objc(LiveUpdatePlugin)
 public class LiveUpdatePlugin: CAPPlugin, CAPBridgedPlugin {
     public static let tag = "LiveUpdate"
-    public static let version = "8.4.2"
+    public static let version = "8.4.3"
     public static let userDefaultsPrefix = "CapawesomeLiveUpdate" // DO NOT CHANGE
 
     public let identifier = "LiveUpdatePlugin"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/capacitor-live-update",
-  "version": "8.4.2",
+  "version": "8.4.3",
   "description": "Capacitor plugin to update your app remotely in real-time on Android and iOS.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",