CronetEngine.Builder

public static final int HTTP_CACHE_DISABLED = 0

Configuração para desativar o cache HTTP. Alguns dados ainda podem ser armazenados temporariamente na memória. Transmitido para enableHttpCache.

public static final int HTTP_CACHE_DISK = 3

Configuração para ativar o cache em disco, incluindo dados HTTP. setStoragePath precisa ser chamado antes de transmitir essa constante para enableHttpCache.

public static final int HTTP_CACHE_DISK_NO_HTTP = 2

Configuração para ativar o cache em disco, excluindo dados HTTP. setStoragePath precisa ser chamado antes de transmitir essa constante para enableHttpCache.

public static final int HTTP_CACHE_IN_MEMORY = 1

Configuração para ativar o cache HTTP na memória, incluindo dados HTTP. Transmitido para enableHttpCache.

protected JSONObject mParsedExperimentalOptions

Representação JSON das opções experimentais.

public Builder(Context context)

Cria um objeto Builder que facilita a criação de um CronetEngine. A configuração padrão ativa o HTTP/2 e o QUIC, mas desativa o cache HTTP.

public CronetEngine.Builder addPublicKeyPins(
    String hostName,
    Set<byte[]> pinsSha256,
    boolean includeSubdomains,
    Date expirationDate
)

Fixa um conjunto de chaves públicas para um determinado host. Ao fixar um conjunto de chaves públicas, pinsSha256, a comunicação com hostName é necessária para autenticar com um certificado que tenha uma chave pública do conjunto fixado. Um app pode fixar a chave pública do certificado raiz, de qualquer um dos certificados intermediários ou do certificado de entrada final. A autenticação vai falhar e a comunicação segura não será estabelecida se nenhuma das chaves públicas estiver presente na cadeia de certificados do host, mesmo que ele tente se autenticar com um certificado permitido pelo repositório de certificados confiáveis do dispositivo.

Chamar esse método várias vezes com o mesmo nome de host substitui os fixadores definidos anteriormente para o host.

Para mais informações sobre a fixação de chaves públicas, consulte a RFC 7469 (em inglês).

public CronetEngine.Builder addQuicHint(String host, int port, int alternatePort)

Adiciona a dica de que host é compatível com QUIC. enableHttpCache (HTTP_CACHE_DISK) é necessário para aproveitar o estabelecimento de conexão 0-RTT entre sessões.

public CronetEngine build()

Crie um CronetEngine usando a configuração deste builder.

public CronetEngine.Builder enableBrotli(boolean value)

Define se a compactação Brotli está ativada. Se ativado, o Brotli será anunciado nos cabeçalhos de solicitação Accept-Encoding. O padrão é "desativado".

public CronetEngine.Builder enableHttp2(boolean value)

Define se o protocolo HTTP/2 está ativado. O padrão é ativado.

public CronetEngine.Builder enableHttpCache(int cacheMode, long maxSize)

Ativa ou desativa o armazenamento em cache de dados HTTP e outras informações, como informações do servidor QUIC.

public CronetEngine.Builder enableNetworkQualityEstimator(boolean value)

Ativa o estimador de qualidade da rede, que coleta e informa medições de tempo de retorno (RTT) e taxa de transferência downstream em várias camadas da pilha de rede. Depois de ativar o estimador, os listeners de RTT e taxa de transferência podem ser adicionados com addRttListener e addThroughputListener e removidos com removeRttListener e removeThroughputListener. O estimador usa memória e CPU somente quando ativado.

public CronetEngine.Builder enablePublicKeyPinningBypassForLocalTrustAnchors(boolean value)

Ativa ou desativa o bypass do fixação de chave pública para âncoras de confiança locais. Não é recomendável desativar o bypass para âncoras de confiança locais, já que isso pode impedir que o app se comunique com os hosts fixados. Por exemplo, um usuário pode querer enviar todo o tráfego por um proxy habilitado para SSL mudando as configurações de proxy do dispositivo e adicionando o certificado de proxy à lista de âncoras de confiança locais. A desativação da substituição provavelmente vai impedir que o app envie tráfego para os hosts fixados. Para mais informações, consulte "Como o fixação de chaves interage com proxies e filtros locais?" em https://www.chromium.org/Home/chromium-security/security-faq (em inglês).

