go/misc/android/README

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
androidtest.bash, misc/android: build scripts for android LGTM=minux R=minux CC=golang-codereviews https://golang.org/cl/107640044 2014-07-09 04:56:49 -06:00			`Android`
			`=======`

			`For details on developing Go for Android, see the documentation in the`
misc/android: choose the right subdirectory for bin under GOPATH. This change includes the cleanup of temporary files created during the binary execution as well. Change-Id: Ic01a0a537d1daafcaa3acda1ec344aff5dcddfc2 Reviewed-on: https://go-review.googlesource.com/2903 Reviewed-by: David Crawshaw <crawshaw@golang.org> 2015-01-15 14:47:41 -07:00			`mobile subrepository:`
androidtest.bash, misc/android: build scripts for android LGTM=minux R=minux CC=golang-codereviews https://golang.org/cl/107640044 2014-07-09 04:56:49 -06:00
misc/android: choose the right subdirectory for bin under GOPATH. This change includes the cleanup of temporary files created during the binary execution as well. Change-Id: Ic01a0a537d1daafcaa3acda1ec344aff5dcddfc2 Reviewed-on: https://go-review.googlesource.com/2903 Reviewed-by: David Crawshaw <crawshaw@golang.org> 2015-01-15 14:47:41 -07:00			`https://github.com/golang/mobile`
androidtest.bash, misc/android: build scripts for android LGTM=minux R=minux CC=golang-codereviews https://golang.org/cl/107640044 2014-07-09 04:56:49 -06:00
misc/android,cmd/dist: move $GOROOT copying to the exec wrapper To run the standard library tests on Android, the androidtest.bash script copies GOROOT to the device. Move that logic to the android exec wrapper, thereby making androidtest.bash obsolete. Apart from making Android less special, the sharded builder infrastructure should now be able to run (emulated) Android builders and trybots without special treatment. Updates #23824 Change-Id: I41591fea9a15b38c6dcf84046ea57f1e9165eaa5 Reviewed-on: https://go-review.googlesource.com/c/163619 Run-TryBot: Elias Naur <mail@eliasnaur.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2019-02-24 07:18:02 -07:00			`To run the standard library tests, enable Cgo and use an appropriate`
			`C compiler from the Android NDK. For example,`
androidtest.bash, misc/android: build scripts for android LGTM=minux R=minux CC=golang-codereviews https://golang.org/cl/107640044 2014-07-09 04:56:49 -06:00
misc/android,cmd/dist: move $GOROOT copying to the exec wrapper To run the standard library tests on Android, the androidtest.bash script copies GOROOT to the device. Move that logic to the android exec wrapper, thereby making androidtest.bash obsolete. Apart from making Android less special, the sharded builder infrastructure should now be able to run (emulated) Android builders and trybots without special treatment. Updates #23824 Change-Id: I41591fea9a15b38c6dcf84046ea57f1e9165eaa5 Reviewed-on: https://go-review.googlesource.com/c/163619 Run-TryBot: Elias Naur <mail@eliasnaur.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2019-02-24 07:18:02 -07:00			`CGO_ENABLED=1 \`
			`GOOS=android \`
			`GOARCH=arm64 \`
misc/android: fix a typo in README A cross C compiler should be specified when cross building go for android on x86 host. This CL fixes the typo in README. Change-Id: Ideda915364d9f7f0fcd53146abc1e74506a8a8e6 Reviewed-on: https://go-review.googlesource.com/c/go/+/177777 Reviewed-by: Emmanuel Odeke <emm.odeke@gmail.com> Reviewed-by: Elias Naur <mail@eliasnaur.com> 2019-05-16 21:27:15 -06:00			`CC_FOR_TARGET=$NDK/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android21-clang \`
misc/android,cmd/dist: move $GOROOT copying to the exec wrapper To run the standard library tests on Android, the androidtest.bash script copies GOROOT to the device. Move that logic to the android exec wrapper, thereby making androidtest.bash obsolete. Apart from making Android less special, the sharded builder infrastructure should now be able to run (emulated) Android builders and trybots without special treatment. Updates #23824 Change-Id: I41591fea9a15b38c6dcf84046ea57f1e9165eaa5 Reviewed-on: https://go-review.googlesource.com/c/163619 Run-TryBot: Elias Naur <mail@eliasnaur.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2019-02-24 07:18:02 -07:00			`./all.bash`
misc/android: add more information to README Add more information to misc/android/README for developing arm and arm64 with an Android environment. Change-Id: I0c88996b6ab0c41946a2c7e69e9c92ec7bb3be27 Reviewed-on: https://go-review.googlesource.com/112276 Reviewed-by: Elias Naur <elias.naur@gmail.com> 2018-05-08 22:11:12 -06:00
			`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`
misc/android,cmd/dist: move $GOROOT copying to the exec wrapper To run the standard library tests on Android, the androidtest.bash script copies GOROOT to the device. Move that logic to the android exec wrapper, thereby making androidtest.bash obsolete. Apart from making Android less special, the sharded builder infrastructure should now be able to run (emulated) Android builders and trybots without special treatment. Updates #23824 Change-Id: I41591fea9a15b38c6dcf84046ea57f1e9165eaa5 Reviewed-on: https://go-review.googlesource.com/c/163619 Run-TryBot: Elias Naur <mail@eliasnaur.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2019-02-24 07:18:02 -07:00			`make.bash. For example, to run the go1 benchmarks`
misc/android: add more information to README Add more information to misc/android/README for developing arm and arm64 with an Android environment. Change-Id: I0c88996b6ab0c41946a2c7e69e9c92ec7bb3be27 Reviewed-on: https://go-review.googlesource.com/112276 Reviewed-by: Elias Naur <elias.naur@gmail.com> 2018-05-08 22:11:12 -06:00
			`export PATH=$GOROOT/bin:$PATH`
			`cd $GOROOT/test/bench/go1/`
misc/android: add a NL at the of README There is no NL at the end of README, and that make it strange when doing "cat misc/android/README". Change-Id: Ib47953d7b16e8927a4d6be7d5be8de8f2ddbcc39 Reviewed-on: https://go-review.googlesource.com/114010 Reviewed-by: Elias Naur <elias.naur@gmail.com> 2018-05-22 23:33:06 -06:00			`GOOS=android GOARCH=arm64 go test -bench=. -count=N -timeout=T`