diff options
| author | Kalle Lindström <karl.lindstrom@mullvad.net> | 2025-07-24 14:08:17 +0200 |
|---|---|---|
| committer | Kalle Lindström <karl.lindstrom@mullvad.net> | 2025-07-24 14:20:44 +0200 |
| commit | a7b764913235c236775ff326487bfbf87ec9b3a6 (patch) | |
| tree | cb948a7cc4b802a7784886f167ab2dac2348e87b /android/docs/DebugInstructions.md | |
| parent | 75fb47db0e7d0bf98e3add90865c238c049d565e (diff) | |
| download | mullvadvpn-a7b764913235c236775ff326487bfbf87ec9b3a6.tar.xz mullvadvpn-a7b764913235c236775ff326487bfbf87ec9b3a6.zip | |
Update Android native debug instructions
Diffstat (limited to 'android/docs/DebugInstructions.md')
| -rw-r--r-- | android/docs/DebugInstructions.md | 23 |
1 files changed, 15 insertions, 8 deletions
diff --git a/android/docs/DebugInstructions.md b/android/docs/DebugInstructions.md index 9faa5237b2..e76fe1fbc5 100644 --- a/android/docs/DebugInstructions.md +++ b/android/docs/DebugInstructions.md @@ -1,13 +1,20 @@ ## Debugging the native libraries in Android Studio with LLDB -1. In Android Studio, go to `Run -> Edit configurations...` -2. Make sure the `app` configuration is selected. -3. In the `Debugger` tab, select `Dual (Java + Native)` -4. Start debugging the app as usual from Android Studio. The app should now stop on a SIGURG signal. -5. Select the `LLDB` tab in the debugger. Now you can set breakpoints etc, e.g. - `breakpoint set -n open_tun` -6. Before continuing run `pro hand -p true -s false SIGURG` -7. Click `Resume Program` and the app will resume until the breakpoint is hit. +1. In `gradle.properties` or in your `$HOME/.gradle/gradle.properties` file set the following: + +``` +mullvad.app.build.keepDebugSymbols=true +mullvad.app.build.replaceRustPathPrefix=false +``` + +2. In Android Studio, go to `Run -> Edit configurations...` +3. Make sure the `app` configuration is selected. +4. In the `Debugger` tab, select `Dual (Java + Native)` +5. Start debugging the app as usual from Android Studio. +6. Click the `View Breakpoints...` icon in the debug view. +7. Click `+ -> Symbolic Breakpoints` and enter a function name in the `Symbol name` field. + +Android Studio should now break on the function you selected. NOTE: When running LLDB, Android Studio can sometimes get into a state where it will try to connect to the debugger when running the app normally, which blocks the app from starting. |
