v7.2.0: Major bug fixes and improvements (JaffaKetchup#111)

* Added `maxStoreLength` config to example app Fixed bugs Improved documentation * Built Example Applications * Improved migrator stability * Built Example Applications * Fixed JaffaKetchup#106 with similar fix to JaffaKetchup#107 Fixed example application bug * Fixed JaffaKetchup#59 (over JaffaKetchup#110), by adding 'watcher' package * Reinforced 5617ca8 to add secondary redundant fix for JaffaKetchup#106 (JaffaKetchup#107) * Reinforced 5617ca8 / 76e732c to add tertiary redundant fix for JaffaKetchup#106 (JaffaKetchup#107) * Built Example Applications * Updated pubspec versioning Updated changelog Improved GitHub Actions workflow * Built Example Applications * Improved general stability and reliability Improved documentation --------- Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Former-commit-id: 8419f998bd251214819c939cf1340e52b4c5cbce [formerly 12256f5] Former-commit-id: 9f5bb84e4e9e3d32cc673fc2704585b4add38c68

Author: JaffaKetchup

.github/workflows/main.yml

@@ -5,6 +5,7 @@ jobs:
  package-analysis:
  name: "Analyse Package"
  runs-on: ubuntu-latest
+ if: github.event.head_commit.message != 'Built Example Applications'
  steps:
  - name: Checkout Repository
  uses: actions/checkout@v3
@@ -27,6 +28,7 @@ jobs:
  content-analysis:
  name: "Analyse Contents"
  runs-on: ubuntu-latest
+ if: github.event.head_commit.message != 'Built Example Applications'
  steps:
  - name: Checkout Repository
  uses: actions/checkout@v3

CHANGELOG.md

@@ -13,6 +13,16 @@ Many thanks to my sponsors, no matter how much or how little they donated. Spons
 
 # Changelog
 
+## [7.2.0] - 2023/03/XX
+
+* Stability improvements
+ * Starting multiple downloads no longer causes `LateInitializationErrors`
+ * Migrator storage and memory usage no longer spikes as significantly as previously, thanks to transaction batching
+ * Opening and processing of stores on initialisation is more robust and less error-prone to filename variations
+ * Root statistic watching now works on all platforms
+* Multiple minor bug fixes and documentation improvements
+* Added `maxStoreLength` config to example app
+
 ## [7.1.2] - 2023/02/18
 
 * Minor bug fixes

example/currentAppVersion.txt

@@ -1 +1 @@
-7.1.2
+7.2.0

example/lib/screens/main/pages/map/map_view.dart

@@ -76,6 +76,9 @@ class _MapPageState extends State<MapPage> {
  metadata.data!['validDuration']!,
  ),
  ),
+ maxStoreLength: int.parse(
+ metadata.data!['maxLength']!,
+ ),
  ),
  )
  : NetworkNoRetryTileProvider(),

example/lib/screens/main/pages/settingsAndAbout/settings_and_about.dart

@@ -80,7 +80,7 @@ class _SettingsAndAboutPageState extends State<SettingsAndAboutPage> {
  context: context,
  applicationName: 'FMTC Demo',
  applicationVersion:
- 'for v7.1.0\n(on ${Platform().operatingSystemFormatted})',
+ 'for v7.2.0\n(on ${Platform().operatingSystemFormatted})',
  applicationIcon: Image.asset(
  'assets/icons/ProjectIcon.png',
  height: 48,

example/lib/screens/main/pages/stores/components/store_tile.dart

@@ -177,8 +177,7 @@ class _StoreTileState extends State<StoreTile> {
  setState(
  () => _emptyingProgress = true,
  );
- _store.manage.reset();
-
+ await _store.manage.resetAsync();
  setState(
  () => _emptyingProgress = false,
  );

example/lib/screens/main/pages/update/update.dart

@@ -53,8 +53,6 @@ class _UpdatePageState extends State<UpdatePage> {
  } else {
  await OpenFile.open(file.absolute.path);
  }
-
- exit(0);
  }
 
  @override

example/lib/screens/store_editor/components/header.dart

@@ -58,6 +58,7 @@ AppBar buildHeader({
  }
 
  await newStore.manage.createAsync();
+
  await newStore.metadata.addAsync(
  key: 'sourceURL',
  value: newValues['sourceURL']!,
@@ -66,6 +67,10 @@ AppBar buildHeader({
  key: 'validDuration',
  value: newValues['validDuration']!,
  );
+ await newStore.metadata.addAsync(
+ key: 'maxLength',
+ value: newValues['maxLength']!,
+ );
 
  if (widget.existingStoreName == null || useNewCacheModeValue) {
  await newStore.metadata.addAsync(

example/lib/screens/store_editor/store_editor.dart

@@ -200,6 +200,36 @@ class _StoreEditorPopupState extends State<StoreEditorPopup> {
  textInputAction: TextInputAction.done,
  ),
  const SizedBox(height: 5),
+ TextFormField(
+ decoration: const InputDecoration(
+ labelText: 'Maximum Length',
+ helperText:
+ 'Use 0 days for infinite number of tiles',
+ suffixText: 'tiles',
+ prefixIcon: Icon(Icons.disc_full),
+ isDense: true,
+ ),
+ validator: (input) {
+ if (input == null ||
+ input.isEmpty ||
+ int.parse(input) < 0) {
+ return 'Must be 0 or more';
+ }
+ return null;
+ },
+ onSaved: (input) =>
+ _newValues['maxLength'] = input!,
+ autovalidateMode:
+ AutovalidateMode.onUserInteraction,
+ keyboardType: TextInputType.number,
+ inputFormatters: [
+ FilteringTextInputFormatter.digitsOnly
+ ],
+ initialValue: metadata.data!.isEmpty
+ ? '20000'
+ : metadata.data!['maxLength'],
+ textInputAction: TextInputAction.done,
+ ),
  Row(
  children: [
  const Text('Cache Behaviour:'),

example/pubspec.yaml

@@ -3,7 +3,7 @@ description: The example application for 'flutter_map_tile_caching', showcasing
  it's functionality and use-cases.
 publish_to: "none"
 
-version: 7.0.1
+version: 7.2.0
 
 environment:
  sdk: ">=2.18.0 <3.0.0"