Prepare for release 5.4.0.

Author: swankjesse

CHANGELOG.md

@@ -1,6 +1,21 @@
 Change Log
 ==========
 
+## Version 5.4.0
+
+_2026-06-08_
+
+ *  New: Add superpowers to interceptors. Interceptors can now override anything settable on
+    `OkHttpClient.Builder`, such as the cache, connection pool, socket factory, and DNS. We expect
+    this will allow most users to use interceptors everywhere, insted of mixing and matching
+    interceptors with custom `Call.Factory` wrappers.
+ *  Fix: Limit each HTTP/2 response to 256 KiB of total headers.
+ *  Upgrade: [kotlinx.coroutines 1.11.0][coroutines_1_11_0]. This is used by the optional
+    `okhttp-coroutines` artifact.
+ *  Upgrade: [GraalVM 25.0.3][graalvm_25].
+ *  Upgrade: [Okio 3.17.0][okio_3_17_0].
+
+
 ## Version 5.3.2
 
 _2025-11-18_
@@ -765,11 +780,13 @@ See [4.x Change log](https://square.github.io/okhttp/changelogs/changelog_4x/) f
 [annotation_1_9_1]: https://developer.android.com/jetpack/androidx/releases/annotation#annotation-1.9.1
 [assertk]: https://github.com/willowtreeapps/assertk
 [coroutines_1_10_2]: https://github.com/Kotlin/kotlinx.coroutines/releases/tag/1.10.2
+[coroutines_1_11_0]: https://github.com/Kotlin/kotlinx.coroutines/releases/tag/1.11.0
 [curl]: https://curl.se/
 [elf_alignment]: https://developer.android.com/guide/practices/page-sizes
 [graalvm]: https://www.graalvm.org/
 [graalvm_21]: https://www.graalvm.org/release-notes/21_0/
 [graalvm_22]: https://www.graalvm.org/release-notes/22_2/
+[graalvm_25]: https://www.graalvm.org/release-notes/JDK_25/
 [idna_15_1_0]: https://www.unicode.org/reports/tr46/#Modifications
 [kotlin_1_4_20]: https://github.com/JetBrains/kotlin/releases/tag/v1.4.20
 [kotlin_1_5_31]: https://github.com/JetBrains/kotlin/releases/tag/v1.5.31
@@ -793,6 +810,7 @@ See [4.x Change log](https://square.github.io/okhttp/changelogs/changelog_4x/) f
 [okio_3_16_2]: https://square.github.io/okio/changelog/#version-3162
 [okio_3_16_3]: https://square.github.io/okio/changelog/#version-3163
 [okio_3_16_4]: https://square.github.io/okio/changelog/#version-3164
+[okio_3_17_0]: https://square.github.io/okio/changelog/#version-3170
 [okio_3_1_0]: https://square.github.io/okio/changelog/#version-310
 [okio_3_2_0]: https://square.github.io/okio/changelog/#version-320
 [okio_3_7_0]: https://square.github.io/okio/changelog/#version-370

README.md

@@ -123,10 +123,10 @@ Releases
 
 Our [change log][changelog] has release history.
 
-The latest release is available on [Maven Central](https://search.maven.org/artifact/com.squareup.okhttp3/okhttp/5.3.0/jar).
+The latest release is available on [Maven Central](https://search.maven.org/artifact/com.squareup.okhttp3/okhttp/5.4.0/jar).
 
 ```kotlin
-implementation("com.squareup.okhttp3:okhttp:5.3.0")
+implementation("com.squareup.okhttp3:okhttp:5.4.0")
 ```
 
 Snapshot builds are [available][snap]. [R8 and ProGuard][r8_proguard] rules are available.
@@ -136,7 +136,7 @@ Also, we have a [bill of materials (BOM)][bom] available to help you keep OkHttp
 ```kotlin
     dependencies {
        // define a BOM and its version
-       implementation(platform("com.squareup.okhttp3:okhttp-bom:5.3.0"))
+       implementation(platform("com.squareup.okhttp3:okhttp-bom:5.4.0"))
 
        // define any required OkHttp artifacts without version
        implementation("com.squareup.okhttp3:okhttp")
@@ -191,10 +191,10 @@ MockWebServer
 
 OkHttp includes a library for testing HTTP, HTTPS, and HTTP/2 clients.
 
-The latest release is available on [Maven Central](https://search.maven.org/artifact/com.squareup.okhttp3/mockwebserver/5.3.0/jar).
+The latest release is available on [Maven Central](https://search.maven.org/artifact/com.squareup.okhttp3/mockwebserver/5.4.0/jar).
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:mockwebserver3:5.3.0")
+testImplementation("com.squareup.okhttp3:mockwebserver3:5.4.0")
 ```
 
 MockWebServer is used for firstly for internal testing, and for basic testing of apps using OkHttp client.

build-logic/src/main/kotlin/okhttp.base-conventions.gradle.kts

@@ -7,7 +7,7 @@ import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
 val libs = extensions.getByType<VersionCatalogsExtension>().named("libs")
 
 group = "com.squareup.okhttp3"
-version = "5.4.0-SNAPSHOT"
+version = "5.4.0"
 
 val platform = project.platform
 val testJavaVersion = project.testJavaVersion

docs/releasing.md

@@ -15,7 +15,7 @@ Releasing
     ```
     sed -i "" \
       "s/version = \".*\"/version = \"$RELEASE_VERSION\"/g" \
-      build.gradle.kts
+      build-logic/src/main/kotlin/okhttp.base-conventions.gradle.kts
     sed -i "" \
       "s/\"com.squareup.okhttp3:\([^\:]*\):[^\"]*\"/\"com.squareup.okhttp3:\1:$RELEASE_VERSION\"/g" \
       `find . -name "README.md"`
@@ -29,7 +29,7 @@ Releasing
 
    sed -i "" \
       "s/version = \".*\"/version = \"$NEXT_VERSION\"/g" \
-      build.gradle.kts
+      build-logic/src/main/kotlin/okhttp.base-conventions.gradle.kts
     git commit -am "Prepare next development version."
     git push
     ```

mockwebserver-junit4/README.md

@@ -6,7 +6,7 @@ This module integrates mockwebserver3.MockWebServer with JUnit 4.
 To use, first add this library as a test dependency:
 
 ```
-testImplementation("com.squareup.okhttp3:mockwebserver3-junit4:5.3.0")
+testImplementation("com.squareup.okhttp3:mockwebserver3-junit4:5.4.0")
 ```
 
 Then in tests annotated `@org.junit.Test`, you may declare a field with the `@Rule` annotation:

mockwebserver-junit5/README.md

@@ -6,7 +6,7 @@ This module integrates mockwebserver3.MockWebServer with JUnit 5.
 To use, first add this library as a test dependency:
 
 ```
-testImplementation("com.squareup.okhttp3:mockwebserver3-junit5:5.3.0")
+testImplementation("com.squareup.okhttp3:mockwebserver3-junit5:5.4.0")
 ```
 
 Annotate fields in test classes with `@StartStop`. The server will be started and shut down

mockwebserver/README.md

@@ -270,7 +270,7 @@ server.dispatcher = dispatcher
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:mockwebserver3:5.3.0")
+testImplementation("com.squareup.okhttp3:mockwebserver3:5.4.0")
 ```
 
 ### License

okhttp-brotli/README.md

@@ -14,7 +14,7 @@ OkHttpClient client = new OkHttpClient.Builder()
 ```
 
 ```kotlin
-implementation("com.squareup.okhttp3:okhttp-brotli:5.3.0")
+implementation("com.squareup.okhttp3:okhttp-brotli:5.4.0")
 ```
 
  [1]: https://github.com/google/brotli

okhttp-dnsoverhttps/README.md

@@ -6,7 +6,7 @@ This module is an implementation of [DNS over HTTPS][1] using OkHttp.
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:okhttp-dnsoverhttps:5.3.0")
+testImplementation("com.squareup.okhttp3:okhttp-dnsoverhttps:5.4.0")
 ```
 
 ### Usage

okhttp-java-net-cookiejar/README.md

@@ -7,5 +7,5 @@ This used to be part of `okhttp-urlconnection`
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:okhttp-java-net-cookiehandler:5.3.0")
+testImplementation("com.squareup.okhttp3:okhttp-java-net-cookiehandler:5.4.0")
 ```