Update KMP Compatibility Guide for 1.9.20

[dsavvinov]

No description provided.

[martinbonnin]

I think where this falls short is tests? Suppose you had a common test suite that tested both ktor and okhttp clients. The code in the tests is all the same, it just expects a HTTP client:

// commonMain
interface HttpClient { ... }
expect fun HttpClient(): HttpClient

// commonTest
@Test 
fun testClient() {
  assertThat(HttpClient().get("https://...").data).isEqualsTo("Hello World")
}

With multiple JVM targets, it was only a matter of defining 2 actuals:

// ktorMain
actual fun HttpClient() = KtorHttpClient()

// okHttpMain
actual fun HttpClient() = OkHttpClient()

Now with different Gradle projects, how would one do this? expect/actual do not cross Gradle projects boundaries. And duplicating the test code doesn't feel great. Any thoughts?

[dsavvinov]

That's true. The brutally honest description for this deprecation would've been something like: "if you've encountered this deprecation, and you don't see an easy way to migrate your project, then reach us and tell more about your case".

But that would be a bit unfriendly, so we tried our best to provide some intrsuctions which applicable at least in some cases. It is expected that these instructions miss some cases, and we'll be happy to learn if someone encounters such cases in real projects

[martinbonnin]

We actually have this exact expect/actual scenario in this integration test. I've turned this problem upside down but still not sure how to convert. Any guidance would be super welcome.

[martinbonnin]

Just took another look at it. In the current state, it's working with a single JVM target and 2 compilations but shows this warning:

w: Kotlin Source Set 'ktorTest' can't depend on 'commonTest' as they are from different Source Set Trees.
Please remove this dependency edge.

I'm not sure how to remove the common source set without breaking the expect/actual

[dsavvinov]

Please take a loot at my comment about forms of verbs in deprecation timeline sections and about "similat target types". Everything else is a minor