Preparación y recuperación previa: mediante el servicio de pestañas personalizadas

Sebastian Benz

La tercera parte de esta guía se enfoca en el servicio de pestañas personalizadas y en por qué usarlo en tu aplicación crea una mejor experiencia del usuario:

• Abre contenido externo de forma instantánea: El uso de warmup() hace que el proceso del navegador se inicie en segundo plano incluso antes de que el usuario haga clic en un vínculo y puede ahorrar hasta 700 ms cuando se abre un vínculo. mayLaunchUrl() recupera páginas de antemano. El uso de ambas APIs permite que las páginas se carguen de forma instantánea, lo que mejora en gran medida la experiencia del usuario de una integración de pestañas personalizadas.
• Mejor manejo de las pestañas personalizadas minimizadas: Si te conectas al servicio de pestañas personalizadas y usas el mismo CustomTabSession cuando inicias la pestaña personalizada, Chrome podrá quitar una pestaña personalizada minimizada antes de iniciar una nueva, lo que brindará una experiencia del usuario más coherente.

Estos son los pasos necesarios:

1. Verifica si el navegador predeterminado admite pestañas personalizadas con CustomTabsClient.getPackageName(...). Si es así, vincúlate a CustomTabsService con CustomTabsClient.bindCustomTabsService().

2. Una vez que te conectes a CustomTabsService, en la devolución de llamada CustomTabsServiceConnection.onCustomTabsServiceConnected(), haz lo siguiente:

   a. Activa el proceso del navegador con CustomTabsClient.warmup(). b. Crea un CustomTabsSession nuevo con CustomTabsClient.newSession().

3. De manera opcional, precarga las páginas web que el usuario probablemente visite con CustomTabsSession.mayLaunchUrl().

4. Cuando inicies una nueva pestaña personalizada, pasa el CustomTabsSession a CustomTabsIntent.Builder con el constructor new CustomTabsIntent.Builder(session).

Si tu app se orienta al nivel de API 30 de Android, CustomTabsClient.getPackageName(...) requiere que agregues una sección de consultas a tu manifiesto de Android y declares un filtro de intents que coincida con los navegadores compatibles con Custom Tabs.

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">
  …
   <queries>
        <intent>
            <action android:name="android.support.customtabs.action.CustomTabsService" />
        </intent>
    </queries>
</manifest>

Este es un ejemplo completo de cómo conectarse a un servicio de pestañas personalizadas:

private CustomTabsClient mClient;
private CustomTabsSession mSession;

private CustomTabsServiceConnection mConnection = new CustomTabsServiceConnection() {
    @Override
    public void onCustomTabsServiceConnected(
            @NonNull ComponentName name,
            @NonNull CustomTabsClient client
    ) {
        mClient = client;
        // Warm up the browser process
        mClient.warmup(0 /* placeholder for future use */);
        // Create a new browser session
        mSession = mClient.newSession(new CustomTabsCallback());
        // Pre-render pages the user is likely to visit
        // you can do this any time while the service is connected
        mSession.mayLaunchUrl(Uri.parse("https://developers.android.com"), null, null);
    }

    @Override
    public void onServiceDisconnected(ComponentName name) {
        mClient = null;
        mSession = null;
    }
};

private void bindCustomTabService(Context context) {
    // Check for an existing connection
    if (mClient != null) {
        // Do nothing if there is an existing service connection
        return;
    }

    // Get the default browser package name, this will be null if
    // the default browser does not provide a CustomTabsService
    String packageName = CustomTabsClient.getPackageName(context, null);
    if (packageName == null) {
        // Do nothing as service connection is not supported
        return;
    }
    CustomTabsClient.bindCustomTabsService(context, packageName, mConnection);
}

@Override
protected void onCreate(Bundle savedInstanceState) {
…
    bindCustomTabService(this);
    findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            String url = "https://developers.android.com";
            CustomTabsIntent intent = new CustomTabsIntent.Builder(mSession)
                    .build();
            intent.launchUrl(MainActivity.this, Uri.parse(url));
        }
    });
}

Precaución: Es posible que una conexión de servicio de Tabs personalizados falle mientras se ejecuta tu actividad. Si tu app requiere una conexión de servicio activa, existen dos estrategias para garantizar que funcione:

1. Cuando te conectes de forma anticipada a CustomTabsService durante onCreate(), vuelve a conectarte al servicio si tu actividad se desconecta y se invoca la devolución de llamada onServiceDisconnected().
2. Espera a que el usuario active una pestaña personalizada y, luego, establece la conexión del servicio y, luego, iníciala.

Cómo abrir vínculos en apps para Android

En Android, las aplicaciones pueden controlar las URLs. Por ejemplo, si el usuario tiene instalada la app de Facebook y hace clic en un vínculo a una publicación de Facebook, por lo general, prefiere que el vínculo se abra en la app de Facebook en lugar de en el navegador.

De forma predeterminada, las pestañas personalizadas abren vínculos en la aplicación para Android correspondiente si está instalada. Sin embargo, una vez que se establece un CustomTabsServiceConnection, este comportamiento deja de funcionar y todas las URLs se abren en pestañas personalizadas. Para mejorar la experiencia del usuario, te recomendamos que vuelvas a habilitar este comportamiento con el siguiente código:

CustomTabsIntent customTabsIntent = new CustomTabsIntent.Builder()
    .setSendToExternalDefaultHandlerEnabled(true)
    .build();

A continuación, obtén información para cambiar el tamaño de la experiencia de las pestañas personalizadas.