@capawesome/capacitor-live-update 8.3.0 → 8.4.1

package/README.md

@@ -1,4 +1,4 @@
-# @capawesome/capacitor-live-update
+# Capacitor Live Update Plugin
 
 Capacitor plugin that allows you to update your app remotely in real-time without requiring users to download a new version from the app store, known as Over-the-Air (OTA) updates.
 
@@ -10,7 +10,7 @@ Capacitor plugin that allows you to update your app remotely in real-time withou
 
 ## Features
 
-We are proud to offer one of the most complete and feature-rich Capacitor plugins for Over-the-Air (OTA) updates. Here are some of the key features:
+The Capacitor Live Update plugin is one of the most feature-rich Over-the-Air (OTA) update solutions for Capacitor apps. Here are some of the key features:
 
 - 🔋 Supports **Android and iOS**
 - ⚡️ **Capacitor 6/7/8** support
@@ -28,27 +28,39 @@ We are proud to offer one of the most complete and feature-rich Capacitor plugin
 - 🔒 **Security**: Verify the authenticity and integrity of the bundle using a public key.
 - ⚔️ **Battle-Tested**: Used in more than 1,000 projects to update apps on more than 20,000,000 devices.
 - 🌐 **Open Source**: Licensed under the MIT License.
+- 🤝 **Compatibility**: Works alongside the [App Update](https://capawesome.io/docs/sdks/capacitor/app-update/) and [Firebase Remote Config](https://capawesome.io/docs/sdks/capacitor/firebase/remote-config/) plugins.
 
 Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
 
-## Newsletter
+## Use Cases
 
-Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+The Live Update plugin is typically used to ship changes to users without going through the app stores, for example:
+
+- **Instant bug fixes**: Deliver critical fixes to your users in real-time without waiting for app store reviews.
+- **Fast feature delivery**: Ship new web-based features as soon as they are ready by publishing a new bundle.
+- **Staged rollouts**: Gradually roll out new bundles to a subset of devices to gather feedback before a full release.
+- **Testing and QA channels**: Distribute preview versions to testers via dedicated channels before promoting them to production.
+- **Safe releases**: Automatically roll back to the default bundle if a faulty update prevents the app from becoming ready.
 
 ## Compatibility
 
 | Plugin Version | Capacitor Version | Status         |
 | -------------- | ----------------- | -------------- |
 | 8.x.x          | >=8.x.x           | Active support |
-| 7.x.x          | 7.x.x             | Deprecated     |
-| 6.x.x          | 6.x.x             | Deprecated     |
+| 7.x.x          | 7.x.x             | Maintenance    |
+| 6.x.x          | 6.x.x             | Maintenance    |
 | 5.x.x          | 5.x.x             | Deprecated     |
 
 ## Guides
 
 - [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/)
+- [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/)
 - [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/)
 
 ## Installation
 
@@ -76,7 +88,7 @@ npx cap sync
 
 #### Channel
 
-If you are using [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/guides/best-practices/#versioned-channels), you can set a default channel directly in your native project by adding a string resource.
+If you are using [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/channels/#versioned-channels), you can set a default channel directly in your native project by adding a string resource.
 This allows you to tie the channel to the version code at build time.
 
 Add the following to your app's `build.gradle` file:
@@ -93,7 +105,7 @@ android {
 
 If needed, you can define the following project variable in your app’s `variables.gradle` file to change the default version of the dependency:
 
-- `$okhttp3Version` version of `com.squareup.okhttp3:okhttp` (default: `5.3.2`)
+- `$okhttp3Version` version of `com.squareup.okhttp3:okhttp` and `com.squareup.okhttp3:okhttp-brotli` (default: `5.3.2`)
 - `$zip4jVersion` version of `net.lingala.zip4j:zip4j` (default: `2.11.5`)
 
 This can be useful if you encounter dependency conflicts with other plugins in your project.
@@ -102,7 +114,7 @@ This can be useful if you encounter dependency conflicts with other plugins in y
 
 #### Channel
 
-If you are using [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/guides/best-practices/#versioned-channels), you can set a default channel directly in your native project by adding a key to your `Info.plist` file.
+If you are using [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/channels/#versioned-channels), you can set a default channel directly in your native project by adding a key to your `Info.plist` file.
 This allows you to tie the channel to the build version at build time.
 
 Add the following to your `Info.plist` file:
@@ -216,56 +228,182 @@ A working example can be found here: [capawesome-team/capacitor-live-update-demo
 
 ## Usage
 
+All methods are only available on Android and iOS. The following examples show how to sync with Capawesome Cloud, mark the app as ready, check for and download new bundles, switch between and manage bundles, work with channels, inspect the current and next bundle, identify devices, read the app version, and reset to the default bundle.
+
+### Sync with Capawesome Cloud
+
+Automatically download and set the latest bundle for the app using [Capawesome Cloud](https://cloud.capawesome.io/). Call `reload()` or restart the app to apply the changes. The `channel` option overrides the channel for this single sync call without persisting it:
+
 ```typescript
 import { LiveUpdate } from '@capawesome/capacitor-live-update';
 
-const deleteBundle = async () => {
-  await LiveUpdate.deleteBundle({ bundleId: 'my-bundle' });
+const sync = async () => {
+  const result = await LiveUpdate.sync({
+    channel: 'production-5',
+  });
+  return result.nextBundleId;
+};
+```
+
+### Notify the plugin that the app is ready
+
+Call `ready()` as soon as the app is ready to use so that the plugin knows no rollback is needed. If the `readyTimeout` configuration option is set and this method is not called in time, the plugin resets the app to the default bundle:
+
+```typescript
+import { LiveUpdate } from '@capawesome/capacitor-live-update';
+
+const ready = async () => {
+  const result = await LiveUpdate.ready();
+  if (result.currentBundleId) {
+    console.log(`The app is now using the bundle with the identifier ${result.currentBundleId}.`);
+  }
+  if (result.previousBundleId) {
+    console.log(`The app was using the bundle with the identifier ${result.previousBundleId}.`);
+  }
+  if (result.rollback) {
+    console.log('The app was reset to the default bundle.');
+  }
+};
+```
+
+### Check if a new bundle is available
+
+Fetch the latest bundle from Capawesome Cloud and compare it with the bundle that is currently in use:
+
+```typescript
+import { LiveUpdate } from '@capawesome/capacitor-live-update';
+
+const fetchLatestBundle = async () => {
+  await LiveUpdate.fetchLatestBundle();
+};
+
+const isNewBundleAvailable = async () => {
+  const { bundleId: latestBundleId } = await LiveUpdate.fetchLatestBundle({
+    channel: 'production-5',
+  });
+  if (latestBundleId) {
+    const { bundleId: currentBundleId } = await LiveUpdate.getCurrentBundle();
+    return latestBundleId !== currentBundleId;
+  } else {
+    return false;
+  }
 };
+```
+
+### Download a bundle from your own server
+
+Download a self-hosted bundle from any URL, without any Capawesome Cloud dependency:
+
+```typescript
+import { LiveUpdate } from '@capawesome/capacitor-live-update';
 
 const downloadBundle = async () => {
   await LiveUpdate.downloadBundle({ url: 'https://example.com/1.0.0.zip', bundleId: '1.0.0' });
 };
+```
 
-const fetchChannels = async () => {
-  const result = await LiveUpdate.fetchChannels();
-  return result.channels;
+### Switch to a downloaded bundle
+
+Set the next bundle to use for the app. Call `reload()` or restart the app to apply the changes:
+
+```typescript
+import { LiveUpdate } from '@capawesome/capacitor-live-update';
+
+const setNextBundle = async () => {
+  await LiveUpdate.setNextBundle({ bundleId: '7f0b9bf2-dff6-4be2-bcac-b068cc5ea756' });
 };
 
-const fetchLatestBundle = async () => {
-  await LiveUpdate.fetchLatestBundle();
+const reload = async () => {
+  await LiveUpdate.reload();
 };
+```
+
+### Manage downloaded bundles
+
+Get the identifiers of all bundles that have been downloaded and delete bundles that are no longer needed:
+
+```typescript
+import { LiveUpdate } from '@capawesome/capacitor-live-update';
 
 const getBundles = async () => {
   const result = await LiveUpdate.getBundles();
   return result.bundleIds;
 };
 
+const deleteBundle = async () => {
+  await LiveUpdate.deleteBundle({ bundleId: 'my-bundle' });
+};
+```
+
+### Work with channels
+
+Set the channel to use for updates, read the currently resolved channel, and fetch the available channels from Capawesome Cloud. The channel set via `setChannel(...)` is persisted across app restarts. Note that `fetchChannels(...)` only works for apps with public channels enabled:
+
+```typescript
+import { LiveUpdate } from '@capawesome/capacitor-live-update';
+
+const setChannel = async () => {
+  await LiveUpdate.setChannel({ channel: 'production-5' });
+};
+
 const getChannel = async () => {
   const result = await LiveUpdate.getChannel();
   return result.channel;
 };
 
+const fetchChannels = async () => {
+  const result = await LiveUpdate.fetchChannels();
+  return result.channels;
+};
+```
+
+### Inspect the current and next bundle
+
+Get the identifier of the bundle that is currently used by the app and of the bundle that will be used after the next reload or app restart:
+
+```typescript
+import { LiveUpdate } from '@capawesome/capacitor-live-update';
+
 const getCurrentBundle = async () => {
   const result = await LiveUpdate.getCurrentBundle();
   return result.bundleId;
 };
 
-const getCustomId = async () => {
-  const result = await LiveUpdate.getCustomId();
-  return result.customId;
+const getNextBundle = async () => {
+  const result = await LiveUpdate.getNextBundle();
+  return result.bundleId;
 };
+```
+
+### Identify devices
+
+Read the unique device identifier and manage a custom identifier for the device:
+
+```typescript
+import { LiveUpdate } from '@capawesome/capacitor-live-update';
 
 const getDeviceId = async () => {
   const result = await LiveUpdate.getDeviceId();
   return result.deviceId;
 };
 
-const getNextBundle = async () => {
-  const result = await LiveUpdate.getNextBundle();
-  return result.bundleId;
+const setCustomId = async () => {
+  await LiveUpdate.setCustomId({ customId: 'my-custom-id' });
 };
 
+const getCustomId = async () => {
+  const result = await LiveUpdate.getCustomId();
+  return result.customId;
+};
+```
+
+### Read the app version
+
+Get the native version code and version name of the app, for example to restrict live updates to compatible native versions:
+
+```typescript
+import { LiveUpdate } from '@capawesome/capacitor-live-update';
+
 const getVersionCode = async () => {
   const result = await LiveUpdate.getVersionCode();
   return result.versionCode;
@@ -275,58 +413,18 @@ const getVersionName = async () => {
   const result = await LiveUpdate.getVersionName();
   return result.versionName;
 };
+```
 
-const ready = async () => {
-  const result = await LiveUpdate.ready();
-  if (result.currentBundleId) {
-    console.log(`The app is now using the bundle with the identifier ${result.currentBundleId}.`);
-  }
-  if (result.previousBundleId) {
-    console.log(`The app was using the bundle with the identifier ${result.previousBundleId}.`);
-  }
-  if (result.rollback) {
-    console.log('The app was reset to the default bundle.');
-  }
-};
+### Reset to the default bundle
 
-const reload = async () => {
-  await LiveUpdate.reload();
-};
+Reset the app to the bundle that shipped with the native app binary. Call `reload()` or restart the app to apply the changes:
+
+```typescript
+import { LiveUpdate } from '@capawesome/capacitor-live-update';
 
 const reset = async () => {
   await LiveUpdate.reset();
 };
-
-const setChannel = async () => {
-  await LiveUpdate.setChannel({ channel: 'production-5' });
-};
-
-const setCustomId = async () => {
-  await LiveUpdate.setCustomId({ customId: 'my-custom-id' });
-};
-
-const setNextBundle = async () => {
-  await LiveUpdate.setNextBundle({ bundleId: '7f0b9bf2-dff6-4be2-bcac-b068cc5ea756' });
-};
-
-const sync = async () => {
-  const result = await LiveUpdate.sync({
-    channel: 'production-5',
-  });
-  return result.nextBundleId;
-};
-
-const isNewBundleAvailable = async () => {
-  const { bundleId: latestBundleId } = await LiveUpdate.fetchLatestBundle({
-    channel: 'production-5',
-  });
-  if (latestBundleId) {
-    const { bundleId: currentBundleId } = await LiveUpdate.getCurrentBundle();
-    return latestBundleId !== currentBundleId;
-  } else {
-    return false;
-  }
-};
 ```
 
 ## API
@@ -1268,7 +1366,7 @@ On Capawesome Cloud, the bundle ID corresponds to the ID of the app build artifa
 There are four ways to set a channel, listed from lowest to highest priority:
 
 1. **Capacitor config**: Set the `defaultChannel` property in the [plugin configuration](#configuration). This is the simplest way to set a static default channel.
-2. **Native config**: Set `CapawesomeLiveUpdateDefaultChannel` in `Info.plist` (iOS) or `capawesome_live_update_default_channel` in `strings.xml` (Android). This is useful for [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/guides/best-practices/#versioned-channels) where the channel is tied to the build version.
+2. **Native config**: Set `CapawesomeLiveUpdateDefaultChannel` in `Info.plist` (iOS) or `capawesome_live_update_default_channel` in `strings.xml` (Android). This is useful for [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/channels/#versioned-channels) where the channel is tied to the build version.
 3. **[`setChannel(...)`](#setchannel)**: Set the channel at runtime. The value is persisted across app restarts.
 4. **[`sync(...)`](#sync)**: Pass a `channel` option to override the channel for a single sync call. This does **not** persist the channel.
 
@@ -1288,6 +1386,27 @@ You then have three options to get back to the default bundle:
 
 However, this is only a problem during development. It is not a problem in production, as Capacitor automatically resets to the default bundle after a native update.
 
+### Do I have to use Capawesome Cloud?
+
+No, the plugin also supports self-hosted bundles. You can download a bundle from any URL using the [`downloadBundle(...)`](#downloadbundle) method and apply it with [`setNextBundle(...)`](#setnextbundle), without any Capawesome Cloud dependency. Capawesome Cloud is only required for the convenience features such as [`sync(...)`](#sync), channels, and rollouts.
+
+### What changes can I ship with a live update?
+
+Live updates are only supported for [binary-compatible changes](https://capawesome.io/docs/cloud/live-updates/faq/#what-are-binary-compatible-changes) such as HTML, CSS, and JavaScript. If you change native code, for example by adding a new plugin, you need to resubmit your app to the app stores. You should therefore [restrict live updates to compatible native versions](https://capawesome.io/blog/how-to-restrict-capacitor-live-updates-to-native-versions/) of your app, as described in the [Limitations](#limitations) section.
+
+### How does the rollback mechanism work?
+
+If the `readyTimeout` configuration option is set, the plugin waits for the app to call the [`ready()`](#ready) method after a new bundle has been applied. If the method is not called within the configured timeout, the plugin assumes the bundle is faulty and resets the app to the default bundle. It is strongly recommended to configure `readyTimeout` (e.g. `10000` ms). Additionally, with the `autoBlockRolledBackBundles` option enabled, bundles that caused a rollback are automatically blocked and skipped in future sync operations.
+
+## Related Plugins
+
+- [App Update](https://capawesome.io/docs/sdks/capacitor/app-update/): Assist users with native app updates, which are required for changes that are not binary-compatible.
+- [Firebase Remote Config](https://capawesome.io/docs/sdks/capacitor/firebase/remote-config/): Change the behavior and appearance of your app remotely without publishing an update.
+
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
 ## Changelog
 
 See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/live-update/CHANGELOG.md).

package/android/build.gradle

@@ -56,6 +56,7 @@ dependencies {
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     implementation "net.lingala.zip4j:zip4j:$zip4jVersion"
     implementation "com.squareup.okhttp3:okhttp:$okhttp3Version"
+    implementation "com.squareup.okhttp3:okhttp-brotli:$okhttp3Version"
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

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

@@ -7,9 +7,11 @@ import android.content.pm.PackageManager;
 import android.content.res.AssetManager;
 import android.os.Build;
 import android.os.Handler;
+import android.os.Looper;
 import android.util.Base64;
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
+import androidx.core.content.pm.PackageInfoCompat;
 import com.getcapacitor.Bridge;
 import com.getcapacitor.Logger;
 import com.getcapacitor.plugin.WebView;
@@ -102,7 +104,7 @@ public class LiveUpdate {
     private final SharedPreferences.Editor webViewSettingsEditor;
 
     private final String bundlesDirectory = "_capacitor_live_update_bundles"; // DO NOT CHANGE!
-    private final Handler rollbackHandler = new Handler();
+    private final Handler rollbackHandler = new Handler(Looper.getMainLooper());
     private final String manifestFileName = "capawesome-live-update-manifest.json"; // DO NOT CHANGE!
 
     private boolean initialPageLoaded = false;
@@ -1050,7 +1052,7 @@ public class LiveUpdate {
             MessageDigest digest = MessageDigest.getInstance("SHA-256");
             BufferedSource source = Okio.buffer(Okio.source(file));
             Buffer buffer = new Buffer();
-            for (long bytesRead; (bytesRead = source.read(buffer, 2048)) != -1;) {
+            for (long bytesRead; (bytesRead = source.read(buffer, 2048)) != -1; ) {
                 digest.update(buffer.readByteArray());
             }
             source.close();
@@ -1173,7 +1175,7 @@ public class LiveUpdate {
     }
 
     private int getVersionCodeAsInt() throws PackageManager.NameNotFoundException {
-        return getPackageInfo().versionCode;
+        return (int) PackageInfoCompat.getLongVersionCode(getPackageInfo());
     }
 
     private String getVersionCodeAsString() throws PackageManager.NameNotFoundException {
@@ -1488,7 +1490,7 @@ public class LiveUpdate {
             sig.initVerify(key);
             BufferedSource source = Okio.buffer(Okio.source(file));
             Buffer buffer = new Buffer();
-            for (long bytesRead; (bytesRead = source.read(buffer, 2048)) != -1;) {
+            for (long bytesRead; (bytesRead = source.read(buffer, 2048)) != -1; ) {
                 sig.update(buffer.readByteArray());
             }
             source.close();

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

@@ -15,6 +15,7 @@ import okhttp3.OkHttpClient;
 import okhttp3.Request;
 import okhttp3.Response;
 import okhttp3.ResponseBody;
+import okhttp3.brotli.BrotliInterceptor;
 import okio.Buffer;
 import okio.BufferedSink;
 import okio.BufferedSource;
@@ -58,6 +59,7 @@ public class LiveUpdateHttpClient {
         dispatcher.setMaxRequestsPerHost(30);
 
         this.okHttpClient = new OkHttpClient.Builder()
+            .addInterceptor(BrotliInterceptor.INSTANCE)
             .dispatcher(dispatcher)
             .connectTimeout(httpTimeout, TimeUnit.MILLISECONDS)
             .readTimeout(httpTimeout, TimeUnit.MILLISECONDS)
@@ -101,7 +103,7 @@ public class LiveUpdateHttpClient {
         Buffer sinkBuffer = sink.getBuffer();
         long totalBytesRead = 0;
         int bufferSize = 8 * 1024;
-        for (long bytesRead; (bytesRead = source.read(sinkBuffer, bufferSize)) != -1;) {
+        for (long bytesRead; (bytesRead = source.read(sinkBuffer, bufferSize)) != -1; ) {
             sink.emit();
             totalBytesRead += bytesRead;
             if (callback != null) {

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

@@ -37,7 +37,7 @@ 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.3.0";
+    public static final String VERSION = "8.4.1";
     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.";
@@ -89,17 +89,16 @@ public class LiveUpdatePlugin extends Plugin {
             // or constructor, it MUST be done here in onResume().
             if (!webViewListenerRegistered) {
                 webViewListenerRegistered = true;
-                getBridge()
-                    .addWebViewListener(
-                        new WebViewListener() {
-                            @Override
-                            public void onPageLoaded(WebView webView) {
-                                if (implementation != null) {
-                                    implementation.handleOnPageLoaded();
-                                }
+                getBridge().addWebViewListener(
+                    new WebViewListener() {
+                        @Override
+                        public void onPageLoaded(WebView webView) {
+                            if (implementation != null) {
+                                implementation.handleOnPageLoaded();
                             }
                         }
-                    );
+                    }
+                );
             }
         } catch (Exception exception) {
             Logger.error(TAG, exception.getMessage(), exception);

package/ios/Plugin/LiveUpdate.swift

@@ -463,7 +463,8 @@ import CommonCrypto
 
     private func downloadAndVerifyFile(url: String, file: URL, checksum: String?, signature: String?, callback: ((Progress) -> Void)?) async throws {
         let destination: DownloadRequest.Destination = { _, _ in
-            return (file, [.createIntermediateDirectories])
+            // `removePreviousFile` ensures that a leftover file from a failed attempt does not fail the download
+            return (file, [.createIntermediateDirectories, .removePreviousFile])
         }
         let urlComponents = URLComponents(string: url)!
         let result = try await httpClient.download(url: urlComponents.asURL(), destination: destination, callback: callback)

package/ios/Plugin/LiveUpdateHttpClient.swift

@@ -27,13 +27,16 @@ public class LiveUpdateHttpClient: NSObject {
 
     public func download(url: URL, destination: @escaping DownloadRequest.Destination, callback: ((Progress) -> Void)?) async throws -> AFDownloadResponse<Data> {
         var request = URLRequest(url: url)
+        // Ignore the URL cache so that a cached response is never replayed for a deterministic request URL
+        request.cachePolicy = .reloadIgnoringLocalCacheData
         request.httpMethod = HTTPMethod.get.rawValue
         request.timeoutInterval = Double(config.httpTimeout) / 1000.0
         if let deviceId = deviceId, !deviceId.isEmpty {
             request.setValue(deviceId, forHTTPHeaderField: "X-Capawesome-Device-Id")
         }
         return try await withCheckedThrowingContinuation { continuation in
-            AF.download(request, to: destination).downloadProgress { progress in
+            // `validate()` treats non-2xx responses as errors so that an error body is never saved as a bundle file
+            AF.download(request, to: destination).validate().downloadProgress { progress in
                 if let callback = callback {
                     callback(progress)
                 }
@@ -45,6 +48,8 @@ public class LiveUpdateHttpClient: NSObject {
 
     public func request<T: Decodable>(url: URL, type: T.Type) async throws -> AFDataResponse<T> {
         var request = URLRequest(url: url)
+        // Ignore the URL cache so that a cached response is never replayed for a deterministic request URL
+        request.cachePolicy = .reloadIgnoringLocalCacheData
         request.httpMethod = HTTPMethod.get.rawValue
         request.timeoutInterval = Double(config.httpTimeout) / 1000.0
         if let deviceId = deviceId, !deviceId.isEmpty {

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.3.0"
+    public static let version = "8.4.1"
     public static let userDefaultsPrefix = "CapawesomeLiveUpdate" // DO NOT CHANGE
 
     public let identifier = "LiveUpdatePlugin"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@capawesome/capacitor-live-update",
-  "version": "8.3.0",
-  "description": "Capacitor plugin to update your app remotely in real-time.",
+  "version": "8.4.1",
+  "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",
   "types": "dist/esm/index.d.ts",
@@ -23,7 +23,7 @@
   "bugs": {
     "url": "https://github.com/capawesome-team/capacitor-plugins/issues"
   },
-  "homepage": "https://capawesome.io/docs/plugins/live-update/",
+  "homepage": "https://capawesome.io/docs/sdks/capacitor/live-update/",
   "funding": [
     {
       "type": "github",
@@ -44,7 +44,14 @@
     "live update",
     "remote update",
     "ota",
-    "capgo"
+    "capgo",
+    "capacitor-plugin",
+    "live updates",
+    "ota update",
+    "over-the-air updates",
+    "code push",
+    "hot update",
+    "bundle management"
   ],
   "scripts": {
     "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
@@ -53,7 +60,7 @@
     "verify:web": "npm run build",
     "e2e:android": "npm install --prefix example && npm run build && npm --prefix example run e2e:android",
     "e2e:ios": "npm install --prefix example && npm run build && npm --prefix example run e2e:ios",
-    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "lint": "npm run version:check && npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
     "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
     "eslint": "eslint . --ext ts",
     "prettier": "prettier \"**/*.{css,html,ts,js,java}\"",
@@ -63,20 +70,21 @@
     "clean": "rimraf ./dist",
     "watch": "tsc --watch",
     "version": "node scripts/sync-plugin-version.mjs",
+    "version:check": "node scripts/sync-plugin-version.mjs --check",
     "ios:pod:install": "cd ios && pod install --repo-update && cd ..",
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
     "@capacitor/android": "8.0.0",
-    "@capacitor/cli": "8.0.0",
+    "@capacitor/cli": "8.4.2",
     "@capacitor/core": "8.0.0",
     "@capacitor/docgen": "0.3.1",
     "@capacitor/ios": "8.0.0",
     "@ionic/eslint-config": "0.4.0",
     "eslint": "8.57.0",
-    "prettier-plugin-java": "2.6.7",
+    "prettier-plugin-java": "2.9.7",
     "rimraf": "6.1.2",
-    "rollup": "4.53.3",
+    "rollup": "4.62.3",
     "swiftlint": "2.0.0",
     "typescript": "5.9.3"
   },