{"canonical_url":"https://engineer.company/de/notes/solana-mobile-wallet-deeplinks/","content_markdown":"# Eine dApp in mobilen Solana-Wallets öffnen\n\n2026-08-10\n\nEine mit `@solana/wallet-adapter-react` entwickelte React-dApp verbindet Desktop-Wallets problemlos. Auf dem Telefon scheitert derselbe Ablauf: Die Wallet muss die dApp im eigenen integrierten Browser öffnen, doch die vorgesehenen Deep Links tun es stillschweigend nicht. Backpack landet auf einer Seite mit „download the app“; Solflare öffnet die App, aber nie die Website. Jede Variante scheint zu scheitern. Wir untersuchten das Problem und fanden vier getrennte Ursachen mit demselben Symptom.\n\n## Die vier Probleme\n\n- **Der Backpack-Link war falsch aufgebaut.** Das einzige dokumentierte Format ist `https://backpack.app/ul/v1/browse/\u003curl\u003e?ref=\u003cref\u003e` — ein Universal Link mit der Ziel-URL im Pfad und einem erforderlichen `ref`. Ein geratenes eigenes Schema wie `backpack://ul/v1/browse?url=...` passt zu keiner von der App registrierten Route. Deshalb landet der Benutzer auf der Installationsseite der Wallet.\n- **Auch Solflare benötigt seinen Universal Link:** `https://solflare.com/ul/v1/browse/\u003curl\u003e?ref=\u003cref\u003e`, nicht das bloße Schema `solflare://`. Ein nacktes Schema kann die App ohne Weiterleitung öffnen — genau der Fall, in dem die App startet, der Website-Tab aber von Hand geöffnet werden muss.\n- **Beide Parameter müssen kodiert sein.** `url` ist die vollständige absolute dApp-Adresse, `ref` die anfragende Origin; beide werden durch `encodeURIComponent` geführt. Ein nicht kodiertes `?` oder `\u0026` im Ziel beschädigt die Auswertung. Die Wallet öffnet dann ihren Startbildschirm statt des Browsertabs.\n- **Der Auslöser zählt genauso wie der Link.** Universal Links wechseln nur bei einer vom Betriebssystem als vertrauenswürdig eingestuften Navigation die App. Beim Einfügen in die Adressleiste tun sie bewusst nichts — so kann auch ein vollkommen korrekter Link beim Test scheinbar scheitern.\n\n## Die dokumentierten Formate\n\n- Phantom: `https://phantom.app/ul/browse/\u003curl\u003e?ref=\u003cref\u003e` — hier ohne `/v1`.\n- Solflare: `https://solflare.com/ul/v1/browse/\u003curl\u003e?ref=\u003cref\u003e`\n- Backpack: `https://backpack.app/ul/v1/browse/\u003curl\u003e?ref=\u003cref\u003e`\n\nEin Muster genügt für alle drei:\n\n```js\nconst WALLET_BROWSE = {\n  phantom: (url, ref) =\u003e\n    `https://phantom.app/ul/browse/${url}?ref=${ref}`,\n  solflare: (url, ref) =\u003e\n    `https://solflare.com/ul/v1/browse/${url}?ref=${ref}`,\n  backpack: (url, ref) =\u003e\n    `https://backpack.app/ul/v1/browse/${url}?ref=${ref}`,\n};\n\nfunction walletBrowseLink(\n  walletName,\n  targetUrl = window.location.href,\n) {\n  const build = WALLET_BROWSE[walletName.toLowerCase()];\n  if (!build) return null;\n  return build(\n    encodeURIComponent(targetUrl),\n    encodeURIComponent(window.location.origin),\n  );\n}\n```\n\n## Den Link so auslösen, dass iOS und Android ihn akzeptieren\n\n- **Ein echtes, vorab berechnetes Linkelement darstellen.** Ein einfaches `\u003ca href={walletBrowseLink('phantom')}\u003e` ist auf beiden Plattformen der zuverlässigste Auslöser.\n- **Wenn es programmatisch sein muss**, weisen Sie `window.location.href` synchron innerhalb des Tap-Handlers zu — vorher kein `await`, `fetch` oder `setTimeout`. Nach asynchroner Arbeit ist der Gestenkontext verloren, und iOS fällt auf die Website der Wallet zurück. Niemals `window.open` verwenden.\n- **Nie durch Einfügen in die Adressleiste testen.** Universal Links werden dort absichtlich nicht ausgelöst. Testen Sie mit einem angetippten Link oder einem von der Kamera gescannten QR-Code.\n- **Integrierte Messenger-Browser beachten.** In den In-App-Browsern von Telegram oder Instagram werden Universal Links häufig abgefangen; stattdessen lädt die gewöhnliche Website der Wallet. User-Agent-Erkennung bleibt bestenfalls eine Heuristik. Bieten Sie deshalb zusätzlich einen sichtbaren Ausweg an: „In Safari oder Chrome öffnen, dann verbinden“.\n\n## Die umfassendere Lösung für Android\n\nSelbst gebaute Deep Links sind der Weg für iOS. Unter Android ermöglicht Solana Mobiles Mobile Wallet Adapter einer dApp im mobilen Browser die direkte Verbindung mit der installierten Wallet-App, ganz ohne Umweg über deren integrierten Browser. Neuere Versionen von `@solana/wallet-adapter-react` registrieren den mobilen Adapter automatisch. Ein Update der wallet-adapter-Pakete kann Android daher bereits für sich genommen korrigieren. Die Zielarchitektur: Mobile Wallet Adapter auf Android, Browse-Universal-Links auf iOS, wo Apple kein entsprechendes Verfahren erlaubt.\n\n## Auf einem Gerät überprüfen\n\n1. Echtes Gerät, installierte Wallet, Link aus dem Systembrowser geöffnet — nicht aus einem Messenger.\n2. Einen dargestellten Link antippen oder einen QR-Code scannen; niemals in die Adressleiste einfügen.\n3. Prüfen, dass die Wallet öffnet und die dApp in ihrem integrierten Browsertab lädt — der zweite Teil ist der fehleranfällige.\n4. Ohne installierte Wallet wiederholen: Der Universal Link sollte auf die Wallet-Website zurückfallen. Erscheint diese Seite bei installierter App, stimmt weiterhin der Link oder der Auslöser nicht.\n5. Danach den Messenger-Weg testen und bei Bedarf den Hinweis zum Öffnen im Browser ergänzen.\n\n## Quellen\n\n- [Phantom: Deep Links auf iOS und Android](https://docs.phantom.com/phantom-deeplinks/deeplinks-ios-and-android)\n- [Solflare: der Browse-Deep-Link](https://docs.solflare.com/solflare/technical/deeplinks/other-methods/browse)\n- [Backpack: der Browse-Deep-Link](https://docs.backpack.app/deeplinks/other-methods/browse)\n- [Solana Mobile: Mobile Wallet Adapter](https://docs.solanamobile.com/mobile-wallet-adapter/mobile-apps)\n\n\u003chttps://engineer.company/de/notes/solana-mobile-wallet-deeplinks/\u003e\n","date_modified":"2026-11-08T09:42:23Z","description":"Warum Browse-Deep-Links von Phantom, Solflare und Backpack mobil scheitern und welche Formate, Auslöser und Korrekturen funktionieren.","formats":{"gemtext":"https://software.engineer.company/de/notes/solana-mobile-wallet-deeplinks/index.gmi","gopher":"https://software.engineer.company/de/notes/solana-mobile-wallet-deeplinks/gophermap","html":"https://software.engineer.company/de/notes/solana-mobile-wallet-deeplinks/","json":"https://software.engineer.company/de/notes/solana-mobile-wallet-deeplinks/index.json","markdown":"https://software.engineer.company/de/notes/solana-mobile-wallet-deeplinks/index.md","pdf":"https://software.engineer.company/de/notes/solana-mobile-wallet-deeplinks/index.pdf"},"kind":"page","language":"de","title":"Eine dApp in mobilen Solana-Wallets öffnen","url":"https://software.engineer.company/de/notes/solana-mobile-wallet-deeplinks/","version":1}