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 acelerar el inicio del navegador a través de warmup() y cargar previamente las páginas web con mayLaunchUrl(). El calentamiento del proceso del navegador puede ahorrar hasta 700 ms cuando se abre un vínculo. El procesamiento previo del contenido a través de mayLaunchUrl hace que el contenido externo se abra al instante. Ambas APIs juntas pueden mejorar en gran medida la experiencia del usuario de una integración de pestañas personalizadas, por lo que son muy recomendables.

Estos son los pasos necesarios:

1. Verifica mediante CustomTabsClient.getPackageName(...) Si el navegador predeterminado admite pestañas personalizadas. Si es así, realiza la vinculación 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 mediante CustomTabsClient.warmup(). b. Crea una CustomTabsSession nueva mediante CustomTabsClient.newSession().

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

4. Cuando inicies una nueva pestaña personalizada, pasa el elemento CustomTabsSession a CustomTabsIntent.Builder mediante 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));
        }
    });
}

Precaución: La conexión al servicio de pestañas personalizadas puede fallar mientras se ejecuta tu actividad. Si tu app requiere una conexión de servicio activa, existen dos estrategias para garantizar que funcione la conexión:

1. Cuando te conectes con anticipación a CustomTabsService durante onCreate(), vuelve a conectarte al servicio si se desconecta la actividad y se invoca la devolución de llamada onServiceDisconnected().
2. Espera hasta que el usuario active una pestaña personalizada, luego establece la conexión con el servicio y, luego, inicia la pestaña personalizada.

Cómo abrir páginas web en aplicaciones nativas

En Android, las aplicaciones nativas 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 nativa 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.