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

Sebastian Benz

A terceira parte deste guia foca em acelerar a inicialização do navegador com warmup() e fazer a pré-busca de páginas da Web com mayLaunchUrl(). Aquecer o processo do navegador pode economizar até 700 ms ao abrir um link. Pré-renderizar o conteúdo usando mayLaunchUrl faz com que o conteúdo externo seja aberto instantaneamente. Juntas, as duas APIs podem melhorar muito a experiência do usuário em uma integração de guias personalizadas e são altamente recomendadas.

As etapas necessárias são:

1. Verifique em CustomTabsClient.getPackageName(...) se o navegador padrão é compatível com guias personalizadas. Em caso afirmativo, vincule ao CustomTabsService por meio de CustomTabsClient.bindCustomTabsService().

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

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

3. Como opção, faça uma pré-busca de páginas da Web que o usuário provavelmente vai visitar com o CustomTabsSession.mayLaunchUrl().

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

Se o app for destinado 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 corresponde aos 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));
        }
    });
}

Cuidado:uma conexão do serviço de guias personalizadas pode falhar enquanto a atividade está em execução. Caso seu app precise de uma conexão de serviço ativa, há duas estratégias para garantir o funcionamento dela:

1. Ao se conectar ao CustomTabsService durante onCreate(), reconecte-se ao serviço caso a atividade seja desconectada e o callback onServiceDisconnected() seja invocado.
2. Aguarde até que o usuário acione uma guia personalizada e, em seguida, estabeleça a conexão de serviço e inicie a guia personalizada.

Abrir páginas da Web em apps nativos

No Android, os URLs podem ser gerenciados por apps nativos. Por exemplo, se o usuário tem o aplicativo do Facebook instalado e clica em um link para uma postagem do Facebook, ele geralmente prefere abrir o link no aplicativo do Facebook em vez de no navegador.

Por padrão, guias personalizadas abrem links no respectivo aplicativo nativo, caso esteja instalado. No entanto, depois que uma CustomTabsServiceConnection é estabelecida, esse comportamento deixa de funcionar, e todos os URLs sã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.