{"canonical_url":"https://engineer.company/sv/notes/solana-mobile-wallet-deeplinks/","content_markdown":"# Öppna en dApp i Solanas mobilplånböcker\n\n2026-08-10\n\nEn React-dApp byggd på `@solana/wallet-adapter-react` ansluter till plånböcker på\ndatorn utan problem, men i en telefon faller samma flöde isär: plånboken måste\nöppna dAppen i sin egen inbyggda webbläsare, och djuplänkarna som ska få det att\nhända misslyckas i det tysta. Backpack hamnar på en sida med ”ladda ned appen”;\nSolflare öppnar appen men aldrig webbplatsen; varje variant verkar misslyckas. Vi\nplockade isär problemet, och det visade sig vara fyra separata problem bakom ett\noch samma symptom.\n\n## De fyra problemen\n\n- **Backpack-länken var felaktigt utformad.** Det enda dokumenterade formatet är\n  `https://backpack.app/ul/v1/browse/\u003curl\u003e?ref=\u003cref\u003e` — en universell länk med\n  mål-URL:en i sökvägen och en obligatorisk `ref`. En gissning med ett eget\n  URL-schema, som `backpack://ul/v1/browse?url=...`, matchar ingen rutt som\n  appen registrerar, så användaren hamnar på plånbokens installationssida.\n- **Solflare behöver också sin universella länk:**\n  `https://solflare.com/ul/v1/browse/\u003curl\u003e?ref=\u003cref\u003e`, inte det nakna schemat\n  `solflare://`. Ett naket schema kan starta appen utan att dirigera den vidare —\n  vilket är exakt ”appen öppnas, men webbplatsfliken måste öppnas för hand”.\n- **Båda parametrarna måste kodas.** `url` är dAppens fullständiga, absoluta\n  adress och `ref` är ursprunget som gör begäran, och båda skickas genom\n  `encodeURIComponent`. Ett okodat `?` eller `\u0026` i målet förstör tolkningen, och\n  plånboken öppnas på sin startskärm i stället för i webbläsarfliken.\n- **Hur länken utlöses spelar lika stor roll som länken.** Universella länkar\n  byter bara app vid en navigering som operativsystemet litar på — och de gör\n  avsiktligt ingenting när de klistras in i adressfältet, vilket också är hur en\n  helt korrekt länk ”misslyckas” under testning.\n\n## De dokumenterade formaten\n\n- Phantom: `https://phantom.app/ul/browse/\u003curl\u003e?ref=\u003cref\u003e` — utan `/v1` i den\n  här.\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\nEtt och samma mönster fungerar för alla tre:\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## Utlös länken så att iOS och Android accepterar den\n\n- **Rendera ett riktigt ankarelement, beräknat i förväg.** En vanlig\n  `\u003ca href={walletBrowseLink('phantom')}\u003e` är den mest pålitliga utlösaren på\n  båda plattformarna.\n- **Om det måste ske programmatiskt**, sätt `window.location.href` synkront\n  inuti hanteraren för trycket — ingen `await`, ingen `fetch`, ingen\n  `setTimeout` först. Efter asynkront arbete är gestens kontext borta, och iOS\n  faller tillbaka på plånbokens webbplats. Aldrig `window.open`.\n- **Testa aldrig genom att klistra in i adressfältet.** Universella länkar\n  utlöses avsiktligt inte där; testa med en länk som du trycker på eller en\n  QR-kod som skannas med kameran.\n- **Se upp med meddelandeappars webbvyer.** I Telegrams eller Instagrams\n  inbyggda webbläsare sväljs universella länkar ofta, och plånbokens vanliga\n  webbplats laddas i stället. Att känna igen dem på user agent är i bästa fall\n  en heuristik, så ge också användarna en synlig nödutgång: ”öppna i Safari\n  eller Chrome och anslut sedan”.\n\n## Den större lösningen på Android\n\nHandbyggda djuplänkar är iOS-sidan av saken. På Android låter Mobile Wallet\nAdapter från Solana Mobile en dApp som körs i mobilens webbläsare ansluta\ndirekt till den installerade plånboksappen, helt utan omvägen via en inbyggd\nwebbläsare. Nyare versioner av `@solana/wallet-adapter-react` registrerar\nmobiladaptern automatiskt, så en uppgradering av wallet-adapter-paketen kan på\negen hand lösa problemet på Android. Målarkitekturen: Mobile Wallet Adapter på Android,\nuniversella browse-länkar på iOS, där Apple inte tillåter någon motsvarighet.\n\n## Verifiera på en enhet\n\n1. Riktig enhet, plånboken installerad, länken öppnad från systemets webbläsare\n   — inte från en meddelandeapp.\n2. Tryck på en renderad länk eller skanna en QR-kod; klistra aldrig in i\n   adressfältet.\n3. Bekräfta att plånboken öppnas och att dAppen laddas i dess inbyggda\n   webbläsarflik — den andra halvan är den del som misslyckas.\n4. Upprepa utan plånboken installerad: den universella länken ska då falla\n   tillbaka på plånbokens webbplats. Visas den sidan medan appen är installerad\n   är länken eller utlösningen fortfarande fel.\n5. Testa sedan vägen via meddelandeappar, och lägg till tipset ”öppna i\n   webbläsaren” om det misslyckas där.\n\n## Källor\n\n- [Phantom: djuplänkar på iOS och Android](https://docs.phantom.com/phantom-deeplinks/deeplinks-ios-and-android)\n- [Solflare: Browse-djuplänken](https://docs.solflare.com/solflare/technical/deeplinks/other-methods/browse)\n- [Backpack: Browse-djuplänken](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/sv/notes/solana-mobile-wallet-deeplinks/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Varför browse-djuplänkar till Phantom, Solflare och Backpack misslyckas i mobilen, och de format, regler och lösningar som får dem att fungera.","formats":{"gemtext":"https://engineer.company/sv/notes/solana-mobile-wallet-deeplinks/index.gmi","gopher":"https://engineer.company/sv/notes/solana-mobile-wallet-deeplinks/gophermap","html":"https://engineer.company/sv/notes/solana-mobile-wallet-deeplinks/","json":"https://engineer.company/sv/notes/solana-mobile-wallet-deeplinks/index.json","markdown":"https://engineer.company/sv/notes/solana-mobile-wallet-deeplinks/index.md","pdf":"https://engineer.company/sv/notes/solana-mobile-wallet-deeplinks/index.pdf"},"kind":"page","language":"sv","title":"Öppna en dApp i Solanas mobilplånböcker","url":"https://engineer.company/sv/notes/solana-mobile-wallet-deeplinks/","version":1}