UNPKG

@capawesome/capacitor-live-update

Version:

Capacitor plugin to update your app remotely in real-time.

1,752 lines 53.5 kB
{ "api": { "name": "LiveUpdatePlugin", "slug": "liveupdateplugin", "docs": "", "tags": [], "methods": [ { "name": "clearBlockedBundles", "signature": "() => Promise<void>", "parameters": [], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "7.4.0" } ], "docs": "Clear all blocked bundles from the blocked list.\n\nThis removes all bundle identifiers that were automatically blocked\ndue to rollbacks when `autoBlockRolledBackBundles` is enabled.\n\nOnly available on Android and iOS.", "complexTypes": [], "slug": "clearblockedbundles" }, { "name": "deleteBundle", "signature": "(options: DeleteBundleOptions) => Promise<void>", "parameters": [ { "name": "options", "docs": "", "type": "DeleteBundleOptions" } ], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Delete a bundle from the app.\n\nOnly available on Android and iOS.", "complexTypes": [ "DeleteBundleOptions" ], "slug": "deletebundle" }, { "name": "downloadBundle", "signature": "(options: DownloadBundleOptions) => Promise<void>", "parameters": [ { "name": "options", "docs": "", "type": "DownloadBundleOptions" } ], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Download a bundle.\n\nOnly available on Android and iOS.", "complexTypes": [ "DownloadBundleOptions" ], "slug": "downloadbundle" }, { "name": "fetchChannels", "signature": "(options?: FetchChannelsOptions | undefined) => Promise<FetchChannelsResult>", "parameters": [ { "name": "options", "docs": "", "type": "FetchChannelsOptions | undefined" } ], "returns": "Promise<FetchChannelsResult>", "tags": [ { "name": "since", "text": "8.2.0" } ], "docs": "Fetch channels from [Capawesome Cloud](https://capawesome.io/cloud/).\n\nThis is primarily intended for development and QA purposes.\nIt allows you to retrieve a list of available channels so you can\ndynamically switch between them using `setChannel(...)`.\n\n**Attention**: Only works for apps with public channels enabled.\nIf channels are private, they can still be set using `setChannel(...)`\nbut won't be returned by this method.\n\nOnly available on Android and iOS.", "complexTypes": [ "FetchChannelsResult", "FetchChannelsOptions" ], "slug": "fetchchannels" }, { "name": "fetchLatestBundle", "signature": "(options?: FetchLatestBundleOptions | undefined) => Promise<FetchLatestBundleResult>", "parameters": [ { "name": "options", "docs": "", "type": "FetchLatestBundleOptions | undefined" } ], "returns": "Promise<FetchLatestBundleResult>", "tags": [ { "name": "since", "text": "6.6.0" } ], "docs": "Fetch the latest bundle using the [Capawesome Cloud](https://capawesome.io/cloud/).\n\nOnly available on Android and iOS.", "complexTypes": [ "FetchLatestBundleResult", "FetchLatestBundleOptions" ], "slug": "fetchlatestbundle" }, { "name": "getBlockedBundles", "signature": "() => Promise<GetBlockedBundlesResult>", "parameters": [], "returns": "Promise<GetBlockedBundlesResult>", "tags": [ { "name": "since", "text": "7.4.0" } ], "docs": "Get all blocked bundle identifiers.\n\nReturns the list of bundle identifiers that were automatically blocked\ndue to rollbacks when `autoBlockRolledBackBundles` is enabled.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetBlockedBundlesResult" ], "slug": "getblockedbundles" }, { "name": "getBundles", "signature": "() => Promise<GetBundlesResult>", "parameters": [], "returns": "Promise<GetBundlesResult>", "tags": [ { "name": "since", "text": "5.0.0" }, { "name": "deprecated", "text": "Use `getDownloadedBundles()` instead." } ], "docs": "Get all identifiers of bundles that have been downloaded.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetBundlesResult" ], "slug": "getbundles" }, { "name": "getChannel", "signature": "() => Promise<GetChannelResult>", "parameters": [], "returns": "Promise<GetChannelResult>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Get the channel that is used for the update.\n\nThe channel is resolved in the following order (highest priority first):\n1. `setChannel()` (SharedPreferences on Android / UserDefaults on iOS)\n2. Native config (`CapawesomeLiveUpdateDefaultChannel` in `Info.plist` on iOS or\n `capawesome_live_update_default_channel` in `strings.xml` on Android)\n3. Capacitor config `defaultChannel`\n\n**Note**: The `channel` parameter of `sync()` takes the highest priority\nbut is not persisted and therefore not returned by this method.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetChannelResult" ], "slug": "getchannel" }, { "name": "getConfig", "signature": "() => Promise<GetConfigResult>", "parameters": [], "returns": "Promise<GetConfigResult>", "tags": [ { "name": "since", "text": "7.4.0" } ], "docs": "Get the runtime configuration.\n\nReturns the current plugin configuration including any runtime\noverrides set via `setConfig()`.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetConfigResult" ], "slug": "getconfig" }, { "name": "getDownloadedBundles", "signature": "() => Promise<GetDownloadedBundlesResult>", "parameters": [], "returns": "Promise<GetDownloadedBundlesResult>", "tags": [ { "name": "since", "text": "7.4.0" } ], "docs": "Get all identifiers of bundles that have been downloaded.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetDownloadedBundlesResult" ], "slug": "getdownloadedbundles" }, { "name": "getCurrentBundle", "signature": "() => Promise<GetCurrentBundleResult>", "parameters": [], "returns": "Promise<GetCurrentBundleResult>", "tags": [ { "name": "since", "text": "6.7.0" } ], "docs": "Get the bundle identifier of the current bundle.\nThe current bundle is the bundle that is currently used by the app.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetCurrentBundleResult" ], "slug": "getcurrentbundle" }, { "name": "getCustomId", "signature": "() => Promise<GetCustomIdResult>", "parameters": [], "returns": "Promise<GetCustomIdResult>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Get the custom identifier of the device.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetCustomIdResult" ], "slug": "getcustomid" }, { "name": "getDeviceId", "signature": "() => Promise<GetDeviceIdResult>", "parameters": [], "returns": "Promise<GetDeviceIdResult>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Get the unique device identifier.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetDeviceIdResult" ], "slug": "getdeviceid" }, { "name": "isSyncing", "signature": "() => Promise<IsSyncingResult>", "parameters": [], "returns": "Promise<IsSyncingResult>", "tags": [ { "name": "since", "text": "7.4.0" } ], "docs": "Check whether a sync operation is currently in progress.\n\nOnly available on Android and iOS.", "complexTypes": [ "IsSyncingResult" ], "slug": "issyncing" }, { "name": "getNextBundle", "signature": "() => Promise<GetNextBundleResult>", "parameters": [], "returns": "Promise<GetNextBundleResult>", "tags": [ { "name": "since", "text": "6.7.0" } ], "docs": "Get the bundle identifier of the next bundle.\nThe next bundle is the bundle that will be used after calling `reload()`\nor restarting the app.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetNextBundleResult" ], "slug": "getnextbundle" }, { "name": "getVersionCode", "signature": "() => Promise<GetVersionCodeResult>", "parameters": [], "returns": "Promise<GetVersionCodeResult>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Get the version code of the app.\n\nOn **Android**, this is the `versionCode` from the `android/app/build.gradle` file.\nOn **iOS**, this is the `CFBundleVersion` from the `Info.plist` file.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetVersionCodeResult" ], "slug": "getversioncode" }, { "name": "getVersionName", "signature": "() => Promise<GetVersionNameResult>", "parameters": [], "returns": "Promise<GetVersionNameResult>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Get the version name of the app.\n\nOn **Android**, this is the `versionName` from the `android/app/build.gradle` file.\nOn **iOS**, this is the `CFBundleShortVersionString` from the `Info.plist` file.\n\nOnly available on Android and iOS.", "complexTypes": [ "GetVersionNameResult" ], "slug": "getversionname" }, { "name": "ready", "signature": "() => Promise<ReadyResult>", "parameters": [], "returns": "Promise<ReadyResult>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Notify the plugin that the app is ready to use and no rollback is needed.\n\n**Attention**: This method should be called as soon as the app is ready to use\nto prevent the app from being reset to the default bundle.\n\nOnly available on Android and iOS.", "complexTypes": [ "ReadyResult" ], "slug": "ready" }, { "name": "reload", "signature": "() => Promise<void>", "parameters": [], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Reload the app to apply the new bundle.\n\nOnly available on Android and iOS.", "complexTypes": [], "slug": "reload" }, { "name": "reset", "signature": "() => Promise<void>", "parameters": [], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Reset the app to the default bundle.\n\nCall `reload()` or restart the app to apply the changes.\n\nOnly available on Android and iOS.", "complexTypes": [], "slug": "reset" }, { "name": "resetConfig", "signature": "() => Promise<void>", "parameters": [], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "7.4.0" } ], "docs": "Reset the runtime configuration to the values from the Capacitor config file.\n\nThis clears any runtime configuration set via `setConfig()`.\nThe changes take effect immediately.\n\nOnly available on Android and iOS.", "complexTypes": [], "slug": "resetconfig" }, { "name": "setChannel", "signature": "(options: SetChannelOptions) => Promise<void>", "parameters": [ { "name": "options", "docs": "", "type": "SetChannelOptions" } ], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Set the channel to use for the update.\n\nOnly available on Android and iOS.", "complexTypes": [ "SetChannelOptions" ], "slug": "setchannel" }, { "name": "setConfig", "signature": "(options: SetConfigOptions) => Promise<void>", "parameters": [ { "name": "options", "docs": "", "type": "SetConfigOptions" } ], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "7.4.0" } ], "docs": "Set the runtime configuration.\n\nThis allows updating plugin configuration options at runtime.\nThe changes are persisted across app restarts and take effect immediately.\n\n**Important:** Runtime configuration is automatically reset to default values\nwhenever the native app is updated to a new version. This ensures that\nconfiguration from previous versions doesn't persist after an app update.\n\nOnly available on Android and iOS.", "complexTypes": [ "SetConfigOptions" ], "slug": "setconfig" }, { "name": "setCustomId", "signature": "(options: SetCustomIdOptions) => Promise<void>", "parameters": [ { "name": "options", "docs": "", "type": "SetCustomIdOptions" } ], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Set the custom identifier of the device.\n\nOnly available on Android and iOS.", "complexTypes": [ "SetCustomIdOptions" ], "slug": "setcustomid" }, { "name": "setNextBundle", "signature": "(options: SetNextBundleOptions) => Promise<void>", "parameters": [ { "name": "options", "docs": "", "type": "SetNextBundleOptions" } ], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "6.7.0" } ], "docs": "Set the next bundle to use for the app.\n\nCall `reload()` or restart the app to apply the changes.\n\nOnly available on Android and iOS.", "complexTypes": [ "SetNextBundleOptions" ], "slug": "setnextbundle" }, { "name": "sync", "signature": "(options?: SyncOptions | undefined) => Promise<SyncResult>", "parameters": [ { "name": "options", "docs": "", "type": "SyncOptions | undefined" } ], "returns": "Promise<SyncResult>", "tags": [ { "name": "since", "text": "5.0.0" } ], "docs": "Automatically download and set the latest bundle for the app using the [Capawesome Cloud](https://capawesome.io/cloud/).\n\nCall `reload()` or restart the app to apply the changes.\n\nOnly available on Android and iOS.", "complexTypes": [ "SyncResult", "SyncOptions" ], "slug": "sync" }, { "name": "addListener", "signature": "(eventName: 'downloadBundleProgress', listenerFunc: DownloadBundleProgressListener) => Promise<PluginListenerHandle>", "parameters": [ { "name": "eventName", "docs": "", "type": "'downloadBundleProgress'" }, { "name": "listenerFunc", "docs": "", "type": "DownloadBundleProgressListener" } ], "returns": "Promise<PluginListenerHandle>", "tags": [ { "name": "since", "text": "7.0.0" } ], "docs": "Listen for the download progress of a bundle.\n\nOnly available on Android and iOS.", "complexTypes": [ "PluginListenerHandle", "DownloadBundleProgressListener" ], "slug": "addlistenerdownloadbundleprogress-" }, { "name": "addListener", "signature": "(eventName: 'nextBundleSet', listenerFunc: NextBundleSetListener) => Promise<PluginListenerHandle>", "parameters": [ { "name": "eventName", "docs": "", "type": "'nextBundleSet'" }, { "name": "listenerFunc", "docs": "", "type": "NextBundleSetListener" } ], "returns": "Promise<PluginListenerHandle>", "tags": [ { "name": "since", "text": "7.3.0" } ], "docs": "Listen for when a bundle is set as the next bundle.\n\nThis event is triggered whenever a bundle is set to be used on the next app restart,\neither through automatic updates or manual calls to `setNextBundle()`.\n\nOnly available on Android and iOS.", "complexTypes": [ "PluginListenerHandle", "NextBundleSetListener" ], "slug": "addlistenernextbundleset-" }, { "name": "addListener", "signature": "(eventName: 'reloaded', listenerFunc: ReloadedListener) => Promise<PluginListenerHandle>", "parameters": [ { "name": "eventName", "docs": "", "type": "'reloaded'" }, { "name": "listenerFunc", "docs": "", "type": "ReloadedListener" } ], "returns": "Promise<PluginListenerHandle>", "tags": [ { "name": "since", "text": "7.4.0" } ], "docs": "Listen for when the app is reloaded.\n\nThis event is triggered after the `reload()` method is called\nand the app has been reloaded.\n\n**Note:** To verify whether an update was successfully applied after a reload,\nuse the `ready()` method instead. The `ready()` method provides detailed information\nabout the current bundle, previous bundle, and whether a rollback occurred.\n\nOnly available on Android and iOS.", "complexTypes": [ "PluginListenerHandle", "ReloadedListener" ], "slug": "addlistenerreloaded-" }, { "name": "removeAllListeners", "signature": "() => Promise<void>", "parameters": [], "returns": "Promise<void>", "tags": [ { "name": "since", "text": "7.2.0" } ], "docs": "Remove all listeners for this plugin.", "complexTypes": [], "slug": "removealllisteners" } ], "properties": [] }, "interfaces": [ { "name": "DeleteBundleOptions", "slug": "deletebundleoptions", "docs": "", "tags": [ { "text": "5.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "bundleId", "tags": [ { "text": "5.0.0", "name": "since" }, { "text": "'1.0.0'", "name": "example" } ], "docs": "The unique identifier of the bundle to delete.", "complexTypes": [], "type": "string" } ] }, { "name": "DownloadBundleOptions", "slug": "downloadbundleoptions", "docs": "", "tags": [], "methods": [], "properties": [ { "name": "artifactType", "tags": [ { "text": "6.6.0", "name": "since" }, { "text": "'zip'", "name": "default" }, { "text": "'manifest'", "name": "example" } ], "docs": "The artifact type of the bundle.", "complexTypes": [], "type": "'manifest' | 'zip' | undefined" }, { "name": "bundleId", "tags": [ { "text": "5.0.0", "name": "since" }, { "text": "'1.0.0'", "name": "example" } ], "docs": "The unique identifier of the bundle.\n\n**Attention**: The value `public` is reserved and cannot be used as a bundle identifier.", "complexTypes": [], "type": "string" }, { "name": "checksum", "tags": [ { "text": "7.1.0", "name": "since" } ], "docs": "The checksum of the self-hosted bundle as a SHA-256 hash\nin hex format to verify the integrity of the bundle.\n\n**Attention**: Only supported for the `zip` artifact type.", "complexTypes": [], "type": "string | undefined" }, { "name": "signature", "tags": [ { "text": "7.1.0", "name": "since" } ], "docs": "The signature of the self-hosted bundle as a signed SHA-256 hash\nin base64 format to verify the integrity of the bundle.\n\n**Attention**: Only supported for the `zip` artifact type.", "complexTypes": [], "type": "string | undefined" }, { "name": "url", "tags": [ { "text": "5.0.0", "name": "since" }, { "text": "'https://example.com/bundle.zip'", "name": "example" } ], "docs": "The URL of the bundle to download.\n\nFor the `zip` artifact type, the URL must point to a ZIP file.\nFor the `manifest` artifact type, the URL serves as the base URL\nto download the individual files. For example, if the URL is\n`https://example.com/download`, the plugin will download the file\nwith the href `index.html` from `https://example.com/download?href=index.html`.\n\nTo **verify the integrity** of the file, the server should return\na `X-Checksum` header with the SHA-256 hash in hex format.\n\nTo **verify the signature** of the file, the server should return\na `X-Signature` header with the signed SHA-256 hash in base64 format.", "complexTypes": [], "type": "string" } ] }, { "name": "FetchChannelsResult", "slug": "fetchchannelsresult", "docs": "", "tags": [ { "text": "8.2.0", "name": "since" } ], "methods": [], "properties": [ { "name": "channels", "tags": [ { "text": "8.2.0", "name": "since" } ], "docs": "The list of channels.", "complexTypes": [ "Channel" ], "type": "Channel[]" } ] }, { "name": "Channel", "slug": "channel", "docs": "", "tags": [ { "text": "8.2.0", "name": "since" } ], "methods": [], "properties": [ { "name": "id", "tags": [ { "text": "8.2.0", "name": "since" } ], "docs": "The unique identifier of the channel.", "complexTypes": [], "type": "string" }, { "name": "name", "tags": [ { "text": "8.2.0", "name": "since" } ], "docs": "The name of the channel.", "complexTypes": [], "type": "string" } ] }, { "name": "FetchChannelsOptions", "slug": "fetchchannelsoptions", "docs": "", "tags": [ { "text": "8.2.0", "name": "since" } ], "methods": [], "properties": [ { "name": "limit", "tags": [ { "text": "8.2.0", "name": "since" }, { "text": "50", "name": "default" } ], "docs": "The maximum number of channels to return.", "complexTypes": [], "type": "number | undefined" }, { "name": "offset", "tags": [ { "text": "8.2.0", "name": "since" }, { "text": "0", "name": "default" } ], "docs": "The number of channels to skip.", "complexTypes": [], "type": "number | undefined" }, { "name": "query", "tags": [ { "text": "8.2.0", "name": "since" } ], "docs": "The query to filter channels by name.", "complexTypes": [], "type": "string | undefined" } ] }, { "name": "FetchLatestBundleResult", "slug": "fetchlatestbundleresult", "docs": "", "tags": [ { "text": "6.6.0", "name": "since" } ], "methods": [], "properties": [ { "name": "artifactType", "tags": [ { "text": "6.7.0", "name": "since" } ], "docs": "The artifact type of the bundle.", "complexTypes": [], "type": "'manifest' | 'zip' | undefined" }, { "name": "bundleId", "tags": [ { "text": "6.6.0", "name": "since" } ], "docs": "The unique identifier of the latest bundle.\n\nOn Capawesome Cloud, this is the ID of the app build artifact.\n\nIf `null`, no bundle is available.", "complexTypes": [], "type": "string | null" }, { "name": "checksum", "tags": [ { "text": "7.1.0", "name": "since" } ], "docs": "The checksum of the latest bundle if the bundle is self-hosted.\n\nIf the bundle is hosted on Capawesome Cloud, the checksum will be\nreturned as response header when downloading the bundle.", "complexTypes": [], "type": "string | undefined" }, { "name": "customProperties", "tags": [ { "text": "7.0.0", "name": "since" }, { "text": "{ \"key\": \"value\" }", "name": "example" } ], "docs": "Custom properties that are associated with the latest bundle.", "complexTypes": [], "type": "{ [key: string]: string; } | undefined" }, { "name": "downloadUrl", "tags": [ { "text": "6.7.0", "name": "since" } ], "docs": "The URL of the latest bundle to download.\nPass this URL to the `downloadBundle(...)` method to download the bundle.", "complexTypes": [], "type": "string | undefined" }, { "name": "signature", "tags": [ { "text": "7.1.0", "name": "since" } ], "docs": "The signature of the latest bundle if the bundle is self-hosted.\n\nIf the bundle is hosted on Capawesome Cloud, the signature will be\nreturned as response header when downloading the bundle.", "complexTypes": [], "type": "string | undefined" } ] }, { "name": "FetchLatestBundleOptions", "slug": "fetchlatestbundleoptions", "docs": "", "tags": [ { "text": "6.7.0", "name": "since" } ], "methods": [], "properties": [ { "name": "channel", "tags": [ { "text": "6.7.0", "name": "since" } ], "docs": "The name of the channel where the latest bundle is fetched from.", "complexTypes": [], "type": "string | undefined" } ] }, { "name": "GetBlockedBundlesResult", "slug": "getblockedbundlesresult", "docs": "", "tags": [ { "text": "7.4.0", "name": "since" } ], "methods": [], "properties": [ { "name": "bundleIds", "tags": [ { "text": "7.4.0", "name": "since" } ], "docs": "An array of unique identifiers of all blocked bundles.", "complexTypes": [], "type": "string[]" } ] }, { "name": "GetBundlesResult", "slug": "getbundlesresult", "docs": "", "tags": [ { "text": "5.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "bundleIds", "tags": [ { "text": "5.0.0", "name": "since" } ], "docs": "An array of unique identifiers of all available bundles.", "complexTypes": [], "type": "string[]" } ] }, { "name": "GetChannelResult", "slug": "getchannelresult", "docs": "", "tags": [ { "text": "5.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "channel", "tags": [ { "text": "5.0.0", "name": "since" }, { "text": "'production'", "name": "example" } ], "docs": "The channel name.\n\nIf `null`, the app is using the default channel.", "complexTypes": [], "type": "string | null" } ] }, { "name": "GetConfigResult", "slug": "getconfigresult", "docs": "", "tags": [ { "text": "7.4.0", "name": "since" } ], "methods": [], "properties": [ { "name": "appId", "tags": [ { "text": "7.4.0", "name": "since" }, { "text": "'6e351b4f-69a7-415e-a057-4567df7ffe94'", "name": "example" } ], "docs": "The app ID used to identify the app.\n\nIf `null`, no app ID is configured.", "complexTypes": [], "type": "string | null" }, { "name": "autoUpdateStrategy", "tags": [ { "text": "7.4.0", "name": "since" }, { "text": "'background'", "name": "example" } ], "docs": "The auto-update strategy for live updates.", "complexTypes": [], "type": "'none' | 'background'" } ] }, { "name": "GetDownloadedBundlesResult", "slug": "getdownloadedbundlesresult", "docs": "", "tags": [ { "text": "7.4.0", "name": "since" } ], "methods": [], "properties": [ { "name": "bundleIds", "tags": [ { "text": "7.4.0", "name": "since" } ], "docs": "An array of unique identifiers of all downloaded bundles.", "complexTypes": [], "type": "string[]" } ] }, { "name": "GetCurrentBundleResult", "slug": "getcurrentbundleresult", "docs": "", "tags": [ { "text": "6.7.0", "name": "since" } ], "methods": [], "properties": [ { "name": "bundleId", "tags": [ { "text": "6.7.0", "name": "since" } ], "docs": "The unique identifier of the current bundle.\n\nIf `null`, the default bundle is being used.", "complexTypes": [], "type": "string | null" } ] }, { "name": "GetCustomIdResult", "slug": "getcustomidresult", "docs": "", "tags": [ { "text": "5.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "customId", "tags": [ { "text": "5.0.0", "name": "since" }, { "text": "'50d2a548-80b7-4dad-adc7-97c0e79d8a89'", "name": "example" } ], "docs": "The custom identifier of the device.\n\nIf `null`, no custom identifier is set.", "complexTypes": [], "type": "string | null" } ] }, { "name": "GetDeviceIdResult", "slug": "getdeviceidresult", "docs": "", "tags": [ { "text": "5.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "deviceId", "tags": [ { "text": "5.0.0", "name": "since" }, { "text": "'50d2a548-80b7-4dad-adc7-97c0e79d8a89'", "name": "example" } ], "docs": "The unique identifier of the device.\n\nOn iOS, [`identifierForVendor`](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor) is used.\nThe value of this property is the same for apps that come from the same vendor running on the same device.", "complexTypes": [], "type": "string" } ] }, { "name": "IsSyncingResult", "slug": "issyncingresult", "docs": "", "tags": [ { "text": "7.4.0", "name": "since" } ], "methods": [], "properties": [ { "name": "syncing", "tags": [ { "text": "7.4.0", "name": "since" } ], "docs": "Whether a sync operation is currently in progress.", "complexTypes": [], "type": "boolean" } ] }, { "name": "GetNextBundleResult", "slug": "getnextbundleresult", "docs": "", "tags": [ { "text": "6.7.0", "name": "since" } ], "methods": [], "properties": [ { "name": "bundleId", "tags": [ { "text": "6.7.0", "name": "since" } ], "docs": "The unique identifier of the next bundle.\n\nIf `null`, the default bundle is being used.", "complexTypes": [], "type": "string | null" } ] }, { "name": "GetVersionCodeResult", "slug": "getversioncoderesult", "docs": "", "tags": [ { "text": "5.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "versionCode", "tags": [ { "text": "5.0.0", "name": "since" }, { "text": "\"1\"", "name": "example" } ], "docs": "The version code of the app.\n\nOn **Android**, this is the `versionCode` from the `android/app/build.gradle` file.\nOn **iOS**, this is the `CFBundleVersion` from the `Info.plist` file.", "complexTypes": [], "type": "string" } ] }, { "name": "GetVersionNameResult", "slug": "getversionnameresult", "docs": "", "tags": [ { "text": "5.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "versionName", "tags": [ { "text": "5.0.0", "name": "since" }, { "text": "\"1.0.0\"", "name": "example" } ], "docs": "The version name of the app.\n\nOn **Android**, this is the `versionName` from the `android/app/build.gradle` file.\nOn **iOS**, this is the `CFBundleShortVersionString` from the `Info.plist` file.", "complexTypes": [], "type": "string" } ] }, { "name": "ReadyResult", "slug": "readyresult", "docs": "", "tags": [ { "text": "7.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "previousBundleId", "tags": [ { "text": "7.0.0", "name": "since" } ], "docs": "The identifier of the previous bundle used.\n\nIf `null`, the default bundle was used.", "complexTypes": [], "type": "string | null" }, { "name": "currentBundleId", "tags": [ { "text": "7.0.0", "name": "since" } ], "docs": "The identifier of the current bundle used.\n\nIf `null`, the default bundle is being used.", "complexTypes": [], "type": "string | null" }, { "name": "rollback", "tags": [ { "text": "7.0.0", "name": "since" } ], "docs": "Whether or not the app was reset to the default bundle.", "complexTypes": [], "type": "boolean" } ] }, { "name": "SetChannelOptions", "slug": "setchanneloptions", "docs": "", "tags": [ { "text": "5.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "channel", "tags": [ { "text": "5.0.0", "name": "since" } ], "docs": "The channel name.\n\nSet `null` to remove the channel.", "complexTypes": [], "type": "string | null" } ] }, { "name": "SetConfigOptions", "slug": "setconfigoptions", "docs": "", "tags": [ { "text": "7.4.0", "name": "since" } ], "methods": [], "properties": [ { "name": "appId", "tags": [ { "text": "7.4.0", "name": "since" }, { "text": "'6e351b4f-69a7-415e-a057-4567df7ffe94'", "name": "example" } ], "docs": "The app ID used to identify the app.\n\nSet `null` to reset to the value from the Capacitor config file.", "complexTypes": [], "type": "string | null | undefined" } ] }, { "name": "SetCustomIdOptions", "slug": "setcustomidoptions", "docs": "", "tags": [ { "text": "5.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "customId", "tags": [ { "text": "5.0.0", "name": "since" } ], "docs": "The custom identifier of the device.\n\nSet `null` to remove the custom identifier.", "complexTypes": [], "type": "string | null" } ] }, { "name": "SetNextBundleOptions", "slug": "setnextbundleoptions", "docs": "", "tags": [ { "text": "6.7.0", "name": "since" } ], "methods": [], "properties": [ { "name": "bundleId", "tags": [ { "text": "6.7.0", "name": "since" }, { "text": "'1.0.0'", "name": "example" } ], "docs": "The unique identifier of the bundle to use.\n\nSet `null` to use the default bundle (same as calling `reset()`).", "complexTypes": [], "type": "string | null" } ] }, { "name": "SyncResult", "slug": "syncresult", "docs": "", "tags": [ { "text": "5.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "nextBundleId", "tags": [ { "text": "5.0.0", "name": "since" } ], "docs": "The identifier of the next bundle to use.\n\nIf `null`, the app is up-to-date and no new bundle is available.", "complexTypes": [], "type": "string | null" } ] }, { "name": "SyncOptions", "slug": "syncoptions", "docs": "", "tags": [ { "text": "6.7.0", "name": "since" } ], "methods": [], "properties": [ { "name": "channel", "tags": [ { "text": "6.7.0", "name": "since" } ], "docs": "The name of the channel where the latest bundle is fetched from.", "complexTypes": [], "type": "string | undefined" } ] }, { "name": "PluginListenerHandle", "slug": "pluginlistenerhandle", "docs": "", "tags": [], "methods": [], "properties": [ { "name": "remove", "tags": [], "docs": "", "complexTypes": [], "type": "() => Promise<void>" } ] }, { "name": "DownloadBundleProgressEvent", "slug": "downloadbundleprogressevent", "docs": "Event that is triggered when the download progress of a bundle changes.", "tags": [ { "text": "7.0.0", "name": "since" } ], "methods": [], "properties": [ { "name": "bundleId", "tags": [ { "text": "7.0.0", "name": "since" } ], "docs": "The unique identifier of the bundle that is being downloaded.", "complexTypes": [], "type": "string" }, { "name": "downloadedBytes", "tags": [ { "text": "7.0.0", "name": "since" } ], "docs": "The number of bytes that have been downloaded.", "complexTypes": [], "type": "number" }, { "name": "progress", "tags": [ { "text": "7.0.0", "name": "since" }, { "text": "0.5", "name": "example" } ], "docs": "The progress of the download in percent as a value between `0` and `1`.", "complexTypes": [], "type": "number" }, { "name": "totalBytes", "tags": [ { "text": "7.0.0", "name": "since" } ], "docs": "The total number of bytes to download.", "complexTypes": [], "type": "number" } ] }, { "name": "NextBundleSetEvent", "slug": "nextbundlesetevent", "docs": "Event that is triggered when a bundle is set as the next bundle.", "tags": [ { "text": "7.3.0", "name": "since" } ], "methods": [], "properties": [ { "name": "bundleId", "tags": [ { "text": "7.3.0", "name": "since" }, { "text": "'1.0.0'", "name": "example" } ], "docs": "The unique identifier of the bundle that is set as the next bundle.\n\nIf `null`, the default bundle will be used.", "complexTypes": [], "type": "string | null" } ] } ], "enums": [], "typeAliases": [ { "name": "DownloadBundleProgressListener", "slug": "downloadbundleprogresslistener", "docs": "Listener for the download progress of a bundle.", "types": [ { "text": "(event: DownloadBundleProgressEvent): void", "complexTypes": [ "DownloadBundleProgressEvent" ] } ] }, { "name": "NextBundleSetListener", "slug": "nextbundlesetlistener", "docs": "Listener for when a bundle is set as the next bundle.", "types": [ { "text": "(event: NextBundleSetEvent): void", "complexTypes": [ "NextBundleSetEvent" ] } ] }, { "name": "ReloadedListener", "slug": "reloadedlistener", "docs": "Listener for when the app is reloaded.", "types": [ { "text": "(): void", "complexTypes": [] } ] } ], "pluginConfigs": [ { "name": "LiveUpdate", "slug": "liveupdate", "properties": [ { "name": "appId", "tags": [ { "text": "5.0.0", "name": "since" }, { "text": "'6e351b4f-69a7-415e-a057-4567df7ffe94'", "name": "example" } ], "docs": "The app ID is used to identify the app when using [Capawesome Cloud](https://capawesome.io/cloud/).\n\nThis is **NOT** the same as the app identifier (e.g. `com.example.app`).\nThis is a unique identifier generated by Capawesome Cloud (e.g. `6e351b4f-69a7-415e-a057-4567df7ffe94`).", "complexTypes": [], "type": "string | undefined" }, { "name": "autoBlockRolledBackBundles", "tags": [ { "text": "7.3.0", "name": "since" }, { "text": "false", "name": "default" } ], "docs": "Whether or not to automatically block bundles that have been rolled back.\n\nWhen enabled, the plugin will automatically block bundles that caused a rollback\n(up to 100 bundles). When the limit is reached, the oldest blocked bundle is unblocked.\nBlocked bundles will be skipped in future sync operations.\n\n**Attention**: This option has no effect if `readyTimeout` is set to `0`.\n\nOnly available on Android and iOS.", "complexTypes": [], "type": "boolean | undefined" }, { "name": "autoDeleteBundles", "tags": [ { "text": "5.0.0", "name": "since" }, { "text": "false", "name": "default" } ], "docs": "Whether or not to automatically delete unused bundles.\n\nWhen enabled, the plugin will automatically delete unused bundles after calling `ready()`.", "complexTypes": [], "type": "boolean | undefined" }, { "name": "autoUpdateStrategy", "tags": [ { "text": "7.3.0", "name": "since" }, { "text": "'none'", "name": "default" }, { "text": "'background'", "name": "example" } ], "docs": "The auto-update strategy for live updates.\n\n- `none`: Live updates will not be applied automatically.\n- `background`: Live updates will be automatically downloaded\nand a