Prepare for release 4.7.0.

Author: squarejesse

CHANGELOG.md

@@ -1,6 +1,45 @@
 Change Log
 ==========
 
+## Version 4.7.0
+
+_2020-05-17_
+
+ *  New: `HandshakeCertificates.Builder.addInsecureHost()` makes it easy to turn off security in
+    private development environments that only carry test data. Prefer this over creating an
+    all-trusting `TrustManager` because only hosts on the allowlist are insecure. From
+    [our DevServer sample][dev_server]:
+
+    ```kotlin
+    val clientCertificates = HandshakeCertificates.Builder()
+        .addPlatformTrustedCertificates()
+        .addInsecureHost("localhost")
+        .build()
+
+    val client = OkHttpClient.Builder()
+        .sslSocketFactory(clientCertificates.sslSocketFactory(), clientCertificates.trustManager)
+        .build()
+    ```
+
+ *  New: Add `cacheHit`, `cacheMiss`, and `cacheConditionalHit()` events to `EventListener`. Use
+    these in logs, metrics, and even test cases to confirm your cache headers are configured as
+    expected.
+
+ *  New: Constant string `okhttp3.VERSION`. This is a string like "4.5.0-RC1", "4.5.0", or
+    "4.6.0-SNAPSHOT" indicating the version of OkHttp in the current runtime. Use this to include
+    the OkHttp version in custom `User-Agent` headers.
+
+ *  Fix: Don't crash when running as a plugin in Android Studio Canary 4.1. To enable
+    platform-specific TLS features OkHttp must detect whether it's running in a JVM or in Android.
+    The upcoming Android Studio runs in a JVM but has classes from Android and that confused OkHttp!
+
+ *  Fix: Include the header `Accept: text/event-stream` for SSE calls. This header is not added if
+    the request already contains an `Accept` header.
+
+ *  Fix: Don't crash with a `NullPointerException` if a server sends a close while we're sending a
+    ping. OkHttp had a race condition bug.
+
+
 ## Version 4.6.0
 
 _2020-04-28_
@@ -376,6 +415,7 @@ _2019-06-03_
 
  [bom]: https://docs.gradle.org/6.2/userguide/platforms.html#sub:bom_import
  [bouncy_castle_releases]: https://www.bouncycastle.org/releasenotes.html
+ [dev_server]: https://github.com/square/okhttp/blob/482f88300f78c3419b04379fc26c3683c10d6a9d/samples/guide/src/main/java/okhttp3/recipes/kt/DevServer.kt
  [iana_websocket]: https://www.iana.org/assignments/websocket/websocket.txt
  [jetty_8_252]: https://webtide.com/jetty-alpn-java-8u252/
  [kotlin_1_3_71]: https://github.com/JetBrains/kotlin/releases/tag/v1.3.71
@@ -387,3 +427,4 @@ _2019-06-03_
  [rfc_2045]: https://tools.ietf.org/html/rfc2045
  [rfc_7231_647]: https://tools.ietf.org/html/rfc7231#section-6.4.7
  [rfc_7692]: https://tools.ietf.org/html/rfc7692
+ [semver]: https://semver.org/

README.md

@@ -102,7 +102,7 @@ Our [change log][changelog] has release history.
 The latest release is available on [Maven Central](https://search.maven.org/artifact/com.squareup.okhttp3/okhttp/4.6.0/jar).
 
 ```kotlin
-implementation("com.squareup.okhttp3:okhttp:4.6.0")
+implementation("com.squareup.okhttp3:okhttp:4.7.0")
 ```
 
 Snapshot builds are [available][snap]. [R8 and ProGuard][r8_proguard] rules are available.
@@ -116,7 +116,7 @@ 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/4.6.0/jar).
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:mockwebserver:4.6.0")
+testImplementation("com.squareup.okhttp3:mockwebserver:4.7.0")
 ```
 
 License

build.gradle

@@ -89,7 +89,7 @@ ext.publishedArtifactId = { project ->
 allprojects {
   group = 'com.squareup.okhttp3'
   project.ext.artifactId = rootProject.ext.publishedArtifactId(project)
-  version = '4.7.0-SNAPSHOT'
+  version = '4.7.0'
 
   repositories {
     mavenCentral()

docs/changelog_3x.md

@@ -1,6 +1,15 @@
 OkHttp 3.x Change Log
 =====================
 
+## Version 3.14.9
+
+_2020-05-17_
+
+ *  Fix: Don't crash when running as a plugin in Android Studio Canary 4.1. To enable
+    platform-specific TLS features OkHttp must detect whether it's running in a JVM or in Android.
+    The upcoming Android Studio runs in a JVM but has classes from Android and that confused OkHttp!
+
+
 ## Version 3.14.8
 
 _2020-04-28_
@@ -209,6 +218,15 @@ _2019-02-04_
  *  New: Log the TLS handshake in `LoggingEventListener`.
 
 
+## Version 3.12.12
+
+_2020-05-17_
+
+ *  Fix: Don't crash when running as a plugin in Android Studio Canary 4.1. To enable
+    platform-specific TLS features OkHttp must detect whether it's running in a JVM or in Android.
+    The upcoming Android Studio runs in a JVM but has classes from Android and that confused OkHttp!
+
+
 ## Version 3.12.11
 
 _2020-04-28_

mockwebserver/README.md

@@ -142,7 +142,7 @@ server.setDispatcher(dispatcher);
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:mockwebserver:4.6.0")
+testImplementation("com.squareup.okhttp3:mockwebserver:4.7.0")
 ```
 
 ### License

okhttp-brotli/README.md

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

okhttp-dnsoverhttps/README.md

@@ -7,5 +7,5 @@ API is not considered stable and may change at any time.
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:okhttp-dnsoverhttps:4.6.0")
+testImplementation("com.squareup.okhttp3:okhttp-dnsoverhttps:4.7.0")
 ```

okhttp-logging-interceptor/README.md

@@ -37,7 +37,7 @@ Download
 --------
 
 ```kotlin
-implementation("com.squareup.okhttp3:logging-interceptor:4.6.0")
+implementation("com.squareup.okhttp3:logging-interceptor:4.7.0")
 ```
 
 

okhttp-sse/README.md

@@ -7,5 +7,5 @@ API is not considered stable and may change at any time.
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:okhttp-sse:4.6.0")
+testImplementation("com.squareup.okhttp3:okhttp-sse:4.7.0")
 ```

okhttp-tls/README.md

@@ -227,7 +227,7 @@ Download
 --------
 
 ```kotlin
-implementation("com.squareup.okhttp3:okhttp-tls:4.6.0")
+implementation("com.squareup.okhttp3:okhttp-tls:4.7.0")
 ```
 
  [held_certificate]: http://square.github.io/okhttp/4.x/okhttp-tls/okhttp3.tls/-held-certificate/

okhttp-urlconnection/README.md

@@ -6,5 +6,5 @@ This module integrates OkHttp with `Authenticator` and `CookieHandler` from `jav
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:okhttp-urlconnection:4.6.0")
+testImplementation("com.squareup.okhttp3:okhttp-urlconnection:4.7.0")
 ```