Vinculación de aplicaciones en Android

Artículo
12/02/2021
7 minutos para leer

En esta guía se explica cómo Android 6.0 admite la vinculación de aplicaciones, una técnica que permite a las aplicaciones móviles responder a las direcciones URL de los sitios web. Se explicará qué es la vinculación de aplicaciones, cómo implementar la vinculación de aplicaciones en una aplicación Android 6.0 y cómo configurar un sitio web para conceder permisos a la aplicación móvil en un dominio.

Información general sobre la vinculación de aplicaciones

Las aplicaciones móviles ya no se encuentran en un silo: en muchos casos son un componente importante de sus negocios, junto con su sitio web. Lo deseable que las empresas conecten sin problemas su presencia web y sus aplicaciones móviles, con vínculos en el sitio web que inicien aplicaciones móviles y que muestren contenido relevante en dichas aplicaciones. La vinculación de aplicaciones (también conocida como vinculación profunda) es una técnica que permite a un dispositivo móvil responder a un URI e iniciar una aplicación móvil que se corresponda con ese URI.

Android controla la vinculación de aplicaciones a través del sistema de intenciones: cuando el usuario hace clic en un vínculo en un explorador móvil, el explorador móvil enviará una intención que Android delegará en una aplicación registrada. Por ejemplo, al hacer clic en un vínculo de un sitio web de cocina, se abriría una aplicación móvil que está asociada a ese sitio web y mostrará una receta específica al usuario. Si hay más de una aplicación registrada para controlar esa intención, Android generará lo que se conoce como un cuadro de diálogo de desambiguación, que le pedirá a un usuario qué seleccione qué aplicación debe administrar la intención. Por ejemplo:

Captura de pantalla de ejemplo de un cuadro de diálogo de desambiguación

Android 6.0 mejora esto mediante el control automático de vínculos. Es posible que Android registre automáticamente una aplicación como controlador predeterminado de un URI: la aplicación se iniciará automáticamente y navegará directamente a la actividad correspondiente. El modo en que Android 6.0 decide controlar el clic en un URI depende de los siguientes criterios:

Una aplicación existente ya está asociada al URI: es posible que el usuario ya haya asociado una aplicación existente a un URI. En ese caso, Android seguirá usando esa aplicación.
No hay ninguna aplicación existente asociada al URI, pero se instala una aplicación compatible: en este escenario, el usuario no ha especificado una aplicación existente, por lo que Android usará la aplicación compatible instalada para controlar la solicitud.
No hay ninguna aplicación existente asociada al URI, pero hay muchas aplicaciones compatibles instaladas: dado que hay varias aplicaciones que admiten el URI, se mostrará el cuadro de diálogo de desambiguación y el usuario debe seleccionar qué aplicación controlará el URI.

Si el usuario no tiene ninguna aplicación instalada que admita el URI y posteriormente se instala una, Android establecerá esa aplicación como controlador predeterminado para el URI después de comprobar la asociación con el sitio web asociado al URI.

En esta guía se explica cómo configurar una aplicación Android 6.0, además de cómo crear y publicar el archivo de Digital Asset Links para admitir la vinculación de aplicaciones en Android 6.0.

Requisitos

En esta guía se requiere Xamarin.Android 6.1 y una aplicación destinada a Android 6.0 (nivel de API 23) o una versión superior.

La vinculación de aplicaciones es posible en versiones anteriores de Android mediante el paquete de NuGet de Rivets desde el almacén de componentes de Xamarin. El paquete de Rivets no es compatible con la vinculación de aplicaciones en Android 6.0.

Configuración de la vinculación de aplicaciones en Android 6.0

Para configurar los vínculos de aplicaciones en Android 6.0 implica dos pasos principales:

Agregar uno o varios filtros de intención para el URI del sitio web: los filtros de intención guían a Android sobre cómo controlar un clic de dirección URL en un explorador móvil.
Publicación de un archivo JSON de vínculos de recursos digitales en el sitio web: se trata de un archivo que se carga en un sitio web y que Android usa para comprobar la relación entre la aplicación móvil y el dominio del sitio web. Sin esto, Android no puede instalar la aplicación como identificador predeterminado para los URI; el usuario debe hacerlo manualmente.

Configuración del filtro de intención

Es necesario configurar un filtro de intención que asigne un URI (o posiblemente un conjunto de URI) de un sitio web a una actividad en una aplicación Android. En Xamarin.Android, esta relación se establece adornando una actividad con IntentFilterAttribute. El filtro de intención debe declarar la siguiente información:

Intent.ActionView : se registrará el filtro de intención para responder a las solicitudes para ver información.
Categories : el filtro de intención debe registrar Categories y Intent.CategoryDefault para poder controlar correctamente el URI web.
DataScheme : el filtro de intención debe http declarar o https . Esos son los únicos dos esquemas válidos.
DataHost : es el dominio del que se originarán los URI.
DataPathPrefix : se trata de una ruta de acceso opcional a los recursos del sitio web.
AutoVerify : el autoVerify atributo indica a Android que compruebe la relación entre la aplicación y el sitio web. Esto se tratará más adelante.

En el ejemplo siguiente se muestra cómo usar IntentFilterAttribute para controlar vínculos desde y desde http://www.recipe-app.com/recipes :

