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

Denton Gentry 594ed6b7bc android: bump version code On 6/24 I built a v43 and started to release it to production, then decided to do an Internal release first. The Play Store would not allow v43 to be used again so I built v44, released it to Internal, and after testing promoted it to Production and it went into Google's review process. Crucially, I did not push the tags before going to bed. On 6/25, not knowing any of this because I hadn't pushed the tags, Elias built v43 and released it. The Play Store had apparently cleaned up the state from my abandoned v43 by that point. This commit increments the build number to v44 so we don't re-use it. I'm not building an actual release, just incrementing the build number and pointing to the same git commit. I'm hoping F-Droid will therefore build exactly the same thing as it did for v43. I promise to push the tags before going to bed next time. Signed-off-by: Denton Gentry <dgentry@tailscale.com>		5 years ago
android	android: bump version code	5 years ago
cmd/tailscale	cmd/tailscale: use go:embed directives for image files	5 years ago
jni	jni: merge jni.c into jni.go	5 years ago
metadata/en-US	metadata/en-US/images/phoneScreenshots: add screenshots for F-Droid	5 years ago
version	Makefile,version: update versioning scheme to match main repository	5 years ago
.gitignore	gitignore: also ignore tailscale-debug.apk	5 years ago
Dockerfile	Dockerfile: bump Go to 1.16, set ANDROID_SDK_ROOT for dockershell	5 years ago
LICENSE	all: initial commit	6 years ago
Makefile	Makefile,version: update versioning scheme to match main repository	5 years ago
PATENTS	all: initial commit	6 years ago
README.md	README.md: document how to get the app working in android emulator.	5 years ago
go.mod	cmd/tailscale: use go:embed directives for image files	5 years ago
go.sum	cmd/tailscale: use go:embed directives for image files	5 years 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

Building

Go, the Android SDK, the Android NDK are required.

$ make tailscale-debug.apk
$ adb install -r tailscale-debug.apk

The dockershell target builds a container with the necessary dependencies and runs a shell inside it.

$ make dockershell
# make tailscale-debug.apk

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.

Google Sign-In support relies on configuring a Google API Console project with the app identifier and signing key hashes. The official release uses the app identifier com.tailscale.ipn; custom builds should use a different identifier.

Running in the Android emulator

By default, the android emulator uses an older version of OpenGL ES, which results in a black screen when opening the Tailscale app. To fix this, with the emulator running:

Open the three-dots menu to access emulator settings
To to Settings > Advanced
Set "OpenGL ES API level" to "Renderer maximum (up to OpenGL ES 3.1)"
Close the emulator.
In Android Studio's emulator view (that lists all your emulated devices), hit the down arrow by the virtual device and select "Cold boot now" to restart the emulator from scratch.

The Tailscale app should now render correctly.

Additionally, there seems to be a bug that prevents using the system-level Google sign-in option (the one that pops up a system-level UI to select your Google account). You can work around this by selecting "Other" at the sign-in screen, and then selecting Google from the next screen.

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 apenwarr, bradfitz, crawshaw, danderson, dfcarney, from Tailscale Inc. You can learn more about us from our website.

WireGuard is a registered trademark of Jason A. Donenfeld.