Skip to content

feat!: Support Spine 4.3#3760

Merged
spydon merged 13 commits intoflame-engine:mainfrom
Taormina:taormina/spine-flutter-4.3
Nov 3, 2025
Merged

feat!: Support Spine 4.3#3760
spydon merged 13 commits intoflame-engine:mainfrom
Taormina:taormina/spine-flutter-4.3

Conversation

@Taormina
Copy link
Copy Markdown
Contributor

@Taormina Taormina commented Nov 2, 2025

Description

As-is, the existing flame_spine supports Spine 4.2. spine_flutter in 4.3.0 now supports Spine 4.3, and this is backwards incompatible and breaking. If you need Spine 4.2, you should not upgrade to flame_spine 0.3.0, but this is for anyone who is ready to make the Spine 4.3 jump. We recommend pinning to 0.2.2 for spine_flutter 4.2.36 if you are staying on Spine 4.2.

The top-level API has many breaking changes, and this changelog has a good summary of what needs to be done: https://pub.dev/packages/spine_flutter/changelog

The Dart code changes are relatively straightforward, but any Spine models need to be re-exported through the 4.3 Spine Editor (and you SHOULD make sure that all models still do everything that is expected! There might be random bones that don't look right any more, random animations, and certain models just don't work.)

Checklist

  • I have followed the Contributor Guide when preparing my PR.
  • I have updated/added tests for ALL new/updated/fixed functionality.
  • I have updated/added relevant documentation in docs and added dartdoc comments with ///.
  • I have updated/added relevant examples in examples or docs.

Breaking Change?

  • Yes, this PR is a breaking change.
  • No, this PR is not a breaking change.

Migration instructions

Dart API changes: https://pub.dev/packages/spine_flutter/changelog
Re-export at 4.2 Spine models from the 4.3 Spine Editor and confirm each model works.

Related Issues

@Taormina Taormina changed the title !feat: Support Spine 4.3 feat!: Support Spine 4.3 Nov 2, 2025
@Taormina
Copy link
Copy Markdown
Contributor Author

Taormina commented Nov 2, 2025

@spydon Any idea why the spell check lint is failing?

@Taormina
Copy link
Copy Markdown
Contributor Author

Taormina commented Nov 2, 2025

@spydon
Copy link
Copy Markdown
Member

spydon commented Nov 2, 2025

@spydon Any idea why the spell check lint is failing?

It's due to an update of the dictionary, so skel and antialiasing can be removed from our custom added words.

@Taormina
Copy link
Copy Markdown
Contributor Author

Taormina commented Nov 2, 2025

Well, I updated it. I must admit that I am surprised because I didn't delete any documentation, and .skel files are definitely still a thing, but whatever.

@spydon
Copy link
Copy Markdown
Member

spydon commented Nov 2, 2025

Well, I updated it. I must admit that I am surprised because I didn't delete any documentation, and .skel files are definitely still a thing, but whatever.

The general dictionary that we extend was updated to include those words, that's why we need to remove them from our custom add-ons.

Copy link
Copy Markdown
Member

@spydon spydon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just one small comment, otherwise it looks good to me!

Comment thread packages/flame_spine/pubspec.yaml Outdated
@Taormina
Copy link
Copy Markdown
Contributor Author

Taormina commented Nov 2, 2025

@spydon So, now it's mismatched in a few places. Do I need to drop it to 0.2.2 everywhere and the Melos release will update it in the tests/examples?

@spydon
Copy link
Copy Markdown
Member

spydon commented Nov 3, 2025

@spydon So, now it's mismatched in a few places. Do I need to drop it to 0.2.2 everywhere and the Melos release will update it in the tests/examples?

Yes, Melos will bump it everywhere automatically.

Copy link
Copy Markdown
Member

@spydon spydon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for your contribution!

@spydon spydon merged commit 17bc40c into flame-engine:main Nov 3, 2025
10 checks passed
nickf2k pushed a commit to nickf2k/flame that referenced this pull request Nov 16, 2025
As-is, the existing `flame_spine` supports Spine 4.2. `spine_flutter` in
4.3.0 now supports Spine 4.3, and this is backwards incompatible and
breaking. If you need Spine 4.2, you should not upgrade to `flame_spine`
0.3.0, but this is for anyone who is ready to make the Spine 4.3 jump.
We recommend pinning to 0.2.2 for `spine_flutter` 4.2.36 if you are
staying on Spine 4.2.

The top-level API has many breaking changes, and this changelog has a
good summary of what needs to be done:
https://pub.dev/packages/spine_flutter/changelog

The Dart code changes are relatively straightforward, but any Spine
models need to be re-exported through the 4.3 Spine Editor (and you
SHOULD make sure that all models still do everything that is expected!
There might be random bones that don't look right any more, random
animations, and certain models just don't work.)


Dart API changes: https://pub.dev/packages/spine_flutter/changelog
Re-export at 4.2 Spine models from the 4.3 Spine Editor and confirm each
model works.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants