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

Deep linking universal cu Expo Router: custom scheme și universal links fără dureri de cap

De Gabriela Neagu, 12 nov. 2026 · 14 vizualizări · 2 like-uri

Postat 12 nov. 2026
typescript
import { ExpoConfig, ConfigContext } from 'expo/config';

export default ({ config }: ConfigContext): ExpoConfig => ({
  ...config,
  name: 'StoreApp',
  slug: 'store-app',
  scheme: 'storeapp',
  ios: {
    bundleIdentifier: 'ro.eduardweb.store',
    associatedDomains: [
      'applinks:store.ro',
      'applinks:store.ro?mode=developer' // util doar pe build-uri de test
    ]
  },
  android: {
    package: 'ro.eduardweb.store',
    intentFilters: [
      {
        action: 'VIEW',
        autoVerify: true,
        data: [
          { scheme: 'https', host: 'store.ro', pathPrefix: '/produs' },
          { scheme: 'https', host: 'store.ro', pathPrefix: '/cont' }
        ],
        category: ['BROWSABLE', 'DEFAULT']
      }
    ]
  }
});

Deep linking-ul în React Native a fost mult timp o sursă de nervi, dar Expo Router schimbă complet ecuația. Fiindcă navigația se bazează pe sistemul de fișiere, orice URL web se mapează direct peste ierarhia din folderul app, fără să mai scrii manual obiecte kilometrice de configurare în React Navigation. Totuși, pasul de la un simplu custom scheme pe emulator la link-uri universale reale pe producție ascunde câteva capcane clasice.

De la custom scheme la link-uri universale

Custom scheme-ul (myapp://produs/123) este minunat în mediul de dezvoltare. Îl configurezi în două secunde, rulezi un npx uri-scheme open și ești fericit. În producție, însă, experiența de utilizare este groaznică. Pe iOS, Safari deschide acel dialog enervant care te întreabă dacă ești sigur că vrei să deschizi aplicația, iar din aplicații ca WhatsApp sau clienți web de mail, scheme-ul adesea nici măcar nu e randat ca link clicabil.

Universal Links (pe iOS) și App Links (pe Android) rezolvă problema asta elegant. Folosești un domeniu HTTPS normal (https://site.ro/produs/123). Dacă utilizatorul are aplicația instalată, sistemul de operare interceptează link-ul și deschide direct ecranul nativ. Dacă nu o are, browserul deschide pagina web obișnuită. La un e-commerce cu vreo 40k MAU unde am implementat fluxul ăsta, conversia din newslettere a crescut cu 22% în prima lună doar pentru că am eliminat blocajul din browser.

Configurația în Expo: app.json și fișierele de domeniu

Expo Router rezolvă partea de routing intern automat, dar trebuie să-i spui sistemului de operare ce domenii îi aparțin aplicației tale. Asta presupune două etape: setările din app.json (sau app.config.ts) și fișierele pe care le servești pe domeniul web.

Pe serverul tău web, în directorul /.well-known/, trebuie să ai două fișiere statice servite obligatoriu prin HTTPS valid, fără redirecturi și cu mimetype-ul corect:

  1. apple-app-site-association (fără extensie pe iOS, returnat cu header Content-Type: application/json).
  2. assetlinks.json (pentru Android).

Capcanele care-ți mănâncă două zile degeaba

Am pierdut ore bune din cauza a două probleme care nu țin de codul React Native, ci de infrastructura din spate.

Prima este SHA-256 fingerprint-ul pentru Android. Dacă folosești Google Play App Signing (ceea ce e standard pentru orice bundle .aab), amprenta keystore-ului generat local sau pe CI este complet inutilă pe build-urile descărcate din Play Store. Google re-semnează binarul cu cheia lor de producție. Trebuie să mergi în Google Play Console la App integrity -> App signing, să copiezi de acolo SHA-256 certificate fingerprint și să-l treci în fișierul assetlinks.json. Altfel, linkul va merge brici pe build-ul tău local de debug, dar va refuza să se deschidă în app după lansare.

A doua capcană: CDN-ul de caching de la Apple. Când instalezi o aplicație pe iOS, telefonul nu contactează direct serverul tău pentru a descărca fișierul AASA, ci trece printr-un CDN Apple care face cache agresiv, uneori până la 48 de ore. Dacă ai greșit un prefix de Team ID sau bundle ID în JSON, chiar dacă îl repari pe server, telefoanele vor continua să ignore link-urile. Salvarea pe durata testelor este să activezi pe device-ul fizic modul de dezvoltare din Settings -> Developer -> Associated Domains Development și să setezi flag-ul ?mode=developer în configurarea domeniului.

Voi cum gestionați cazurile când linkul deschide o rută protejată, dar starea de auth e încă nesincronizată la cold start? Faceți redirect forțat din layout-ul rădăcină sau blocați splash screen-ul până când se rezolvă sesiunea?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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