Enlaces de aplicaciones Android

Filtros de intención, assetlinks.json, y enlaces verificados - el manual de Android para abrir URLs https:// directamente en tu aplicación Expo SDK 57 sin la hoja de desambiguación "Abrir con".

Receta

Tarjeta de referencia rápida - lista para copiar y pegar.

// app.config.ts
export default {
  expo: {
    android: {
      package: "com.example.shopapp",
      intentFilters: [
        {
          action: "VIEW",
          autoVerify: true,
          data: [
            {
              scheme: "https",
              host: "shop.example.com",
              pathPrefix: "/orders",
            },
          ],
          category: ["BROWSABLE", "DEFAULT"],
        },
      ],
    },
  },
};

// https://shop.example.com/.well-known/assetlinks.json
[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.shopapp",
      "sha256_cert_fingerprints": [
        "14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:10:D4:4A:8F:D8:00:6F:8F:95:34:E7:6B:58"
      ]
    }
  }
]

Cuándo usarlo:

• Los enlaces de marketing de Android deben omitir el selector app/navegador.
• Ya aloja AASA de iOS en el mismo dominio - agrega assetlinks.json al lado.
• Las notificaciones push y correos electrónicos usan rutas https://shop.example.com/....
• Necesitas paridad con iOS Universal Links en Android.

Ejemplo funcional

Configuración de verificación completa para https://shop.example.com/orders/*.

Paso 1 - Filtros de intención en app.config.ts

// app.config.ts
import type { ExpoConfig } from "expo/config";
 
const config: ExpoConfig = {
  name: "ShopApp",
  slug: "shop-app",
  scheme: "shopapp",
  android: {
    package: "com.example.shopapp",
    intentFilters: [
      {
        action: "VIEW",
        autoVerify: true,
        data: [
          {
            scheme: "https",
            host: "shop.example.com",
            pathPrefix: "/orders",
          },
          {
            scheme: "https",
            host: "shop.example.com",
            pathPrefix: "/product",
          },
        ],
        category: ["BROWSABLE", "DEFAULT"],
      },
    ],
  },
  ios: {
    bundleIdentifier: "com.example.shopapp",
    associatedDomains: ["applinks:shop.example.com"],
  },
};
 
export default config;

Paso 2 - Aloja assetlinks.json

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.shopapp",
      "sha256_cert_fingerprints": [
        "AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99"
      ]
    }
  }
]

Sirvelo en: https://shop.example.com/.well-known/assetlinks.json

Paso 3 - Obtén la huella digital SHA-256

# Play Console -> App integrity -> App signing key certificate -> SHA-256
# Almacén de claves de depuración local (solo compilaciones de desarrollo):
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

• La verificación de producción usa el certificado de Play App Signing - no tu clave de carga.
• Agrega ambas huellas digitales de depuración y lanzamiento durante el desarrollo para que se verifiquen las compilaciones internas.

Paso 4 - Compila y prueba

npx expo prebuild --platform android
npx expo run:android
adb shell am start -a android.intent.action.VIEW -d "https://shop.example.com/orders/42" com.example.shopapp

Paso 5 - Verifica el estado de verificación

adb shell pm get-app-links com.example.shopapp

Busca shop.example.com: verified - none o legacy_failure significa que hay que corregir el hosting o la huella digital.

Lo que esto demuestra:

• autoVerify: true activa la verificación de dominio en tiempo de instalación.
• pathPrefix limita qué URLs reclama la aplicación.
• assetlinks.json vincula el nombre del paquete al certificado de firma.
• Comandos adb para pruebas de humo del emulador.
• pm get-app-links para diagnóstico de verificación.

Análisis profundo

Cómo funciona

• En la instalación/actualización, Android obtiene assetlinks.json para cada host en filtros de intención con autoVerify.
• El SO compara el SHA-256 del certificado de firma de tu aplicación con la entrada JSON.
• Los enlaces verificados abren tu aplicación directamente; la falla de verificación muestra un selector o navegador.
• Varias aplicaciones pueden reclamar el mismo host - la aplicación verificada gana; de lo contrario el usuario elige.
• Los esquemas personalizados (shopapp://) omiten la verificación - aún son útiles para desarrollo y OAuth.

Campos de intentFilters

Valores de estado de verificación

Notas de Android

# Vuelve a ejecutar la verificación después de corregir assetlinks.json (Android 12+)
adb shell pm verify-app-links --re-verify com.example.shopapp

• Las redirecciones HTTP en assetlinks.json rompen la verificación - sirve 200 en la URL exacta.
• Content-Type debe ser application/json.
• android:launchMode en la actividad principal afecta a la pila de retroceso - singleTask es común para aplicaciones con enlaces profundos.

Errores comunes

• Huella digital SHA-256 incorrecta - falla más común; el certificado Play App Signing difiere de la clave de carga local. Corrección: copia la huella digital de Play Console - App integrity.
• Compilación de depuración en assetlinks de producción - certificado de depuración no listado. Corrección: agrega la huella digital de depuración al array JSON durante el desarrollo.
• Falta autoVerify: true - el filtro funciona pero muestra selector. Corrección: establece autoVerify y reinstala la aplicación.
• pathPrefix demasiado amplio - / reclama todo el sitio incluyendo blog. Corrección: reduce a /orders, /product.
• Configuración Expo no aplicada - editaste app.config.ts pero ejecutaste APK antiguo. Corrección: npx expo prebuild --clean luego reconstruye.
• Prueba solo con shopapp:// - App Links son solo HTTPS. Corrección: prueba URLs https:// con comando de intención adb.

Alternativas

FAQs

Relacionado

• Conceptos básicos de enlaces profundos - resumen de esquemas y hosts
• iOS Universal Links - AASA en el mismo dominio
• API expo-linking - análisis de URL después de la entrega de intención
• Matriz de prueba de enlaces profundos - matriz de emulador y dispositivo Android
• ../expo-router/expo-router-basics/expo-router-basics.md - mapeo de rutas
• ../expo-rules/navigation-and-routing-rules/navigation-and-routing-rules.md - lista de verificación de revisión de enrutamiento

Versiones de Stack: Esta página fue escrita para React 19.2.3, React Native 0.86.0, y Expo SDK 57 (expo ~57.0.4).