Skip to main content
This section provides migration guides to help you upgrade between major versions of the Rive iOS Runtime SDK.

​
Available Migration Guides

Migrating from 5.x to 6.x

Learn about breaking changes and how to migrate from version 5.x to 6.x

​
Why Migrate?

Keeping your Rive iOS Runtime up to date ensures you benefit from:
  • Performance improvements - Each major version includes optimizations and rendering enhancements
  • New features - Access the latest Rive capabilities like data binding, scripting, and multi-touch support
  • Bug fixes - Critical fixes and stability improvements
  • Platform support - Support for the latest iOS, macOS, tvOS, and visionOS versions
  • Security updates - Stay current with security patches and best practices

​
General Migration Tips

​
1. Review the CHANGELOG

Before migrating, review the CHANGELOG for detailed information about all changes between versions.

​
2. Update Dependencies

Update your dependency manager configuration: 
// In Package.swift
dependencies: [
    .package(url: "https://github.com/rive-app/rive-ios.git", from: "6.0.0")
]

​
3. Test Thoroughly

After migration:
  • Test all Rive animations in your app
  • Verify state machine interactions work as expected
  • Check layout and rendering on different device sizes
  • Test on all supported platforms (iOS, macOS, tvOS, visionOS)
  • Review performance metrics

​
4. Incremental Updates

For the smoothest migration experience:
  1. Update to the latest patch version of your current major version first
  2. Address any deprecation warnings
  3. Then upgrade to the next major version
  4. Test thoroughly at each step

​
Getting Help

If you encounter issues during migration:

​
Version Support

We recommend always using the latest stable version of the Rive iOS Runtime. Older major versions may not receive updates or bug fixes.
For minimum supported platform versions, see Package.swift.

Build docs developers (and LLMs) love

Get started for freeTalk to us