Why is withOpacity deprecated in Flutter 3.27.0, and what is its recommended replacement?

I'm upgrading my Flutter project to version 3.27.0, and I noticed that the withOpacity method is marked as deprecated. I'm using it in my code as follows:

  SizedBox(
  height: 55,
  width: 50,
  child: VerticalDivider(
    color: const Color(0xff171433).withOpacity(0.1),
    thickness: 1.5,
  ),
)

This code works fine in earlier versions of Flutter, but after the upgrade, I receive a warning that withOpacity is deprecated.

I reviewed the Flutter changelog for 3.27.0 but couldn't find detailed information about why this change was made.

Questions: Why was withOpacity deprecated in Flutter 3.27.0? What is the recommended alternative or best practice to achieve the same functionality?

I’d appreciate any insights into the reasoning behind this deprecation and how I can adapt my code for the new version.

The reason withOpacity has been deprecated in Flutter 3.27.0 is because, according to the Flutter docs:

"Previously, Color had the concept of opacity, which showed up in the methods opacity and withOpacity(). Opacity was introduced as a way to communicate with Color about its alpha channel using floating-point values. Now that alpha is a floating-point value, opacity is redundant, and both opacity and withOpacity are deprecated and slated to be removed."

The recommended replacement is using withValues(), which helps avoid precision loss because its values remain in their floating-point representation.

How to use withValues() correctly when migrating from withOpacity():

// Before
final x = color.withOpacity(0.0);

// After
final x = color.withValues(alpha: 0.0);