CronetEngine.Builder

const val HTTP_CACHE_DISABLED = 0: Int

Einstellung zum Deaktivieren des HTTP-Cache. Einige Daten können weiterhin vorübergehend im Arbeitsspeicher gespeichert werden. An enableHttpCache weitergeleitet.

const val HTTP_CACHE_DISK = 3: Int

Einstellung zum Aktivieren des On-Disk-Cache, einschließlich HTTP-Daten. setStoragePath muss aufgerufen werden, bevor diese Konstante an enableHttpCache übergeben wird.

const val HTTP_CACHE_DISK_NO_HTTP = 2: Int

Einstellung zum Aktivieren des On-Disk-Cache, ausgenommen HTTP-Daten. setStoragePath muss aufgerufen werden, bevor diese Konstante an enableHttpCache übergeben wird.

const val HTTP_CACHE_IN_MEMORY = 1: Int

Einstellung zum Aktivieren des In-Memory-HTTP-Cache, einschließlich HTTP-Daten. An enableHttpCache weitergeleitet.

Builder(context: Context!)

Erstellt ein Builder-Objekt, mit dem ein CronetEngine erstellt werden kann. In der Standardkonfiguration sind HTTP/2 und QUIC aktiviert, der HTTP-Cache ist jedoch deaktiviert.

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

Pint eine Reihe öffentlicher Schlüssel für einen bestimmten Host an. Durch das Anpinnen einer Reihe von öffentlichen Schlüsseln, pinsSha256, ist für die Kommunikation mit hostName eine Authentifizierung mit einem Zertifikat mit einem öffentlichen Schlüssel aus der Reihe der angepinnten Schlüssel erforderlich. Eine App kann den öffentlichen Schlüssel des Root-Zertifikats, eines der Zwischenzertifikate oder des End-Entry-Zertifikats anpinnen. Die Authentifizierung schlägt fehl und es wird keine sichere Kommunikation hergestellt, wenn keiner der öffentlichen Schlüssel in der Zertifikatskette des Hosts vorhanden ist, auch wenn der Host versucht, sich mit einem Zertifikat zu authentifizieren, das vom vertrauenswürdigen Zertifikatspeicher des Geräts zugelassen wird.

Wenn diese Methode mehrmals mit demselben Hostnamen aufgerufen wird, werden die zuvor festgelegten Pins für den Host überschrieben.

Weitere Informationen zum Public Key Pinning finden Sie in RFC 7469.

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

Fügt einen Hinweis hinzu, dass host QUIC unterstützt. enableHttpCache (HTTP_CACHE_DISK) ist erforderlich, um die 0-RTT-Verbindungsherstellung zwischen Sitzungen nutzen zu können.

fun build(): CronetEngine!

Erstellt ein CronetEngine mit der Konfiguration dieses Builders.

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

Legt fest, ob die Brotli-Komprimierung aktiviert ist. Wenn diese Option aktiviert ist, wird Brotli in Accept-Encoding-Anfrageheadern beworben. Die Standardeinstellung ist „disabled“.

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

Legt fest, ob das HTTP/2-Protokoll aktiviert ist. Die Einstellung ist standardmäßig aktiviert.

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

Aktiviert oder deaktiviert das Caching von HTTP-Daten und anderen Informationen wie QUIC-Serverinformationen.

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

Aktiviert die Schätzung der Netzwerkqualität. Dabei werden Messungen der Umlaufzeit (Round Trip Time, RTT) und des Downstream-Durchsatzes auf verschiedenen Ebenen des Netzwerk-Stacks erfasst und gemeldet. Nachdem der Schätzer aktiviert wurde, können mit addRttListener und addThroughputListener Listener für RTT und Durchsatz hinzugefügt und mit removeRttListener und removeThroughputListener entfernt werden. Der Schätzer verwendet Arbeitsspeicher und CPU nur, wenn er aktiviert ist.

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

Aktiviert oder deaktiviert das Umgehen des Public-Key-Pinning für lokale Vertrauensanker. Das Deaktivieren der Umgehung für lokale Vertrauensanker wird dringend abgeraten, da dadurch die Kommunikation der App mit den angepinnten Hosts verhindert werden kann. Ein Nutzer möchte beispielsweise den gesamten Traffic über einen SSL-fähigen Proxy senden, indem er die Proxy-Einstellungen des Geräts ändert und das Proxy-Zertifikat der Liste der lokalen Vertrauensanker hinzufügt. Wenn Sie die Umgehung deaktivieren, wird die App höchstwahrscheinlich keinen Traffic mehr an die angepinnten Hosts senden. Weitere Informationen finden Sie unter „How does key pinning interact with local proxies and filters?“ (Wie interagiert Key Pinning mit lokalen Proxys und Filtern?) auf https://www.chromium.org/Home/chromium-security/security-faq.

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

