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

Deep linking universal cu Expo Router: de la custom scheme la Universal Links

De Delia Petre, 11 nov. 2026 · 7 vizualizări · 3 like-uri

Postat 11 nov. 2026
json
{
  "expo": {
    "name": "MyApp",
    "slug": "my-app",
    "scheme": "myapp",
    "ios": {
      "supportsTabletWidth": true,
      "bundleIdentifier": "ro.eduardweb.myapp",
      "associatedDomains": [
        "applinks:eduardweb.ro"
      ]
    },
    "android": {
      "package": "ro.eduardweb.myapp",
      "intentFilters": [
        {
          "action": "VIEW",
          "autoVerify": true,
          "data": [
            {
              "scheme": "https",
              "host": "eduardweb.ro",
              "pathPrefix": "/comanda"
            }
          ],
          "category": ["BROWSABLE", "DEFAULT"]
        }
      ]
    }
  }
}

Deep linking-ul arată elegant în documentație până când îl testezi în producție și vezi că Safari refuză să deschidă aplicația, iar Android 12+ ignoră complet URL-ul dacă n-ai validarea domeniului la virgulă. Cu Expo Router am scăpat măcar de mapping-ul manual de routes din React Navigation, dar infrastructura din spate rămâne la fel de pretențioasă. Vă las mai jos setup-ul pe care l-am bătut în cuie la o aplicație cu vreo 25k utilizatori activi, după ce am pierdut câteva zile bune cu debugging-ul.

Custom Scheme vs Universal Links: de ce nu scapi doar cu scheme

Custom scheme-ul (myapp://profil/123) e genial pe localhost. Îl pui în 30 de secunde în app.json, rulezi comanda npx uri-scheme open și totul zboară. Problema apare când vrei să trimiți link-uri din campanii de marketing, email-uri de resetare a parolei sau integrări cu Stripe.

Pe iOS, dacă userul n-are aplicația instalată și dă click pe myapp://, primește un ecran alb urât cu „Safari cannot open the page”. Pe Android, oricare altă aplicație malițioasă poate declara același custom scheme în manifest și să fure intenția. Universal Links (pe iOS) și App Links (pe Android) folosesc https://domeniul-tau.ro, oferind fallback automat pe web dacă aplicația lipsește și validare prin semnături criptografice.

Trade-off-ul e cinstit: custom scheme-ul e rapid dar nesigur și fără fallback; Universal Links oferă experiență nativă impecabilă, dar cer domeniu propriu, HTTPS strict și mentenanță pe server.

Configurația în Expo Router (app.json)

În Expo Router, fișierele din folderul app/ dictează automat structura link-urilor. Dacă ai fișierul app/comanda/[id].tsx, link-ul va fi automat https://domeniul-tau.ro/comanda/456. Nu mai facem mapping manual cu regex-uri obscure ca pe vremuri.

Pentru iOS trebuie adăugat entitlements pentru associatedDomains. Atenție: prefixul applinks: este obligatoriu. Pe Android avem nevoie de intentFilters cu autoVerify: true și configurarea fingerprint-ului SHA-256 generat de cheia de release (sau de Google Play App Signing).

Fișierele de pe server: unde greșește majoritatea

Ca sistemele de operare să aibă încredere în aplicație, serverul tău web trebuie să servească două fișiere statice fără absolut niciun redirect (nici măcar 301 de la HTTP la HTTPS, trebuie direct HTTPS):

  1. iOS: https://domeniul-tau.ro/.well-known/apple-app-site-association (fără extensia .json, cu header-ul Content-Type: application/json).
  2. Android: https://domeniul-tau.ro/.well-known/assetlinks.json.

Am pățit la un deploy ca Nginx să adauge un slash la final (/.well-known/apple-app-site-association/) din cauza unui rewrite prost pus. iOS a refuzat instantaneu să mai verifice domeniul. Apple descarcă acest fișier o singură dată la instalarea aplicației printr-un proxy propriu CDN, așa că dacă ai greșit ceva, poți aștepta și 48 de ore până se invalidează cache-ul lor, dacă nu folosești un flag de debug pe device fizic.

Android 12 și verificarea strictă

Începând cu Android 12, dacă domeniul nu returnează HTTP 200 pe fișierul assetlinks.json sau dacă SHA-256 nu corespunde exact cu cel din keystore-ul final, sistemul pur și simplu nu mai arată pop-up-ul de „Open with” și deschide direct Chrome. Fără erori în logcat, fără avertismente vizibile.

Puteți testa dacă Android-ul a aprobat domeniul direct prin ADB cu comanda: adb shell pm get-app-links com.pachetul.tau

Dacă statusul returnat este verified, ești safe. Dacă zice legacy_failure sau 1024, ai greșit amprenta SHA sau serverul răspunde cu eroare.

Voi cum ați rezolvat fallback-ul pe web când userul deschide link-ul din aplicații ca Instagram sau Facebook in-app browser? Le forțați deschiderea în browserul extern sau mergeți pe un landing page intermediar?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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