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

Sebastian Benz

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

• Abrir contenido externo de forma instantánea: Con warmup(), el proceso del navegador se inicia 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() precarga páginas. El uso conjunto de ambas APIs permite que las páginas se carguen al instante, lo que mejora considerablemente la experiencia del usuario de una integración de pestañas personalizadas.
• Mejor manejo de las pestañas personalizadas minimizadas: Cuando se conecta al servicio de pestañas personalizadas y se usa la misma CustomTabSession cuando se inicia la pestaña personalizada, Chrome puede quitar una pestaña personalizada minimizada antes de lanzar una nueva, lo que brinda una experiencia del usuario más coherente.

Estos son los pasos necesarios:

1. Verifica si el navegador predeterminado admite pestañas personalizadas usando 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 de CustomTabsServiceConnection.onCustomTabsServiceConnected(), haz lo siguiente:

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

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

4. Cuando inicies una nueva pestaña personalizada, pasa el objeto 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 declare un filtro de intents que coincida con los 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>

A continuación, se muestra 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: Una conexión de servicio de pestañas personalizadas puede fallar mientras se ejecuta tu actividad. Si tu app requiere una conexión de servicio activa, hay dos estrategias para garantizar que esta funcione:

1. Cuando te conectes de inmediato 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 lanza la pestaña personalizada.

Abrir vínculos en apps para Android

En Android, las apps para Android pueden controlar las URLs. Por ejemplo, si el usuario tiene instalada la aplicación 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 aplicación de Facebook en lugar de hacerlo en el navegador.

De forma predeterminada, las pestañas personalizadas abren vínculos en la aplicación para Android correspondiente si están instaladas. 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 pestañas personalizadas.