SurfaceProducer migration doc should be updated to use new onSurfaceCleanup function

[navaronbracke]

Page URL

https://docs.flutter.dev/release/breaking-changes/android-surface-plugins

Page source

No response

Describe the problem

When the onSurfaceDestroyed is deprecated in the future, and replaced by onSurfaceCleanup, the migration guide should be updated to reflect this.

There should also be a note that notifies readers that the old API was available in Flutter 3.27, but renamed in a to-be-named subsequent release.

There is prior art for a similar change in the document as of today:

In the upcoming stable release, 3.27, onSurfaceCreated is deprecated, and onSurfaceAvailable and handlesCropAndRotation are added.

so this change will closely follow that pattern.

Expected fix

The migration guide's code sample should be updated to use onSurfaceCleanup instead, and a footnote should be added to clarify how the transition happened, akin to what we did for the change relating to onSurfaceAvailable.

Additional context

The following issue talks about the aforementioned change: flutter/flutter#160933
and the PR that adds the API change is flutter/flutter#160937

I would like to fix this problem.

• I will try and fix this problem on docs.flutter.dev.

[sfshaza2]

@matanlurey, can you weigh in?