This skill upgrades an existing Android Kotlin app from Salesforce Mobile SDK 13.x to 14.0. It is consumed by autonomous coding agents — every reference file is self-contained and contains exact source-of-truth code, file paths, and CLI commands.
Scenarios
| Scenario | Reference | Preconditions |
|---|---|---|
| Upgrade SDK 13.x → 14.0 | references/upgrade-13-to-14.md |
SDK 13.x is already integrated; app is Kotlin |
Cross-cutting references:
| Topic | Reference |
|---|---|
| Removed APIs, changed signatures, new APIs | references/breaking-changes.md |
| Build / runtime / behavioral error symptoms | references/troubleshooting.md |
Detection Rules
Run these checks against the working directory before proceeding:
- Check
app/build.gradle.ktsforcom.salesforce.mobilesdk:with version string containing13.. - Check
libs.versions.tomlforsalesforceSDK = "13.version string. - If SDK 13 is detected AND
14.is NOT present anywhere in the same file → this skill applies.
Invariants
These hold regardless of the project shape (version catalog or inline dependencies):
- Do NOT recreate the Android project from scratch. Preserve all hand-maintained module configuration, signing config, and build variants.
- Do NOT rename or move app source files. Only SDK version identifiers and removed/renamed APIs change.
- Do NOT change
applicationId, signing config, or non-SDK build settings unless the upgrade explicitly requires it. minSdkMUST be raised to 31. SDK 14.0 requires Android 12 (API 31) as the minimum. This drops support for Android 9, 10, and 11 — confirm the app's Play Store minimum version policy before applying.compileSdkandtargetSdkmust be at least 36. The SDK 14.0 library itself targetscompileSdk = 36(libs/SalesforceSDK/build.gradle.ktshas an explicit// TODO: MSDK 14 will remain on 36. The next increment will be in MSDK 15.), so an app on 36 is fully compatible — this matches theandroid-mobile-sdkskill, which generates apps at 36.37also builds but is not required; it comes only from sample apps. Do not force a bump to 37.- Gradle wrapper MUST be updated to 9.4.1; AGP MUST be updated to 9.1.1.
- Reconcile the Kotlin plugin with the
android.builtInKotlinflag. Two valid configurations exist: with AGP built-in Kotlin active (android.builtInKotlintrue/unset) removeid("org.jetbrains.kotlin.android")fromplugins { }, since leaving it in conflicts; or setandroid.builtInKotlin=falseingradle.propertiesand keep the plugin. (The Mobile SDK library itself setsbuiltInKotlin=false, but that is the library's internal build choice and does not propagate to consuming apps via Maven — a consuming app on AGP 9 gets built-in Kotlin by default, so prefer Path A and choose Path B only deliberately.) Do not remove the plugin without confirming the flag. Seereferences/upgrade-13-to-14.mdStep 4. - Build target:
./gradlew assembleDebugfrom the project root unless there is reason to use a different variant.
Source of Truth
When the SDK API in this skill disagrees with reality, the upstream Kotlin source in the release wins.
Release: https://github.com/forcedotcom/SalesforceMobileSDK-Android/releases/tag/v14.0.0