termux-app

1
package com.termux.shared.android;
2

3
import android.app.ActivityManager;
4
import android.content.Context;
5

6
import androidx.annotation.NonNull;
7
import androidx.annotation.Nullable;
8

9
import com.termux.shared.logger.Logger;
10

11
import java.util.List;
12

13
public class ProcessUtils {
14

15
    public static final String LOG_TAG = "ProcessUtils";
16

17
    /**
18
     * Get the app process name for a pid with a call to {@link ActivityManager#getRunningAppProcesses()}.
19
     *
20
     * This will not return child process names. Android did not keep track of them before android 12
21
     * phantom process addition, but there is no API via IActivityManager to get them.
22
     *
23
     * To get process name for pids of own app's child processes, check `get_process_name_from_cmdline()`
24
     * in `local-socket.cpp`.
25
     *
26
     * https://cs.android.com/android/platform/superproject/+/android-12.0.0_r32:frameworks/base/core/java/android/app/ActivityManager.java;l=3362
27
     * https://cs.android.com/android/platform/superproject/+/android-12.0.0_r32:frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java;l=8434
28
     * https://cs.android.com/android/_/android/platform/frameworks/base/+/refs/tags/android-12.0.0_r32:services/core/java/com/android/server/am/PhantomProcessList.java
29
     * https://cs.android.com/android/_/android/platform/frameworks/base/+/refs/tags/android-12.0.0_r32:services/core/java/com/android/server/am/PhantomProcessRecord.java
30
     *
31
     * @param context The {@link Context} for operations.
32
     * @param pid The pid of the process.
33
     * @return Returns the app process name if found, otherwise {@code null}.
34
     */
35
    @Nullable
36
    public static String getAppProcessNameForPid(@NonNull Context context, int pid) {
37
        if (pid < 0) return null;
38

39
        ActivityManager activityManager = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
40
        if (activityManager == null) return null;
41
        try {
42
            List<ActivityManager.RunningAppProcessInfo> runningApps = activityManager.getRunningAppProcesses();
43
            if (runningApps == null) {
44
                return null;
45
            }
46
            for (ActivityManager.RunningAppProcessInfo procInfo : runningApps) {
47
                if (procInfo.pid == pid) {
48
                    return procInfo.processName;
49
                }
50
            }
51
        } catch (Exception e) {
52
            Logger.logStackTraceWithMessage(LOG_TAG, "Failed to get app process name for pid " + pid, e);
53
        }
54

55
        return null;
56
    }
57

58
}
59