O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Navegador

Exiba páginas da Web no navegador padrão do usuário.
Atualização mais recente Versão estável atual Próximo candidato a lançamento Versão Beta Versão Alfa
11 de novembro de 2020 1.2.0 1.3.0-rc01 - -

Como declarar dependências

Para adicionar uma dependência ao Browser, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários no arquivo build.gradle para seu app ou módulo:

    dependencies {
        implementation "androidx.browser:browser:1.2.0"
    }
    

Para ver mais informações sobre dependências, consulte Adicionar dependências de compilação.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas existentes (link em inglês) nesta biblioteca antes de criar um novo. Adicione seu voto a um problema existente clicando no botão de estrela.

Criar uma nova edição

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.3.0

Versão 1.3.0-rc01

11 de novembro de 2020

Lançamento de androidx.browser:browser:1.3.0-rc01 sem mudanças desde a 1.3.0-beta01. A versão 1.3.0-rc01 contém essas confirmações (link em inglês).

Versão 1.3.0-beta01

28 de outubro de 2020

Lançamento de androidx.browser:browser:1.3.0-beta01. A versão 1.3.0-beta01 contém estas confirmações.

Mudanças na API

  • Renomeação de bindCustomTabServicePreservePriority para bindCustomTabsServicePreservePriority (I29ac1).

Correções de bugs

  • A verificação de lint da API para MissingGetterMatchingBuilder está ativada para o androidx (I4bbea, b/138602561).

Versão 1.3.0-alpha06

1º de outubro de 2020

Lançamento de androidx.browser:browser:1.3.0-alpha06. A versão 1.3.0-alpha06 contém estas confirmações.

Novos recursos

  • Adição de CustomTabsIntent#setShareState, que permite ao desenvolvedor definir o compartilhamento de estado como ativado, desativado ou deixar a definição para o navegador (I153fe).
  • Adição de CustomTabsIntent.Builder#setDefaultColorSchemeParams que precisa ser usado no lugar dos métodos #setNavigationBarColor, #setNavigationBarDividerColor, #setToolbarColor e #setSecondaryToolbarColor agora obsoletos (I09012).

Mudanças na API

  • A verificação de lint da API para o StaticFinalBuilder está ativada para androidx (I2b11b, b/138602561).
  • Adição de CustomTabsService#KEY_SUCCESS e TrustedWebActivityService#KEY_SUCCESS, que podem ser usados para indicar que o extraCommand é bem-sucedido (I6f7b5).

Versão 1.3.0-alpha05

5 de agosto de 2020

Lançamento do androidx.browser:browser:1.3.0-alpha05. A versão 1.3.0-alpha05 contém essas confirmações.

Novos recursos

  • Permita a configuração da orientação das atividades da Web confiáveis iniciadas.
  • Permita a configuração da cor do divisor da barra de navegação para as atividades da Web confiáveis e as guias personalizadas.

Mudanças na API

  • Adição de um método setScreenOrientation no TrustedWebActivityIntentBuilder.
  • Adição de um @IntDef para ScreenOrientation.LockType para representar um tipo de bloqueio (I802d2).
  • Adição do método setNavigationBarDividerColor a TrustedWebActivityIntentBuilder e CustomTabColorSchemeParams (Ia04dd).
    • Adição de @IntDefs aos métodos TrustedWebActivityIntentBuilder que usam um esquema de cores.

Versão 1.3.0-alpha04

24 de junho de 2020

Lançamento do androidx.browser:browser:1.3.0-alpha04. A versão 1.3.0-alpha04 contém essas confirmações (link em inglês).

Novos recursos

  • Adição do método CustomTabsClient#bindCustomTabServicePreservePriority, permitindo a conexão com um serviço de guias personalizadas sem usar a sinalização Context.BIND_WAIVE_PRIORITY.

Versão 1.3.0-alpha03

10 de junho de 2020

androidx.browser:browser:1.3.0-alpha03 é lançado. A versão 1.3.0-alpha03 contém essas confirmações (link em inglês).

Novos recursos

  • Adição da interface TrustedWebActivityCallback pode ser usada por um cliente de atividades confiáveis na Web para retornar dados ao navegador (I64dbb, link em inglês).

