android-upgrade-mobile-sdk-12-to-13
Upgrades an existing Android app from Salesforce Mobile SDK 12.x to 13.2.1. Use when the user asks to upgrade the Mobile SDK version, or when you detect SDK 12.x version strings in build.gradle.kts, libs.versions.toml, or build.gradle files. Covers: minSdk bump (26→28), compileSdk bump (34→36), Gradle/AGP upgrade, removed API fixes (OAuthWebviewHelper, LoginOptions, ServerPickerActivity, LogoutCompleteReceiver), login customization migration to LoginViewModel, and ProGuard/R8 rule cleanup. Does NOT cover React Native or Hybrid/Cordova upgrades.
소스 정보
- 저장소
- forcedotcom/SalesforceMobileSDK-Templates
- 최근 소스 활동
- 2026년 9월 23일 21:02
- 감지된 SKILL.md 언어
- 영어
- 스타
- 58
- 포크
- 63
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
파일 탐색기
4 개 파일SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- android-upgrade-mobile-sdk-12-to-13
- description
- Upgrades an existing Android app from Salesforce Mobile SDK 12.x to 13.2.1. Use when the user asks to upgrade the Mobile SDK version, or when you detect SDK 12.x version strings in build.gradle.kts, libs.versions.toml, or build.gradle files. Covers: minSdk bump (26→28), compileSdk bump (34→36), Gradle/AGP upgrade, removed API fixes (OAuthWebviewHelper, LoginOptions, ServerPickerActivity, LogoutCompleteReceiver), login customization migration to LoginViewModel, and ProGuard/R8 rule cleanup. Does NOT cover React Native or Hybrid/Cordova upgrades.
# Android Salesforce Mobile SDK — Upgrade 12.x to 13.2.1
This skill upgrades an existing Android app from Salesforce Mobile SDK 12.x to 13.2.1. 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 12.x → 13.2.1 | [`references/upgrade-12-to-13.md`](references/upgrade-12-to-13.md) | SDK 12.x is already integrated |
Cross-cutting references:
| Topic | Reference |
|---|---|
| Removed APIs, changed signatures, new APIs | [`references/api-changes.md`](references/api-changes.md) |
| Build / runtime / behavioral error symptoms | [`references/troubleshooting.md`](references/troubleshooting.md) |
## Detection Rules
Run these checks against the working directory before proceeding:
1. Check `app/build.gradle.kts` for `com.salesforce.mobilesdk:` with version string containing `12.`.
2. Check `libs.versions.toml` for `salesforceSDK = "12.` version string.
3. Check `app/build.gradle` (Groovy DSL) for `'com.salesforce.mobilesdk:` with `:12.`.
4. If SDK 12 is detected AND `13.` 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.
- **`minSdk` MUST be raised to 28.** SDK 13.x requires Android 9 (API 28) as the minimum. This drops support for Android 8.0 (API 26) and 8.1 (API 27) — confirm the app's Play Store minimum version policy before applying.
- **`compileSdk` and `targetSdk` MUST be raised to 36.**
- **Gradle wrapper MUST be updated to 8.14.3; AGP MUST be updated to 8.12.0.**
- **Build target**: `./gradlew assembleDebug` from 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/Java in the release wins.
Release: <https://github.com/forcedotcom/SalesforceMobileSDK-Android/releases/tag/v13.2.1>
GitHub에서 보기