# Sådan åbner man en dApp i Solana-mobilwallets

2026-08-10

En React-dApp bygget på `@solana/wallet-adapter-react` forbinder desktop-wallets uden problemer, men på en telefon falder det samme flow fra hinanden: wallet'en skal åbne dApp'en i sin egen indbyggede browser, og de deeplinks, der skulle klare det, virker bare ikke. Backpack lander på en "hent appen"-side; Solflare åbner appen, men aldrig sitet; alle varianter ser ud til at fejle. Vi skilte problemet ad, og det viste sig at være fire adskilte problemer med ét fælles symptom.

## De fire problemer
* Backpack-linket var forkert bygget. Det eneste dokumenterede format er `https://backpack.app/ul/v1/browse/<url>?ref=<ref>` — et universelt link med mål-URL'en i stien og et påkrævet `ref`. Et gæt med eget skema som `backpack://ul/v1/browse?url=...` matcher ingen rute i appen, så brugeren ender på wallet'ens installationsside.
* Solflare skal også bruge sit universelle link: `https://solflare.com/ul/v1/browse/<url>?ref=<ref>` — ikke det rå `solflare://`-skema. Et råt skema kan starte appen uden at dirigere den — hvilket er præcis "appen åbner, men site-fanen må åbnes manuelt".
* Begge parametre skal være kodet. `url` er dApp'ens fulde absolutte adresse, og `ref` er den kaldende origin, hver især gennem `encodeURIComponent`. Et ukodet `?` eller `&` i målet ødelægger fortolkningen, og wallet'en åbner på sin forside i stedet for browserfanen.
* Udløsningen betyder lige så meget som linket. Universelle links skifter kun app ved en navigation, styresystemet stoler på — og de gør med vilje ingenting, når de indsættes i adresselinjen, hvilket også er sådan, et helt korrekt link "fejler" under test.

## De dokumenterede formater
* Phantom: `https://phantom.app/ul/browse/<url>?ref=<ref>` — uden `/v1` i netop dette.
* Solflare: `https://solflare.com/ul/v1/browse/<url>?ref=<ref>`
* Backpack: `https://backpack.app/ul/v1/browse/<url>?ref=<ref>`

Ét mønster dækker alle tre:

```js
const WALLET_BROWSE = {
  phantom: (url, ref) =>
    `https://phantom.app/ul/browse/${url}?ref=${ref}`,
  solflare: (url, ref) =>
    `https://solflare.com/ul/v1/browse/${url}?ref=${ref}`,
  backpack: (url, ref) =>
    `https://backpack.app/ul/v1/browse/${url}?ref=${ref}`,
};

function walletBrowseLink(
  walletName,
  targetUrl = window.location.href,
) {
  const build = WALLET_BROWSE[walletName.toLowerCase()];
  if (!build) return null;
  return build(
    encodeURIComponent(targetUrl),
    encodeURIComponent(window.location.origin),
  );
}
```

## Udløs linket, så iOS og Android accepterer det
* Render et rigtigt anker, beregnet på forhånd. Et almindeligt `<a href={walletBrowseLink('phantom')}>` er den mest pålidelige udløser på begge platforme.
* Skal det ske programmatisk, så sæt `window.location.href` synkront inde i tryk-handleren — ingen `await`, ingen `fetch`, ingen `setTimeout` først. Efter asynkront arbejde er gestus-konteksten væk, og iOS falder tilbage til wallet'ens websted. Aldrig `window.open`.
* Test aldrig ved at indsætte i adresselinjen. Universelle links udløses med vilje ikke dér; test med et link, der trykkes på, eller en QR-kode, som kameraet scanner.
* Pas på messenger-webviews. Åbnet i Telegrams eller Instagrams indbyggede browser bliver universelle links ofte slugt, og wallet'ens almindelige websted indlæses i stedet. User-agent-detektion er i bedste fald et gæt, så giv også brugerne en synlig nødudgang: "åbn i Safari eller Chrome, og forbind derefter".

## Den større løsning på Android

Håndbyggede deeplinks er iOS-historien. På Android lader Solana Mobiles Mobile Wallet Adapter en dApp i mobilbrowseren forbinde direkte til den installerede wallet-app, helt uden omvejen om den indbyggede browser. Nyere versioner af `@solana/wallet-adapter-react` registrerer mobiladapteren automatisk, så en opgradering af wallet-adapter-pakkerne kan i sig selv løse problemet på Android. Målarkitekturen: Mobile Wallet Adapter på Android, universelle browse-links på iOS, hvor Apple ikke tillader en tilsvarende løsning.

## Efterprøv på en enhed

1. Rigtig enhed, wallet installeret, link åbnet fra systembrowseren — ikke fra en messenger.
2. Tryk på et renderet link, eller scan en QR-kode; indsæt aldrig i adresselinjen.
3. Bekræft, at wallet'en åbner, og at dApp'en indlæses i dens indbyggede browserfane — anden halvdel er den, der fejler.
4. Gentag uden wallet'en installeret: det universelle link skal falde tilbage til wallet'ens websted. Ser du dén side, mens appen er installeret, er linket eller udløsningen stadig forkert.
5. Test derefter messenger-vejen, og tilføj "åbn i browser"-hjælpen, hvis den fejler dér.

## Kilder
* Phantom: deeplinks på iOS og Android
* Solflare: Browse-deeplinket
* Backpack: Browse-deeplinket
* Solana Mobile: Mobile Wallet Adapter

=> https://docs.phantom.com/phantom-deeplinks/deeplinks-ios-and-android Phantom: deeplinks på iOS og Android
=> https://docs.solflare.com/solflare/technical/deeplinks/other-methods/browse Solflare: Browse-deeplinket
=> https://docs.backpack.app/deeplinks/other-methods/browse Backpack: Browse-deeplinket
=> https://docs.solanamobile.com/mobile-wallet-adapter/mobile-apps Solana Mobile: Mobile Wallet Adapter

=> https://software.engineer.company/da/notes/solana-mobile-wallet-deeplinks/ Denne side på nettet
