Skip to content

feat: migrate android-maps-ktx into android-maps-utils (v6.0.0-rc01)#1716

Draft
dkhawk wants to merge 3 commits into
feat/rewrite-android-maps-utilsfrom
feat/migrate-ktx-to-utils
Draft

feat: migrate android-maps-ktx into android-maps-utils (v6.0.0-rc01)#1716
dkhawk wants to merge 3 commits into
feat/rewrite-android-maps-utilsfrom
feat/migrate-ktx-to-utils

Conversation

@dkhawk

@dkhawk dkhawk commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Summary

Consolidates all Kotlin reactive Coroutine/Flow/Builder extensions (maps-ktx and maps-utils-ktx from android-maps-ktx) directly into android-maps-utils, establishing a single canonical source of truth (v6.0.0-rc01).

Key Changes

  1. Canonical Implementation Relocation (com.google.maps.android.*)
    • Migrated all 32 source KTX files into android-maps-utils modules (:library, :clustering, :data, :heatmaps).
    • Extensions (awaitMap(), mapClickEvents(), addMarker { ... }) now reside directly inside canonical non-ktx packages (com.google.maps.android, com.google.maps.android.model, com.google.maps.android.collections, com.google.maps.android.clustering, com.google.maps.android.data.geojson, com.google.maps.android.data.kml, com.google.maps.android.heatmaps).
  2. Backward-Compatibility Bridge Layer (com.google.maps.android.ktx.*)
    • Preserved full legacy com.google.maps.android.ktx.* package structure via @Deprecated(level = DeprecationLevel.WARNING, replaceWith = ReplaceWith(...)) forwarding wrappers and typealiases.
    • Ensures zero breaking changes for existing codebases while guiding developers toward canonical replacements.
  3. Comprehensive Test Suite & Verification
    • Migrated all 18 KTX unit test suites with both Canonical Tests and Shim Tests to verify side-by-side execution (100% pass rate across 160 test tasks).
  4. Demo App & Documentation
    • Integrated KtxExtensionsDemoActivity into :demo illustrating both canonical and bridge builder usage without duplicate class issues.
    • Updated README.md and CHANGELOG.md with consolidation guidelines and 6.0.0-rc01 notes.
    • Ran dokkaGenerate to update public API documentation.

dkhawk added 3 commits July 13, 2026 16:16
- Consolidate all reactive Coroutine/Flow/Builder extensions into android-maps-utils canonical packages (com.google.maps.android.*)
- Preserve com.google.maps.android.ktx.* as deprecated compatibility layer with @deprecated forwarding wrappers and typealiases
- Migrate all 18 KTX unit test suites with both canonical and shim test coverage (100% pass rate across 160 test tasks)
- Add KtxExtensionsDemoActivity demonstrating reactive extensions to demo app
- Update version to 6.0.0-rc01 and update README.md/CHANGELOG.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant