CronetEngine.Builder

public static final int HTTP_CACHE_DISABLED = 0

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.

public static final int HTTP_CACHE_DISK = 3

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.

public static final int HTTP_CACHE_DISK_NO_HTTP = 2

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.

public static final int HTTP_CACHE_IN_MEMORY = 1

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

protected JSONObject mParsedExperimentalOptions

Representación JSON de las opciones experimentales.

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

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

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.

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

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.

public CronetEngine build()

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

public CronetEngine.Builder enableBrotli(boolean value)

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.

public CronetEngine.Builder enableHttp2(boolean value)

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

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

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

public CronetEngine.Builder enableNetworkQualityEstimator(boolean value)

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.

public CronetEngine.Builder enablePublicKeyPinningBypassForLocalTrustAnchors(boolean value)

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.

public CronetEngine.Builder enableQuic(boolean value)

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.

public String getDefaultUserAgent()

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

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

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.

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

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

public CronetEngine.Builder setProxyOptions(@NonNull ProxyOptions proxyOptions)

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

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.

public CronetEngine.Builder setStoragePath(String value)

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.

public CronetEngine.Builder setThreadPriority(int priority)

Establece la prioridad del subproceso interno de Cronet.

public CronetEngine.Builder setUserAgent(String userAgent)

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.