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

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

  • Abrir contenido externo al instante: Si usas warmup(), el proceso del navegador se inicia en segundo plano, incluso antes de que el usuario haga clic en un vínculo, y puede guardar hasta 700 ms cuando lo abre. mayLaunchUrl() precarga páginas. El uso de ambas APIs en conjunto permite que las páginas se carguen al instante, 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: Al conectarte al servicio de Pestañas personalizadas y usar el mismo CustomTabSession al iniciar la Pestaña personalizada, Chrome podrá quitar las Pestañas personalizadas minimizadas antes de abrir una pestaña 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úlalo 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. Prepara el proceso del navegador con CustomTabsClient.warmup(). b. Crea una CustomTabsSession nueva con CustomTabsClient.newSession().

  3. De manera opcional, realiza una carga previa de las páginas web que el usuario probablemente visite con CustomTabsSession.mayLaunchUrl().

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

Si tu app está orientada al nivel de API de Android 30, CustomTabsClient.getPackageName(...) requiere que agregues una sección de consultas a tu manifiesto de Android para declarar un filtro de intents que coincida con navegadores compatibles con pestañas personalizadas.

<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 al 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));
        }
    });
}

En Android, las aplicaciones para Android 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, generalmente prefiere que el vínculo se abra en la app de Facebook en lugar de hacerlo en el navegador.

De forma predeterminada, las pestañas personalizadas abren vínculos en la aplicación de Android correspondiente si está instalada. Sin embargo, una vez que se establece una CustomTabsServiceConnection, este comportamiento deja de funcionar y todas las URLs se abren en pestañas personalizadas. Para mejorar la experiencia del usuario, te recomendamos volver 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.