Riscaldamento e precaricamento: utilizzo del servizio Schede personalizzate

Sebastian Benz

La terza parte di questa guida è incentrata sull'accelerazione dell'avvio del browser tramite warmup() e sul precaricamento delle pagine web tramite mayLaunchUrl(). L'avvio del processo del browser può consentire di risparmiare fino a 700 ms all'apertura di un link. Il pre-rendering dei contenuti tramite mayLaunchUrl consente di aprire subito i contenuti esterni. Insieme, entrambe le API possono migliorare notevolmente l'esperienza utente di un'integrazione delle schede personalizzate e sono vivamente consigliate.

I passaggi richiesti sono:

1. Controlla tramite CustomTabsClient.getPackageName(...) se il browser predefinito supporta le schede personalizzate. In caso affermativo, esegui l'associazione a CustomTabsService tramite CustomTabsClient.bindCustomTabsService().

2. Dopo aver eseguito la connessione a CustomTabsService, nel callback CustomTabsServiceConnection.onCustomTabsServiceConnected() procedi nel seguente modo:

   a. Riscalda il processo del browser tramite CustomTabsClient.warmup(). b. Crea un nuovo CustomTabsSession tramite CustomTabsClient.newSession().

3. Se vuoi, puoi precaricare le pagine web che è probabile che l'utente visiti tramite CustomTabsSession.mayLaunchUrl().

4. Quando avvii una nuova scheda personalizzata, trasmetti CustomTabsSession a CustomTabsIntent.Builder tramite il costruttore new CustomTabsIntent.Builder(session).

Se la tua app ha come target il livello API 30 di Android, CustomTabsClient.getPackageName(...) richiede di aggiungere una sezione per le query al file manifest Android, dichiarando un filtro per intent che corrisponda ai browser che supportano le schede personalizzate.

<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>

Ecco un esempio completo di come connettersi a un servizio di schede personalizzate:

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

Attenzione:la connessione al servizio Schede personalizzate potrebbe non riuscire mentre è in esecuzione l'attività. Se la tua app richiede una connessione ai servizi attiva, esistono due strategie per garantire che la connessione funzioni:

1. Quando ti connetti con impazienza a CustomTabsService durante onCreate(), riconnettiti al servizio se la tua attività viene disconnessa e il callback onServiceDisconnected() viene richiamato.
2. Attendi finché l'utente non attiva una Scheda personalizzata, quindi stabilisci la connessione al servizio e avvia la Scheda personalizzata.

Apri pagine web nelle app native

Su Android, gli URL possono essere gestiti da applicazioni native. Ad esempio, se l'utente ha installato l'app di Facebook e fa clic su un link a un post di Facebook, di solito preferisce che il link si apra nell'app di Facebook anziché nel browser.

Per impostazione predefinita, la funzionalità Schede personalizzate apre i link nella rispettiva applicazione nativa, se installata. Tuttavia, una volta stabilito un CustomTabsServiceConnection, questo comportamento smette di funzionare e tutti gli URL si aprono invece nelle schede personalizzate. Per una migliore esperienza utente, ti consigliamo di riattivare questo comportamento utilizzando il seguente codice:

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

Passaggio successivo: scopri come ridimensionare l'esperienza delle schede personalizzate.