[BUG][Web] Crash in Release mode with v0.25.0 (Uncaught Error / Minification issues)

[R-3MY]

Platforms

web

Version of flutter maplibre_gl

0.25.0

Bug Description

Hi, I am encountering a critical issue with version 0.25.0 on Web. Everything works perfectly in Debug mode, but the app crashes in Release mode (flutter run -d chrome --release).

It seems related to minification or JS interop issues with the new version (Dart objects not being properly handled/converted for the JS side in release).

I can confirm the issue only appear in release version of 0.25.0 and is not present in 0.24.1 at all.

Logs from 0.24.1 :
GETTING LAYERS...
js_primitives.dart:28 LAYERS : [background, coastline, countries-fill, countries-boundary, geolines, geolines-label, countries-label, crimea-fill, BIiwKtKJWt_0, BIiwKtKJWt_1, MgZ2UT3c6x_0, hPVt9b0hzL_0, aa3uAygkb1_0, aa3uAygkb1_1]

Steps to Reproduce

Create a new flutter project and add maplibre_gl: ^0.25.0 dependency to pubspec
Don't forget to add required js & css maplibre urls in index.html head (follow package instructions)
Run in release : flutter run -d chrome --release

Expected Results

List of layerIds.

Actual Results

Error in console :
GETTING LAYERS...

core_patch.dart:293 Uncaught Error
    at VG.$1 (maplibre_web_gl_platform.dart:1372:40)
    at ab.cm (iterable.dart:442:29)
    at be.n (iterable.dart:371:5)
    at Object.A (core_patch.dart:377:5)
    at core_patch.dart:364:23
    at aaN.a (async_patch.dart:339:19)
    at aaN.$2 (async_patch.dart:365:23)
    at Object.D (async_patch.dart:265:3)
    at p1.kS (maplibre_web_gl_platform.dart:1372:5)
    at main.dart:38:37
apU	@	core_patch.dart:293
apV	@	errors.dart:120
$0	@	zone.dart:1512
ax4	@	schedule_microtask.dart:119
axf	@	schedule_microtask.dart:49
$1	@	async_patch.dart:55
childList		
$1	@	async_patch.dart:75
akB	@	async_patch.dart:33
qX	@	zone.dart:1623
S9	@	zone.dart:1869
ja	@	future_impl.dart:763
eY	@	future_impl.dart:359
(anonymous)	@	feedback.dart:101
(anonymous)	@	async_patch.dart:339
$2	@	async_patch.dart:365
D	@	async_patch.dart:265
Si	@	feedback.dart:92
KJ	@	ink_well.dart:1220
(anonymous)	@	js_helper.dart:2635
L_	@	recognizer.dart:345
dW	@	recognizer.dart:326
KM	@	tap.dart:758
DO	@	tap.dart:383
KH	@	tap.dart:314
iA	@	recognizer.dart:721
(anonymous)	@	js_helper.dart:2646
TZ	@	pointer_router.dart:97
$2	@	pointer_router.dart:142
a9	@	linked_hash_map.dart:193
Er	@	pointer_router.dart:140
Ml	@	pointer_router.dart:130
iB	@	binding.dart:528
a3F	@	binding.dart:498
Ft	@	binding.dart:473
zR	@	binding.dart:394
wY	@	binding.dart:341
Wu	@	binding.dart:308
(anonymous)	@	js_helper.dart:2646
jt	@	platform_dispatcher.dart:1553
a79	@	platform_dispatcher.dart:292
(anonymous)	@	js_helper.dart:2657
me	@	main.dart.js:25800
$1	@	pointer_binding.dart:1070
$1	@	pointer_binding.dart:953
$1	@	pointer_binding.dart:576
a8o	@	zone.dart:1849
v6	@	zone.dart:1848
$1	@	zone.dart:1804
aw4	@	js_allow_interop_patch.dart:363
(anonymous)	@	js_allow_interop_patch.dart:132

Code Sample

import 'package:flutter/material.dart';
import 'package:maplibre_gl/maplibre_gl.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(home: MapTestPage());
  }
}

class MapTestPage extends StatefulWidget {
  const MapTestPage({super.key});

  @override
  State<MapTestPage> createState() => _MapTestPageState();
}

class _MapTestPageState extends State<MapTestPage> {
  MapLibreMapController? mapController;
  bool isLoaded = false;

  void _onMapCreated(MapLibreMapController controller) {
    mapController = controller;
  }

  Future<void> _getLayerIds() async {
    if (mapController == null) {
      debugPrint("MAPCONTROLLER NULL");
      return;
    }
    debugPrint("GETTING LAYERS...");
    var layers = await mapController!.getLayerIds();
    debugPrint("LAYERS : $layers");
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("Test MapLibre 0.25.0")),
      floatingActionButton: FloatingActionButton(
        onPressed: _getLayerIds,
        child: const Icon(Icons.print),
      ),
      body: MapLibreMap(
        styleString: "https://demotiles.maplibre.org/style.json",
        initialCameraPosition: const CameraPosition(
          target: LatLng(46.603354, 1.888334),
          zoom: 5,
        ),
        onMapCreated: _onMapCreated,
      ),
    );
  }
}

[gabbopalma]

Hello @R-3MY, thank you for reporting the issue.
We will look into it as soon as possible and try to resolve it.

In the meantime, we recommend using version 0.24.1.

[gabbopalma]

Have you tried to run the new version with WASM option?
https://docs.flutter.dev/platform-integration/web/wasm

flutter build web --wasm

[R-3MY]

Have you tried to run the new version with WASM option? https://docs.flutter.dev/platform-integration/web/wasm

flutter build web --wasm

I don't have tried the new WASM option because it's not supported for iOS : https://docs.flutter.dev/platform-integration/web/wasm#learn-more-about-browser-compatibility

[gabbopalma]

I checked it out, and it seems like the new getSourceIds and old getLayersId worked fine in debug mode, but something happened in the final version that caused the new flutter_js interop (compatible with WASM) to break.
I already have the fix ready, but it'll be released with the new version 0.25.1 in the middle of the month.

Currently, getSourceIds has only recently been introduced, and releasing a new version after just one day doesn't seem like the right choice.

Thank you for your patience.

[gabbopalma]

Hi @R-3MY, the JS interoperability bug and the new WASM compilation have been fixed and are now ready for use.
If you would like to stay up to date on this topic, you can align your pubspec.yaml package directly with the main branch of maplibre-flutter-gl.

  maplibre-flutter-gl:
    git:
      url: https://github.com/maplibre/flutter-maplibre-gl.git
      ref: main

I will only release the fix for this issue in the main, which seems to be a priority, and nothing else before version 0.26.0.
Or you can continue to use version 0.24.1 until the new version is released.