spine_flutter

Flutter

• Bug fixes
  • Fixed automated release publishing so native source files are included in the pub.dev package.

Flutter

• Additions
  • Added GitHub Actions release automation for spine-flutter.

Flutter

• Bug fixes
  • Updated bundled spine-c/spine-cpp sources and WebAssembly assets for the 4.3 release.

Flutter

• Additions
  • Added fromMemory methods to AtlasFlutter, SkeletonDataFlutter, SkeletonDrawableFlutter, and SpineWidget for loading Spine data from custom sources (memory, encrypted storage, databases, custom caching, etc.)
  • Added example load_from_memory.dart demonstrating how to load all assets into memory and use the fromMemory API

Dart

• Additions

  • Added Slider and SliderData classes for slider constraints
  • Added SliderTimeline and SliderMixTimeline for animating sliders
  • Added new pose system with BoneLocal, BonePose, and related classes
  • Added Pose, Posed, and PosedActive base classes for unified pose management

• Breaking changes

  • The Dart runtime is now fully auto-generated from the C runtime, maintaining the full C++ type hierarchy with proper nullability annotations. The code generator creates 150+ Dart files in lib/generated/ providing complete API coverage of all Spine runtime types.
  • All properties are now exposed as getters and setters instead of methods
  • API changes to match C++ naming conventions (see examples below)
  • Timeline apply() methods now take an additional appliedPose parameter

Flutter

• Breaking changes
  • Updated to use the new auto-generated Dart runtime with all the Dart API changes above

Migration Examples

The examples and documentation have been updated to demonstrate the minimal changes needed to migrate from 4.2 to 4.3.

Property Access Changes

Before (4.2):

controller.skeleton.setScaleX(0.5);
controller.skeleton.setScaleY(0.5);
controller.skeleton.findSlot("gun")?.setColor(Color(1, 0, 0, 1));

After (4.3):

controller.skeleton.scaleX = 0.5;
controller.skeleton.scaleY = 0.5;
controller.skeleton.findSlot("gun")?.pose.color.set(1, 0, 0, 1);

Animation State API Changes

Before (4.2):

controller.animationState.getData().setDefaultMix(0.2);
controller.animationState.setAnimationByName(0, "portal", true);
controller.animationState.addAnimationByName(0, "run", true, 0);

After (4.3):

controller.animationState.data.defaultMix = 0.2;
controller.animationState.setAnimation(0, "portal", true);
controller.animationState.addAnimation(0, "run", true, 0);

Event Access Changes

Before (4.2):

print("Event: ${event?.getData().getName()}");
print("Int value: ${event?.getIntValue()}");
print("Animation: ${entry?.getAnimation().getName()}");

After (4.3):

print("Event: ${event?.data.name}");
print("Int value: ${event?.intValue}");
print("Animation: ${entry?.animation.name}");

Bone Transform Changes (Pose System)

Before (4.2):

final bone = controller.skeleton.findBone("crosshair")!;
final parent = bone.getParent()!;
final position = parent.worldToLocal(worldPosition.dx, worldPosition.dy);
bone.setX(position.x);
bone.setY(position.y);

After (4.3):

final bone = controller.skeleton.findBone("crosshair")!;
final parent = bone.parent;
if (parent != null) {
  final position = parent.appliedPose.worldToLocal(worldPosition.dx, worldPosition.dy);
  bone.appliedPose.x = position.x;
  bone.appliedPose.y = position.y;
}

• Support for 16KB page alignement on Android. You must specify the NDK version in the build.gradle file of your app's Android project. See https://github.com/EsotericSoftware/spine-runtimes/issues/2849

• Port of commit f1e0f0f: Fixed animation not being mixed out in some cases.

• Merge fixes in spine-cpp(-lite)
• Prepare for upcoming Dart/Flutter releases, see https://github.com/EsotericSoftware/spine-runtimes/pull/2690

