Why wait for debugger and then attach debugger to process?

Question

What is the significance of

android.os.Debug.waitForDebugger();

I am aware that we [sometimes] need to use this function in order to debug a Service, but my question is:

• WHY do we have to do this?
• Why does this method exist? What other purpose does it serve?
• What does it mean to attach a debugger to a process, and why do we have to do this? Why does a Service have to be debugged in this way, and not an Activity or BroadcastReceiver?

One would think that debugging any kind of code in a project would be straightforward. Except it isn't. Not for a Service anyway.

What is the reason for the existence of this special procedure? And what else is it used for?

Wait until a debugger attaches. As soon as the debugger attaches, this returns, so you will need to place a breakpoint after the waitForDebugger() call if you want to start tracing immediately.

The WHY remains unanswered.

UPDATE:

I found one use case for this function: when an Android app is auto-restarted after the app process is killed. The process is killed when a runtime permission is toggled by the user in the app settings. More generally, an app process is killed & restarted whenever ...

android.os.Process.killProcess(android.os.Process.myPid());

is called.

To debug the app after process restart, you write android.os.Debug.waitForDebugger() in your code and then attach the debugger to the current process.

Android: how to debug app's start-up process.

This is one use case for this function.

References:

Debugging a service.

A proper way to Debug a Service in Android Studio?.

Breakpoint in service not working.

How to debug an Android Background Service?.

How to debug a Service?.

How to Attach debbuger to process from the first line without compile code every time.

you can attach a debugger after the app is already open.

Possibly related:

Accessibility service disabled upon each debug run

When using the Java debugger in Intellij what does “Drop Frame” mean?

Configure on-device developer options.

Test your service.

Force application to restart from first Activity.

Answer 1

I don't sure my answer would be right, because you might expect complicated insights inside. In reality, there is pretty straight forward process, to connect and intercept process responses.

• Why does this method exist? What other purpose does it serve?

As you can see, answering this question is pretty simple. Because of race condition during process interception, you will not be able to stop on your early break point, and should call waitForDebugger(). In most frequent places, like Service debugging and Application.

• What does it mean to "attach a debugger to a process", and why do we have to do this? Why does a Service have to be debugged in this way, and not an Activity or BroadcastReceiver?

It's another question and I don't sure about context here, but. We need to call the method, and attach to process manually for cases, where our Service using another process from a Manifest. Obviously debug bridge will set on the current active process with application, but since we can run Service from another process, we need to manually add it to debug bridge and wait for debug connection.