Como transmitir informações para uma Atividade confiável na Web usando parâmetros de consulta

André Cipriani Bandarra

Ao usar a Atividade na Web Confiável nos aplicativos, os desenvolvedores podem precisar transmitir informações a parte nativa do aplicativo no Progressive Web App (PWA).

Um caso de uso comum para isso é implementar segmentações de análise personalizadas para medir as instalações e sessões iniciadas pela Atividade na Web Confiável. Os parâmetros de consulta podem ser adicionados ao URL de início para implementar isso.

Modificar o URL de início

Se o parâmetro transmitido para o PWA permanecer o mesmo para todos os usuários e for iniciado, o parâmetro poderá ser anexado diretamente ao URL de inicialização. Um exemplo desse uso é Quando os desenvolvedores querem medir o número de sessões de navegação criadas a partir de uma página da Web Atividade.

Como usar o plástico bolha

Bolha é uma ferramenta criada para ajudar os desenvolvedores a criar um projeto para uma Aplicativo para Android que inicia um PWA já existente usando um aplicativo Trusted Web Atividade. Ele contém uma biblioteca e uma interface de linha de comando (CLI).

Como criar um novo projeto

Ao usar a CLI Bubblewrap, um projeto é inicializado com o comando init e cria valores padrão de um manifesto da Web, fornecidos como parâmetro:

bubblewrap init --manifest https://material.money/manifest.json

O assistente vai usar o start_url do manifesto da Web como padrão e pedir que os usuários confirmem o valor, oferecendo aos desenvolvedores a chance de adicionar parâmetros extras ao URL usado para iniciar o App Web Progressivo.

Como modificar um projeto atual

Quando o balão gera um projeto, as informações desse projeto específico são armazenadas em um arquivo chamado twa-manifest.json, na pasta do projeto. Para modificar o URL inicial de um projeto atual, os desenvolvedores precisam modificar o arquivo:

{
  ...
  "startUrl": "/?utm_source=trusted-web-activity",
  ...
}

Em seguida, gere novamente os arquivos do projeto e aplique o novo URL de início

bubblewrap update

Usar o Android Studio

Ao usar o Android Studio e a LauncherActivity padrão, startUrl é definido como uma metatag no AndroidManifest.xml. Também podemos mudar o URL usado para iniciar a Atividade confiável na Web modificá-la:

<activity android:name="com.google.androidbrowserhelper.trusted.LauncherActivity"
    android:label="@string/app_name">
    ...
    <meta-data android:name="android.support.customtabs.trusted.DEFAULT_URL"
        android:value="https://svgomg.firebaseapp.com/?utm_source=trusted-web-activity" />
    ...
</activity>

Modificar o URL de início de forma dinâmica

Em outros casos, os desenvolvedores podem querer criar parâmetros que mudam entre usuários ou sessões, para instância. Na maioria dos casos, isso envolve a coleta de detalhes por parte do Android da para passá-lo ao Progressive Web App.

Etapa 1: criar uma LauncherActivity personalizada

public class CustomQueryStringLauncherActivity extends LauncherActivity {
    private String getDynamicParameterValue() {
        return String.valueOf((int)(Math.random() * 1000));
    }

    @Override
    protected Uri getLaunchingUrl() {
        // Get the original launch Url.
        Uri uri = super.getLaunchingUrl();

        // Get the value we want to use for the parameter value
        String customParameterValue = getDynamicParameterValue();

        // Append the extra parameter to the launch Url
        return uri
                .buildUpon()
                .appendQueryParameter("my_parameter", customParameterValue)
                .build();
    }
}

Etapa 2: modificar o AndroidManifest.xml para usar a LauncherActivity personalizada

<activity android:name="com.myapp.CustomQueryStringLauncherActivity"
    android:label="@string/app_name">
    ...
    <meta-data android:name="android.support.customtabs.trusted.DEFAULT_URL"
        android:value="https://squoosh.app/?utm_source=trusted-web-activity" />
    ...
</activity>

Conclusão

A transmissão de informações da parte nativa para a parte da Web de um aplicativo pode ser feita usando parâmetros de consulta. Quando um parâmetro é adicionado à string de consulta, ele fica acessível para scripts exibidos na página e também podem fazer parte da referência quando os usuários navegam para uma página diferente ou o desenvolvedor implementa uma ação de compartilhamento.

Os desenvolvedores precisam estar cientes dessas implicações e podem mitigá-las usando link rel=noreferrer ou limpe o URL usando a API Page Location.

No momento, o protocolo da Atividade na Web Confiável não fornece um mecanismo para trocar mensagens com a parte nativa do aplicativo depois que a parte da Web é invocada.

Acreditamos que as APIs Web Platform existentes ou futuras possibilitam a maioria dos casos de uso necessários para os desenvolvedores. Se estiver procurando APIs da Web novas ou futuras, confira a página de status de Novas capacidades.