feat: Add option for a custom image and asset loader

packages/flame_tiled/lib/src/flame_tsx_provider.dart

@@ -1,10 +1,12 @@
 import 'package:flame/flame.dart';
+import 'package:flutter/services.dart';
 import 'package:tiled/tiled.dart';
 import 'package:xml/xml.dart';
 
 /// A implementation of [TsxProvider] use by RenderableTileMap.
 ///
-/// It uses [Flame.bundle] and has a built-in cache for the file read.
+/// It uses [Flame.bundle] or a custom asset bundle
+/// and has a built-in cache for the file read.
 class FlameTsxProvider implements TsxProvider {
  /// Parsed data for this tsx file.
  final String data;
@@ -34,8 +36,11 @@ class FlameTsxProvider implements TsxProvider {
  /// Parses a file returning a [FlameTsxProvider].
  ///
  /// NOTE: this method looks for files under the path "assets/tiles/".
- static Future<FlameTsxProvider> parse(String key) async {
- final data = await Flame.bundle.loadString('assets/tiles/$key');
+ static Future<FlameTsxProvider> parse(
+ String key, [
+ AssetBundle? bundle,
+ ]) async {
+ final data = await (bundle ?? Flame.bundle).loadString('assets/tiles/$key');
  return FlameTsxProvider._(data, key);
  }
 }

packages/flame_tiled/lib/src/renderable_layers/image_layer.dart

@@ -1,3 +1,4 @@
+import 'package:flame/cache.dart';
 import 'package:flame/components.dart';
 import 'package:flame/extensions.dart';
 import 'package:flame/flame.dart';
@@ -68,13 +69,14 @@ class FlameImageLayer extends RenderableLayer<ImageLayer> {
  required CameraComponent? camera,
  required TiledMap map,
  required Vector2 destTileSize,
+ Images? images,
  }) async {
  return FlameImageLayer(
  layer: layer,
  parent: parent,
  map: map,
  destTileSize: destTileSize,
- image: await Flame.images.load(layer.image.source!),
+ image: await (images ?? Flame.images).load(layer.image.source!),
  );
  }
 

packages/flame_tiled/lib/src/renderable_layers/renderable_layer.dart

@@ -1,3 +1,4 @@
+import 'package:flame/cache.dart';
 import 'package:flame/components.dart';
 import 'package:flame/extensions.dart';
 import 'package:flame_tiled/src/renderable_layers/group_layer.dart';
@@ -35,6 +36,7 @@ abstract class RenderableLayer<T extends Layer> {
  required Map<Tile, TileFrames> animationFrames,
  required TiledAtlas atlas,
  bool? ignoreFlip,
+ Images? images,
  }) async {
  if (layer is TileLayer) {
  return FlameTileLayer.load(
@@ -53,6 +55,7 @@ abstract class RenderableLayer<T extends Layer> {
  camera: camera,
  map: map,
  destTileSize: destTileSize,
+ images: images,
  );
  } else if (layer is ObjectGroup) {
  return ObjectLayer.load(

packages/flame_tiled/lib/src/renderable_tile_map.dart

@@ -1,5 +1,6 @@
 import 'dart:async';
 
+import 'package:flame/cache.dart';
 import 'package:flame/components.dart';
 import 'package:flame/extensions.dart';
 import 'package:flame/flame.dart';
@@ -13,6 +14,7 @@ import 'package:flame_tiled/src/tile_animation.dart';
 import 'package:flame_tiled/src/tile_atlas.dart';
 import 'package:flame_tiled/src/tile_stack.dart';
 import 'package:flutter/painting.dart';
+import 'package:flutter/services.dart';
 import 'package:tiled/tiled.dart';
 
 /// {@template _renderable_tiled_map}
@@ -201,13 +203,17 @@ class RenderableTiledMap {
  Vector2 destTileSize, {
  CameraComponent? camera,
  bool? ignoreFlip,
+ Images? images,
+ AssetBundle? bundle,
  }) async {
  final contents = await Flame.bundle.loadString('assets/tiles/$fileName');
  return fromString(
  contents,
  destTileSize,
  camera: camera,
  ignoreFlip: ignoreFlip,
+ images: images,
+ bundle: bundle,
  );
  }
 
@@ -219,16 +225,20 @@ class RenderableTiledMap {
  Vector2 destTileSize, {
  CameraComponent? camera,
  bool? ignoreFlip,
+ Images? images,
+ AssetBundle? bundle,
  }) async {
  final map = await TiledMap.fromString(
  contents,
- FlameTsxProvider.parse,
+ (key) => FlameTsxProvider.parse(key, bundle),
  );
  return fromTiledMap(
  map,
  destTileSize,
  camera: camera,
  ignoreFlip: ignoreFlip,
+ images: images,
+ bundle: bundle,
  );
  }
 
@@ -240,6 +250,8 @@ class RenderableTiledMap {
  Vector2 destTileSize, {
  CameraComponent? camera,
  bool? ignoreFlip,
+ Images? images,
+ AssetBundle? bundle,
  }) async {
  // We're not going to load animation frames that are never referenced; but
  // we do supply the common cache for all layers in this map, and maintain
@@ -259,6 +271,7 @@ class RenderableTiledMap {
  animationFrames,
  atlas: await TiledAtlas.fromTiledMap(map),
  ignoreFlip: ignoreFlip,
+ images: images,
  );
 
  return RenderableTiledMap(
@@ -279,6 +292,7 @@ class RenderableTiledMap {
  Map<Tile, TileFrames> animationFrames, {
  required TiledAtlas atlas,
  bool? ignoreFlip,
+ Images? images,
  }) async {
  final visibleLayers = layers.where((layer) => layer.visible);
 
@@ -292,6 +306,7 @@ class RenderableTiledMap {
  animationFrames: animationFrames,
  atlas: atlas,
  ignoreFlip: ignoreFlip,
+ images: images,
  );
 
  if (layer is Group && renderableLayer is GroupLayer) {
@@ -304,6 +319,7 @@ class RenderableTiledMap {
  animationFrames,
  atlas: atlas,
  ignoreFlip: ignoreFlip,
+ images: images,
  );
  }