env

README

go-android-env

辅助设置 Golang 的 Android NDK 环境变量，简化 Android 交叉编译和运行的流程。

安装后会生成四个可执行文件，分别对应四种交叉编译环境：

• 386：32 位 x86 设备或模拟器
• amd64：64 位 amd64 设备或模拟器
• arm：32 位 armv7a 设备或模拟器
• arm64：64 位 armv8a 设备或模拟器

它们会安装到 $GOBIN 或 $GOPATN/bin 目录下。请将上述目录添加到 $PATH 中以便运行。

依赖

• Golang 环境并设置 $GOPATH 环境变量
• arun 工具（ https://github.com/ClarkGuan/arun ）
• NDK 并设置 $NDK 环境变量
• Android 模拟器或真实设备

安装

git clone https://github.com/ClarkGuan/go-android-env
cd go-android-env
./build.sh

或

go install -x github.com/ClarkGuan/go-android-env/...@latest

使用

运行 go run

[386|amd64|arm|arm64] go run -buildmode=pie -exec=arun <package or directory> [arguments...]

举例：

新建 demo 文件夹 mkdir demo，初始化 go module go mod init demo_android， 新建 main.go 如下：

package main

import (
	"fmt"
	"os"
)

func main() {
	fmt.Println("Hello android device!")
	os.Exit(1)  // 强制返回错误码 1
}

确保 arun 工具、adb 工具和 NDK 都已经安装完毕。设置 $NDK 环境变量指向 NDK 根目录。

此时分情况：

• 如果需要安装到 Android 模拟器上，请运行

386 go run -buildmode=pie -exec=arun ./demo

• 如果需要在 Android 真实设备上运行（armv7a 或 armv8），请运行

arm go run -buildmode=pie -exec=arun ./demo

或

arm64 go run -buildmode=pie -exec=arun ./demo

如果 Android 设备比较新的话（一定是支持 64 位芯片的）。 如果不熟悉 go run 命令可以查看 go help run 文档。 一切顺利的话，会有类似下面的输出：

prepare to push /var/folders/n5/26_m50tn4_j2n3gmvt19300h0000gn/T/go-build440104086/b001/exe/demo to device
/var/folders/n5/26_m50tn4_j2n3gmvt19300h0000gn/T/go-build440104086/b001/exe/demo: 1 file pushed, 0 skipped. 60.2 MB/s (1850264 bytes in 0.029s)
[程序输出如下]
Hello android device!
[程序执行返回错误码(1)]

运行 go test

和运行 go run 类似，

[386|amd64|arm|arm64] go test -buildmode=pie -exec=arun <package or directory> [build/test flags & test binary flags]

例如，新建单元测试文件 demo_test.go

package main

import "testing"

func TestDemo(t *testing.T) {
	t.Log("Hello Android Device!!!")
	t.Fatal("Force fail.")
}

然后在 Android 真实设备中运行该测试 case：

arm64 go test -buildmode=pie -exec=arun . -v

会有如下输出：

prepare to push /var/folders/n5/26_m50tn4_j2n3gmvt19300h0000gn/T/go-build199324000/b001/demo.test to device
/var/folders/n5/26_m50tn4_j2n3gmvt19300h0000gn/T/go-build199324000/b001/demo.test: 1 file pushed, 0 skipped. 76.3 MB/s (2853464 bytes in 0.036s)
[程序输出如下]
=== RUN   TestDemo
    TestDemo: demo_test.go:6: Hello Android Device!!!
    TestDemo: demo_test.go:7: Force fail.
--- FAIL: TestDemo (0.00s)
FAIL
[程序执行返回错误码(1)]

Documentation

Index

• func LibsMain(level int, args ...string)
• func Main(s string)

Functions

func LibsMain

func LibsMain(level int, args ...string)

func Main

func Main(s string)