Check and Install Updates

The SDK does not automatically update installed regions. The Android application should retrieve the online catalog, compare versions, and ask the user for confirmation:

1
fun hasUpdate(
2
    online: OfflineCatalogItem,
3
    installed: OfflineInstalledRegion,
4
): Boolean =
5
    online.version != null &&
6
        online.version != installed.regionVersion

After the user confirms, start a replacement download:

1
lifecycleScope.launch {
2
    RegionalOffline.download(
3
        regionId = regionId,
4
        clearBefore = true,
5
    ).onFailure { throwable ->
6
        renderError(OfflineRegionError.from(throwable))
7
    }
8
}

clearBefore = true clears the old installed manifest entry when the new task starts, then installs the complete package set defined by the current catalog. Do not update installed regions silently, especially during critical flows such as navigation. When a newer version is available, ask the user to confirm the update and explain that the old region data may be temporarily unavailable while the replacement package is installed.