public CronetEngine.Builder enableQuic(boolean value)

Define se o protocolo QUIC está ativado. O padrão é ativado. Se o QUIC estiver ativado, o ID do user agent do QUIC contendo o nome do aplicativo e a versão do Cronet será enviado ao servidor.

public String getDefaultUserAgent()

Cria uma string User-Agent, incluindo nome e versão do aplicativo, versão de build do sistema, modelo e ID, além da versão do Cronet.

@ConnectionMigrationOptions.Experimental
public CronetEngine.Builder setConnectionMigrationOptions(
    ConnectionMigrationOptions connectionMigrationOptions
)

Configura o comportamento da migração de conexão. Para mais detalhes, consulte a documentação de ConnectionMigrationOptions e os métodos individuais de ConnectionMigrationOptions.Builder.

Só é relevante se enableQuic estiver ativado.

@DnsOptions.Experimental
public CronetEngine.Builder setDnsOptions(DnsOptions dnsOptions)

Configura o comportamento da pesquisa de nome do host. Para mais detalhes, consulte a documentação de DnsOptions e os métodos individuais de DnsOptions.Builder.

Só é relevante se enableQuic estiver ativado.

public CronetEngine.Builder setLibraryLoader(CronetEngine.Builder.LibraryLoader loader)

Define um LibraryLoader a ser usado para carregar a biblioteca nativa. Se não for definido, a biblioteca será carregada usando loadLibrary.

public CronetEngine.Builder setProxyOptions(@NonNull ProxyOptions proxyOptions)

Configura o comportamento de proxy. Isso afeta, de diferentes maneiras: o estabelecimento de conexões, UrlRequest e BidirectionalStream. Para mais detalhes, consulte a documentação de Proxy.

Isso não deve ser confundido com a configuração de proxy definida pelo usuário, por alguma configuração de perfil empresarial ou (mais provavelmente) por alguma configuração automática de rede (por exemplo, o protocolo de descoberta automática de proxy da Web). Isso geralmente é chamado de configuração de proxy "do sistema". Se presente, respeitar a configuração de proxy do sistema geralmente é um requisito para obter conectividade local e/ou com a Internet. O CronetEngine já processa a configuração de proxy do sistema internamente.

Uma configuração de proxy definida por essa API é chamada de configuração de proxy "de app". A configuração de proxy do app e do sistema são separadas e, mais importante, diferentes. No momento, as configurações de proxy do app e do sistema são mutuamente exclusivas: especificar ProxyOptions substitui a configuração de proxy do sistema, se houver. Isso pode causar problemas de conectividade em alguns cenários em que uma configuração de proxy do sistema está presente. Nesses casos, os usuários podem ficar sem acesso à Internet, a menos que o ProxyOptions tenha sido configurado com um retorno null final. Consulte a documentação do ProxyOptions.

@QuicOptions.Experimental
public CronetEngine.Builder setQuicOptions(QuicOptions quicOptions)

Configura o comportamento da Cronet ao usar o QUIC. Para mais detalhes, consulte a documentação de QuicOptions e os métodos individuais de QuicOptions.Builder.

Só é relevante se enableQuic estiver ativado.

public CronetEngine.Builder setStoragePath(String value)

Define o diretório para cache HTTP e armazenamento de cookies. O diretório precisa existir.

OBSERVAÇÃO:não use o mesmo diretório de armazenamento com mais de um CronetEngine por vez. O acesso ao diretório de armazenamento não é compatível com acesso simultâneo por vários CronetEngines.

public CronetEngine.Builder setThreadPriority(int priority)

Define a prioridade da linha de execução interna do Cronet.

public CronetEngine.Builder setUserAgent(String userAgent)

Substitui o cabeçalho User-Agent em todas as solicitações. Um cabeçalho User-Agent definido explicitamente (usando addHeader) vai substituir um valor definido usando essa função.