test-sdk-consumer-skills

# 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: ```bash 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>`. ```bash 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): ```bash # Usage: scaffold_ios <AppName> <BundleID> <OutputDir> 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 ```bash # Usage: scaffold_android <AppName> <PackageName> <OutputDir> 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" # Copy wrapper from the Templates repo. # If running from inside the SalesforceMobileSDK-Workspace, use: # local TMPL="$(git -C "$(dirname "$0")" rev-parse --show-toplevel)/AndroidNativeKotlinTemplate" # Otherwise set the full path explicitly: 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) 1. Run `scaffold_ios SkillTest_iOS_SDK com.skilltest.ios.sdk $BASE` 2. Invoke `ios-mobile-sdk` skill and follow the "Add Mobile SDK" scenario for `$BASE/SkillTest_iOS_SDK` (CocoaPods path, placeholders for OAuth) 3. `pod install` in `$BASE/SkillTest_iOS_SDK` ### App 3 — iOS SmartStore (ios-mobile-sdk → Add Mobile SDK → Add SmartStore) 1. Run `scaffold_ios SkillTest_iOS_SmartStore com.skilltest.ios.smartstore $BASE` 2. Invoke `ios-mobile-sdk` skill → "Add Mobile SDK" scenario 3. Follow the "Add SmartStore" section within the same skill (soup name: `Item`) 4. `pod install` ### App 4 — iOS MobileSync (ios-mobile-sdk → Add Mobile SDK → Add SmartStore → Add MobileSync) 1. Run `scaffold_ios SkillTest_iOS_MobileSync com.skilltest.ios.mobilesync $BASE` 2. Invoke `ios-mobile-sdk` skill → "Add Mobile SDK" scenario 3. Follow the "Add SmartStore" section (soup name: `Item`) 4. Follow the "Add MobileSync" section (soup: `Item`, sObject: `Contact`) 5. `pod install` ### App 5 — iOS Biometric (ios-mobile-sdk → Add Mobile SDK → Add Biometric Auth) 1. Run `scaffold_ios SkillTest_iOS_Biometric com.skilltest.ios.biometric $BASE` 2. Invoke `ios-mobile-sdk` skill → "Add Mobile SDK" scenario (CocoaPods path, placeholders for OAuth) 3. Follow the "Add Biometric Auth" section 4. `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`