This guide will help you migrate from older versions of the Linkrunner SDK to the latest version in your Expo application.
Need installation help? For fresh installations, see the Installation Guide.

​
Migration Guide to v3.x.x

If you are using expo-linkrunner with v1.x.x or v2.x.x then moving forward you’ll need to migrate to a v3.x.x.

​
Architecture Changes

Starting with version 3.0.0, the Expo SDK has been redesigned to use a new architecture:
  • Config Plugin Architecture: The SDK now uses an Expo config plugin for better integration with the Expo ecosystem
  • React Native SDK: Business logic is now handled by the React Native SDK, ensuring consistency across platforms
  • Improved Developer Experience: Simplified setup with automatic native configuration

​
Breaking Changes

  • The package installation process has changed to require both React Native and Expo SDKs
  • Plugin configuration is now required in app.json

​
Migration Steps

  1. Uninstall the old package: 
    npx expo uninstall expo-linkrunner
  2. Install the new version (see Installation section)
  3. Update your code to use rn-linkrunner: The expo-linkrunner package is now just a config plugin. All SDK methods and APIs are now provided by the rn-linkrunner package. You’ll need to update your imports and usage accordingly. For detailed implementation instructions, see the Next Steps section in the installation guide.