Verify Plugin Release

Verify plugin release

End-to-end verification of a published AppsFlyer Capacitor plugin version using the example app at examples/CapacitorReact.

Prerequisites

Before starting, confirm:

• An Android physical device is connected (adb devices)
• An iOS simulator is booted (xcrun simctl list devices booted)
• The target version is published on npm (npm view appsflyer-capacitor-plugin@<tag> version)
• The example app has a valid .env with REACT_APP_AF_DEV_KEY and REACT_APP_AF_APP_ID

Workflow

1. Determine the install tag

Confirm the published version:

npm view appsflyer-capacitor-plugin@QA version   # for RC
npm view appsflyer-capacitor-plugin@latest version  # for production

2. Install the plugin from npm

From examples/CapacitorReact:

npm run installQA        # RC releases
# or
npm run installFromNpm   # production releases

This runs npm install appsflyer-capacitor-plugin@<tag> && npx cap sync.

3. Handle iOS pod install failures

If cap sync fails on iOS with a pod version conflict (common when the native SDK version was bumped), fix it:

cd ios/App
rm Podfile.lock
pod repo update
pod install
cd ../..

Then re-run npx cap sync to confirm both platforms succeed.

4. Build web assets and sync

npm run rebuild

This runs npm run build && npx cap sync. Verify the Capacitor sync output lists the correct plugin version for both platforms:

appsflyer-capacitor-plugin@<expected-version>

5. Deploy to devices

Identify targets:

• Android: adb devices (use the physical device serial)
• iOS: xcrun simctl list devices booted (use the simulator UDID)

Run in parallel:

npx cap run android --target <DEVICE_SERIAL>
npx cap run ios --target <SIMULATOR_UDID>

Both should complete with Deploying ... to <target>.

6. Collect and verify logs

Give the user a moment to interact with the app, then pull logs.

Android:

adb -s <DEVICE_SERIAL> logcat -d -v time \
  | grep -iE "AppsFlyer_[0-9]|Capacitor/Plugin|CapacitorPlugin|onConversion|logEvent" \
  | tail -60

iOS:

xcrun simctl spawn <SIMULATOR_UDID> log show --last 2m \
  --predicate 'eventMessage CONTAINS "AppsFlyer" OR eventMessage CONTAINS "initSdk" OR eventMessage CONTAINS "onConversion" OR eventMessage CONTAINS "logEvent" OR (process == "App" AND eventMessage CONTAINS[cd] "capacitor")' \
  --style compact

7. Verification checklist

Confirm the following from the logs:

• SDK version: Native SDK version matches androidSdkVersion / iosSdkVersion from package.json
• Plugin version: platform_extension_v2.version matches the published version
• Launch event: Sent successfully with HTTP 200 response
• Conversion data: onConversionDataSuccess callback received
• In-app event (if triggered): logEvent sent with HTTP 200 response
• No crashes or errors: No fatal/error-level AppsFlyer logs

8. Clean up

After verification, revert the example app's package.json back to local dependency:

cd examples/CapacitorReact
npm run installLocal

This restores the "appsflyer-capacitor-plugin": "file:../.." dependency so the repo stays clean for development.

Troubleshooting