How golang/mobile works
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: main.go gobind CLI · app.go App event loop API · event Input and lifecycle events · java.go Java API importer
Components 21
App runtime
- Platform app backends
app - App event loop API
app/app.go
Events and graphics
- Input and lifecycle events
event - OpenGL API
gl/gl.go - Window geometry
geom/geom.go
Language bindings
- gobind CLI
cmd/gobind/main.go - Go AST importer
internal/importers/ast.go - Java API importer
internal/importers/java/java.go - Objective-C importer
internal/importers/objc/objc.go - Java binding generator
bind/genjava.go - Objective-C generator
bind/genobjc.go - Java sequence runtime
bind/java/seq_android.h - Objective-C reference runtime
bind/objc/ref.h
Mobile tooling
- gomobile CLI
cmd/gomobile/main.go
Mobile capabilities
- Platform assets
asset/asset.go - Device sensors
exp/sensor/sensor.go - OpenAL audio
exp/audio/al/al.go - Platform fonts
exp/font/font.go - 2D sprite scene graph
exp/sprite/sprite.go - Portable sprite engine
exp/sprite/portable/portable.go
Other components
- App developer
Connections 18
- 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
app/app.go - App event loop API → OpenGL API: creates context
app/app.go - Input and lifecycle events → Window geometry: uses geometry
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
cmd/gobind/main.go - gobind CLI → Java API importer: imports Java APIs
cmd/gobind/main.go - gobind CLI → Objective-C importer: imports ObjC APIs
cmd/gobind/main.go - Java API importer → Go AST importer: uses references
internal/importers/java/java.go - Objective-C importer → Go AST importer: uses references
internal/importers/objc/objc.go - Java binding generator → Java API importer: uses type metadata
bind/genjava.go - Objective-C generator → Objective-C importer: uses type metadata
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
exp/sprite/portable/portable.go - 2D sprite scene graph → Input and lifecycle events: uses size events
exp/sprite/sprite.go