summaryrefslogtreecommitdiffstats
path: root/misc/android/README
diff options
context:
space:
mode:
Diffstat (limited to 'misc/android/README')
-rw-r--r--misc/android/README25
1 files changed, 25 insertions, 0 deletions
diff --git a/misc/android/README b/misc/android/README
new file mode 100644
index 0000000..13b59d9
--- /dev/null
+++ b/misc/android/README
@@ -0,0 +1,25 @@
+Android
+=======
+
+For details on developing Go for Android, see the documentation in the
+mobile subrepository:
+
+ https://github.com/golang/mobile
+
+To run the standard library tests, enable Cgo and use an appropriate
+C compiler from the Android NDK. For example,
+
+ CGO_ENABLED=1 \
+ GOOS=android \
+ GOARCH=arm64 \
+ CC_FOR_TARGET=$NDK/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android21-clang \
+ ./all.bash
+
+To run tests on the Android device, add the bin directory to PATH so the
+go tool can find the go_android_$GOARCH_exec wrapper generated by
+make.bash. For example, to run the go1 benchmarks
+
+ export PATH=$GOROOT/bin:$PATH
+ cd $GOROOT/test/bench/go1/
+ GOOS=android GOARCH=arm64 go test -bench=. -count=N -timeout=T
+