Urgent need of a migration guide/documentation for `amplitude_flutter 4.0.0`

[Dohmanlechx]

Urgent need of a migration guide/documentation for `amplitude_flutter 4.0.0`

[Dohmanlechx]

Hi @Dohmanlechx, Thanks for choosing Amplitude. We are in the progress of updating the Flutter SDK and just release 4.0.0-beta.1. We follow semantic versioning. As you can see it's a major version with breaking changes and also a beta version with potential interfaces changes. The beta version is under the branch beta and you can find the example app under the example directory.

@Mercy811 Yeah, breaking changes in a major version update is fair. I didn't find any documentation or migration guide, but I eventually found it when I made another Google search. #182 (comment)

What is your dependencies section of your pubspec.yaml? If it's amplitude_flutter: ^3, it should not auto upgrade to a new major version even if your app uses the latest Android Gradle version.

amplitude_flutter ^3 is unable to run with the latest version of Android Gradle. At least I got this error:

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':amplitude_flutter:compileReleaseKotlin'.
> 'compileReleaseJavaWithJavac' task (current target is 1.8) and 'compileReleaseKotlin' task (current target is 17) jvm target compatibility should be set to the same Java version.
  Consider using JVM toolchain: https://kotl.in/gradle/jvm/toolchain

It's the reason why I bumped the Amplitude package to 4.0.0. This is explicitly stated in the description:

From Amplitude Flutter v4, we bump up the kotlin version to v1.9.22 to support latest Gradle.

[Dohmanlechx]

Found it. Sorry. I'll paste the link here in case someone can't find it:
https://www.docs.developers.amplitude.com/data/sdks/flutter/migration/

[Dohmanlechx]

However, that link should definitively be in the description of the Flutter package!

[Mercy811]

Hi @Dohmanlechx, Thanks for choosing Amplitude. We are in the progress of updating the Flutter SDK and just release 4.0.0-beta.1. We follow semantic versioning. As you can see it's a major version with breaking changes and also a beta version with potential interfaces changes. The beta version is under the branch beta and you can find the example app under the example directory.

Today I bumped the Amplitude package version from 3.16.2 to 4.0.0-beta.1 because our app uses the latest Android Gradle version.

What is your dependencies section of your pubspec.yaml? If it's amplitude_flutter: ^3, it should not auto upgrade to a new major version even if your app uses the latest Android Gradle version.