Purchasely SDK Migration Guide

You are migrating an existing Purchasely SDK integration. You must edit the user's project and verify each migration phase with the platform build/test commands. Native Android (Kotlin & Java), native iOS (Swift & Objective-C), Flutter, React Native, and Cordova v5.x → v6 are supported (native iOS pins 6.2.0, latest stable; native Android pins 6.2.0, latest stable — Android never had a 6.0.0 tag, the line went rc.1 → rc.2 → rc.3 → 6.0.1; Flutter pins 6.2.0, stable; React Native pins 6.2.0, stable GA; Cordova pins 6.2.0, stable GA).

The goal is a one-prompt upgrade: detect the platform and call-site language, rewrite every v5 API to its v6 form, and leave the project building with no v5-only symbols remaining.

⚠️ The change you must surface first: default running mode is now Observer

This is the single most impactful v6 change and it is silent — the project keeps compiling.

• v5 defaulted to Full mode (Purchasely processes and validates purchases).
• v6 defaults to Observer mode (Purchasely only observes transactions).

If the app relies on Purchasely to handle and validate purchases, you MUST set the running mode to Full explicitly during the init rewrite: