Upgrading com.squareup.okhttp3:okhttp 4 to 5

Removes AddressPolicy, AsyncDns, and ConnectionListener from the public API.

Renames RecordedRequest.sequenceNumber to exchangeIndex and adds connectionIndex.

Renames RecordedRequest.path to RecordedRequest.target.

Removes the okhttp-android artifact introduced in 5.0.0-alpha.7.

Removes the AndroidLogging class; LoggingEventListener and HttpLoggingInterceptor now write to logcat by default.

Drops support for Kotlin Multiplatform.

Uses kotlin.time.Duration in APIs like OkHttpClient.Builder.callTimeout() and drops the DurationUnit functions from earlier alphas.

Removes the tunnelProxy argument from MockWebServer.useHttps() in the mockwebserver3 package.

Removes Cloneable from OkHttpClient.

MockWebServer moves to new mockwebserver3 Maven coordinates and package names, removing the JUnit 4 dependency from the core module.

Code that subclasses okhttp3.mockwebserver.QueueDispatcher is no longer source or binary compatible; migrate to the mockwebserver3 package.

OkHttp is now packaged as separate JVM and Android artifacts, enabling platform-specific features and optimizations.

MockWebServer moves to new coordinates and package names, with the old okhttp3.mockwebserver artifact still published.

Moves gzip from RequestBody to Request.Builder, handling body compression and Content-Encoding.

Makes RecordedRequest.body nullable, with null meaning the request has no body.

Makes RecordedRequest.chunkSizes nullable, with null meaning the request is not chunked.

Replaces SocketPolicy with SocketEffect, splitting triggers from effects.

Replaces the parameters-based JUnit 5 extension with a @StartStop annotation on a MockWebServer property.

Stops auto-starting MockWebServer on accessor calls like port; accessors now throw IllegalStateException if not started.

Decomposes RecordedRequest.requestLine into method, target, and version properties.

Changes RecordedRequest.body from a mutable Buffer to an immutable ByteString.

Adopts Okio's new Socket interface for MockResponse.socketHandler.

Moves the AndroidAsyncDns class from okhttp-android to the okhttp artifact.

Moves coroutines extensions to the okhttp3.coroutines package for Java Platform Module System compatibility.

Tags unstable new APIs as @ExperimentalOkHttpApi, with OkHttp 5.0 planned to ship without stabilizing them.

Reorders the parameters in the Cache constructor introduced in 5.0.0-alpha.3.

Makes mockwebserver3.SocketPolicy a sealed interface, a backwards-incompatible change for early adopters.

Makes mockwebserver3.MockResponse immutable, requiring a Builder.

Makes Response.body non-null; reading content fails for cacheResponse, networkResponse, and priorResponse bodies.

Blocks 8 compromised eMudhra intermediate certificates, protecting JVMs and AOSP devices exposed to them.

Stops logging sensitive headers in Request.toString().

ECH requires platform TLS stack support, currently only Android 17 (API 37, released June 2026).