@capawesome/capacitor-live-update 7.3.0 → 7.4.0-dev.f18299f8.1767510052

package/README.md

@@ -56,13 +56,16 @@ npx cap sync
 
 #### Variables
 
-If needed, you can define the following project variable in your app’s `variables.gradle` file to change the default version of the dependency:
+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: `22.3.1`)
+- `$okhttp3Version` version of `com.squareup.okhttp3:okhttp` (default: `4.12.0`)
 - `$zip4jVersion` version of `net.lingala.zip4j:zip4j` (default: `2.11.5`)
+- `$conscryptVersion` version of `org.conscrypt:conscrypt-android` (default: `2.5.3`)
 
 This can be useful if you encounter dependency conflicts with other plugins in your project.
 
+**Note**: The plugin uses Google Conscrypt as the security provider to ensure better SSL/TLS certificate compatibility on older Android versions (especially Android 7 and below).
+
 ### iOS
 
 #### Privacy manifest
@@ -273,26 +276,34 @@ const isNewBundleAvailable = async () => {
 
 <docgen-index>
 
+* [`clearBlockedBundles()`](#clearblockedbundles)
 * [`deleteBundle(...)`](#deletebundle)
 * [`downloadBundle(...)`](#downloadbundle)
 * [`fetchLatestBundle(...)`](#fetchlatestbundle)
+* [`getBlockedBundles()`](#getblockedbundles)
 * [`getBundles()`](#getbundles)
 * [`getChannel()`](#getchannel)
+* [`getConfig()`](#getconfig)
+* [`getDownloadedBundles()`](#getdownloadedbundles)
 * [`getCurrentBundle()`](#getcurrentbundle)
 * [`getCustomId()`](#getcustomid)
 * [`getDeviceId()`](#getdeviceid)
+* [`isSyncing()`](#issyncing)
 * [`getNextBundle()`](#getnextbundle)
 * [`getVersionCode()`](#getversioncode)
 * [`getVersionName()`](#getversionname)
 * [`ready()`](#ready)
 * [`reload()`](#reload)
 * [`reset()`](#reset)
+* [`resetConfig()`](#resetconfig)
 * [`setChannel(...)`](#setchannel)
+* [`setConfig(...)`](#setconfig)
 * [`setCustomId(...)`](#setcustomid)
 * [`setNextBundle(...)`](#setnextbundle)
 * [`sync(...)`](#sync)
 * [`addListener('downloadBundleProgress', ...)`](#addlistenerdownloadbundleprogress-)
 * [`addListener('nextBundleSet', ...)`](#addlistenernextbundleset-)
+* [`addListener('reloaded', ...)`](#addlistenerreloaded-)
 * [`removeAllListeners()`](#removealllisteners)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
@@ -302,6 +313,24 @@ const isNewBundleAvailable = async () => {
 <docgen-api>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
+### clearBlockedBundles()
+
+```typescript
+clearBlockedBundles() => Promise<void>
+```
+
+Clear all blocked bundles from the blocked list.
+
+This removes all bundle identifiers that were automatically blocked
+due to rollbacks when `autoBlockRolledBackBundles` is enabled.
+
+Only available on Android and iOS.
+
+**Since:** 7.4.0
+
+--------------------
+
+
 ### deleteBundle(...)
 
 ```typescript
@@ -361,6 +390,26 @@ Only available on Android and iOS.
 --------------------
 
 
+### getBlockedBundles()
+
+```typescript
+getBlockedBundles() => Promise<GetBlockedBundlesResult>
+```
+
+Get all blocked bundle identifiers.
+
+Returns the list of bundle identifiers that were automatically blocked
+due to rollbacks when `autoBlockRolledBackBundles` is enabled.
+
+Only available on Android and iOS.
+
+**Returns:** <code>Promise&lt;<a href="#getblockedbundlesresult">GetBlockedBundlesResult</a>&gt;</code>
+
+**Since:** 7.4.0
+
+--------------------
+
+
 ### getBundles()
 
 ```typescript
@@ -395,6 +444,43 @@ Only available on Android and iOS.
 --------------------
 
 
+### getConfig()
+
+```typescript
+getConfig() => Promise<GetConfigResult>
+```
+
+Get the runtime configuration.
+
+Returns the current plugin configuration including any runtime
+overrides set via `setConfig()`.
+
+Only available on Android and iOS.
+
+**Returns:** <code>Promise&lt;<a href="#getconfigresult">GetConfigResult</a>&gt;</code>
+
+**Since:** 7.4.0
+
+--------------------
+
+
+### getDownloadedBundles()
+
+```typescript
+getDownloadedBundles() => Promise<GetDownloadedBundlesResult>
+```
+
+Get all identifiers of bundles that have been downloaded.
+
+Only available on Android and iOS.
+
+**Returns:** <code>Promise&lt;<a href="#getdownloadedbundlesresult">GetDownloadedBundlesResult</a>&gt;</code>
+
+**Since:** 7.4.0
+
+--------------------
+
+
 ### getCurrentBundle()
 
 ```typescript
@@ -447,6 +533,23 @@ Only available on Android and iOS.
 --------------------
 
 
+### isSyncing()
+
+```typescript
+isSyncing() => Promise<IsSyncingResult>
+```
+
+Check whether a sync operation is currently in progress.
+
+Only available on Android and iOS.
+
+**Returns:** <code>Promise&lt;<a href="#issyncingresult">IsSyncingResult</a>&gt;</code>
+
+**Since:** 7.4.0
+
+--------------------
+
+
 ### getNextBundle()
 
 ```typescript
@@ -558,6 +661,24 @@ Only available on Android and iOS.
 --------------------
 
 
+### resetConfig()
+
+```typescript
+resetConfig() => Promise<void>
+```
+
+Reset the runtime configuration to the values from the Capacitor config file.
+
+This clears any runtime configuration set via `setConfig()`.
+The changes take effect immediately.
+
+Only available on Android and iOS.
+
+**Since:** 7.4.0
+
+--------------------
+
+
 ### setChannel(...)
 
 ```typescript
@@ -577,6 +698,32 @@ Only available on Android and iOS.
 --------------------
 
 
+### setConfig(...)
+
+```typescript
+setConfig(options: SetConfigOptions) => Promise<void>
+```
+
+Set the runtime configuration.
+
+This allows updating plugin configuration options at runtime.
+The changes are persisted across app restarts and take effect immediately.
+
+**Important:** Runtime configuration is automatically reset to default values
+whenever the native app is updated to a new version. This ensures that
+configuration from previous versions doesn't persist after an app update.
+
+Only available on Android and iOS.
+
+| Param         | Type                                                          |
+| ------------- | ------------------------------------------------------------- |
+| **`options`** | <code><a href="#setconfigoptions">SetConfigOptions</a></code> |
+
+**Since:** 7.4.0
+
+--------------------
+
+
 ### setCustomId(...)
 
 ```typescript
@@ -687,6 +834,35 @@ Only available on Android and iOS.
 --------------------
 
 
+### addListener('reloaded', ...)
+
+```typescript
+addListener(eventName: 'reloaded', listenerFunc: ReloadedListener) => Promise<PluginListenerHandle>
+```
+
+Listen for when the app is reloaded.
+
+This event is triggered after the `reload()` method is called
+and the app has been reloaded.
+
+**Note:** To verify whether an update was successfully applied after a reload,
+use the `ready()` method instead. The `ready()` method provides detailed information
+about the current bundle, previous bundle, and whether a rollback occurred.
+
+Only available on Android and iOS.
+
+| Param              | Type                                                          |
+| ------------------ | ------------------------------------------------------------- |
+| **`eventName`**    | <code>'reloaded'</code>                                       |
+| **`listenerFunc`** | <code><a href="#reloadedlistener">ReloadedListener</a></code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 7.4.0
+
+--------------------
+
+
 ### removeAllListeners()
 
 ```typescript
@@ -740,6 +916,13 @@ Remove all listeners for this plugin.
 | **`channel`** | <code>string</code> | The name of the channel where the latest bundle is fetched from. | 6.7.0 |
 
 
+#### GetBlockedBundlesResult
+
+| Prop            | Type                  | Description                                            | Since |
+| --------------- | --------------------- | ------------------------------------------------------ | ----- |
+| **`bundleIds`** | <code>string[]</code> | An array of unique identifiers of all blocked bundles. | 7.4.0 |
+
+
 #### GetBundlesResult
 
 | Prop            | Type                  | Description                                              | Since |
@@ -754,6 +937,21 @@ Remove all listeners for this plugin.
 | **`channel`** | <code>string \| null</code> | The channel name. If `null`, the app is using the default channel. | 5.0.0 |
 
 
+#### GetConfigResult
+
+| Prop                     | Type                                | Description                                                              | Since |
+| ------------------------ | ----------------------------------- | ------------------------------------------------------------------------ | ----- |
+| **`appId`**              | <code>string \| null</code>         | The app ID used to identify the app. If `null`, no app ID is configured. | 7.4.0 |
+| **`autoUpdateStrategy`** | <code>'none' \| 'background'</code> | The auto-update strategy for live updates.                               | 7.4.0 |
+
+
+#### GetDownloadedBundlesResult
+
+| Prop            | Type                  | Description                                               | Since |
+| --------------- | --------------------- | --------------------------------------------------------- | ----- |
+| **`bundleIds`** | <code>string[]</code> | An array of unique identifiers of all downloaded bundles. | 7.4.0 |
+
+
 #### GetCurrentBundleResult
 
 | Prop           | Type                        | Description                                                                               | Since |
@@ -775,6 +973,13 @@ Remove all listeners for this plugin.
 | **`deviceId`** | <code>string</code> | The unique identifier of the device. On iOS, [`identifierForVendor`](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor) is used. The value of this property is the same for apps that come from the same vendor running on the same device. | 5.0.0 |
 
 
+#### IsSyncingResult
+
+| Prop          | Type                 | Description                                        | Since |
+| ------------- | -------------------- | -------------------------------------------------- | ----- |
+| **`syncing`** | <code>boolean</code> | Whether a sync operation is currently in progress. | 7.4.0 |
+
+
 #### GetNextBundleResult
 
 | Prop           | Type                        | Description                                                                            | Since |
@@ -812,6 +1017,13 @@ Remove all listeners for this plugin.
 | **`channel`** | <code>string \| null</code> | The channel name. Set `null` to remove the channel. | 5.0.0 |
 
 
+#### SetConfigOptions
+
+| Prop        | Type                        | Description                                                                                           | Since |
+| ----------- | --------------------------- | ----------------------------------------------------------------------------------------------------- | ----- |
+| **`appId`** | <code>string \| null</code> | The app ID used to identify the app. Set `null` to reset to the value from the Capacitor config file. | 7.4.0 |
+
+
 #### SetCustomIdOptions
 
 | Prop           | Type                        | Description                                                                      | Since |
@@ -884,6 +1096,13 @@ Listener for when a bundle is set as the next bundle.
 
 <code>(event: <a href="#nextbundlesetevent">NextBundleSetEvent</a>): void</code>
 
+
+#### ReloadedListener
+
+Listener for when the app is reloaded.
+
+<code>(): void</code>
+
 </docgen-api>
 
 ## Testing

package/android/build.gradle

@@ -5,6 +5,7 @@ ext {
     androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
     okhttp3Version = project.hasProperty('okhttp3Version') ? rootProject.ext.okhttp3Version : '4.12.0'
     zip4jVersion = project.hasProperty('zip4jVersion') ? rootProject.ext.zip4jVersion : '2.11.5'
+    conscryptVersion = project.hasProperty('conscryptVersion') ? rootProject.ext.conscryptVersion : '2.5.3'
 }
 
 buildscript {
@@ -56,6 +57,7 @@ dependencies {
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     implementation "net.lingala.zip4j:zip4j:$zip4jVersion"
     implementation "com.squareup.okhttp3:okhttp:$okhttp3Version"
+    implementation "org.conscrypt:conscrypt-android:$conscryptVersion"
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"