Skip to content

Feat/1.1.0 - #1

Merged
VMichael1999 merged 27 commits into
mainfrom
feat/1.1.0
Oct 25, 2026
Merged

VMichael1999 merged 27 commits into
mainfrom
feat/1.1.0

Conversation

@VMichael1999

Copy link
Copy Markdown
Owner

1.1.0: attribution, fixes, compatibility and quality

Attribution

  • Restore the upstream BSD-3-Clause notice (google_map_animation, Manish Relani) and state in the README that this is a fork.

Fixes (each with a regression test)

  • Delays no longer shorten the animation (behavior change)
  • generateEquidistantPolylineByDuration: no duplicated first point, correct spacing at joins, includes the last point (behavior change)
  • Animator equality includes delays and colors
  • SnackAnimator and ColorTransitionAnimation accept the missing parameters
  • Stationary markers keep their rotation; new useMarkerRotation option
  • Renamed delayed_curved_animation.dart; documented onAnimationStop

Compatibility

  • Dart >=3.4, Flutter >=3.22, platform_interface ^2.10.0; platforms: android, ios, web
  • Example no longer requests the legacy Android renderer

Quality

  • 70 tests, 97.6% line coverage
  • GitHub Actions CI (format, analyze, tests + coverage gate, min/latest matrix, publish dry run, Android build)
  • README: animated markers, ID clash warning; dartdoc on the public API

Not verified locally: Flutter 3.22 (CI matrix covers it), web at runtime, manual device checks.
Pending: the demo GIF is still 7 MB (excluded from the published package).

- LICENSE: original BSD-3-Clause notice (Manish Relani) plus fork section
- README: state this is a fork, drop ToolRides wording, fix links and GIF alt
- lib/src: add origin header to copied files
- doc/notes/upstream.md: draft message for the original author
Formatting only, no behavior change.
The AnimationController lasted only `duration` while DelayedCurvedAnimation
computed its interval over duration + delayStart + delayEnd, so delays ate
into the drawing time. The controller now runs for the whole cycle.

Behavior change: animations with delays now take the full `duration` to draw.
- the first point was emitted twice
- the offset carried across segment joins had the wrong sign, so spacing
  drifted after every join
- the last point of the path was never included

Also returns the path unchanged when its total length is zero, which would
otherwise loop forever with a zero spacing.
PolylineAnimator ignored delayStart and delayEnd in == and hashCode, and
ColorTransitionAnimation ignored its colors, so the polyline manager kept the
old animation when only those values changed.
…onAnimation

SnackAnimator now accepts delayStart and delayEnd. ColorTransitionAnimation
now accepts repeatCount, reverse, delayStart and delayEnd. Defaults keep the
previous behavior.
computeHeading between identical positions is 0, so a stationary marker
snapped to face north. Moves shorter than 0.5 m now keep the current rotation.

useMarkerRotation (default false) uses Marker.rotation as the target rotation
instead of the heading, matching the name used by the original package.
It is called once when the animation completes. It is not called on dispose
or for endless repeating animations. Also tidies unused test code.
withValues needs Flutter 3.27. withAlpha works on every supported version.
Adds a test for the fade-in phase of FadeInProgressiveAnimator.
- sdk >=3.4.0, flutter >=3.22.0 (was flutter >=1.17.0)
- google_maps_flutter_platform_interface ^2.10.0, the first release that
  supports Flutter 3.22; tests pass against 2.10.0 and the latest version
- flutter_lints ^4.0.0 so the package still resolves on Dart 3.4
- platforms: android, ios, web
- repository links point to VMichael1999
Formatting only, no behavior change.
The legacy renderer is no longer supported by Google Maps and requesting it
has no effect, so the initialization block is gone. This also drops two
imports of packages the example did not declare.
FakeMapsPlatform records marker and polyline updates so tests can check what
a real map would show: initial state, animated polylines, marker movement and
deferred removal, static polyline updates and dispose.
Jobs: format/analyze/test with a 90% coverage gate and Codecov upload;
Flutter 3.22.0 and stable against minimum and latest dependencies;
publish dry run; Android debug build of the example. The demo GIF (7 MB)
is left out of the published package.
Also lists web as a supported platform and links the demo GIF by absolute URL
because it is no longer part of the published package.
All exported classes, constructors, fields and methods now have dartdoc
comments. The lint is enabled; internal files that are not exported opt out.
README.md is the English version shown on pub.dev; README.es.md is the
Spanish one, linked from the top of each file. Adds badges, a table of
contents, requirements, a table of built-in animators, a custom animator
example and contributing steps.
@VMichael1999 VMichael1999 self-assigned this Oct 25, 2026
@codecov-commenter

Copy link
Copy Markdown

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

ℹ️ You can also turn on project coverage checks and project coverage reporting on Pull Request comment

Thanks for integrating Codecov - We've got you covered ☂️

Recent Flutter rewrites analysis_options.yaml on pub get, which made
flutter pub publish --dry-run warn about modified files in CI.
Both failed to compile on Flutter 3.22.0, the minimum declared in the pubspec:
- AnimationController.repeat(count:) does not exist there. Limited repeats
  now use a small Simulation with the same timing as repeat(count:).
- DelayedCurvedAnimation overrode isAnimating, which CurvedAnimation does not
  have in 3.22. The getter is renamed to isInAnimationPhase (internal class).

Adds tests for repeatCount, with and without reverse.
Flutter stable now requires Gradle 8.14 or newer, so the Android build of the
example failed. Moves to Gradle 9.3.1, AGP 9.1.0, Kotlin 2.4.0 and Java 17,
as in the current Flutter template, and uses flutter.ndkVersion.
The example needs Dart 3.7, so flutter pub get/upgrade/downgrade failed on
Flutter 3.22.0 while resolving it. The compatibility job now passes
--no-example and --no-pub, since it only checks lib and test.
flutter pub upgrade --no-example resolves the packages but then fails with
"example/.dart_tool/package_config.json does not exist" on a clean checkout.
dart pub does the same resolution without touching the example.
@VMichael1999
VMichael1999 merged commit 1a97653 into main Oct 25, 2026
8 checks passed
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