| name | test-sdk-consumer-skills |
| description | End-to-end test harness for the consolidated SDK consumer skills. Creates 10 apps (5 iOS, 5 Android) in parallel, one per scenario within the ios-mobile-sdk and android-mobile-sdk skills, builds each, and reports results. |
Test SDK Consumer Skills
End-to-end test harness that exercises every scenario within the consolidated ios-mobile-sdk and android-mobile-sdk skills by creating a fresh app for each one, applying the appropriate skill scenario, building the result, and reporting a pass/fail summary alongside the paths so the user can do further manual testing.
The consolidated skills use progressive disclosure, so this test harness validates that each scenario path (create app, add SDK, add SmartStore, add MobileSync, add biometric auth) produces buildable, working apps.
Apps Created
| # | Name | Platform | Skill + Scenario Applied |
|---|
| 1 | SkillTest_iOS_Full | iOS (CocoaPods) | ios-mobile-sdk → "Create New App" |
| 2 | SkillTest_iOS_SDK | iOS (CocoaPods) | ios-mobile-sdk → "Add Mobile SDK" |
| 3 | SkillTest_iOS_SmartStore | iOS (CocoaPods) | ios-mobile-sdk → "Add Mobile SDK" → "Add SmartStore" |
| 4 | SkillTest_iOS_MobileSync | iOS (CocoaPods) | ios-mobile-sdk → "Add Mobile SDK" → "Add SmartStore" → "Add MobileSync" |
| 5 | SkillTest_iOS_Biometric | iOS (CocoaPods) | ios-mobile-sdk → "Add Mobile SDK" → "Add Biometric Auth" |
| 6 | SkillTest_Android_Full | Android (Gradle) | android-mobile-sdk → "Create New App" |
| 7 | SkillTest_Android_SDK | Android (Gradle) | android-mobile-sdk → "Add Mobile SDK" |
| 8 | SkillTest_Android_SmartStore | Android (Gradle) | android-mobile-sdk → "Add Mobile SDK" → "Add SmartStore" |
| 9 | SkillTest_Android_MobileSync | Android (Gradle) | android-mobile-sdk → "Add Mobile SDK" → "Add SmartStore" → "Add MobileSync" |
| 10 | SkillTest_Android_Biometric | Android (Gradle) | android-mobile-sdk → "Add Mobile SDK" → "Add Biometric Auth" |
Prerequisites
xcodegen installed (brew install xcodegen)
cocoapods installed (brew install cocoapods)
- Android SDK installed with
ANDROID_HOME set
JAVA_HOME pointing to a JDK 17
Verify:
which xcodegen && which pod && echo $ANDROID_HOME && java -version
Step 1: Choose an Output Directory
All 10 apps are created under a single parent directory. Default: /tmp/SdkSkillsTest_<timestamp>.
BASE=/tmp/SdkSkillsTest_$(date +%Y%m%d_%H%M%S)
mkdir -p "$BASE"
echo "Output: $BASE"
Step 2: Create the 8 App Skeletons in Parallel
Launch all 8 app skeletons simultaneously. Each group below can be started without waiting for the others.
iOS apps — shared scaffold helper
All 4 iOS apps use the same xcodegen scaffold. For apps 2–4 (where create-ios-app-with-mobile-sdk is NOT applied), use the minimal scaffold produced by steps 1–3 of that skill (project.yml + xcodegen + bare Swift files). For app 1, create-ios-app-with-mobile-sdk handles scaffolding internally.
Create the following reusable function (or repeat the steps inline for each app):
scaffold_ios() {
local NAME=$1 BUNDLE=$2 DIR=$3
mkdir -p "$DIR/$NAME/$NAME"
cat > "$DIR/$NAME/$NAME/AppDelegate.swift" <<'SWIFT'
import UIKit
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
override init() { super.init() }
func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role)
}
func application(_ application: UIApplication, didDiscardSceneSessions sceneSessions: Set<UISceneSession>) {}
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { true }
}
SWIFT
cat > "$DIR/$NAME/$NAME/SceneDelegate.swift" <<'SWIFT'
import UIKit
class SceneDelegate: UIResponder, UIWindowSceneDelegate {
var window: UIWindow?
func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
guard let windowScene = scene as? UIWindowScene else { return }
window = UIWindow(frame: windowScene.coordinateSpace.bounds)
window?.windowScene = windowScene
window?.rootViewController = UIViewController()
window?.makeKeyAndVisible()
}
func sceneDidDisconnect(_ scene: UIScene) {}
func sceneDidBecomeActive(_ scene: UIScene) {}
func sceneWillResignActive(_ scene: UIScene) {}
func sceneWillEnterForeground(_ scene: UIScene) {}
func sceneDidEnterBackground(_ scene: UIScene) {}
}
SWIFT
cat > "$DIR/$NAME/project.yml" <<YAML
name: $NAME
options:
bundleIdPrefix: $(echo $BUNDLE | rev | cut -d. -f2- | rev)
deploymentTarget:
iOS: "18.0"
settings:
PRODUCT_BUNDLE_IDENTIFIER: $BUNDLE
targets:
$NAME:
type: application
platform: iOS
sources:
- $NAME
info:
path: $NAME/Info.plist
properties:
UILaunchStoryboardName: LaunchScreen
UIApplicationSceneManifest:
UIApplicationSupportsMultipleScenes: false
UISceneConfigurations:
UIWindowSceneSessionRoleApplication:
- UISceneConfigurationName: Default Configuration
UISceneDelegateClassName: \$(PRODUCT_MODULE_NAME).SceneDelegate
YAML
(cd "$DIR/$NAME" && xcodegen generate)
}
Android apps — shared scaffold helper
scaffold_android() {
local NAME=$1 PKG=$2 DIR=$3
local PKG_PATH=$(echo $PKG | tr '.' '/')
local APP_DIR="$DIR/$NAME"
mkdir -p "$APP_DIR/app/src/main/java/$PKG_PATH"
mkdir -p "$APP_DIR/app/src/main/res/layout"
mkdir -p "$APP_DIR/app/src/main/res/values"
mkdir -p "$APP_DIR/app/src/main/res/xml"
mkdir -p "$APP_DIR/gradle/wrapper"
local TMPL=/path/to/SalesforceMobileSDK-Templates/AndroidNativeKotlinTemplate
cp "$TMPL/gradlew" "$APP_DIR/gradlew"
cp "$TMPL/gradlew.bat" "$APP_DIR/gradlew.bat"
cp "$TMPL/gradle/wrapper/gradle-wrapper.jar" "$APP_DIR/gradle/wrapper/gradle-wrapper.jar"
chmod +x "$APP_DIR/gradlew"
cat > "$APP_DIR/gradle/wrapper/gradle-wrapper.properties" <<'PROPS'
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
PROPS
cat > "$APP_DIR/gradle.properties" <<'PROPS'
android.useAndroidX=true
org.gradle.jvmargs=-Xmx2g -XX:MaxMetaspaceSize=512m
PROPS
cat > "$APP_DIR/settings.gradle.kts" <<KTS
rootProject.name = "$NAME"
include(":app")
KTS
cat > "$APP_DIR/build.gradle.kts" <<'KTS'
buildscript {
repositories { google(); mavenCentral() }
dependencies {
classpath("com.android.tools.build:gradle:8.12.0")
classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.24")
}
}
allprojects { repositories { google(); mavenCentral() } }
KTS
cat > "$APP_DIR/app/build.gradle.kts" <<KTS
plugins {
id("com.android.application")
id("org.jetbrains.kotlin.android")
}
android {
namespace = "$PKG"
compileSdk = 36
defaultConfig {
applicationId = "$PKG"
minSdk = 28; targetSdk = 36; versionCode = 1; versionName = "1.0"
}
buildFeatures { aidl = true; renderScript = true; buildConfig = true }
packaging { resources { excludes += setOf("META-INF/LICENSE","META-INF/LICENSE.txt","META-INF/DEPENDENCIES","META-INF/NOTICE") } }
}
dependencies { implementation("com.salesforce.mobilesdk:MobileSync:13.2.0") }
kotlin { jvmToolchain(17) }
KTS
cat > "$APP_DIR/app/src/main/AndroidManifest.xml" <<XML
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" android:installLocation="internalOnly">
<application android:name=".MainApplication" android:icon="@drawable/sf__icon" android:label="@string/app_name" android:theme="@style/SalesforceSDK">
<activity android:name=".MainActivity" android:exported="true" android:theme="@style/SalesforceSDK">
<intent-filter>
<action android:name="android.intent.action.MAIN"/>
<category android:name="android.intent.category.LAUNCHER"/>
</intent-filter>
</activity>
</application>
</manifest>
XML
cat > "$APP_DIR/app/src/main/res/values/strings.xml" <<XML
<?xml version="1.0" encoding="utf-8"?>
<resources><string name="app_name">$NAME</string></resources>
XML
cat > "$APP_DIR/app/src/main/res/values/bootconfig.xml" <<'XML'
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="remoteAccessConsumerKey">YOUR_CONSUMER_KEY</string>
<string name="oauthRedirectURI">YOUR_CALLBACK_URL</string>
</resources>
XML
cat > "$APP_DIR/app/src/main/res/xml/servers.xml" <<'XML'
<?xml version="1.0" encoding="utf-8"?>
<servers><server name="Default" url="https://login.salesforce.com"/></servers>
XML
cat > "$APP_DIR/app/src/main/java/$PKG_PATH/MainApplication.kt" <<KT
package $PKG
import android.app.Application
import com.salesforce.androidsdk.mobilesync.app.MobileSyncSDKManager
class MainApplication : Application() {
override fun onCreate() {
super.onCreate()
MobileSyncSDKManager.initNative(applicationContext, MainActivity::class.java)
}
}
KT
cat > "$APP_DIR/app/src/main/java/$PKG_PATH/MainActivity.kt" <<KT
package $PKG
import android.os.Bundle
import android.view.Gravity
import android.widget.TextView
import com.salesforce.androidsdk.rest.RestClient
import com.salesforce.androidsdk.ui.SalesforceActivity
class MainActivity : SalesforceActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(TextView(this).apply { text = "Mobile SDK ready"; gravity = Gravity.CENTER; textSize = 18f })
}
override fun onResume(client: RestClient?) {}
}
KT
}
Note on the wrapper path: Replace /path/to/SalesforceMobileSDK-Templates/AndroidNativeKotlinTemplate with the actual path to the Templates repo on your machine (e.g. the workspace clone). The Gradle wrapper JAR and scripts are binary files that cannot be created manually.
Step 3: Apply Consumer Skills to Each App
Once scaffolded, apply the consumer skills. iOS apps 2–4 need pod install after CocoaPods wiring; iOS app 1 does this internally via create-ios-app-with-mobile-sdk.
App 1 — iOS Full (ios-mobile-sdk → Create New App)
Invoke ios-mobile-sdk skill and follow the "Create New App" scenario with:
- App name:
SkillTest_iOS_Full
- Bundle ID:
com.skilltest.ios.full
- Output directory:
$BASE
- Dependency manager: CocoaPods
- Consumer key / callback URL / login host: leave as placeholders
This scenario handles scaffolding + SDK wiring in one pass.
App 2 — iOS SDK only (ios-mobile-sdk → Add Mobile SDK)
- Run
scaffold_ios SkillTest_iOS_SDK com.skilltest.ios.sdk $BASE
- Invoke
ios-mobile-sdk skill and follow the "Add Mobile SDK" scenario for $BASE/SkillTest_iOS_SDK (CocoaPods path, placeholders for OAuth)
pod install in $BASE/SkillTest_iOS_SDK
App 3 — iOS SmartStore (ios-mobile-sdk → Add Mobile SDK → Add SmartStore)
- Run
scaffold_ios SkillTest_iOS_SmartStore com.skilltest.ios.smartstore $BASE
- Invoke
ios-mobile-sdk skill → "Add Mobile SDK" scenario
- Follow the "Add SmartStore" section within the same skill (soup name:
Item)
pod install
App 4 — iOS MobileSync (ios-mobile-sdk → Add Mobile SDK → Add SmartStore → Add MobileSync)
- Run
scaffold_ios SkillTest_iOS_MobileSync com.skilltest.ios.mobilesync $BASE
- Invoke
ios-mobile-sdk skill → "Add Mobile SDK" scenario
- Follow the "Add SmartStore" section (soup name:
Item)
- Follow the "Add MobileSync" section (soup:
Item, sObject: Contact)
pod install
App 5 — iOS Biometric (ios-mobile-sdk → Add Mobile SDK → Add Biometric Auth)
- Run
scaffold_ios SkillTest_iOS_Biometric com.skilltest.ios.biometric $BASE
- Invoke
ios-mobile-sdk skill → "Add Mobile SDK" scenario (CocoaPods path, placeholders for OAuth)
- Follow the "Add Biometric Auth" section
pod install
App 6 — Android Full (android-mobile-sdk → Create New App)
Invoke android-mobile-sdk skill and follow the "Create New App" scenario with:
- App name:
SkillTest_Android_Full
- Package name:
com.skilltest.android.full
- Output directory:
$BASE
- Consumer key / callback URL / login host: leave as placeholders
This scenario handles scaffolding + SDK wiring in one pass.
App 7 — Android SDK only (android-mobile-sdk → Add Mobile SDK)
- Run
scaffold_android SkillTest_Android_SDK com.skilltest.android.sdk $BASE
- Invoke
android-mobile-sdk skill and follow the "Add Mobile SDK" scenario
The scaffold already includes the SDK wiring, so this primarily validates the skill's instructions match the expected setup.
App 8 — Android SmartStore (android-mobile-sdk → Add Mobile SDK → Add SmartStore)
- Run
scaffold_android SkillTest_Android_SmartStore com.skilltest.android.smartstore $BASE
- Invoke
android-mobile-sdk skill → "Add Mobile SDK" scenario
- Follow the "Add SmartStore" section within the same skill (soup name:
Item)
App 9 — Android MobileSync (android-mobile-sdk → Add Mobile SDK → Add SmartStore → Add MobileSync)
- Run
scaffold_android SkillTest_Android_MobileSync com.skilltest.android.mobilesync $BASE
- Invoke
android-mobile-sdk skill → "Add Mobile SDK" scenario
- Follow the "Add SmartStore" section (soup name:
Item)
- Follow the "Add MobileSync" section (soup:
Item, sObject: Contact)
App 10 — Android Biometric (android-mobile-sdk → Add Mobile SDK → Add Biometric Auth)
- Run
scaffold_android SkillTest_Android_Biometric com.skilltest.android.biometric $BASE
- Invoke
android-mobile-sdk skill → "Add Mobile SDK" scenario
- Follow the "Add Biometric Auth" section
Step 4: Build All Apps
iOS builds (run in parallel using background processes or separate terminals)
First find a simulator UDID to avoid destination-name ambiguity (multiple OS versions with the same device name cause xcodebuild to error):
SIM_ID=$(xcrun simctl list devices available | grep "iPhone 16 Pro " | grep "18\." | head -1 | sed 's/.*(\([A-F0-9-]*\)).*/\1/')
echo "Using simulator: $SIM_ID"
Then build:
for APP in SkillTest_iOS_Full SkillTest_iOS_SDK SkillTest_iOS_SmartStore SkillTest_iOS_MobileSync SkillTest_iOS_Biometric; do
(
cd "$BASE/$APP"
xcodebuild \
-workspace "${APP}.xcworkspace" \
-scheme "$APP" \
-sdk iphonesimulator \
-destination "platform=iOS Simulator,id=$SIM_ID" \
build \
> "$BASE/${APP}_build.log" 2>&1 \
&& echo "PASS: $APP" \
|| echo "FAIL: $APP (see $BASE/${APP}_build.log)"
) &
done
wait
Android builds (run in parallel)
for APP in SkillTest_Android_Full SkillTest_Android_SDK SkillTest_Android_SmartStore SkillTest_Android_MobileSync SkillTest_Android_Biometric; do
(
cd "$BASE/$APP"
./gradlew assembleDebug \
> "$BASE/${APP}_build.log" 2>&1 \
&& echo "PASS: $APP" \
|| echo "FAIL: $APP (see $BASE/${APP}_build.log)"
) &
done
wait
Step 5: Report Results
Print a summary and the locations of all 10 apps:
echo ""
echo "=== SDK Consumer Skills Test Results ==="
echo ""
echo "iOS apps (open .xcworkspace in Xcode to run on simulator):"
for APP in SkillTest_iOS_Full SkillTest_iOS_SDK SkillTest_iOS_SmartStore SkillTest_iOS_MobileSync SkillTest_iOS_Biometric; do
echo " $BASE/$APP/${APP}.xcworkspace"
done
echo ""
echo "Android apps (open directory in Android Studio to run on emulator):"
for APP in SkillTest_Android_Full SkillTest_Android_SDK SkillTest_Android_SmartStore SkillTest_Android_MobileSync SkillTest_Android_Biometric; do
echo " $BASE/$APP"
done
echo ""
echo "Build logs: $BASE/*_build.log"
Manual Testing Checklist
For each app, open it in Xcode / Android Studio and run it on a simulator/emulator:
| App | Expected behaviour |
|---|
SkillTest_iOS_Full | Salesforce login screen on first launch; "Mobile SDK ready" after login |
SkillTest_iOS_SDK | Same as above |
SkillTest_iOS_SmartStore | Salesforce login screen; "SmartStore ready" after login |
SkillTest_iOS_MobileSync | Salesforce login screen; "SmartStore + MobileSync ready" after login |
SkillTest_iOS_Biometric | Salesforce login screen; biometric opt-in dialog after login |
SkillTest_Android_Full | Salesforce login screen on first launch; "Mobile SDK ready" after login |
SkillTest_Android_SDK | Same as above |
SkillTest_Android_SmartStore | Salesforce login screen; "SmartStore ready" after login |
SkillTest_Android_MobileSync | Salesforce login screen; "SmartStore + MobileSync ready" after login |
SkillTest_Android_Biometric | Salesforce login screen; biometric opt-in dialog after login |
Troubleshooting
xcodegen: command not found — brew install xcodegen
pod: command not found — brew install cocoapods
iOS build fails with "No such file or directory: .xcworkspace" — pod install was not run, or ran before xcodegen generate. Run them in order: xcodegen generate → apply consumer skills → pod install.
Android build fails with OutOfMemoryError — Ensure org.gradle.jvmargs=-Xmx2g is in gradle.properties.
Android build fails with android.useAndroidX error — Ensure android.useAndroidX=true is in gradle.properties.
gradle-wrapper.jar missing — Copy it from any local Android project (e.g. AndroidNativeKotlinTemplate/gradle/wrapper/gradle-wrapper.jar).
iOS build fails with "Unable to find a device matching the provided destination specifier" — Multiple simulator OS versions have the same device name. Use xcrun simctl list devices available to find a UDID for a specific iOS 18.x simulator and pass -destination "platform=iOS Simulator,id=<UDID>" instead of using the device name.