chore: prepare v0.2.1 release (#226)

Author: josxha

.github/FUNDING.yml

@@ -1 +1,3 @@
+
+github: ["josxha"]
 custom: ["https://paypal.me/joschaeckert"]

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,14 @@
 blank_issues_enabled: false
 contact_links:
-  - name: "Q&A - GitHub Discussions"
-    url: https://github.com/josxha/flutter-maplibre/discussions/categories/q-a
+  - name: "Ask a Question"
+    url: https://github.com/josxha/flutter-maplibre/discussions/new?category=q-a
     about: "If you have a question about using MapLibre on Flutter"
+  - name: "Start a Discussion"
+    url: https://github.com/josxha/flutter-maplibre/discussions/new?category=general
+    about: "Start a discussion on some topic"
+  - name: "Share some Idea"
+    url: https://github.com/josxha/flutter-maplibre/discussions/new?category=ideas
+    about: "Share an idea, that isn't quite ready for a feature request"
   - name: "Join on Slack"
     url: https://slack.openstreetmap.us/
     about: "Join #maplibre-flutter on the OpenStreetMap Slack"

CHANGELOG.md

@@ -1,3 +1,46 @@
+## 0.2.1
+
+This release builds upon the long anticipated merged threads in Flutter 3.29.0
+which removes the need of switching threads. Furthermore, the release contains a
+couple of features and new fixes.
+
+Thanks for your contributions for this release, @felix-larsen and @pamtbaau!
+
+### New Features
+
+- Upgrade MapLibre Native on Android
+  to [11.8.0](https://github.com/maplibre/maplibre-native/blob/main/platform/android/CHANGELOG.md#1180)
+  which introduces support for PMTiles.
+- Add `removePinchOnPressed` and `webRotationSpeed` as parameters to the
+  `MapCompass` widget.
+- Allow the `SourceAttribution` widget to use multiple lines for its
+  attributions.
+- Underline an attribution link for a `SourceAttribution` widget when hovered
+  with a cursor.
+- Add the parameter `allowInteraction` to the `WidgetLayer` that allows widgets
+  to detect gestures on these widgets.
+- Reintroduce awaitable `moveCamera()`, `animateCamera()` and `fitCamera()` on
+  Android.
+- Use synchronous JNI calls on Android to prevent thread hopping.
+
+### Bug Fixes
+
+- Fix exceptions when the map widget rebuilds a lot in a short amount of time.
+- Fix `moveCamera()`, `animateCamera()` and `fitCamera()` does not ignore null
+  parameters.
+- Fix app freeze on Android using Flutter 3.29.0 caused by the merged threads.
+- Fix exception when adding a RasterSource programatically.
+
+### Misc
+
+- Update examples and documentation.
+- Set minimum Flutter version
+  to [3.29.0](https://discord.com/channels/951867686378409984/951879268227485707/1339719764574081148)
+  and minimum Dart version
+  to [3.7.0](https://discord.com/channels/951867686378409984/951879268227485707/1339719747981545485).
+- Use the new code formatting.
+- Upgrade pigeon to 24.
+
 ## 0.2.0
 
 This release is a collection of user affecting changes along a couple of new

README.md

@@ -110,4 +110,5 @@ development:
   feature, [open a feature request](https://github.com/josxha/flutter-maplibre/issues/new?assignees=&labels=feature&projects=&template=2-feature.yml&title=%5BFEATURE%5D+%3Ctitle%3E).
   or [post your idea as discussion](https://github.com/josxha/flutter-maplibre/discussions/categories/ideas).
 - Enhance the package documentation.
-- [Sponsor this project](https://www.paypal.com/paypalme/joschaeckert).
+- Sponsor this
+  project: [GitHub-Sponsors](https://github.com/sponsors/josxha), [PayPal](https://www.paypal.com/paypalme/joschaeckert).

docs/src/pages/features.md

@@ -22,15 +22,15 @@ lack of platform views of these platforms.
 
 ### General Functionality
 
-| Feature             | web | android | iOS | windows | macOS | linux |
-|---------------------|-----|---------|-----|---------|-------|-------|
-| Map                 | ✅   | ✅       | ❌   | ➖       | ➖     | ➖     |
-| MapController       | ✅   | ✅       | ❌   | ➖       | ➖     | ➖     |
-| UI Controls for web | ✅   | ✅       | ➖   | ➖       | ➖     | ➖     |
-| Offline             | ➖   | ✅       | ❌   | ➖       | ➖     | ➖     |
-| Events              | ✅   | ✅       | ❌   | ➖       | ➖     | ➖     |
-| Snapshotter         | ➖   | ❌       | ❌   | ➖       | ➖     | ➖     |
-| Annotations         | ✅   | ✅       | ❌   | ➖       | ➖     | ➖     |
+| Feature       | web | android | iOS | windows | macOS | linux |
+|---------------|-----|---------|-----|---------|-------|-------|
+| Map           | ✅   | ✅       | ❌   | ➖       | ➖     | ➖     |
+| MapController | ✅   | ✅       | ❌   | ➖       | ➖     | ➖     |
+| Offline       | ➖   | ✅       | ❌   | ➖       | ➖     | ➖     |
+| Events        | ✅   | ✅       | ❌   | ➖       | ➖     | ➖     |
+| Annotations   | ✅   | ✅       | ❌   | ➖       | ➖     | ➖     |
+| MBTiles       | ➖   | ✅       | ❌   | ➖       | ➖     | ➖     |
+| PMTiles       | ❌   | ✅       | ❌   | ➖       | ➖     | ➖     |
 
 ### Style Layers
 

example/analysis_options.yaml

@@ -4,4 +4,3 @@ linter:
   rules:
     public_member_api_docs: false
     document_ignores: true
-    avoid_catches_without_on_clauses: true

example/lib/extensions.dart

@@ -0,0 +1,10 @@
+import 'package:flutter/material.dart';
+
+extension BuildContextExt on BuildContext {
+  void showSnackBox(String message) {
+    debugPrint(message);
+    ScaffoldMessenger.of(this)
+      ..hideCurrentSnackBar()
+      ..showSnackBar(SnackBar(content: Text(message)));
+  }
+}

example/lib/permissions_page.dart

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:maplibre/maplibre.dart';
+import 'package:maplibre_example/extensions.dart';
 
 @immutable
 class PermissionsPage extends StatefulWidget {
@@ -42,16 +43,24 @@ class _PermissionsPageState extends State<PermissionsPage> {
           ),
           ListTile(
             title: OutlinedButton(
-              child: const Text('requestLocationPermissions'),
+              child: const Text('Request Location Permissions'),
               onPressed: () async {
                 try {
                   final granted = await _manager.requestLocationPermissions(
                     explanation: 'Show the user location on the map.',
                   );
-                  debugPrint('requestLocationPermissions granted: $granted');
+                  if (context.mounted) {
+                    if (granted) {
+                      context.showSnackBox('Permission granted.');
+                    } else {
+                      context.showSnackBox('Permission not granted.');
+                    }
+                  }
                   setState(() {}); // refresh the screen
-                } on Exception catch (error, stacktrace) {
-                  debugPrint(error.toString());
+                } catch (error, stacktrace) {
+                  if (context.mounted) {
+                    context.showSnackBox(error.toString());
+                  }
                   debugPrintStack(stackTrace: stacktrace);
                 }
               },

example/lib/user_location_page.dart

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:maplibre/maplibre.dart';
+import 'package:maplibre_example/extensions.dart';
 import 'package:maplibre_example/map_styles.dart';
 
 @immutable
@@ -35,7 +36,11 @@ class _UserLocationPageState extends State<UserLocationPage> {
                         .requestLocationPermissions(
                           explanation: 'Show the user location on the map.',
                         );
-                    debugPrint(granted.toString());
+                    if (context.mounted) {
+                      context.showSnackBox(
+                        'Permission ${granted ? 'granted' : 'not granted'}.',
+                      );
+                    }
                   },
                   child: const Text(
                     'Get permission',
@@ -44,7 +49,16 @@ class _UserLocationPageState extends State<UserLocationPage> {
                 ),
                 OutlinedButton(
                   onPressed: () async {
-                    await _controller.enableLocation();
+                    try {
+                      await _controller.enableLocation();
+                      if (context.mounted) {
+                        context.showSnackBox('Location enabled.');
+                      }
+                    } catch (error) {
+                      if (context.mounted) {
+                        context.showSnackBox(error.toString());
+                      }
+                    }
                   },
                   child: const Text(
                     'Enable location',
@@ -53,7 +67,16 @@ class _UserLocationPageState extends State<UserLocationPage> {
                 ),
                 OutlinedButton(
                   onPressed: () async {
-                    await _controller.trackLocation();
+                    try {
+                      await _controller.trackLocation();
+                      if (context.mounted) {
+                        context.showSnackBox('Tracking location.');
+                      }
+                    } catch (error) {
+                      if (context.mounted) {
+                        context.showSnackBox(error.toString());
+                      }
+                    }
                   },
                   child: const Text(
                     'Track location',

pubspec.yaml

@@ -1,6 +1,6 @@
 name: maplibre
 description: "Permissive and performant mapping library that supports Mapbox Vector Tiles (MVT) powered by MapLibre SDKs."
-version: 0.2.0
+version: 0.2.1
 repository: https://github.com/josxha/flutter-maplibre
 issue_tracker: https://github.com/josxha/flutter-maplibre/issues
 homepage: https://flutter-maplibre.pages.dev
@@ -10,6 +10,7 @@ topics: [ map, maplibre, mvt ]
 
 funding:
   - https://paypal.me/joschaeckert
+  - https://github.com/sponsors/josxha
 
 platforms:
   android: