Android Compose | Mobile SDK | 2GIS Documentation
Android SDK

Android Compose

Android Compose (Jetpack Compose) — это набор инструментов для создания UI в Android-приложениях на языке программирования Kotlin. Основное отличие фреймворка от Android View — декларативный подход к описанию интерфейса.

Модуль compose-map для Android Compose от 2ГИС содержит стандартный набор UI-элементов для управления картой. Модуль доступен для обеих (Full и Map) версий SDK.

Чтобы подключить модуль в своё приложение:

  1. Добавьте следующие элементы в app/build.gradle и укажите номер и тип версии SDK (оба параметра обязательны):

    dependencies {
    
        def sdkVersion = "12.4.0" // Номер версии SDK
    
        implementation("ru.dgis.sdk:sdk-map:$sdkVersion") // Укажите sdk-map или sdk-full
        implementation("ru.dgis.sdk:compose-map:$sdkVersion")
    }
    

    Пример готового app/build.gradle см. в демо-проекте на GitHub.

  2. Получите карту через MapComposable, чтобы в дальнейшем использовать её при добавлении UI-элементов.

    См. пример подготовки карты.

Стандартный набор элементов включает в себя:

  1. IndoorComposable для переключения этажей.
  2. TrafficComposable для показа текущего уровня пробок и для управления видимостью пробок на карте.
  3. ZoomComposable для масштабирования (приближения и удаления) карты.
  4. CompassComposable для отображения текущего угла поворота карты относительно севера.
  5. MyLocationComposable для перелёта к текущему местоположению пользователя. Этот UI-элемент отображает текущее состояние слежения камеры (CameraFollowState) и позволяет изменять его.