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), and Flutter v5.x → v6.0.0-rc.1 are supported. React Native and Cordova v6 migrations are not ready — stop and explain if asked.

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: