Android Bridge SDK

​

What GBGBridge enables

• Native capability access from web journeys: Web-based identity flows can request camera capture and other device features through a standardized message protocol.
• Typed capability slots: Declare support for document capture and selfie capture by setting handlers on built-in typed slots. The SDK handles result encoding, busy rejection, and capability query responses automatically.
• Bidirectional messaging: Both the native host and the web content can send and receive structured messages, enabling real-time coordination.
• Capability negotiation with permission state: The web journey can query which native capabilities are available — including camera permission status — before attempting to use them, enabling graceful degradation across environments.
• Works with Compose and the View system: The SDK has no UI dependency. Compose hosts wrap a WebView in AndroidView; View-system hosts attach to a WebView from an Activity or Fragment. Typed slots expose a StateFlow for reactive UI binding.
• Extensible handler architecture: Register custom capability handlers to fulfil any request type the web journey might send, alongside or instead of typed slots.

​

Architecture at a glance

​

Quick start

import com.gbg.gbgbridge.core.BridgeHost
import android.webkit.WebView
import androidx.compose.runtime.*
import androidx.compose.ui.viewinterop.AndroidView

@Composable
fun JourneyScreen(journeyUrl: String) {
  val host = remember {
    BridgeHost(hostVersion = "1.0.0").apply {
      // Declare document capture support by setting a handler
      documentCapture.handler = { request ->
        // Present your camera UI and return a result
        documentCapture.awaitCompletion()
      }
    }
  }

  AndroidView(factory = { context ->
    WebView(context).apply {
      host.attach(this)
      loadUrl(journeyUrl)
    }
  })

  DisposableEffect(host) {
    onDispose { host.detach() }
  }
}

​

Requirements

dependencies {
  implementation("com.gbg:gbgbridge-sdk:0.1.0-alpha01")
}

​

Reference app

​

Documentation map

​

License