8f449fffd2
Change-Id: I2426f3607120b7ce2da60bcb45d834b539d7dbb9 Reviewed-on: https://go-review.googlesource.com/2342 Reviewed-by: David Crawshaw <crawshaw@golang.org> |
||
---|---|---|
app | ||
bind | ||
build | ||
cmd/gobind | ||
event | ||
example | ||
f32 | ||
geom | ||
gl | ||
sprite | ||
testdata | ||
.gitattributes | ||
.gitignore | ||
AUTHORS | ||
CONTRIBUTORS | ||
Dockerfile | ||
LICENSE | ||
PATENTS | ||
README.md |
README.md
Go support for Mobile devices
The Go mobile repository holds packages and build tools for using Go on Android.
This is early work and the build system is a bumpy ride. Building a binary for Android requires using a Go cross compiler and an external linker from the NDK.
For now, the easiest way to setup a build environment is using the provided Dockerfile:
docker pull golang/mobile
Get the sample applications.
go get -d golang.org/x/mobile/example/...
In your app directory under your $GOPATH
, copy the following files from either
the golang.org/x/mobile/example/basic
or golang.org/x/mobile/example/libhello
apps:
AndroidManifest.xml
all.bash
build.xml
jni/Android.mk
make.bash
Start with basic
if you are writing an all-Go application (that is, an OpenGL game)
or libhello if you are building a .so
file for use from Java via
gobind. Edit the files to change
the name of your app.
To build, run:
docker run -v $GOPATH/src:/src mobile /bin/bash -c 'cd /src/your/project && ./make.bash'
When working with an all-Go application, this will produce a binary at
$GOPATH/src/your/project/bin/name-debug.apk
. You can use the adb tool to install
and run this app. See all.bash for an example.
--
APIs are currently very limited, but under active development. Package documentation serves as a starting point:
Contributions to Go are appreciated. See https://golang.org/doc/contribute.html.