You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

Percy Wegmann 46cdbb7b9b android: set wantRunning to true when started from Always On VPN (#392 ) This way, even if the VPN wasn't previously manually enabled, it'll still turn on after reboot Updates #cleanup Signed-off-by: Percy Wegmann <percy@tailscale.com>		7 months ago
.github	go.mod: run go mod tidy, add github action	7 months ago
.vscode	…
android	android: set wantRunning to true when started from Always On VPN (#392 )	7 months ago
libtailscale	android: only consider backend ready once LocalBackend.Start() has finished	7 months ago
metadata/en-US	metadata: update images for F-Droid (#381 )	7 months ago
scripts	*: add a CI check for license headers and fix all files	9 months ago
tool	*: introduce tool/go following our common pattern	8 months ago
version	…
.gitignore	android: add smoke test	8 months ago
Dockerfile	…
LICENSE	…
Makefile	Makefile: clean up the Makefile (#354 )	7 months ago
PATENTS	…
README.md	README.md: update for new app	7 months ago
eclipse-formatter.xml	…
flake.lock	…
flake.nix	…
go.mod	bump oss and version num for 217 (#390 )	7 months ago
go.sum	bump oss and version num for 217 (#390 )	7 months ago
go.toolchain.rev	android: bump OSS and bump version code to 206 (#329 )	8 months ago

README.md

Tailscale Android Client

https://tailscale.com

Private WireGuard® networks made easy

Overview

This repository contains the open source Tailscale Android client.

Using

Preparing a build environment

There are several options for setting up a build environment. The Android Studio path is the most useful path for longer term development.

In all cases you will need:

Go runtime
Android SDK
Android SDK components (make androidsdk will install them)

Android Studio

Install a Go runtime (https://go.dev/dl/).
Install Android Studio (https://developer.android.com/studio).
Start Android Studio, from the Welcome screen select "More Actions" and "SDK Manager".
In the SDK manager, select the "SDK Tools" tab and install the "Android SDK Command-line Tools (latest)".
Run make androidsdk to install the necessary SDK components.

If you would prefer to avoid Android Studio, you can also install an Android SDK. The makefile detects common paths, so sudo apt install android-sdk is sufficient on Debian / Ubuntu systems. To use an Android SDK installed in a non-standard location, set the ANDROID_SDK_ROOT environment variable to the path to the SDK.

If you installed Android Studio the tools may not be in your path. To get the correct tool path, run make androidpath and export the provided path in your shell.

Code Formatting

The ktmft plugin on the default setting should be used to autoformat all Java, Kotlin and XML files in Android Studio. Enable "Format on Save".

Docker

If you wish to avoid installing software on your host system, a Docker based development strategy is available, you can build and start a shell with:

make dockershell

Nix

If you have Nix 2.4 or later installed, a Nix development environment can be set up with:

alias nix='nix --extra-experimental-features "nix-command flakes"'
nix develop

Building

make apk
make install

Building a release

Use make tag_release to bump the Android version code, update the version name, and tag the current commit.

We only guarantee to support the latest Go release and any Go beta or release candidate builds (currently Go 1.14) in module mode. It might work in earlier Go versions or in GOPATH mode, but we're making no effort to keep those working.

Developing on a Fire Stick TV

On the Fire Stick:

Settings > My Fire TV > Developer Options > ADB Debugging > ON

Then some useful commands:

adb connect 10.2.200.213:5555
adb install -r tailscale-fdroid.apk
adb shell am start -n com.tailscale.ipn/com.tailscale.ipn.MainActivity
adb shell pm uninstall com.tailscale.ipn

Bugs

Please file any issues about this code or the hosted service on the tailscale issue tracker.

Contributing

under_construction.gif

PRs welcome, but we are still working out our contribution process and tooling.

We require Developer Certificate of Origin Signed-off-by lines in commits.

About Us

We are Tailscale. See https://tailscale.com/company for more about us and what we're building.

WireGuard is a registered trademark of Jason A. Donenfeld.