ce2d014f4a
Change-Id: Ibfdd36f306d9a52f226904aa99653dc1b932410b Reviewed-on: https://go-review.googlesource.com/1289 Reviewed-by: Hyang-Ah Hana Kim <hyangah@gmail.com>
49 lines
1.8 KiB
Markdown
49 lines
1.8 KiB
Markdown
# 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:
|
|
|
|
go get -d golang.org/x/mobile/...
|
|
docker build -t mobile $GOPATH/src/golang.org/x/mobile
|
|
|
|
In your app directory under your `$GOPATH`, copy the following files from either
|
|
the [golang.org/x/mobile/basic](https://github.com/golang/mobile/tree/master/example/basic)
|
|
or [golang.org/x/mobile/libhello](https://github.com/golang/mobile/tree/master/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](https://godoc.org/golang.org/x/mobile/cmd/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:
|
|
|
|
- [mobile/app](http://godoc.org/golang.org/x/mobile/app)
|
|
- [mobile/gl](http://godoc.org/golang.org/x/mobile/gl)
|
|
- [mobile/sprite](http://godoc.org/golang.org/x/mobile/sprite)
|
|
- [mobile/cmd/gobind](http://godoc.org/golang.org/x/mobile/cmd/gobind)
|
|
|
|
Contributions to Go are appreciated. See https://golang.org/doc/contribute.html.
|