SDKNativeEngine sdkNativeEngine = SDKNativeEngine.getSharedInstance();

if (sdkNativeEngine != null) {
    // Create MapUpdater in background to not block the UI thread.
    MapUpdater.fromEngineAsync(sdkNativeEngine, mapUpdater -> {
        // mapUpdater created.
    });
}
else {
    Log.e("Error: ", "SDKNativeEngine not initialized.");
}

sdkNativeEngine?.let { engine ->
    // Create MapUpdater in background to not block the UI thread.
    MapUpdater.fromEngineAsync(engine) { mapUpdater ->
        // mapUpdater created.
    }
} ?: run {
    Log.e("Error:", "SDKNativeEngine not initialized.")
}

SDKNativeEngine sdkNativeEngine = SDKNativeEngine.getSharedInstance();

if (sdkNativeEngine != null) {
    // Create MapUpdater in background to not block the UI thread.
    MapUpdater.fromEngineAsync(sdkNativeEngine, mapUpdater -> {
        try {
            MapVersionHandle mapVersionHandle = mapUpdater.getCurrentMapVersion();
            String versionInfo = mapVersionHandle.stringRepresentation(",");
            Log.d("Info: ", "Current Map Version: " + versionInfo);
        } catch (MapLoaderException e) {
            Log.e("Map Error: ", "Get current map version failed: " + e.error.name());
        }
    });
}
else {
    Log.e("Error: ", "SDKNativeEngine not initialized.");
}

private void checkForMapUpdates() {
    if (mapUpdater == null) {
        String message = "MapUpdater instance not ready. Try again.";
        snackbar.setText(message).show();
        return;
    }

    mapUpdater.retrieveCatalogsUpdateInfo(new CatalogsUpdateInfoCallback() {
        @Override
        public void apply(@Nullable MapLoaderError mapLoaderError, @Nullable List<CatalogUpdateInfo> catalogList) {
            if (mapLoaderError != null) {
                Log.e("CatalogUpdateCheck", "Error: " + mapLoaderError.name());
                return;
            }

            // When error is null, then the list is guaranteed to be not null.
            if (catalogList.isEmpty()) {
                Log.d("CatalogUpdateCheck", "No map updates are available.");
            }

            logCurrentSDKVersion();
            logCurrentMapVersion();

            // Usually, only one global catalog is available that contains regions for the whole world.
            // For some regions like Japan only a base map is available, by default.
            // If your company has an agreement with HERE to use a detailed Japan map, then in this case you
            // can install and use a second catalog that references the detailed Japan map data.
            // All map data is part of downloadable regions. A catalog contains references to the
            // available regions. The map data for a region may differ based on the catalog that is used
            // or on the version that is downloaded and installed.
            for (CatalogUpdateInfo catalogUpdateInfo : catalogList) {
                Log.d("CatalogUpdateCheck", "Catalog name:" + catalogUpdateInfo.installedCatalog.catalogIdentifier.hrn);
                Log.d("CatalogUpdateCheck", "Installed map version:" + catalogUpdateInfo.installedCatalog.catalogIdentifier.version);
                Log.d("CatalogUpdateCheck", "Latest available map version:" + catalogUpdateInfo.latestVersion);
                performMapUpdate(catalogUpdateInfo);
            }
        }
    });
}

private fun checkForMapUpdates() {
    if (!this::mapUpdater.isInitialized) {
        val message = "MapUpdater instance not ready. Try again."
        snackbar.show(message)
        return
    }

    mapUpdater.retrieveCatalogsUpdateInfo(object : CatalogsUpdateInfoCallback {
        override fun apply(
            error: MapLoaderError?,
            catalogs: List<CatalogUpdateInfo>?
        ) {
            if (error != null) {
                Log.e("CatalogUpdateCheck", "Error: " + error.name)
                return
            }

            // When error is null, then the list is guaranteed to be not null.
            if (catalogs!!.isEmpty()) {
                Log.d("CatalogUpdateCheck", "No map updates are available.")
            }

            logCurrentMapVersion()

            // Usually, only one global catalog is available that contains regions for the whole world.
            // For some regions like Japan only a base map is available, by default.
            // If your company has an agreement with HERE to use a detailed Japan map, then in this case you
            // can install and use a second catalog that references the detailed Japan map data.
            // All map data is part of downloadable regions. A catalog contains references to the
            // available regions. The map data for a region may differ based on the catalog that is used
            // or on the version that is downloaded and installed.
            for (catalogUpdateInfo in catalogs) {
                Log.d(
                    "CatalogUpdateCheck",
                    "Catalog name:" + catalogUpdateInfo.installedCatalog.catalogIdentifier.hrn
                )
                Log.d(
                    "CatalogUpdateCheck",
                    "Installed map version:" + catalogUpdateInfo.installedCatalog.catalogIdentifier.version
                )
                Log.d(
                    "CatalogUpdateCheck",
                    "Latest available map version:" + catalogUpdateInfo.latestVersion
                )
                performMapUpdate(catalogUpdateInfo)
            }
        }
    })
}

