Deprecated Paint.enableDithering

Most users and libraries will not need to make any changes.

For users that maintain golden tests, you might need to update your golden images to reflect the new default. For example, if you use [matchesGoldenFile][] to test a widget that contains a gradient:

$ flutter test --update-goldens

While this is not expected to be a common case, you can disable dithering temporarily by setting the enableDithering property in your main() method (either in an app or test):

  void main() {
+   // TODO: Remove this after XYZ.
+   Paint.enableDithering = false;

    runApp(MyApp());
  }

As the plan is to permanently remove the enableDithering property, please provide feedback in [Issue 112498][] if you have a use case that requires disabling dithering (due to performance, crashes).

If you must draw gradients without dithering, you can write a custom fragment shader. Describing how to write shaders is outside the scope of this migration guide. For more information, refer to Writing and using fragment shaders.

NOTE: Flutter web does not support dithering: [Issue 134250][].