Legt fest, ob das QUIC-Protokoll aktiviert ist. Die Einstellung ist standardmäßig aktiviert. Wenn QUIC aktiviert ist, wird die QUIC-User-Agent-ID mit dem Anwendungsnamen und der Cronet-Version an den Server gesendet.

fun getDefaultUserAgent(): String!

Erstellt einen User-Agent-String, der den Anwendungsnamen und die Version, die Systembuild-Version, das Modell und die ID sowie die Cronet-Version enthält.

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

Konfiguriert das Verhalten der Verbindungsmigration. Weitere Informationen finden Sie in der Dokumentation zu ConnectionMigrationOptions und den einzelnen Methoden von ConnectionMigrationOptions.Builder.

Nur relevant, wenn enableQuic aktiviert ist.

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

Konfiguriert das Verhalten der Hostnamensuche. Weitere Informationen finden Sie in der Dokumentation zu DnsOptions und den einzelnen Methoden von DnsOptions.Builder.

Nur relevant, wenn enableQuic aktiviert ist.

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

Legt einen LibraryLoader fest, der zum Laden der nativen Bibliothek verwendet werden soll. Wenn nicht festgelegt, wird die Bibliothek mit loadLibrary geladen.

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

Konfiguriert das Proxying-Verhalten. Dies wirkt sich auf unterschiedliche Weise auf die Verbindungsherstellung, UrlRequest und BidirectionalStream aus. Weitere Informationen finden Sie in der Dokumentation zu Proxy.

Dies ist nicht zu verwechseln mit Proxykonfigurationen, die vom Nutzer, durch eine Unternehmensprofilkonfiguration oder (höchstwahrscheinlich) durch eine automatische Netzwerkkonfiguration (z.B. Web Proxy Auto-Discovery Protocol) eingerichtet wurden. Dies wird in der Regel als „System“-Proxykonfiguration bezeichnet. Falls vorhanden, ist die Berücksichtigung der Systemproxykonfiguration häufig eine Voraussetzung für die lokale und/oder Internetverbindung. Die Systemproxykonfiguration wird bereits intern von CronetEngine verarbeitet.

Eine über diese API definierte Proxykonfiguration wird als „App“-Proxykonfiguration bezeichnet. Die Proxykonfiguration für Apps und das System ist getrennt und unterscheidet sich vor allem. Derzeit schließen sich App- und System-Proxykonfigurationen gegenseitig aus: Wenn ProxyOptions angegeben wird, wird die System-Proxykonfiguration überschrieben, sofern vorhanden. Dies kann in einigen Szenarien, in denen eine Systemproxykonfiguration vorhanden ist, zu Verbindungsproblemen führen. In solchen Fällen haben Nutzer möglicherweise keinen Internetzugriff, es sei denn, ProxyOptions wurde mit einem finalen null-Fallback konfiguriert. Weitere Informationen finden Sie in der Dokumentation zu ProxyOptions.

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

Konfiguriert das Verhalten von Cronet bei Verwendung von QUIC. Weitere Informationen finden Sie in der Dokumentation zu QuicOptions und den einzelnen Methoden von QuicOptions.Builder.

Nur relevant, wenn enableQuic aktiviert ist.

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

Legt das Verzeichnis für den HTTP-Cache und die Cookie-Speicherung fest. Das Verzeichnis muss vorhanden sein.

HINWEIS:Verwenden Sie nicht dasselbe Speicherverzeichnis mit mehreren CronetEngine gleichzeitig. Der Zugriff auf das Speicherverzeichnis unterstützt keinen gleichzeitigen Zugriff durch mehrere CronetEngines.

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

Legt die Thread-Priorität des internen Threads von Cronet fest.

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

Überschreibt den User-Agent-Header für alle Anfragen. Ein explizit festgelegter User-Agent-Header (mit addHeader festgelegt) überschreibt einen mit dieser Funktion festgelegten Wert.

protected val mParsedExperimentalOptions: JSONObject!

JSON-Darstellung der experimentellen Optionen.