Mudanças na API

  • TrustedWebActivityServiceConnection.extraCommand agora também usa um parâmetro @Nullable TrustedWebActivityCallback. O parâmetro de pacote agora está marcado como @NonNull em vez de @Nullable (I64dbb, link em inglês).
  • O método TrustedWebActivityServiceConnection.extraCommand foi renomeado como sendExtraCommand (Id29a8, link em inglês)
  • CustomTabsIntent.Builder#addDefaultShareMenuItem() foi suspenso em favor do novo #setDefaultShareMenuItemEnabled(boolean) e CustomTabsIntent.Builder#enableUrlBarHiding() foi suspenso em favor do novo #setUrlBarHidingEnabled(boolean) (Iad702, link em inglês).

Versão 1.3.0-alpha01

8 de janeiro de 2020

Lançamento do androidx.browser:browser:1.3.0-alpha01. A versão 1.3.0-alpha01 contém essas confirmações (link em inglês).

Novos recursos

  • Os comandos de formato livre podem ser transmitidos de um navegador para um cliente de Atividades confiáveis na Web chamando TrustedWebActivityServiceConnection#extraCommand. O cliente pode lidar com isso em TrustedWebActivityService#onExtraCommand.

Mudanças na API

  • O URL fornecido para CustomTabsSession#mayLauncherUrl e recebido em CustomTabsService#mayLaunchUrl foi transformado em @Nullable.

Versão 1.2.0

Versão 1.2.0

18 de dezembro de 2019

androidx.browser:browser:1.2.0 é lançado sem mudanças desde 1.2.0-rc01. A versão 1.2.0 contém essas confirmações (link em inglês).

Principais mudanças desde a versão 1.0.0

  • Atividades confiáveis na Web
    • A compatibilidade com Atividades confiáveis na Web agora está estável.
    • O TrustedWebActivityIntentBuilder pode ser usado para personalizar e criar um TrustedWebActivityIntent, para iniciar uma Atividade confiável na Web.
    • O TrustedWebActivityService pode ser incluído ou estendido para permitir que os clientes exibam notificações push da Web entregues pelo navegador.
    • O TrustedWebActivityServiceConnectionPool pode ser usado por navegadores para se conectar a TrustedWebActivityServices em clientes. Uma TrustedWebActivityServiceConnection representa esse tipo de conexão.
    • Atividades confiáveis na Web podem ser lançadas fornecendo informações para um destino de compartilhamento da Web.
  • Tema escuro
    • Os desenvolvedores podem oferecer (por meio de CustomTabColorSchemeParams) cores de tema diferentes para serem usadas quando o dispositivo estiver no modo claro ou escuro.
    • Os desenvolvedores podem solicitar que o próprio navegador esteja no modo claro ou escuro.
  • Retomada da sessão
    • As CustomTabsSessions podem ser criadas com um ID, permitindo lançamentos de guias personalizadas subsequentes do mesmo cliente e ID a serem mesclados.
  • A cor da barra de navegação pode ser especificada para guias personalizadas.
  • As classes relacionadas às Ações do navegador foram marcadas como obsoletas devido ao uso extremamente baixo de recursos e serão removidas em uma versão futura da biblioteca.

Versão 1.2.0-rc01

4 de dezembro de 2019

Lançamento do androidx.browser:browser:1.2.0-rc01. A versão 1.2.0-rc01 contém essas confirmações (link em inglês).

Correções de bugs

  • A formatação Javadoc para amostras de código foi corrigida.

Versão 1.2.0-beta01

20 de novembro de 2019

Lançamento de androidx.browser:browser:1.2.0-beta01 sem alterações desde 1.2.0-alpha09. Versão 1.2.0-beta01 contém essas confirmações (link em inglês).

Versão 1.2.0-alpha09

23 de outubro de 2019

Lançamento de androidx.browser:browser:1.2.0-alpha09. A versão 1.2.0-alpha09 contém essas confirmações (link em inglês).

Novos recursos

  • A classe Token pode ser usada para representar a identidade de um pacote, ele contém o nome do pacote e a assinatura do certificado de assinatura do pacote.
    • Ela foi desenvolvida para ser serializada como um byte[] para persistência.
    • Ela é usada pelo TrustedWebActivityService para determinar qual provedor de TWA tem permissão para se conectar a ele.
    • Ela é usada pelo TrustedWebActivityConnectionPool pelo provedor de TWA para determinar quais pacotes são válidos para se conectar.
  • A interface TokenStore agora é usada por TrustedWebActivityService para determinar qual app tem permissão para se conectar a ele.
    • Cabe ao cliente chamar TokenStore#store, TrustedWebActivityService apenas carrega os tokens.
  • O TrustedWebActivityServiceConnectionPool (anteriormente TrustedWebActivityServiceConnectionManager) não armazena mais o conjunto de pacotes verificados:
    • registerClient e getVerifiedPackages foram removidos.
    • A coleção de pacotes verificados agora é fornecida de forma manual para execute (anteriormente connect) e serviceExistsForScope.
  • O TrustedWebActivityService delega à classe modificada o armazenamento do provedor verificado.
    • O setVerifiedProvider foi removido.
    • O cliente precisa implementar getTokenStore, que retorna um TokenStore e pode ser usado para armazenar e recuperar um Token.

