365b0ce6b0
Prior to https://github.com/tailscale/tailscale-android/pull/73/, the exit node status pane was set to a background color using: paint.Fill(gtx.Ops, bg) paint.Fill() is documented to fill the entire clipped area. It assumes that one has already applied a clip area... but no clip area had been set in this code path. As far as I can tell, that this worked prior to pull #73 was a bug, something had a side-effect of setting a clipping rectangle. We updated to the head of the Gio repo, which apparently fixed that bug. After pull #73, the paint.Fill() painted the entire app window. Fix this using a stacked layout. A color filled widget is the lower layer, and will expand to the size of the widget sitting atop of it. Fixes https://github.com/tailscale/tailscale/issues/6873 Signed-off-by: Denton Gentry <dgentry@tailscale.com> Signed-off-by: Denton Gentry <dgentry@tailscale.com> |
2 years ago | |
|---|---|---|
| .github | 2 years ago | |
| android | 2 years ago | |
| cmd/tailscale | 2 years ago | |
| jni | 3 years ago | |
| metadata/en-US | 4 years ago | |
| version | 3 years ago | |
| .gitignore | 3 years ago | |
| Dockerfile | 3 years ago | |
| LICENSE | 5 years ago | |
| Makefile | 2 years ago | |
| PATENTS | 5 years ago | |
| README.md | 3 years ago | |
| flake.lock | 3 years ago | |
| flake.nix | 3 years ago | |
| go.mod | 2 years ago | |
| go.sum | 2 years ago | |
README.md
Tailscale Android Client
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
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
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
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.
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.IPNActivity
adb shell pm uninstall com.tailscale.ipn
Building on macOS
To build from the CLI on macOS:
- Install Android Studio
- In Android Studio's home screen: "More Actions" > "SDK Manager", install NDK.
- You can now close Android Studio, unless you want it to create virtual devices ("More Actions" > "Virtual Device Manager").
- Then, from CLI:
export JAVA_HOME='/Applications/Android Studio.app/Contents/jre/Contents/Home'export ANDROID_SDK_ROOT=$HOME/Library/Android/sdkmake tailscale-fdroid.apk, etc
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.