marcandClaude Opus 5
430ecdc737
Ein Song oder Album laesst sich per https://<host>/?song=<id> an jemanden auf derselben Instanz schicken. Der Link traegt nur die Navidrome-Id, keine Zugangsdaten — der Empfaenger sieht den Inhalt mit seinem eigenen Konto. Web: Teilen ueber navigator.share() mit Rueckfall auf die Zwischenablage. Beim Start wird ?song= / ?album= aufgeloest (nach der Anmeldung, vorher fehlen die Zugangsdaten), das Album geoeffnet, der Song gestartet und der Parameter aus der Adresszeile entfernt, damit ein Neuladen nicht erneut losspielt. Das Manifest bekommt launch_handler=navigate-existing, damit der Link in einem bereits offenen PWA-Fenster landet statt in einem neuen. Android: Teilen ueber ACTION_SEND, Empfang ueber einen App-Link-Intent-Filter. Der Host ist eine Build-Eigenschaft (-PnovasonicHost=…, verifiziert am zusammengefuehrten Manifest), die Web-Adresse fuer ausgehende Links eine neue Einstellung. Weil der NavController in der Compose-Hierarchie lebt und die Activity nicht selbst navigieren kann, reicht DeepLinkState den Link durch; onNewIntent ist mitbedacht, sonst passierte beim zweiten Link nichts. assetlinks.json liegt als Vorlage in public/ und wird vom Frontend-Image ausgeliefert (im Build verifiziert); ohne den Release-Fingerabdruck oeffnet der Link die Web-App im Browser statt die App. Anleitung: docs/share-links.md. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2.0 KiB
Teilen per Link
Ein geteilter Link sieht so aus:
https://<deine-web-adresse>/?song=<navidrome-song-id>
https://<deine-web-adresse>/?album=<navidrome-album-id>
Er trägt nur die Id, keine Zugangsdaten. Der Empfänger sieht den Inhalt mit seinem eigenen Navidrome-Konto auf derselben Instanz — wer dort keinen Zugang hat, sieht nichts.
Web
Funktioniert ohne weitere Einrichtung. Der Link wird beim Start ausgelesen (?song= / ?album=),
das Album geöffnet und der Song abgespielt; danach verschwindet der Parameter aus der Adresszeile,
damit ein Neuladen nicht erneut startet. Als installierte PWA landet der Link dank
launch_handler: navigate-existing im bereits offenen Fenster statt in einem neuen.
Android
Zwei Dinge sind nötig, damit ein Link direkt in der App landet statt im Browser:
1. Web-Adresse in der App hinterlegen — Einstellungen → „NovaSonic Web-Adresse". Ohne sie erscheint der Teilen-Eintrag im Kontextmenü gar nicht erst, weil der Link sonst ins Leere zeigt.
2. Den Host beim Bauen mitgeben und die Signatur hinterlegen:
./gradlew assembleRelease -PnovasonicHost=music.example.com
Dann den SHA-256 des Release-Signaturschlüssels ermitteln …
keytool -list -v -keystore <dein-keystore>.jks -alias <alias> | grep SHA256
… und in public/.well-known/assetlinks.json anstelle von PLATZHALTER_RELEASE_SHA256 eintragen.
Die Datei muss unter https://<deine-web-adresse>/.well-known/assetlinks.json erreichbar sein —
sie liegt im public/-Verzeichnis und wird vom Frontend-Image mit ausgeliefert.
Prüfen lässt sich das Ergebnis mit:
adb shell pm get-app-links com.novasonic.app
Steht dort verified, öffnet Android die Links ohne Nachfrage.
Ohne diesen Schritt ist der Link trotzdem nicht verloren: er öffnet im Browser die Web-App. Wer die App bevorzugt, kann sie in den Systemeinstellungen unter Standardmäßig öffnen → Links manuell für die Domain zulassen.