CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

Paramètre permettant de désactiver le cache HTTP. Certaines données peuvent encore être stockées temporairement en mémoire. Transmis à enableHttpCache.

const val HTTP_CACHE_DISK = 3: Int

Paramètre permettant d'activer le cache sur le disque, y compris les données HTTP. setStoragePath doit être appelé avant de transmettre cette constante à enableHttpCache.

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

Paramètre permettant d'activer le cache sur disque, à l'exclusion des données HTTP. setStoragePath doit être appelé avant de transmettre cette constante à enableHttpCache.

const val HTTP_CACHE_IN_MEMORY = 1: Int

Paramètre permettant d'activer le cache HTTP en mémoire, y compris les données HTTP. Transmis à enableHttpCache.

Builder(context: Context!)

Construit un objet Builder qui facilite la création d'un CronetEngine. La configuration par défaut active HTTP/2 et QUIC, mais désactive le cache HTTP.

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

Épingle un ensemble de clés publiques pour un hôte donné. En épinglant un ensemble de clés publiques, pinsSha256, la communication avec hostName est nécessaire pour s'authentifier avec un certificat dont la clé publique fait partie de l'ensemble épinglé. Une application peut épingler la clé publique du certificat racine, de l'un des certificats intermédiaires ou du certificat d'entrée de fin. L'authentification échouera et la communication sécurisée ne sera pas établie si aucune des clés publiques n'est présente dans la chaîne de certificats de l'hôte, même si l'hôte tente de s'authentifier avec un certificat autorisé par le magasin de certificats approuvés de l'appareil.

Si vous appelez cette méthode plusieurs fois avec le même nom d'hôte, les épingles précédemment définies pour l'hôte seront remplacées.

Pour en savoir plus sur l'épinglage de clé publique, consultez la RFC 7469.

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

Ajoute une indication selon laquelle host est compatible avec QUIC. Notez que enableHttpCache (HTTP_CACHE_DISK) est nécessaire pour profiter de l'établissement de connexion 0-RTT entre les sessions.

fun build(): CronetEngine!

Créez un CronetEngine à l'aide de la configuration de ce compilateur.

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

Indique si la compression Brotli est activée. Si Brotli est activé, il sera annoncé dans les en-têtes de requête Accept-Encoding. La valeur par défaut est "disabled".

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

Indique si le protocole HTTP/2 est activé. Elle est activée par défaut.

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

Active ou désactive la mise en cache des données HTTP et d'autres informations, comme celles du serveur QUIC.

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

Active l'estimateur de qualité du réseau, qui collecte et signale les mesures du délai aller-retour (DAR) et du débit descendant à différents niveaux de la pile réseau. Une fois l'estimateur activé, les écouteurs de RTT et de débit peuvent être ajoutés avec addRttListener et addThroughputListener, et supprimés avec removeRttListener et removeThroughputListener. L'estimateur n'utilise la mémoire et le processeur que lorsqu'il est activé.

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

Active ou désactive le contournement de l'épinglage de clé publique pour les ancres de confiance locales. Il est fortement déconseillé de désactiver le contournement pour les ancres d'approbation locales, car cela peut empêcher l'application de communiquer avec les hôtes épinglés. Par exemple, un utilisateur peut vouloir envoyer tout le trafic via un proxy SSL en modifiant les paramètres proxy de l'appareil et en ajoutant le certificat de proxy à la liste des ancres de confiance locales. Si vous désactivez le contournement, il est fort probable que l'application ne puisse plus envoyer de trafic aux hôtes épinglés. Pour en savoir plus, consultez "How does key pinning interact with local proxies and filters?" (Comment l'épinglage de clés interagit-il avec les filtres et les proxys locaux ?) sur https://www.chromium.org/Home/chromium-security/security-faq.

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

Indique si le protocole QUIC est activé. Elle est activée par défaut. Si QUIC est activé, l'ID de l'agent utilisateur QUIC contenant le nom de l'application et la version de Cronet est envoyé au serveur.

fun getDefaultUserAgent(): String!

Construit une chaîne User-Agent incluant le nom et la version de l'application, la version de compilation du système, le modèle et l'ID, ainsi que la version de Cronet.

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

Configure le comportement de la migration de connexion. Pour en savoir plus, consultez la documentation de ConnectionMigrationOptions et des méthodes individuelles de ConnectionMigrationOptions.Builder.

Pertinent uniquement si enableQuic est activé.

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

Configure le comportement de la recherche de nom d'hôte. Pour en savoir plus, consultez la documentation de DnsOptions et des méthodes individuelles de DnsOptions.Builder.

Pertinent uniquement si enableQuic est activé.

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

Définit un LibraryLoader à utiliser pour charger la bibliothèque native. Si ce paramètre n'est pas défini, la bibliothèque sera chargée à l'aide de loadLibrary.

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

Configure le comportement du proxy. Cela affecte, de différentes manières, l'établissement des connexions, UrlRequest et BidirectionalStream. Pour en savoir plus, consultez la documentation de Proxy.

Il ne faut pas confondre cela avec la configuration de proxy qui a été configurée par l'utilisateur, par une configuration de profil d'entreprise ou (très probablement) par une configuration automatique du réseau (par exemple, le protocole Web Proxy Auto-Discovery). On parle généralement de configuration du proxy "système". Si elle est présente, le respect de la configuration du proxy système est souvent une exigence pour obtenir une connectivité locale et/ou Internet. CronetEngine gère déjà la configuration du proxy système en interne.

Une configuration de proxy définie via cette API est appelée configuration de proxy "d'application". La configuration du proxy de l'application et du système sont distinctes et, surtout, différentes. Actuellement, les configurations de proxy d'application et de système s'excluent mutuellement : si vous spécifiez ProxyOptions, la configuration de proxy du système est remplacée, le cas échéant. Cela peut entraîner des problèmes de connectivité dans certains scénarios où une configuration de proxy système est présente. Dans de tels scénarios, les utilisateurs peuvent se retrouver sans accès à Internet, sauf si ProxyOptions a été configuré avec une null finale de secours. Consultez la documentation ProxyOptions.

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

Configure le comportement de Cronet lors de l'utilisation de QUIC. Pour en savoir plus, consultez la documentation de QuicOptions et des méthodes individuelles de QuicOptions.Builder.

Pertinent uniquement si enableQuic est activé.

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

Définit le répertoire pour le cache HTTP et le stockage des cookies. Le répertoire doit exister.

REMARQUE : N'utilisez pas le même répertoire de stockage avec plusieurs CronetEngine à la fois. L'accès au répertoire de stockage n'est pas compatible avec l'accès simultané par plusieurs CronetEngine.

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

Définit la priorité du thread interne de Cronet.

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

Remplace l'en-tête User-Agent pour toutes les requêtes. Un en-tête User-Agent défini explicitement (à l'aide de addHeader) remplacera une valeur définie à l'aide de cette fonction.

protected val mParsedExperimentalOptions: JSONObject!

Représentation JSON des options expérimentales.