upgrade-native-sdk

star 30

Use when upgrading native iOS or Android SDK dependency versions in AdaptySDK-Capacitor. Triggered by requests like "bump ios sdk", "upgrade android native", "update native dependency version".

adaptyteam By adaptyteam schedule Updated 2/19/2026

name: upgrade-native-sdk description: Use when upgrading native iOS or Android SDK dependency versions in AdaptySDK-Capacitor. Triggered by requests like "bump ios sdk", "upgrade android native", "update native dependency version".

Upgrade Native SDK

Bumps Adapty native SDK version for iOS or Android platform.

Input

Ask the user for:

  1. Platform: ios or android
  2. Version: target native SDK version (e.g. 3.15.3)

For android, also ask: 3. crossplatform versionio.adapty.internal:crossplatform version (may differ from bom version)

iOS Steps

Edit these files, replacing the OLD version with the NEW version:

1. AdaptyCapacitor.podspec

Update all three pod dependencies:

s.dependency 'Adapty', '<NEW_VERSION>'
s.dependency 'AdaptyUI', '<NEW_VERSION>'
s.dependency 'AdaptyPlugin', '<NEW_VERSION>'

2. Package.swift

Update SPM exact version:

.package(url: "https://github.com/adaptyteam/AdaptySDK-iOS.git", exact: "<NEW_VERSION>")

3. No manual Podfile.lock edit

The lockfile will be regenerated during the verification step.

Android Steps

1. android/build.gradle

Update BOM version:

implementation platform('io.adapty:adapty-bom:<NEW_VERSION>')

Update crossplatform version (ask user for the exact version — it may differ):

implementation 'io.adapty.internal:crossplatform:<CROSSPLATFORM_VERSION>'

Verification

Do NOT run yarn dev-example-full directly — it triggers interactive credentials prompt via postinstall.

Instead, run these steps manually from project root:

# 1. Build the plugin
yarn build

# 2. Install devtools deps without postinstall (avoids interactive credentials prompt)
cd examples/adapty-devtools && yarn install --ignore-scripts

# 3. Run credentials non-interactively
# Read values from examples/adapty-devtools/.adapty-credentials.json and pass them as CLI args:
#   token → --token, ios_bundle → --ios-bundle, android_application_id → --android-id,
#   placement_id → --placement-id, onboarding_placement_id → --onboarding-placement-id
node ../../scripts/credentials.mjs \
  --token=<token> \
  --ios-bundle=<ios_bundle> \
  --android-id=<android_application_id> \
  --placement-id=<placement_id> \
  --onboarding-placement-id=<onboarding_placement_id>

# 4. Build devtools
yarn build

# 5. Update native modules (runs pod update + cap copy + cap sync)
# IMPORTANT: run this BEFORE bare `cap sync` — cap sync uses pod install which
# fails when pod versions changed. update-native-modules does pod update first.
yarn update-native-modules

Wait for all commands to succeed before considering the task done.

Commit

Format: chore: upgrade <platform> SDK to <version>

Examples:

  • chore: upgrade ios SDK to 3.15.3
  • chore: upgrade android SDK to bom 3.15.2, crossplatform 3.15.6

Reminder

After all changes are verified, remind the user:

Don't forget to update cross_platform.yaml if the cross-platform protocol version changed. Don't forget to bump the version in package.json.

Install via CLI
npx skills add https://github.com/adaptyteam/AdaptySDK-Capacitor --skill upgrade-native-sdk
Repository Details
star Stars 30
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator