CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

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

const val HTTP_CACHE_DISK = 3: Int

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

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

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

const val HTTP_CACHE_IN_MEMORY = 1: Int

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

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.

fun addPublicKeyPins(
    hostName: String!,
    pinsSha256: (Mutable)Set<ByteArray!>!,
    includeSubdomains: Boolean,
    expirationDate: Date!
): CronetEngine.Builder!

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

fun addQuicHint(host: String!, port: Int, alternatePort: Int): CronetEngine.Builder!

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.

fun build(): CronetEngine!

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

fun enableBrotli(value: Boolean): CronetEngine.Builder!

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

fun enableHttp2(value: Boolean): CronetEngine.Builder!

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

fun enableHttpCache(cacheMode: Int, maxSize: Long): CronetEngine.Builder!

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

fun enableNetworkQualityEstimator(value: Boolean): CronetEngine.Builder!

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.

fun enablePublicKeyPinningBypassForLocalTrustAnchors(value: Boolean): CronetEngine.Builder!

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

fun enableQuic(value: Boolean): CronetEngine.Builder!

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.

fun getDefaultUserAgent(): String!

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
fun setConnectionMigrationOptions(
    connectionMigrationOptions: ConnectionMigrationOptions!
): CronetEngine.Builder!

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
fun setDnsOptions(dnsOptions: DnsOptions!): CronetEngine.Builder!

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.

fun setLibraryLoader(loader: CronetEngine.Builder.LibraryLoader!): CronetEngine.Builder!

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

fun setProxyOptions(proxyOptions: ProxyOptions): CronetEngine.Builder!

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
fun setQuicOptions(quicOptions: QuicOptions!): CronetEngine.Builder!

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.

fun setStoragePath(value: String!): CronetEngine.Builder!

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.

fun setThreadPriority(priority: Int): CronetEngine.Builder!

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

fun setUserAgent(userAgent: String!): CronetEngine.Builder!

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.

protected val mParsedExperimentalOptions: JSONObject!

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