ContentUpdater class Content

Manages and applies updates for downloaded content in the content store.

A ContentUpdater represents a single update session created by the ContentStore. Use ContentStore.createContentUpdater to obtain an instance. The updater is responsible for starting or resuming the download of available updates, reporting progress and status changes via callbacks, and applying the downloaded update when ready.

The updater supports updating content types such as ContentType.roadMap, ContentType.viewStyleLowRes and ContentType.viewStyleHighRes. For road maps the SDK requires all local road map items to have the same version; partial updates of individual roadMap items with different versions are not supported.

Example

final (contentUpdater, code) = ContentStore.createContentUpdater(ContentType.roadMap);
if (code == GemError.success || code == GemError.exist) {
  final ProgressListener? listener = contentUpdater.update(
    true,
    onStatusUpdated: (status) {
      if (status == ContentUpdaterStatus.fullyReady || status == ContentUpdaterStatus.partiallyReady) {
        if (contentUpdater.canApply) {
          final applyErr = contentUpdater.apply();
          print('Apply resolved with code ${applyErr.code}');
        }
      }
    },
    onProgressUpdated: (p) => print('Progress: $p/100'),
    onComplete: (err) => print('Update finished: $err'),
  );
}

See also:

• ContentStore.createContentUpdater - Obtain a ContentUpdater instance.
• ContentUpdater.update - Start or resume the update process and register callbacks.
• ContentUpdater.apply - Apply a downloaded update when ready.