README
¶
igniter-go-libs
How to build
Prerequirements
- go >= 1.13
- gomobile https://github.com/golang/mobile
Install Go
Please make sure you have at least Go 1.13 installed correctly
go version
You should see something like
go version go1.13.8 linux/amd64
Install and upgrade gomobile
In this example, We will install gomobile and its dependencies to $GOPATH.
You can find the executable in $GOPATH/bin, to make it easy to use, we add it to PATH.
To upgrade, re-run the install commands.
export GOPATH=$HOME/go
go get -u -d -v golang.org/x/mobile/cmd/gomobile
go build -a -v golang.org/x/mobile/cmd/gomobile
go install -v golang.org/x/mobile/cmd/gomobile
# Make sure we can execute gomobile and gobind directly
export PATH="$GOPATH/bin:$PATH"
# prepare gomobile component: gobind
gomobile init
Build
# If you cannot execute command, make sure your PATH is correct
# Point to your Android SDK root
# change to your installation configuration please
export ANDROID_HOME=/path/to/your/android/sdk
# Clone this repository
pushd /path/to/git/repository/just/cloned
make android
Development Guide
How to switch between local and remove module
If you want to say, point to the local version of a dependency in Go rather than the one over the web, use the replace keyword.
The replace line goes above your require statements, like so:
module github.com/person/foo
replace github.com/person/bar => /Users/person/Projects/bar
require (
github.com/person/bar v1.0.0
)
And now when you compile this module (go install), it will use your local code rather than the other dependency.
According to the docs, you do need to make sure that the code you’re pointing to also has a go.mod file.
go mod edit -replace github.com/eycorsican/go-tun2socks=/path/to/my/local/github/igniter-deps/go-tun2socks
It looks everything is fine, we can push changes in your local repository to the remote one.
In this example, the commit we just pushed is efeee82.
To switch to the version over the web, a.k.a. the commit efeee82 from module github.com/trojan-gfw/go-tun2socks
go mod edit -replace github.com/eycorsican/go-tun2socks=github.com/trojan-gfw/go-tun2socks@efeee82
To check which dependency you are truely using:
go list -m all
How to make C/C++ source changes take effect
For go tools, e.g. gobind, it only check *.go file changes.
Please make sure to change at least one golang source by adding whitespaces or line breaks or whatever you like.
The go tools notify *.go changes, it will recompile the C/C++ sources.
Directories