Mudanças na API

  • A classe TrustedWebActivityServiceConnectionManager:
    • agora é chamada de TrustedWebActivityServiceConnectionPool.
    • Agora é final.
    • É construída pelo método estático create em vez de um construtor público.
  • A classe TrustedWebActivityService:
    • tem anotações de linha de execução em métodos modificáveis.
  • A classe TrustedWebActivityServiceWrapper:
    • agora é chamada de TrustedWebActivityServiceConnection.
    • Agora é final.
    • Agora gera RemoteExceptions brutas em vez de envolvê-las em RuntimeExceptions.
  • A classe ShareTarget#FileFormField agora é final.
  • O método TrustedWebUtils#splashScreensAreSupported foi renomeado como areSplashScreensSupported.
  • O método TrustedWebActivityIntentBuilder#getUrl foi renomeado como TrustedWebActivityIntentBuilder#getUri.
  • Os campos estáticos SplashScreenParamKey foram prefixados com KEY_.

Versão 1.2.0-alpha08

18 de setembro de 2019

Lançamento de androidx.browser:browser:1.2.0-alpha08. A versão 1.2.0-alpha08 contém essas confirmações (link em inglês).

Novos recursos

  • Introdução de novas APIs de segmentação compartilhada para atividades confiáveis na Web. Apps que usam Atividades confiáveis na Web agora podem enviar dados para o Destino de compartilhamento da Web, definido pelo protocolo https://wicg.github.io/web-share-target/level-2/ (aosp/I47b93, aosp/I0ec3e)

Mudanças na API

  • Adição do callback extraCallbackWithResult a ICustomTabsCallback (aosp/Ic2cc2, link em inglês)
  • Marcação de alguns parâmetros de método CustomTabsSession como Anulável ou Não nulo (aosp/Iec460, link em inglês)
  • TrustedWebActivityIntentBuilder agora cria um TrustedWebActivityIntent em vez de um intent bruto (aosp/I03fb6, link em inglês)

Correções de bugs

  • CustomTabsClient agora usa o legado requestPostMessageChannel, se necessário (aosp/Ibb324, links em inglês)
  • Correção de CustomTabsSessionToken#equals (aosp/I7f249, link em inglês)
  • CustomTabsClient agora usa o legado newSession, se possível (aosp/Ie27dc, link em inglês)

Contribuição externa

  • A verificação de lint da API para MinMaxConstant está ativada para androidx (aosp/I29b78) (b/138602561) (links em inglês)

Versão 1.2.0-alpha07

7 de agosto de 2019

Lançamento de androidx.browser:browser:1.2.0-alpha07. As confirmações incluídas nessa versão podem ser encontradas aqui (link em inglês).

Novos recursos

  • Tema escuro

    • Os desenvolvedores podem oferecer cores de tema para serem usadas quando o dispositivo estiver no modo escuro.
    • Os desenvolvedores também podem definir se o navegador iniciado deve estar no modo escuro ou claro.
    • A cor da barra de navegação pode ser especificada para guias personalizadas.
  • Atividades confiáveis na Web

    • O TrustedWebActivityBuilder pode ser usado para criar e lançar facilmente Atividades confiáveis na Web.
    • O TrustedWebActivityService e as classes relacionadas podem ser usados para se comunicar com o provedor, aceitando notificações push da Web para o site vinculado e exibindo-as no app do cliente. Esta parte da API está sujeita a mudanças.
  • IDs de sessão da guia personalizada

    • As sessões de guias personalizadas agora podem ser criadas com códigos, permitindo a fusão de duas sessões iniciadas pelo mesmo aplicativo com o mesmo código.

Mudanças na API

  • As classes e os métodos relacionados às ações do navegador foram suspensos. Infelizmente, embora tivéssemos grandes esperanças para o recurso, ele foi pouco usado e apenas um navegador ofereceu compatibilidade com ele. O recurso foi marcado como obsoleto para manter a simplicidade do código e da API.

Versão 1.0.0

Versão 1.0.0

21 de setembro de 2018

Lançamento do browser-1.0.0.