Skip to content

Commit

Permalink
Adjust debugging documentation (Kotlin#3062)
Browse files Browse the repository at this point in the history
* Do not mention obsolete gradle-aspectj-android plugin at all
* Fix broken links

Addresses Kotlin#3060
  • Loading branch information
qwwdfsad committed Dec 10, 2021
1 parent 19cefbf commit dc0e9d6
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 12 deletions.
11 changes: 2 additions & 9 deletions docs/topics/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@
* [Stacktrace recovery](#stacktrace-recovery)
* [Stacktrace recovery machinery](#stacktrace-recovery-machinery)
* [Debug agent](#debug-agent)
* [Debug agent and Android](#debug-agent-and-android)
* [Android optimization](#android-optimization)

<!--- END -->
Expand Down Expand Up @@ -77,12 +76,6 @@ additionally enhancing stacktraces with information where coroutine was created.

The full tutorial of how to use debug agent can be found in the corresponding [readme](../../kotlinx-coroutines-debug/README.md).

### Debug agent and Android

Unfortunately, Android runtime does not support Instrument API necessary for `kotlinx-coroutines-debug` to function, triggering `java.lang.NoClassDefFoundError: Failed resolution of: Ljava/lang/management/ManagementFactory;`.

Nevertheless, it will be possible to support debug agent on Android as soon as [GradleAspectJ-Android](https://github.com/Archinamon/android-gradle-aspectj) will support android-gradle 3.3

<!---
Make an exception googlable
java.lang.NoClassDefFoundError: Failed resolution of: Ljava/lang/management/ManagementFactory;
Expand All @@ -98,8 +91,8 @@ java.lang.NoClassDefFoundError: Failed resolution of: Ljava/lang/management/Mana
## Android optimization

In optimized (release) builds with R8 version 1.6.0 or later both
[Debugging mode](../../docs/debugging.md#debug-mode) and
[Stacktrace recovery](../../docs/debugging.md#stacktrace-recovery)
[Debugging mode](debugging.md#debug-mode) and
[Stacktrace recovery](debugging.md#stacktrace-recovery)
are permanently turned off.
For more details see ["Optimization" section for Android](../../ui/kotlinx-coroutines-android/README.md#optimization).

Expand Down
5 changes: 2 additions & 3 deletions kotlinx-coroutines-debug/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,9 +154,8 @@ of the dump programmatically.

### Debug agent and Android

Unfortunately, Android runtime does not support Instrument API necessary for `kotlinx-coroutines-debug` to function, triggering `java.lang.NoClassDefFoundError: Failed resolution of: Ljava/lang/management/ManagementFactory;`.

Nevertheless, it will be possible to support debug agent on Android as soon as [GradleAspectJ-Android](https://github.com/Archinamon/android-gradle-aspectj) will support android-gradle 3.3
Android runtime does not support Instrument API necessary for `kotlinx-coroutines-debug` to function, triggering `java.lang.NoClassDefFoundError: Failed resolution of: Ljava/lang/management/ManagementFactory;`,
and it is not possible to use coroutine debugger along with Android emulator.

<!---
Make an exception googlable
Expand Down

0 comments on commit dc0e9d6

Please sign in to comment.