psiphon-tunnel-core/AndroidLibrary/README.md

Psiphon Library for Android README

Overview

Psiphon Library for Android enables you to easily embed Psiphon in your Android app.

Status

• Pre-release

Building From Source

Review Go Android documentation:

• Main README
• Sample JNI App README

• gobind documentation

  /AndroidLibrary
  README.md                - this file
  gojni.so                 - build binary output
  /psi
  psi.go                 - main library source
  /go_psi
  go_psi.go              - gobind output
  /java_psi/go/psi
  Psi.java               - gobind output
  /java_golang/go
  Go.java                - fork of Go/Java integration file
  Seq.java               - fork of Go/Java integration file
  /libpsi
  main.go                - stub main package for library
  

• Requires Go 1.4 or later

  • At this time, android/arm support is not yet released but.
  • Install Go from source. The Android instructions are here: https://code.google.com/p/go/source/browse/README?repo=mobile.
  • In summary, download and install the Android NDK, use a script to make a standalone toolchain, and use that toolchain to build android/arm support within the Go source install. Then cross compile as usual.

• $GOPATH/bin/gobind -lang=go github.com/Psiphon-Labs/psiphon-tunnel-core/AndroidLibrary/psi > go_psi/go_psi.go

• $GOPATH/bin/gobind -lang=java github.com/Psiphon-Labs/psiphon-tunnel-core/AndroidLibrary/psi > java_psi/go/psi/Psi.java

• In /libpsi CGO_ENABLED=1 GOOS=android GOARCH=arm GOARM=7 go build -ldflags="-shared" and copy output file to gojni.so

Using

1. Add Go/Java integration files java_golang/go/*.java to your $src/go
2. Add java_psi/go/psi/Psi.java to your $src/go/psi
3. Add `gojni.so

NOTE: may change to Psiphon-specific library name and init.

AndroidApp README

See sample usage in Psiphon.java. Uses gobind conventions for data passing.

1. Embed a config file
2. Call Go.init(getApplicationContext()); in Application.onCreate()
3. Extend Psi.Listener.Stub to receive messages in Message(String line)
4. Call Psi.Start(configFile, Psi.Listener) to start Psiphon. Catch Exception to receive errors.
5. Call Psi.Stop() to stop Psiphon.
6. Sample shows how to monitor messages and detect which proxy ports to use and when the tunnel is active.

NOTE: may add more explicit interface for state change events.

Limitations

• Only supports one concurrent instance of Psiphon.