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 sich ein CronetEngine erstellen lässt. 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
)

Pinnt eine Reihe öffentlicher Schlüssel für einen bestimmten Host an. Durch das Anpinnen einer Reihe öffentlicher Schlüssel, 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)

Es wurde ein Hinweis hinzugefügt, 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 den Anfrageheadern „Accept-Encoding“ beworben. Die Standardeinstellung ist „disabled“.

public CronetEngine.Builder enableHttp2(boolean value)

Legt fest, ob das HTTP/2-Protokoll aktiviert ist. Die Standardeinstellung ist „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 Round-Trip-Zeit (RTT) und des Downstream-Durchsatzes auf verschiedenen Ebenen des Netzwerk-Stacks erfasst und gemeldet. Nachdem Sie den Schätzer aktiviert haben, können Sie mit addRttListener und addThroughputListener Listener für RTT und Durchsatz hinzufügen und mit removeRttListener und removeThroughputListener entfernen. 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. Es wird dringend davon abgeraten, die Umgehung für lokale Vertrauensanker zu deaktivieren, da die App sonst möglicherweise nicht mit den angepinnten Hosts kommunizieren 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, kann die App höchstwahrscheinlich keinen Traffic 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?) unter https://www.chromium.org/Home/chromium-security/security-faq.

public CronetEngine.Builder enableQuic(boolean value)

Legt fest, ob das QUIC-Protokoll aktiviert ist. Die Standardeinstellung ist „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 Anwendungsname und ‑version, Systembuildversion, Modell und 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 der Proxykonfiguration, die vom Nutzer, durch eine Unternehmensprofilkonfiguration oder (höchstwahrscheinlich) durch eine automatische Netzwerkkonfiguration (z.B. Web Proxy Auto-Discovery Protocol) eingerichtet wurde. Dies wird in der Regel als „System“-Proxykonfiguration bezeichnet. Wenn 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 Proxy-Konfiguration wird als „App“-Proxy-Konfiguration bezeichnet. Die Proxykonfiguration für Apps und das System ist separat und vor allem unterschiedlich. Derzeit schließen sich App- und Systemproxykonfigurationen gegenseitig aus: Wenn ProxyOptions angegeben wird, wird die Systemproxykonfiguration ü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, sofern ProxyOptions nicht mit einem finalen null-Fallback konfiguriert wurde. 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.