[IntentFilter(new [] { Intent.ActionView },
              Categories = new[] { Intent.CategoryBrowsable, Intent.CategoryDefault },
              DataScheme = "http",
              DataHost = "recipe-app.com",
              DataPathPrefix = "/recipe",
              AutoVerify=true)]
public class RecipeActivity : Activity
{
    // Code for the activity omitted
}

Android comprobará todos los hosts identificados por los filtros de intención en el archivo Digital Asset Links del sitio web antes de registrar la aplicación como el controlador predeterminado de un URI. Todos los filtros de intención deben pasar la comprobación antes de que Android pueda establecer la aplicación como el controlador predeterminado.

Creación del archivo Digital Asset Links

La vinculación de aplicaciones de Android 6.0 requiere que Android compruebe la asociación entre la aplicación y el sitio web antes de establecer la aplicación como el controlador predeterminado del URI. Esta comprobación se realizará cuando se instale la aplicación por primera vez. El archivo Digital Asset Links es un archivo JSON que se hospeda en los dominios web pertinentes.

Nota:

El android:autoVerify atributo debe establecerse mediante el filtro de intención; de lo contrario, Android no realizará la comprobación.

El archivo lo coloca el administrador web del dominio en la ubicación https://domain/.well-known/assetlinks.json .

El archivo Digital Asset Links contiene los metadatos necesarios para que Android compruebe la asociación. Un archivo assetlinks.json tiene los siguientes pares clave-valor:

namespace : el espacio de nombres de la aplicación Android.
package_name : el nombre del paquete de la aplicación Android (declarado en el manifiesto de aplicación).
sha256_cert_fingerprints : las huellas digitales SHA256 de la aplicación firmada. Para obtener más información sobre cómo obtener la huella digital SHA1 de una aplicación, consulte la guía Buscar la firma MD5 o SHA1 de su almacén de claves.

El siguiente fragmento de código es un ejemplo de assetlinks.json con una sola aplicación enumerada:

[
   {
      "relation":[
         "delegate_permission/common.handle_all_urls"
      ],
      "target":{
         "namespace":"android_app",
         "package_name":"com.example",
         "sha256_cert_fingerprints":[
            "14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"
         ]
      }
   }
]

Es posible registrar más de una huella digital SHA256 para admitir distintas versiones o compilaciones de la aplicación. Este archivo assetlinks.json es un ejemplo de registro de varias aplicaciones:

[
   {
      "relation":[
         "delegate_permission/common.handle_all_urls"
      ],
      "target":{
         "namespace":"android_app",
         "package_name":"example.com.puppies.app",
         "sha256_cert_fingerprints":[
            "14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"
         ]
      }
   },
   {
      "relation":[
         "delegate_permission/common.handle_all_urls"
      ],
      "target":{
         "namespace":"android_app",
         "package_name":"example.com.monkeys.app",
         "sha256_cert_fingerprints":[
            "14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"
         ]
      }
   }
]

El sitio web Google Digital Asset links tiene una herramienta en línea que puede ayudarlo a crear y probar el archivo Digital Asset Links.

Pruebas de los vínculos de aplicaciones

Después de implementar los vínculos de aplicaciones, se deben probar las distintas partes para asegurarse de que funcionan según lo previsto.

Es posible confirmar que el archivo Digital Asset Links tiene el formato adecuado y está hospedado correctamente mediante la API Google Digital Asset Links, tal como se muestra en este ejemplo:

https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=
  https://<WEB SITE ADDRESS>:&relation=delegate_permission/common.handle_all_urls

Se pueden realizar dos pruebas para asegurarse de que los filtros de intención se hayan configurado correctamente y de que la aplicación se establece como el controlador predeterminado de un URI:

El archivo Digital Asset Links está hospeda correctamente como se describió anteriormente. La primera prueba enviará una intención de que Android debe realizar un redireccionamiento a la aplicación móvil. La aplicación Android debe iniciar y mostrar la actividad registrada para la dirección URL. En un símbolo del sistema, escriba:
```
$ adb shell am start -a android.intent.action.VIEW \
    -c android.intent.category.BROWSABLE \
    -d "http://<domain1>/recipe/scalloped-potato"
```
Muestra las directivas de control de vínculos de las aplicaciones instaladas en un dispositivo determinado. El siguiente comando volcará una lista de directivas de vínculo correspondiente a cada usuario del dispositivo con la siguiente información. En el símbolo del sistema, escriba el siguiente comando:
```
$ adb shell dumpsys package domain-preferred-apps
```
- Package : el nombre del paquete de la aplicación.
- Domain : los dominios (separados por espacios) cuyos vínculos web se controlarán mediante la aplicación
- Status : este es el estado actual del control de vínculos para la aplicación. Un valor de siempre significa que la aplicación ha declarado y ha pasado la comprobación del sistema. Va seguido de un número hexadecimal que representa el registro del sistema Android de la preferencia.
Por ejemplo:
```
$ adb shell dumpsys package domain-preferred-apps

App linkages for user 0:
Package: com.android.vending
Domains: play.google.com market.android.com
Status: always : 200000002
```

Resumen

En esta guía se describe cómo funciona la vinculación de aplicaciones en Android 6.0. A continuación, se explica cómo configurar una aplicación Android 6.0 para admitir los vínculos de aplicaciones y responder a ellos. También se describe cómo probar la vinculación de aplicaciones en una aplicación Android.