CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

Es el parámetro de configuración para inhabilitar la caché de HTTP. Es posible que algunos datos aún se almacenen temporalmente en la memoria. Se pasó a enableHttpCache.

const val HTTP_CACHE_DISK = 3: Int

Es el parámetro de configuración para habilitar la caché en el disco, incluidos los datos HTTP. Se debe llamar a setStoragePath antes de pasar esta constante a enableHttpCache.

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

Es el parámetro de configuración para habilitar la caché en el disco, sin incluir los datos HTTP. Se debe llamar a setStoragePath antes de pasar esta constante a enableHttpCache.

const val HTTP_CACHE_IN_MEMORY = 1: Int

Es un parámetro de configuración para habilitar la caché HTTP en memoria, incluidos los datos HTTP. Se pasó a enableHttpCache.

Builder(context: Context!)

Construye un objeto Builder que facilita la creación de un objeto CronetEngine. La configuración predeterminada habilita HTTP/2 y QUIC, pero inhabilita la caché de HTTP.

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

Fija un conjunto de claves públicas para un host determinado. Cuando se fija un conjunto de claves públicas, pinsSha256, se requiere la comunicación con hostName para autenticarse con un certificado que tenga una clave pública del conjunto de claves fijadas. Una app puede fijar la clave pública del certificado raíz, cualquiera de los certificados intermedios o el certificado de entrada final. La autenticación fallará y no se establecerá una comunicación segura si ninguna de las claves públicas está presente en la cadena de certificados del host, incluso si el host intenta autenticarse con un certificado permitido por el almacén de certificados de confianza del dispositivo.

Si se llama a este método varias veces con el mismo nombre de host, se anulan las fijaciones establecidas anteriormente para el host.

Puedes encontrar más información sobre la fijación de claves públicas en RFC 7469.

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

Se agregó una sugerencia que indica que host admite QUIC. Ten en cuenta que se necesita enableHttpCache (HTTP_CACHE_DISK) para aprovechar el establecimiento de conexión con 0 RTT entre sesiones.

fun build(): CronetEngine!

Compila un CronetEngine con la configuración de este compilador.

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

Establece si la compresión Brotli está habilitada. Si está habilitado, Brotli se anunciará en los encabezados de solicitud Accept-Encoding. La configuración predeterminada es inhabilitada.

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

Establece si el protocolo HTTP/2 está habilitado. La configuración predeterminada está habilitada.

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

Habilita o inhabilita el almacenamiento en caché de datos HTTP y otra información, como la información del servidor QUIC.

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

Habilita el estimador de calidad de la red, que recopila y registra mediciones del tiempo de ida y vuelta (RTT) y la capacidad de procesamiento de descarga en varias capas de la pila de red. Después de habilitar el estimador, se pueden agregar objetos de escucha de RTT y de capacidad de procesamiento con addRttListener y addThroughputListener, y se pueden quitar con removeRttListener y removeThroughputListener. El estimador usa memoria y CPU solo cuando está habilitado.

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

Habilita o inhabilita la omisión de la fijación de claves públicas para los anclajes de confianza locales. Se recomienda no inhabilitar la omisión para los anclajes de confianza locales, ya que esto puede impedir que la app se comunique con los hosts fijados. Por ejemplo, un usuario puede querer enviar todo el tráfico a través de un proxy habilitado para SSL. Para ello, debe cambiar la configuración del proxy del dispositivo y agregar el certificado del proxy a la lista de anclajes de confianza locales. Si se inhabilita la omisión, es muy probable que la app no envíe tráfico a los hosts fijados. Para obtener más información, consulta "¿Cómo interactúa la fijación de claves con los proxies y filtros locales?" en https://www.chromium.org/Home/chromium-security/security-faq.

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

Establece si el protocolo QUIC está habilitado. La configuración predeterminada está habilitada. Si QUIC está habilitado, se envía al servidor el ID del agente de usuario de QUIC que contiene el nombre de la aplicación y la versión de Cronet.

fun getDefaultUserAgent(): String!

Construye una cadena de User-Agent que incluye el nombre y la versión de la aplicación, la versión de compilación del sistema, el modelo y el ID, y la versión de Cronet.

@ConnectionMigrationOptions.Experimental
fun setConnectionMigrationOptions(
    connectionMigrationOptions: ConnectionMigrationOptions!
): CronetEngine.Builder!

Configura el comportamiento de la migración de conexión. Para obtener más detalles, consulta la documentación de ConnectionMigrationOptions y los métodos individuales de ConnectionMigrationOptions.Builder.

Solo es relevante si enableQuic está habilitado.

@DnsOptions.Experimental
fun setDnsOptions(dnsOptions: DnsOptions!): CronetEngine.Builder!

Configura el comportamiento de la búsqueda de nombres de host. Para obtener más detalles, consulta la documentación de DnsOptions y los métodos individuales de DnsOptions.Builder.

Solo es relevante si enableQuic está habilitado.

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

Establece un LibraryLoader que se usará para cargar la biblioteca nativa. Si no se establece, la biblioteca se cargará con loadLibrary.

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

Configura el comportamiento del proxy. Esto afecta de diferentes maneras el establecimiento de conexiones, UrlRequest y BidirectionalStream. Para obtener más detalles, consulta la documentación de Proxy.

Esto no se debe confundir con la configuración de proxy que estableció el usuario, alguna configuración de perfil empresarial o (lo más probable) alguna configuración automática de red (p.ej., el Protocolo de detección automática de proxy web). Por lo general, esto se conoce como configuración de proxy "del sistema". Si está presente, respetar la configuración del proxy del sistema suele ser un requisito para obtener conectividad local o a Internet. CronetEngine ya controla la configuración del proxy del sistema de forma interna.

La configuración del proxy definida a través de esta API se conoce como configuración del proxy "de la app". La configuración del proxy del sistema y de la app son independientes y, lo que es más importante, diferentes. Actualmente, las configuraciones de proxy del sistema y de la app son mutuamente exclusivas: especificar ProxyOptions anula la configuración de proxy del sistema, si está presente. Esto puede causar problemas de conectividad en algunos casos en los que hay una configuración de proxy del sistema. En estos casos, es posible que los usuarios no tengan acceso a Internet, a menos que ProxyOptions se haya configurado con una alternativa final, null. Consulta la documentación de ProxyOptions.

@QuicOptions.Experimental
fun setQuicOptions(quicOptions: QuicOptions!): CronetEngine.Builder!

Configura el comportamiento de Cronet cuando se usa QUIC. Para obtener más detalles, consulta la documentación de QuicOptions y los métodos individuales de QuicOptions.Builder.

Solo es relevante si enableQuic está habilitado.

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

Establece el directorio para el almacenamiento de cookies y caché HTTP. El directorio debe existir.

NOTA: No uses el mismo directorio de almacenamiento con más de un CronetEngine a la vez. El acceso al directorio de almacenamiento no admite el acceso simultáneo de varios CronetEngine.

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

Establece la prioridad del subproceso interno de Cronet.

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

Anula el encabezado User-Agent para todas las solicitudes. Un encabezado User-Agent establecido de forma explícita (con addHeader) anulará un valor establecido con esta función.

protected val mParsedExperimentalOptions: JSONObject!

Es la representación JSON de las opciones experimentales.