• Fix spine-flutter spec checksum in Podfile.lock, keeping version control cleaner. See https://github.com/EsotericSoftware/spine-runtimes/pull/2609

• Fix bug in IKConstraint leading to NaNs.

• Switch to spine-cpp SkeletonRenderer

• Fix issue in pubspec.yaml related to C++ include paths.

• Fix incompatibility with Gradle 8.x. See https://github.com/EsotericSoftware/spine-runtimes/issues/2553

• Fixes clipping in case of colinear clipping edges.

• Skeleton.getBounds() takes clipping into consideration.

• Switch to spine-cpp-lite

• Support static linking of native library, see https://github.com/EsotericSoftware/spine-runtimes/issues/2438

• Physics support

• Fix multiply blend mode, see https://esotericsoftware.com/forum/d/25369-spine-flutter-slot%E6%B7%B7%E5%90%88%E6%A8%A1%E5%BC%8F%E5%90%8Ealpha%E4%B8%A2%E5%A4%B1/2

• FilterQuality for texture atlas pages is now set to medium. It is configurable via Atlas.filterQuality. See https://github.com/EsotericSoftware/spine-runtimes/issues/2362
• Track Entry listeners are now invoked properly, see https://github.com/EsotericSoftware/spine-runtimes/issues/2349

• Fixed clipping bug, see https://github.com/EsotericSoftware/spine-runtimes/issues/2431

• Fixes #2412, single bone, translation only IK constraints did not take skeleton scale into account.

• Fixes compilation errors due to API change in Flutter 3.16.0, see this issue. Note: Depending on this version requires your project to depend on Flutter >= 3.16.0 as well.

• Fix allocation patter for temporary structs on Windows, which resulted in a hard crash without a stack trace on the native side.

• Fixed bug in path handling on Windows.

• Updated http dependency to 1.1.0

• Merge changes from 4.1.4.

• Fixes for Impeller.

• Merge changes from 4.1.1 and 4.1.2.

• Update README.md with setup and development instructions.

• Update README.md to point to Junji's Dart-only Spine runtime.

• Fix atlas parsing.

• Change reversed positional argument order in SpineWidget constructors.

• Change package name from esotericsoftware_spine_flutter to spine_flutter.

• Temporary "fix" for https://github.com/EsotericSoftware/spine-runtimes/issues/2479. It appears the canvaskit backend of Flutter has a bug. We currently do not set a FilterQuality anymore. The Flutter rendering backend is supposed to pick a good one depending the platform. Users can still set FilterQuality globally via Atlas.filterQuality as before.

• Fix multiply blend mode, see https://esotericsoftware.com/forum/d/25369-spine-flutter-slot%E6%B7%B7%E5%90%88%E6%A8%A1%E5%BC%8F%E5%90%8Ealpha%E4%B8%A2%E5%A4%B1/2

• FilterQuality for texture atlas pages is now set to medium. It is configurable via Atlas.filterQuality. See https://github.com/EsotericSoftware/spine-runtimes/issues/2362
• Track Entry listeners are now invoked properly, see https://github.com/EsotericSoftware/spine-runtimes/issues/2349

• Fixed clipping bug, see https://github.com/EsotericSoftware/spine-runtimes/issues/2431

• Update WASM binaries

*Fixes #2412, single bone, translation only IK constraints did not take skeleton scale into account.

• Fixes compilation errors due to API change in Flutter 3.16.0, see this issue. Note: Depending on this version requires your project to depend on Flutter >= 3.16.0 as well.

• Fix allocation patter for temporary structs on Windows, which resulted in a hard crash without a stack trace on the native side.

• Fixed bug in path handling on Windows.

• Updated http dependency to 1.1.0

• Fixes for WASM/web builds.

• Fixes for Impeller.

• API documentation and minor cosmetics.

• Backport to 4.1 spine-runtimes branch.
• Blend mode support.
• Hot-reload support. The underlying SkeletonDrawable will be retained if the asset file names and type provided to the SpineWidget constructor has not changed.