| commit | c94142eb97c730ee3ff55567762f9ec3849b9bc9 | [log] [tgz] |
|---|---|---|
| author | Burcu Dogan <jbd@google.com> | Tue Mar 03 10:34:19 2015 -0800 |
| committer | Burcu Dogan <jbd@google.com> | Wed Mar 04 18:58:40 2015 +0000 |
| tree | 159f2d33339fb549b98eadcaa793613b569c8b9e | |
| parent | 79fcbd2571d42137b33346fcc01befe983864c19 [diff] |
mobile/audio: add android support Due to licensing limitations, OpenAL should be dynamically loaded. Android apps that needs to import the audio package needs to be packed with libopenal.so as an extenal lib dependency. Instructions to build OpenAL for Android is available at http://repo.or.cz/w/openal-soft.git/blob/HEAD:/XCompile-Android.txt The packed libopenal.so is exported to /data/data/<package_name>/lib/libopenal.so at installation. The audio package dlopens libopenal.so from this location and dlsym to dispatch the OpenAL functions. Change-Id: I7aa36bb8dd0ae8e101ae4aa5366c3d426b2569a9 Reviewed-on: https://go-review.googlesource.com/6642 Reviewed-by: David Crawshaw <crawshaw@golang.org>
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 golang/mobile /bin/bash -c 'cd /src/your/project && ./make.bash'
Note the use of -v option to mount $GOPATH/src to /src of the container. The above command will fail if the -v option is missing or the specified volume is not accessible from the container.
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.