eduardweb.
Navigație & StateAvansat#react-native#android#ios#deep-linking#expo-router

Deep Linking curat în Expo Router: de la custom scheme la Universal Links

De Paul Ene, 14 nov. 2026 · 16 vizualizări · 2 like-uri

Postat 14 nov. 2026
json
{
  "expo": {
    "name": "MagazinApp",
    "slug": "magazin-app",
    "scheme": "magazinapp",
    "ios": {
      "bundleIdentifier": "ro.magazin.app",
      "associatedDomains": ["applinks:magazin.ro"]
    },
    "android": {
      "package": "ro.magazin.app",
      "intentFilters": [
        {
          "action": "VIEW",
          "autoVerify": true,
          "data": [
            {
              "scheme": "https",
              "host": "magazin.ro",
              "pathPrefix": "/produs"
            }
          ],
          "category": ["BROWSABLE", "DEFAULT"]
        }
      ]
    }
  }
}

Am migrat recent o aplicație de retail cu vreo 35k utilizatori activi de la clasicul React Navigation la Expo Router v3. Pe hârtie, promisiunea e superbă: având file-based routing, deep linking-ul vine „gratis”, pentru că path-ul din browser /produs/123 mapează direct structura de fișiere app/produs/[id].tsx. În practică, până la linkul care deschide aplicația fără fricțiune, te mănâncă sfinții prin configurări de server și provisioning profile-uri.

Să lămurim întâi problema schemelor custom (appmeu://).

De ce custom schemes sunt o capcană în producție

Toată lumea începe cu scheme: "appmeu" în app.json. Dai în terminal npx uri-scheme open appmeu://produs/42 --ios și merge uns. Zici că ai terminat treaba.

Nu ai terminat. În primul rând, pe Android oricine își poate publica o aplicație malițioasă în Play Store care înregistrează exact aceeași schemă appmeu://. Sistemul va deschide un dialog de tip disambiguation („Open with...”) sau, mai rău, o preia pe cealaltă. Pe iOS, dacă userul dă click pe un link cu schemă custom dintr-un mail sau pe web, Safari trântește un popup agresiv: „Open this page in AppMe”? Dacă userul dă Cancel o singură dată, Safari ține minte și linkul e mort.

Pentru producție vrei Universal Links (iOS) și Android App Links. Merg pe HTTPS curat (https://site.ro/produs/42). Dacă app-ul e instalat, se deschide instant. Dacă nu, intră frumos pe web fallback.

Configurația în Expo Router și capcanele din app.json

În Expo Router nu mai definești un obiect masiv de linking: { prefixes: [...], config: {...} } manual ca pe vremuri. Ruta din folder e ruta din URL. Tot ce trebuie să faci în app.json e să legi domeniile native.

Pentru Android, ai nevoie de intentFilters cu autoVerify: true. Pentru iOS, bagi associatedDomains cu prefixul obligatoriu applinks:.

Trade-off-ul cinstit: Expo Router îți simplifică enorm parsarea parametrilor (useLocalSearchParams), dar depanarea problemelor de handshake la nivel de OS rămâne la fel de infectă.

Trei ziduri de care m-am lovit direct cu capul

  1. Cache-ul agresiv al Apple CDN pentru AASA Fișierul apple-app-site-association trebuie servit pe serverul tău la /.well-known/apple-app-site-association cu header content-type: application/json, fără redirecturi (301/302 le omoară pe loc) și cu certificat HTTPS valid. Dar Apple nu verifică serverul tău la fiecare instalare; verifică prin CDN-ul lor proxy. Dacă ai greșit un Team ID sau un Bundle ID, corectezi pe server și testezi iar, Apple îți va servi varianta veche din cache încă 24-48 de ore. Salvarea în development este să adaugi ?mode=developer la finalul domeniului asociat în entitlement-uri sau să testezi pe un build cu developer mode activat pe iOS 16+.

  2. SHA-256 fingerprint pe Android (Play Console vs local) În assetlinks.json ai nevoie de fingerprint-ul SHA-256 al certificatului cu care e semnat APK-ul. Dacă ai Google Play App Signing activat (ceea ce ai sigur dacă publici prin AAB), fingerprint-ul cheii tale locale de upload NU este cel cu care ajunge aplicația la utilizator. Trebuie să iei SHA-256-ul din Google Play Console -> App Integrity -> App Signing Certificate. Am pierdut o jumătate de zi întrebându-mă de ce App Links mergeau brici pe emulator cu build local, dar picau silențios pe build-ul din internal testing.

  3. Cold start vs Warm start cu autentificare Dacă userul dă click pe link când aplicația e închisă complet (cold start), Expo Router montează layout-ul rădăcină. Dacă ai un ProtectedRoute care verifică token-ul JWT asincron din SecureStore, ai grijă la race condition: dacă rutezi către ecranul de Login înainte ca SecureStore să-și termine citirea, linkul inițial se pierde. Păstrează starea de loading până se rezolvă auth-ul, altfel utilizatorul ajunge în Dashboard în loc să ajungă direct pe pagina produsului din link.

Voi cum ați rezolvat fallback-ul elegant când linkul conține query params complecși și utilizatorul n-are încă aplicația instalată?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.