{
"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
-
Cache-ul agresiv al Apple CDN pentru AASA Fișierul
apple-app-site-associationtrebuie servit pe serverul tău la/.well-known/apple-app-site-associationcu headercontent-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=developerla finalul domeniului asociat în entitlement-uri sau să testezi pe un build cu developer mode activat pe iOS 16+. -
SHA-256 fingerprint pe Android (Play Console vs local) În
assetlinks.jsonai 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. -
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
ProtectedRoutecare 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ă?