Aquecimento e pré-busca: uso do serviço de guias personalizadas

Sebastian Benz

A terceira parte deste guia se concentra no serviço de guias personalizadas e por que usá-lo no seu aplicativo cria uma melhor experiência do usuário:

  • Abrir conteúdo externo instantaneamente:usar warmup() faz com que o processo do navegador seja iniciado em segundo plano antes mesmo de o usuário clicar em um link e pode economizar até 700 ms ao abrir um link. O mayLaunchUrl() faz a pré-busca das páginas. O uso de ambas as APIs juntas permite que as páginas sejam carregadas instantaneamente, melhorando muito a experiência do usuário com a integração de guias personalizadas.
  • Melhor tratamento de guias personalizadas minimizadas: ao se conectar ao serviço de guias personalizadas e usar as mesmas CustomTabSession ao abrir a guia personalizada, o Chrome poderá remover uma guia personalizada antes de iniciar uma nova, oferecendo uma experiência do usuário mais consistente.

As etapas necessárias são:

  1. Use o CustomTabsClient.getPackageName(...) para conferir se o navegador padrão oferece suporte a guias personalizadas. Em caso afirmativo, vincule-o a CustomTabsService usando CustomTabsClient.bindCustomTabsService().

  2. Depois de se conectar a CustomTabsService, no callback CustomTabsServiceConnection.onCustomTabsServiceConnected(), faça o seguinte:

    a. Aqueça o processo do navegador usando CustomTabsClient.warmup(). b. Crie um novo CustomTabsSession usando CustomTabsClient.newSession().

  3. Se quiser, faça a pré-busca das páginas da Web que o usuário provavelmente vai visitar usando CustomTabsSession.mayLaunchUrl().

  4. Ao iniciar uma nova guia personalizada, transmita CustomTabsSession para CustomTabsIntent.Builder usando o construtor new CustomTabsIntent.Builder(session).

Se o app for direcionado ao nível 30 da API do Android, o CustomTabsClient.getPackageName(...) vai exigir que você adicione uma seção de consultas ao manifesto do Android, declarando um filtro de intent que corresponda a navegadores com suporte a guias 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>

Veja um exemplo completo de como se conectar a um serviço de guias 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));
        }
    });
}

No Android, os URLs podem ser processados por apps Android. Por exemplo, se o usuário tiver o aplicativo do Facebook instalado e clicar em um link para uma postagem do Facebook, ele geralmente prefere que o link seja aberto no aplicativo do Facebook em vez de no navegador.

Por padrão, as guias personalizadas abrem links no respectivo aplicativo Android, se instalado. No entanto, depois que uma CustomTabsServiceConnection for estabelecida, esse comportamento vai parar de funcionar, e todos os URLs serão abertos em guias personalizadas. Para melhorar a experiência do usuário, recomendamos reativar esse comportamento usando o seguinte código:

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

A seguir: saiba como redimensionar a experiência de guias personalizadas.