> ## Documentation Index
> Fetch the complete documentation index at: https://patch.codemagic.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Capacitor SDK

> Release notes for the Capacitor SDK (@codemagic/capacitor-patch), by version.

# Capacitor SDK release notes

Release notes for `@codemagic/capacitor-patch`, the client SDK for Capacitor,
Ionic, and Cordova-on-Capacitor apps. Releases for these apps are published
with the [CLI for Capacitor](/docs/releases/capacitor-cli). The other
surfaces' releases are on the [Release Notes](/docs/releases) page.

```bash
npm install @codemagic/capacitor-patch@latest
```

Reference: [Native setup for Capacitor](/docs/setup/native-setup-capacitor) ·
[SDK reference](/docs/reference/sdk-reference) ·
[GitHub releases](https://github.com/codemagic-ci-cd/codemagic-patch/releases?q=capacitor-patch%40)

## 0.1.2 {#v0-1-2}

*28th October 2026*

### Fixes

- Fixes Android release builds with resource shrinking removing the
  `CodemagicPatch*` overrides in `strings.xml`, which made the app fall back
  to `capacitor.config.ts`. On older SDKs, see
  [Release published but app finds no update](/docs/troubleshooting#release-published-but-app-finds-no-update).

### Other changes

- Lowers the default of `maxLaunchAttempts` to 2 on Android and iOS, so a
  broken package rolls back on its third launch instead of its fourth. Set
  the value explicitly to keep 3.

See the [SDK release](https://github.com/codemagic-ci-cd/codemagic-patch/releases/tag/%40codemagic/capacitor-patch%400.1.2).

## 0.1.1 {#v0-1-1}

*19th October 2026*

### Fixes

- Fixes metrics uploads on a slow or unresponsive network holding up
  Capacitor plugin calls, manifest fetches, and update downloads. Metrics are
  now processed separately from other SDK operations.

### Other changes

- Removes the unused `sdk_version` field from metrics events. Servers still
  accept it from older SDKs.

See the [SDK release](https://github.com/codemagic-ci-cd/codemagic-patch/releases/tag/%40codemagic/capacitor-patch%400.1.1).

## 0.1.0 {#v0-1-0}

*6th October 2026*

First published version. The API may still change before 1.0.

The SDK applies over-the-air updates to the web assets of a Capacitor, Ionic,
or Cordova-on-Capacitor app. It uses the same protocol and server as the React
Native SDK. A release is a directory of web assets. Applying it points the
WebView at that directory with Capacitor's `setServerBasePath`. There is no
bundler integration and no native fingerprint. Releases are scoped by the
native app version. To set it up, install the package, run `npx cap sync`, and
follow [Native setup for Capacitor](/docs/setup/native-setup-capacitor).

See the [SDK release](https://github.com/codemagic-ci-cd/codemagic-patch/releases/tag/%40codemagic/capacitor-patch%400.1.0).
