vjrj
4fdd5d70d3
Skip the ~1.5 MB catalog parse and the table scan on every launch — the main startup cost. `seedBundledIfNeeded` re-seeds only when the recorded version differs from `speciesCatalogVersion`, writing the version after the seed commits so an interrupted seed retries next launch. Adds `parseSpeciesCatalogVersion` and a test keeping the constant in sync with the asset's `version` field.
46 lines
1.9 KiB
Dart
46 lines
1.9 KiB
Dart
import 'dart:convert';
|
|
|
|
import 'package:flutter/services.dart' show rootBundle;
|
|
|
|
import 'species_repository.dart';
|
|
|
|
const _catalogAsset = 'assets/catalog/species.json';
|
|
|
|
/// Parses the bundled catalog JSON into [SpeciesSeed]s. Kept separate from asset
|
|
/// loading so it is trivially unit-testable without a Flutter binding.
|
|
List<SpeciesSeed> parseSpeciesCatalog(String jsonString) {
|
|
final data = jsonDecode(jsonString) as Map<String, dynamic>;
|
|
final entries = (data['species'] as List).cast<Map<String, dynamic>>();
|
|
return entries.map((e) {
|
|
final common = (e['common'] as Map<String, dynamic>? ?? const {}).map(
|
|
(lang, names) => MapEntry(lang, (names as List).cast<String>()),
|
|
);
|
|
return SpeciesSeed(
|
|
scientificName: e['scientific_name'] as String,
|
|
family: e['family'] as String?,
|
|
wikidataQid: e['wikidata_qid'] as String?,
|
|
gbifKey: (e['gbif_key'] as num?)?.toInt(),
|
|
commonNames: common,
|
|
viabilityYears: (e['viability_years'] as num?)?.toInt(),
|
|
);
|
|
}).toList();
|
|
}
|
|
|
|
/// Loads and parses the bundled species catalog asset.
|
|
Future<List<SpeciesSeed>> loadBundledSpecies() async {
|
|
final jsonString = await rootBundle.loadString(_catalogAsset);
|
|
return parseSpeciesCatalog(jsonString);
|
|
}
|
|
|
|
/// Version of the bundled catalog, mirrored from the asset's `version` field
|
|
/// (written by `tool/gen_species_catalog.dart`). A test asserts the two stay in
|
|
/// sync. The app records the version it last seeded and skips the ~1.5 MB parse
|
|
/// and the table scan in [SpeciesRepository.seedBundled] on every subsequent
|
|
/// launch — so bumping this (alongside the asset) is what triggers a one-time
|
|
/// re-seed after the catalog changes.
|
|
const int speciesCatalogVersion = 3;
|
|
|
|
/// Reads just the `version` field from a catalog JSON string. Used by the sync
|
|
/// test to keep [speciesCatalogVersion] aligned with the asset.
|
|
int parseSpeciesCatalogVersion(String jsonString) =>
|
|
(jsonDecode(jsonString) as Map<String, dynamic>)['version'] as int;
|