# golang/mobile architecture

> Architecture diagram of the GitHub repository golang/mobile, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/golang/mobile
- Repository: https://github.com/golang/mobile

## Overview

Go Mobile supports two main workflows: Go applications run through a platform-backed app/event and graphics layer, while gomobile and gobind support building mobile apps and generating Go-to-Java/Objective-C bindings for SDK apps. The repository also includes optional mobile capabilities such as assets, sensors, audio, fonts, and sprites. Some platform and gomobile internals were not sampled, so their connections are shown only where documented or left out.

Main entry points: [`cmd/gobind/main.go`](https://github.com/golang/mobile/blob/master/cmd/gobind/main.go) (gobind CLI), [`app/app.go`](https://github.com/golang/mobile/blob/master/app/app.go) (App event loop API), [`event`](https://github.com/golang/mobile/tree/master/event) (Input and lifecycle events), [`internal/importers/java/java.go`](https://github.com/golang/mobile/blob/master/internal/importers/java/java.go) (Java API importer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_runtime["App runtime"]
  node_app_platforms["Platform app backends"]
  node_app_api["App event loop API<br/>[app.go]"]
end

subgraph group_graphics_events["Events and graphics"]
  node_event_types["Input and lifecycle events"]
  node_gl_api["OpenGL API<br/>[gl.go]"]
  node_geometry["Window geometry<br/>[geom.go]"]
end

subgraph group_binding["Language bindings"]
  node_gobind["gobind CLI<br/>[main.go]"]
  node_go_importer["Go AST importer<br/>[ast.go]"]
  node_java_importer["Java API importer<br/>[java.go]"]
  node_objc_importer["Objective-C importer<br/>[objc.go]"]
  node_java_generator["Java binding generator<br/>[genjava.go]"]
  node_objc_generator["Objective-C generator<br/>[genobjc.go]"]
  node_java_runtime["Java sequence runtime<br/>[seq_android.h]"]
  node_objc_runtime["Objective-C reference runtime<br/>[ref.h]"]
end

subgraph group_mobile_tools["Mobile tooling"]
  node_gomobile["gomobile CLI<br/>[main.go]"]
end

subgraph group_capabilities["Mobile capabilities"]
  node_assets["Platform assets<br/>[asset.go]"]
  node_sensors["Device sensors<br/>[sensor.go]"]
  node_audio["OpenAL audio<br/>[al.go]"]
  node_fonts["Platform fonts<br/>[font.go]"]
  node_sprites["2D sprite scene graph<br/>[sprite.go]"]
  node_portable_sprite["Portable sprite engine<br/>[portable.go]"]
end

node_developer(("App developer"))

node_developer -->|"runs app"| node_app_api
node_app_platforms -.->|"provides runtime"| node_app_api
node_app_api -->|"delivers events"| node_event_types
node_app_api -->|"creates context"| node_gl_api
node_event_types -->|"uses geometry"| node_geometry
node_developer -->|"builds mobile apps"| node_gomobile
node_developer -->|"generates bindings"| node_gobind
node_gobind -->|"loads Go packages"| node_go_importer
node_gobind -->|"imports Java APIs"| node_java_importer
node_gobind -->|"imports ObjC APIs"| node_objc_importer
node_java_importer -->|"uses references"| node_go_importer
node_objc_importer -->|"uses references"| node_go_importer
node_java_generator -->|"uses type metadata"| node_java_importer
node_objc_generator -->|"uses type metadata"| node_objc_importer
node_java_runtime -.->|"supports generated bindings"| node_java_generator
node_objc_runtime -.->|"supports generated bindings"| node_objc_generator
node_portable_sprite -->|"implements engine"| node_sprites
node_sprites -->|"uses size events"| node_event_types

click node_gomobile "https://github.com/golang/mobile/blob/master/cmd/gomobile/main.go"
click node_app_platforms "https://github.com/golang/mobile/tree/master/app"
click node_app_api "https://github.com/golang/mobile/blob/master/app/app.go"
click node_event_types "https://github.com/golang/mobile/tree/master/event"
click node_gl_api "https://github.com/golang/mobile/blob/master/gl/gl.go"
click node_geometry "https://github.com/golang/mobile/blob/master/geom/geom.go"
click node_assets "https://github.com/golang/mobile/blob/master/asset/asset.go"
click node_sensors "https://github.com/golang/mobile/blob/master/exp/sensor/sensor.go"
click node_audio "https://github.com/golang/mobile/blob/master/exp/audio/al/al.go"
click node_fonts "https://github.com/golang/mobile/blob/master/exp/font/font.go"
click node_sprites "https://github.com/golang/mobile/blob/master/exp/sprite/sprite.go"
click node_portable_sprite "https://github.com/golang/mobile/blob/master/exp/sprite/portable/portable.go"
click node_gobind "https://github.com/golang/mobile/blob/master/cmd/gobind/main.go"
click node_go_importer "https://github.com/golang/mobile/blob/master/internal/importers/ast.go"
click node_java_importer "https://github.com/golang/mobile/blob/master/internal/importers/java/java.go"
click node_objc_importer "https://github.com/golang/mobile/blob/master/internal/importers/objc/objc.go"
click node_java_generator "https://github.com/golang/mobile/blob/master/bind/genjava.go"
click node_objc_generator "https://github.com/golang/mobile/blob/master/bind/genobjc.go"
click node_java_runtime "https://github.com/golang/mobile/blob/master/bind/java/seq_android.h"
click node_objc_runtime "https://github.com/golang/mobile/blob/master/bind/objc/ref.h"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app_platforms,node_app_api toneBlue
class node_event_types,node_gl_api,node_geometry toneAmber
class node_gobind,node_go_importer,node_java_importer,node_objc_importer,node_java_generator,node_objc_generator,node_java_runtime,node_objc_runtime toneMint
class node_gomobile toneRose
class node_assets,node_sensors,node_audio,node_fonts,node_sprites,node_portable_sprite,node_developer toneIndigo
```

## Components

### App runtime

- [Platform app backends](https://github.com/golang/mobile/tree/master/app): `app`
- [App event loop API](https://github.com/golang/mobile/blob/master/app/app.go): `app/app.go`

### Events and graphics

- [Input and lifecycle events](https://github.com/golang/mobile/tree/master/event): `event`
- [OpenGL API](https://github.com/golang/mobile/blob/master/gl/gl.go): `gl/gl.go`
- [Window geometry](https://github.com/golang/mobile/blob/master/geom/geom.go): `geom/geom.go`

### Language bindings

- [gobind CLI](https://github.com/golang/mobile/blob/master/cmd/gobind/main.go): `cmd/gobind/main.go`
- [Go AST importer](https://github.com/golang/mobile/blob/master/internal/importers/ast.go): `internal/importers/ast.go`
- [Java API importer](https://github.com/golang/mobile/blob/master/internal/importers/java/java.go): `internal/importers/java/java.go`
- [Objective-C importer](https://github.com/golang/mobile/blob/master/internal/importers/objc/objc.go): `internal/importers/objc/objc.go`
- [Java binding generator](https://github.com/golang/mobile/blob/master/bind/genjava.go): `bind/genjava.go`
- [Objective-C generator](https://github.com/golang/mobile/blob/master/bind/genobjc.go): `bind/genobjc.go`
- [Java sequence runtime](https://github.com/golang/mobile/blob/master/bind/java/seq_android.h): `bind/java/seq_android.h`
- [Objective-C reference runtime](https://github.com/golang/mobile/blob/master/bind/objc/ref.h): `bind/objc/ref.h`

### Mobile tooling

- [gomobile CLI](https://github.com/golang/mobile/blob/master/cmd/gomobile/main.go): `cmd/gomobile/main.go`

### Mobile capabilities

- [Platform assets](https://github.com/golang/mobile/blob/master/asset/asset.go): `asset/asset.go`
- [Device sensors](https://github.com/golang/mobile/blob/master/exp/sensor/sensor.go): `exp/sensor/sensor.go`
- [OpenAL audio](https://github.com/golang/mobile/blob/master/exp/audio/al/al.go): `exp/audio/al/al.go`
- [Platform fonts](https://github.com/golang/mobile/blob/master/exp/font/font.go): `exp/font/font.go`
- [2D sprite scene graph](https://github.com/golang/mobile/blob/master/exp/sprite/sprite.go): `exp/sprite/sprite.go`
- [Portable sprite engine](https://github.com/golang/mobile/blob/master/exp/sprite/portable/portable.go): `exp/sprite/portable/portable.go`

### Other components

- **App developer**

## Connections

- App developer → App event loop API: runs app
- Platform app backends → App event loop API: provides runtime
- App event loop API → Input and lifecycle events: delivers events (evidence: `app/app.go`)
- App event loop API → OpenGL API: creates context (evidence: `app/app.go`)
- Input and lifecycle events → Window geometry: uses geometry (evidence: `event/size/size.go`)
- App developer → gomobile CLI: builds mobile apps
- App developer → gobind CLI: generates bindings
- gobind CLI → Go AST importer: loads Go packages (evidence: `cmd/gobind/main.go`)
- gobind CLI → Java API importer: imports Java APIs (evidence: `cmd/gobind/main.go`)
- gobind CLI → Objective-C importer: imports ObjC APIs (evidence: `cmd/gobind/main.go`)
- Java API importer → Go AST importer: uses references (evidence: `internal/importers/java/java.go`)
- Objective-C importer → Go AST importer: uses references (evidence: `internal/importers/objc/objc.go`)
- Java binding generator → Java API importer: uses type metadata (evidence: `bind/genjava.go`)
- Objective-C generator → Objective-C importer: uses type metadata (evidence: `bind/genobjc.go`)
- Java sequence runtime → Java binding generator: supports generated bindings
- Objective-C reference runtime → Objective-C generator: supports generated bindings
- Portable sprite engine → 2D sprite scene graph: implements engine (evidence: `exp/sprite/portable/portable.go`)
- 2D sprite scene graph → Input and lifecycle events: uses size events (evidence: `exp/sprite/sprite.go`)
