CronetEngine.Builder

public static final int HTTP_CACHE_DISABLED = 0

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

public static final int HTTP_CACHE_DISK = 3

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

public static final int HTTP_CACHE_DISK_NO_HTTP = 2

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

public static final int HTTP_CACHE_IN_MEMORY = 1

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

protected JSONObject mParsedExperimentalOptions

JSON-Darstellung der experimentellen Optionen.

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

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

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.

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

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.

public CronetEngine build()

Erstellt ein CronetEngine mit der Konfiguration dieses Builders.

public CronetEngine.Builder enableBrotli(boolean value)

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

public CronetEngine.Builder enableHttp2(boolean value)

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

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

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

public CronetEngine.Builder enableNetworkQualityEstimator(boolean value)

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.

public CronetEngine.Builder enablePublicKeyPinningBypassForLocalTrustAnchors(boolean value)

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.

public CronetEngine.Builder enableQuic(boolean value)

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.

public String getDefaultUserAgent()

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

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

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.

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

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

public CronetEngine.Builder setProxyOptions(@NonNull ProxyOptions proxyOptions)

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

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.

public CronetEngine.Builder setStoragePath(String value)

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.

public CronetEngine.Builder setThreadPriority(int priority)

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

public CronetEngine.Builder setUserAgent(String userAgent)

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