Bugfix: Android crash in BasemapGallery due to Canvas trying to use a recycled bitmap Exception (#664)

* - Added a new `ThumbnailImage` class in `BasemapGallery` to address a known issue with recycled bitmaps in MAUI `CollectionView` on Android, preventing related Java exceptions.

- Added a `using` statement for the stream from `Thumbnail.GetEncodedBufferAsync()`, ensuring proper disposal.

* Update BasemapGallery.Appearance.cs

Author: prathameshnarkhede

src/Toolkit/Toolkit.Maui/BasemapGallery/BasemapGallery.Appearance.cs

@@ -15,7 +15,8 @@
 //  ******************************************************************************/
 
 using Microsoft.Maui.Controls;
-using Microsoft.Maui.Controls.Shapes;
+using Microsoft.Maui.Controls.Shapes;
+using Microsoft.Maui.Platform;
 
 namespace Esri.ArcGISRuntime.Toolkit.Maui;
 
@@ -48,8 +49,25 @@ static BasemapGallery()
             outerScrimContainer.RowDefinitions.Add(new RowDefinition { Height = new GridLength(40) });
             outerScrimContainer.RowSpacing = 4;
 
-            Grid thumbnailGrid = new Grid() { WidthRequest = 64, HeightRequest = 64 };
+            Grid thumbnailGrid = new Grid() { WidthRequest = 64, HeightRequest = 64 };
+#if ANDROID
+            // Workaround for .NET MAUI Android bug where CollectionView throws
+            // Java.Lang.RuntimeException: 'Canvas: trying to use a recycled bitmap'
+            // (see https://github.com/dotnet/maui/issues/11519, affects MAUI 9.0.0).
+            // This occurs when images are reused in CollectionView, causing recycled bitmaps to be drawn.
+            // The workaround uses a custom ThumbnailImage control and a custom ImageHandler mapping
+            // to clear the native image view when the image source changes, preventing the recycled bitmap error.
+            ThumbnailImage thumbnail = new ThumbnailImage { Aspect = Aspect.AspectFill, BackgroundColor = Colors.Transparent, HorizontalOptions = LayoutOptions.Center };
+            Microsoft.Maui.Handlers.ImageHandler.Mapper.PrependToMapping(nameof(Microsoft.Maui.IImage.Source), static (handler, view) =>
+            {
+                if (view is ThumbnailImage)
+                {
+                    handler.PlatformView?.Clear();
+                }
+            });
+#else
             Image thumbnail = new Image { Aspect = Aspect.AspectFill, BackgroundColor = Colors.Transparent, HorizontalOptions = LayoutOptions.Center };
+#endif
             Border itemTypeBorder = new Border
             {
                 StrokeShape = new RoundRectangle { CornerRadius = new CornerRadius(7) },
@@ -385,4 +403,16 @@ protected override void OnSizeAllocated(double width, double height)
         // Size change could necesitate a switch between list and grid presentations.
         HandleTemplateChange(width);
     }
-}
+}
+
+#if ANDROID
+/// <summary>
+/// Represents an image used in the Basemap Gallery.
+/// <remarks>
+///  This class is only used on Android to work around a .NET MAUI bug where CollectionView may attempt to use a recycled bitmap,
+///  resulting in a Java.Lang.RuntimeException. By using a custom Image control and clearing the native image view when the source changes,
+///  this issue is avoided. See https://github.com/dotnet/maui/issues/11519 for more details.
+/// </remarks>
+/// </summary>
+internal class ThumbnailImage : Image { }
+#endif

src/Toolkit/Toolkit/UI/Controls/BasemapGallery/BasemapGalleryItem.cs

@@ -111,7 +111,7 @@ private async Task LoadImage()
 
                 if (Thumbnail?.LoadStatus == LoadStatus.Loaded)
                 {
-                    var stream = await Thumbnail.GetEncodedBufferAsync();
+                    using var stream = await Thumbnail.GetEncodedBufferAsync();
                     var buffer = new byte[stream.Length];
 #if NET8_0_OR_GREATER
                     await stream.ReadExactlyAsync(buffer);