// Downloads and installs map updates for any of the already downloaded regions.
// Note that this example only shows how to download one region.
private void performMapUpdate(CatalogUpdateInfo catalogUpdateInfo) {
    if (mapUpdater == null) {
        String message = "MapUpdater instance not ready. Try again.";
        snackbar.setText(message).show();
        return;
    }

    // This method conveniently updates all installed regions for a catalog if an update is available.
    // Optionally, you can use the CatalogUpdateTask to pause / resume or cancel the update.
    CatalogUpdateTask task = mapUpdater.updateCatalog(catalogUpdateInfo, new CatalogUpdateProgressListener() {
        @Override
        public void onProgress(@NonNull RegionId regionId, int percentage) {
            Log.d("CatalogUpdate", "Downloading and installing a map update. Progress for " + regionId.id + ": " + percentage);
        }

        @Override
        public void onPause(@Nullable MapLoaderError mapLoaderError) {
            if (mapLoaderError == null) {
                String message = "The map update was paused by the user calling catalogUpdateTask.pause().";
                Log.e("CatalogUpdate", message);
            } else {
                String message = "Map update onPause error. The task tried to often to retry the update: " + mapLoaderError;
                Log.d("CatalogUpdate", message);
            }
        }

        @Override
        public void onResume() {
            String message = "A previously paused map update has been resumed.";
            Log.d("CatalogUpdate", message);
        }

        @Override
        public void onComplete(@Nullable MapLoaderError mapLoaderError) {
            if (mapLoaderError != null) {
                String message = "Map update completion error: " + mapLoaderError;
                Log.d("CatalogUpdate", message);
                return;
            }

            String message = "One or more map update has been successfully installed.";
            Log.d("CatalogUpdate", message);
            logCurrentMapVersion();

            // It is recommend to call now also `getDownloadableRegions()` to update
            // the internal catalog data that is needed to download, update or delete
            // existing `Region` data. It is required to do this at least once
            // before doing a new download, update or delete operation.
        }});
}

// Downloads and installs map updates for any of the already downloaded regions.
// Note that this example only shows how to download one region.
private fun performMapUpdate(catalogUpdateInfo: CatalogUpdateInfo) {
    if (!this::mapUpdater.isInitialized) {
        val message = "MapUpdater instance not ready. Try again."
        snackbar.show(message)
        return
    }

    // This method conveniently updates all installed regions for a catalog if an update is available.
    // Optionally, you can use the CatalogUpdateTask to pause / resume or cancel the update.
    val task =
        mapUpdater.updateCatalog(catalogUpdateInfo, object : CatalogUpdateProgressListener {
            override fun onProgress(regionId: RegionId, percentage: Int) {
                Log.d(
                    "CatalogUpdate",
                    "Downloading and installing a map update. Progress for " + regionId.id + ": " + percentage
                )
            }

            override fun onPause(mapLoaderError: MapLoaderError?) {
                if (mapLoaderError == null) {
                    val message =
                        "The map update was paused by the user calling catalogUpdateTask.pause()."
                    Log.e("CatalogUpdate", message)
                } else {
                    val message =
                        "Map update onPause error. The task tried to often to retry the update: $mapLoaderError"
                    Log.d("CatalogUpdate", message)
                }
            }

            override fun onResume() {
                val message = "A previously paused map update has been resumed."
                Log.d("CatalogUpdate", message)
            }

            override fun onComplete(mapLoaderError: MapLoaderError?) {
                if (mapLoaderError != null) {
                    val message = "Map update completion error: $mapLoaderError"
                    Log.d("CatalogUpdate", message)
                    return
                }

                val message = "One or more map update has been successfully installed."
                Log.d("CatalogUpdate", message)
                logCurrentMapVersion()

                // It is recommend to call now also `getDownloadableRegions()` to update
                // the internal catalog data that is needed to download, update or delete
                // existing `Region` data. It is required to do this at least once
                // before doing a new download, update or delete operation.
            }
        })
}