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

Deep linking fără bătăi de cap în Expo Router: scheme-uri și universal links

De Ioana Marinescu, 19 oct. 2026 · 23 vizualizări · 2 like-uri

Postat 19 oct. 2026
json
{
  "expo": {
    "name": "ShopApp",
    "slug": "shop-app",
    "scheme": "shopapp",
    "ios": {
      "bundleIdentifier": "ro.shopapp.mobile",
      "associatedDomains": [
        "applinks:shopapp.ro",
        "applinks:www.shopapp.ro"
      ]
    },
    "android": {
      "package": "ro.shopapp.mobile",
      "intentFilters": [
        {
          "action": "VIEW",
          "autoVerify": true,
          "data": [
            {
              "scheme": "https",
              "host": "shopapp.ro",
              "pathPrefix": "/produs"
            }
          ],
          "category": ["BROWSABLE", "DEFAULT"]
        }
      ]
    }
  }
}

Configuratul de deep links în React Native a fost mereu o durere de cap, dar Expo Router a schimbat regulile jocului prin file-based routing. Problema reală nu mai e maparea ecranelor în JavaScript, ci tot baletul cu certificatele de securitate când ieși din simulator. La un client cu 45k useri lunari, o configurare proastă a fișierului de asociere ne-a tăiat vreo 12% din conversiile venite din newslettere până ne-am prins de ce Android 12 refuza să deschidă aplicația.

Custom schemes vs Universal Links

Custom schemes (appme://produs/123) sunt excelente când dezvolți local. Le setezi în cinci secunde în app.json sub cheia scheme, rulezi npx uri-scheme open și funcționează. În producție, însă, scheme-urile custom sunt o vulnerabilitate: pe Android, orice aplicație malițioasă poate înregistra același protocol și să intercepteze datele.

Universal Links (pe iOS) și App Links (pe Android) rezolvă problema validând domeniul tău prin HTTPS. Când userul dă tap pe un link de forma https://siteul-tau.ro/produs/123, sistemul de operare verifică dacă site-ul confirmă că deține aplicația instalată. Fără ferestre de tipul „Deschide cu Chrome sau Aplicație”, fără confirmări dubioase. Merge direct în contextul dorit.

Ce trebuie neapărat în app.json

Expo Router mapează automat rutele din folderul app/ la URL-uri web. Dacă ai fișierul app/produs/[id].tsx, URL-ul https://site.ro/produs/42 va fi parsat nativ fără să mai configurezi manual un obiect gigant de linking ca în vechiul React Navigation.

Totuși, trebuie să declari explicit intenția de verificare în app.json. Pentru iOS specifici associatedDomains cu prefixul obligatoriu applinks:. Pentru Android, specifici intentFilters cu autoVerify: true — dacă uiți flag-ul ăsta pe Android 12+, sistemul ignoră complet deep link-ul și îl deschide sec în browser.

Fișierele de pe server: unde crapă 90% din implementări

Ca totul să funcționeze, domeniul tău web trebuie să servească două fișiere statice, fără redirecturi și neapărat peste HTTPS:

  1. https://site.ro/.well-known/apple-app-site-association (fără extensia .json, dar cu conținut JSON valid).
  2. https://site.ro/.well-known/assetlinks.json.

Am pățit o fază clasică la un deploy: Nginx făcea redirect 301 de la non-www la www, iar botul Apple care validează AASA renunța instant. Apple și Google nu urmăresc redirecturi multiple și cer header-ul Content-Type: application/json.

Alt detaliu enervant: Apple face cache agresiv pe fișierul AASA pe serverele lor CDN. Dacă ai greșit un teamID sau un bundle identifier în fișier, remedierea pe serverul tău nu se va propaga imediat pe telefoanele clienților. Uneori durează până la 24-48 de ore până când Apple își reimprospătează indexul intern de asocieri.

Trade-off-ul real

Expo Router simplifică enorm codul din aplicație — structura folderelor dictează rutele, iar useLocalSearchParams() citește parametrii din URL curat și predictibil. Trade-off-ul e că pierzi din libertatea de a intercepta rutele imperativ înainte de primul render. Dacă userul accesează un link privat (/cont/comenzi) și nu are sesiune activă, trebuie să gestionezi redirect-ul direct în root _layout.tsx cu <Redirect href="/login" />, altfel riști un flicker urât pe ecranul protejat înainte de trimiterea pe login.

Voi cum testați fluxurile astea în CI/CD ca să nu vă treziți cu AASA invalidat pe producție?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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