101 lines
No EOL
3.5 KiB
Markdown
101 lines
No EOL
3.5 KiB
Markdown
# HA starten — Tailscale + Home Assistant launcher
|
|
|
|
Minimalistische Android app die in één tik **Tailscale VPN aanzet** en daarna de
|
|
**Home Assistant** app opent. Ideaal als je HA alleen bereikbaar is via de
|
|
Tailscale MagicDNS-naam (bijv. `https://homeassistant.tail…ts.net`): buiten je
|
|
thuisnetwerk moet eerst de tunnel omhoog, pas dan kan de HA-app verbinden.
|
|
|
|
## Waarom
|
|
|
|
- HA-app staat louter op de **tailnet-URL** (geen LAN-IP), dus de tunnel moet
|
|
actief zijn vóór HA een verbinding kan maken.
|
|
- `getLaunchIntentForPackage`/broadcasts overnemen in Tasker was fragiel en
|
|
verward (accessibility-service, package-visibility, exit-condities). Eén
|
|
knop-app is simpeler en betrouwbaarder.
|
|
|
|
## Werking
|
|
|
|
Op basis van de [officiële Tailscale Android intents](https://github.com/tailscale/tailscale-android/pull/87):
|
|
|
|
| Knop | BroadCast intent |
|
|
|---|---|
|
|
| **VPN aan + HA openen** | `com.tailscale.ipn.CONNECT_VPN` |
|
|
| **VPN uit** (sluit daarna de app) | `com.tailscale.ipn.DISCONNECT_VPN` |
|
|
|
|
Beide gericht op `com.tailscale.ipn/.IPNReceiver` (Broadcast Receiver). De app
|
|
wacht ~3 s na CONNECT (Tailscale-handshake) voordat hij de HA-app start.
|
|
|
|
### Knoppen
|
|
- Verbind-knop bovenaan, uit-knop onderaan — ver uit elkaar om fouttappen te
|
|
voorkomen.
|
|
|
|
## Vereisten
|
|
|
|
- Android 8.0+ (minSdk 26, targetSdk 34)
|
|
- **Tailscale** app geïnstalleerd en ingelogd
|
|
- **Home Assistant** Companion app geïnstalleerd (`io.homeassistant.companion.android`)
|
|
|
|
> Batterijoptimalisatie uitzetten voor Tailscale werkt het betrouwbaarst;
|
|
> direct na een telefoon-reboot kan de broadcast-intent kort falen (startlag van
|
|
> Tailscale's `IPNReceiver`).
|
|
|
|
## Bouwen
|
|
|
|
De app is bewust Gradle-vrij — een handmatige `aapt2`/`javac`/`d8`-pipeline op een
|
|
machine met Android SDK build-tools + platform 34:
|
|
|
|
```bash
|
|
SDK=/opt/homebrew/share/android-commandlinetools
|
|
BT=$SDK/build-tools/34.0.0
|
|
AJ=$SDK/platforms/android-34/android.jar
|
|
|
|
mkdir -p classes dex out out/res
|
|
|
|
# 1. resources compilen + linken
|
|
aapt2 compile --dir res -o out/res/
|
|
aapt2 link -o out/app-unsigned.apk -I "$AJ" \
|
|
--manifest AndroidManifest.xml \
|
|
--min-sdk-version 26 --target-sdk-version 34 \
|
|
--version-code 1 --version-name 1.0 \
|
|
$(find out/res -name '*.flat')
|
|
|
|
# 2. Java -> dex (gebruik een recente d8; oudere build-tools-d8 faalt op inner classes)
|
|
javac --release 8 -classpath "$AJ" -d classes src/nl/eddy/tailscalehalauncher/MainActivity.java
|
|
d8 --release --lib "$AJ" --output dex classes/nl/eddy/tailscalehalauncher/*.class
|
|
|
|
# 3. dex in apk, align, sign
|
|
(cd out && zip -qj app-unsigned.apk ../dex/classes.dex)
|
|
zipalign -f 4 out/app-unsigned.apk out/app-aligned.apk
|
|
apksigner sign --ks debug.keystore --ks-pass pass:android \
|
|
--out out/app.apk out/app-aligned.apk
|
|
```
|
|
|
|
Resultaat: `out/app.apk`.
|
|
|
|
## Installeren
|
|
|
|
```bash
|
|
adb install -r out/app.apk
|
|
```
|
|
|
|
of kopieer `out/app.apk` naar de telefoon en tik hem aan (sideload; "onbekende
|
|
bronnen" toestaan).
|
|
|
|
## Projectstructuur
|
|
|
|
```
|
|
AndroidManifest.xml # manifest + <queries> voor HA-zichtbaarheid
|
|
src/nl/eddy/tailscalehalauncher/ # MainActivity (enige bron)
|
|
res/mipmap-{mdpi..xxxhdpi}/ic_launcher.png # launcher-icoon (HA-blauw + dikke L)
|
|
```
|
|
|
|
## Aanpassen
|
|
|
|
- **Wachttijd VPN → HA-start:** `WAIT_FOR_VPN_MS` in `MainActivity.java`.
|
|
- **Andere target-app:** `HA_PKG` in `MainActivity.java`.
|
|
- **Icoon regenereren:** de `res/mipmap-*/ic_launcher.png` worden uit een 512px-PNG
|
|
gemaakt (`Image.LANCZOS` downscale); pas ze direct aan als je er een wilt wijzigen.
|
|
|
|
---
|
|
|
|
*Dit project is gebouwd met DeepSeek V4 Flash (OMP-agent) als ontwikkelondersteuning.* |