Add Commands Window for running ADB and shell commands

Author: DiannaUnity

com.unity.mobile.android-logcat/Editor/AndroidLogcatAdbCommandCatalog.cs

@@ -0,0 +1,148 @@
+namespace Unity.Android.Logcat
+{
+    internal static class AndroidLogcatAdbCommandCatalog
+    {
+        internal static readonly AndroidLogcatCommandEntry[] All = new[]
+        {
+            // --- Device Management ---
+            new AndroidLogcatCommandEntry("List Devices", "adb devices"),
+            new AndroidLogcatCommandEntry("List Devices (Verbose)", "adb devices -l"),
+            new AndroidLogcatCommandEntry("Start Server", "adb start-server"),
+            new AndroidLogcatCommandEntry("Kill Server", "adb kill-server"),
+            new AndroidLogcatCommandEntry("Reboot Device", "adb reboot"),
+            new AndroidLogcatCommandEntry("Reboot to Bootloader", "adb reboot bootloader"),
+            new AndroidLogcatCommandEntry("Reboot to Recovery", "adb reboot recovery"),
+            new AndroidLogcatCommandEntry("Get Device State", "adb get-state"),
+            new AndroidLogcatCommandEntry("Get Serial Number", "adb get-serialno"),
+            new AndroidLogcatCommandEntry("Wait for Device", "adb wait-for-device"),
+
+            // --- App Management ---
+            new AndroidLogcatCommandEntry("List All Packages", "adb shell pm list packages"),
+            new AndroidLogcatCommandEntry("List Third-Party Packages", "adb shell pm list packages -3"),
+            new AndroidLogcatCommandEntry("List System Packages", "adb shell pm list packages -s"),
+            new AndroidLogcatCommandEntry("Clear App Data", "adb shell pm clear <package>"),
+            new AndroidLogcatCommandEntry("Force Stop App", "adb shell am force-stop <package>"),
+            new AndroidLogcatCommandEntry("Start Activity", "adb shell am start -n <package/activity>"),
+            new AndroidLogcatCommandEntry("Start App (Launcher)", "adb shell monkey -p <package> -c android.intent.category.LAUNCHER 1"),
+            new AndroidLogcatCommandEntry("Start App (UnityPlayerActivity)", "adb shell am start -n <package>/com.unity3d.player.UnityPlayerActivity"),
+            new AndroidLogcatCommandEntry("Start App (GameActivity)", "adb shell am start -n <package>/com.google.androidgamesdk.GameActivity"),
+            new AndroidLogcatCommandEntry("Uninstall App", "adb uninstall <package>"),
+            new AndroidLogcatCommandEntry("Install APK", "adb install <path.apk>"),
+            new AndroidLogcatCommandEntry("Install APK (Replace)", "adb install -r <path.apk>"),
+            new AndroidLogcatCommandEntry("Install Multiple APKs (Split)", "adb install-multiple -r <path1.apk> <path2.apk>"),
+            new AndroidLogcatCommandEntry("Push OBB File", "adb push <local.obb> /sdcard/Android/obb/<package>/"),
+            new AndroidLogcatCommandEntry("Create OBB Directory", "adb shell mkdir -p /sdcard/Android/obb/<package>"),
+            new AndroidLogcatCommandEntry("Grant Permission", "adb shell pm grant <package> <permission>"),
+            new AndroidLogcatCommandEntry("Revoke Permission", "adb shell pm revoke <package> <permission>"),
+            new AndroidLogcatCommandEntry("Dump App Info", "adb shell dumpsys package <package>"),
+
+            // --- File Transfer ---
+            new AndroidLogcatCommandEntry("Push File to Device", "adb push <local> <remote>"),
+            new AndroidLogcatCommandEntry("Pull File from Device", "adb pull <remote> <local>"),
+            new AndroidLogcatCommandEntry("List Directory", "adb shell ls -la <path>"),
+            new AndroidLogcatCommandEntry("Remove File", "adb shell rm <path>"),
+            new AndroidLogcatCommandEntry("Make Directory", "adb shell mkdir -p <path>"),
+
+            // --- Logcat ---
+            new AndroidLogcatCommandEntry("View Logcat", "adb logcat"),
+            new AndroidLogcatCommandEntry("Clear Logcat", "adb logcat -c"),
+            new AndroidLogcatCommandEntry("Dump Logcat & Exit", "adb logcat -d"),
+            new AndroidLogcatCommandEntry("Logcat Errors Only", "adb logcat *:E"),
+            new AndroidLogcatCommandEntry("Logcat Warnings & Above", "adb logcat *:W"),
+            new AndroidLogcatCommandEntry("Logcat with Timestamps", "adb logcat -v time"),
+            new AndroidLogcatCommandEntry("Logcat by Tag", "adb logcat -s <TAG>"),
+            new AndroidLogcatCommandEntry("Logcat Unity Only", "adb logcat -s Unity"),
+
+            // --- Screen Capture ---
+            new AndroidLogcatCommandEntry("Take Screenshot", "adb shell screencap /sdcard/screenshot.png"),
+            new AndroidLogcatCommandEntry("Record Screen", "adb shell screenrecord /sdcard/recording.mp4"),
+            new AndroidLogcatCommandEntry("Record Screen (30s)", "adb shell screenrecord --time-limit 30 /sdcard/recording.mp4"),
+
+            // --- System Info ---
+            new AndroidLogcatCommandEntry("Get Android Version", "adb shell getprop ro.build.version.release"),
+            new AndroidLogcatCommandEntry("Get SDK Version", "adb shell getprop ro.build.version.sdk"),
+            new AndroidLogcatCommandEntry("Get Device Model", "adb shell getprop ro.product.model"),
+            new AndroidLogcatCommandEntry("Get Device Manufacturer", "adb shell getprop ro.product.manufacturer"),
+            new AndroidLogcatCommandEntry("Get All Properties", "adb shell getprop"),
+            new AndroidLogcatCommandEntry("Get Screen Resolution", "adb shell wm size"),
+            new AndroidLogcatCommandEntry("Get Screen Density", "adb shell wm density"),
+            new AndroidLogcatCommandEntry("Get Battery Info", "adb shell dumpsys battery"),
+            new AndroidLogcatCommandEntry("Get CPU Info", "adb shell cat /proc/cpuinfo"),
+            new AndroidLogcatCommandEntry("Get Memory Info", "adb shell cat /proc/meminfo"),
+            new AndroidLogcatCommandEntry("Get Disk Usage", "adb shell df"),
+            new AndroidLogcatCommandEntry("Get Running Processes", "adb shell ps"),
+            new AndroidLogcatCommandEntry("Get Top Processes", "adb shell top -n 1"),
+            new AndroidLogcatCommandEntry("Get Build Properties", "adb shell cat /system/build.prop"),
+
+            // --- Input Simulation ---
+            new AndroidLogcatCommandEntry("Send Keyevent (Home)", "adb shell input keyevent KEYCODE_HOME"),
+            new AndroidLogcatCommandEntry("Send Keyevent (Back)", "adb shell input keyevent KEYCODE_BACK"),
+            new AndroidLogcatCommandEntry("Send Keyevent (Menu)", "adb shell input keyevent KEYCODE_MENU"),
+            new AndroidLogcatCommandEntry("Send Keyevent (Power)", "adb shell input keyevent KEYCODE_POWER"),
+            new AndroidLogcatCommandEntry("Send Keyevent (Volume Up)", "adb shell input keyevent KEYCODE_VOLUME_UP"),
+            new AndroidLogcatCommandEntry("Send Keyevent (Volume Down)", "adb shell input keyevent KEYCODE_VOLUME_DOWN"),
+            new AndroidLogcatCommandEntry("Send Keyevent (Enter)", "adb shell input keyevent KEYCODE_ENTER"),
+            new AndroidLogcatCommandEntry("Send Keyevent (Tab)", "adb shell input keyevent KEYCODE_TAB"),
+            new AndroidLogcatCommandEntry("Send Text", "adb shell input text <text>"),
+            new AndroidLogcatCommandEntry("Tap Screen", "adb shell input tap <x> <y>"),
+            new AndroidLogcatCommandEntry("Swipe Screen", "adb shell input swipe <x1> <y1> <x2> <y2>"),
+
+            // --- Networking ---
+            new AndroidLogcatCommandEntry("Enable WiFi ADB", "adb tcpip 5555"),
+            new AndroidLogcatCommandEntry("Connect via IP", "adb connect <ip>:5555"),
+            new AndroidLogcatCommandEntry("Disconnect All", "adb disconnect"),
+            new AndroidLogcatCommandEntry("Forward Port", "adb forward tcp:<local> tcp:<remote>"),
+            new AndroidLogcatCommandEntry("Reverse Port", "adb reverse tcp:<remote> tcp:<local>"),
+            new AndroidLogcatCommandEntry("Get IP Address", "adb shell ip addr show wlan0"),
+            new AndroidLogcatCommandEntry("Ping Host", "adb shell ping -c 4 <host>"),
+
+            // --- Dumpsys ---
+            new AndroidLogcatCommandEntry("Dump Activity Stack", "adb shell dumpsys activity activities"),
+            new AndroidLogcatCommandEntry("Dump Memory Info", "adb shell dumpsys meminfo"),
+            new AndroidLogcatCommandEntry("Dump Window Info", "adb shell dumpsys window"),
+            new AndroidLogcatCommandEntry("Dump Display Info", "adb shell dumpsys display"),
+            new AndroidLogcatCommandEntry("Dump CPU Info", "adb shell dumpsys cpuinfo"),
+            new AndroidLogcatCommandEntry("Dump Battery Stats", "adb shell dumpsys batterystats"),
+            new AndroidLogcatCommandEntry("Dump SurfaceFlinger", "adb shell dumpsys SurfaceFlinger"),
+            new AndroidLogcatCommandEntry("Dump Graphics Stats", "adb shell dumpsys gfxinfo <package>"),
+            new AndroidLogcatCommandEntry("Dump Wifi Info", "adb shell dumpsys wifi"),
+            new AndroidLogcatCommandEntry("Dump Alarm Info", "adb shell dumpsys alarm"),
+            new AndroidLogcatCommandEntry("Dump Notification Info", "adb shell dumpsys notification"),
+
+            // --- Settings ---
+            new AndroidLogcatCommandEntry("Enable Stay Awake", "adb shell settings put global stay_on_while_plugged_in 3"),
+            new AndroidLogcatCommandEntry("Disable Stay Awake", "adb shell settings put global stay_on_while_plugged_in 0"),
+            new AndroidLogcatCommandEntry("Show Touches On", "adb shell settings put system show_touches 1"),
+            new AndroidLogcatCommandEntry("Show Touches Off", "adb shell settings put system show_touches 0"),
+            new AndroidLogcatCommandEntry("Enable USB Debugging", "adb shell settings put global adb_enabled 1"),
+            new AndroidLogcatCommandEntry("Set Screen Off Timeout", "adb shell settings put system screen_off_timeout <ms>"),
+
+            // --- Debug / Advanced ---
+            new AndroidLogcatCommandEntry("Bug Report", "adb bugreport"),
+            new AndroidLogcatCommandEntry("Remount System", "adb remount"),
+            new AndroidLogcatCommandEntry("Root Shell", "adb root"),
+            new AndroidLogcatCommandEntry("Unroot Shell", "adb unroot"),
+            new AndroidLogcatCommandEntry("Disable Verity", "adb disable-verity"),
+            new AndroidLogcatCommandEntry("Enable Verity", "adb enable-verity"),
+            new AndroidLogcatCommandEntry("Wait for Device Boot", "adb wait-for-device shell getprop sys.boot_completed"),
+            new AndroidLogcatCommandEntry("List Tombstones", "adb shell ls -lt /data/tombstones/"),
+            new AndroidLogcatCommandEntry("Pull Tombstone", "adb pull /data/tombstones/<tombstone_XX> <local_path>"),
+
+            // --- Meta Quest / XR ---
+            new AndroidLogcatCommandEntry("List OVR Packages", "adb shell pm list packages | grep oculus"),
+            new AndroidLogcatCommandEntry("Get Guardian State", "adb shell dumpsys OVRGuardianService"),
+            new AndroidLogcatCommandEntry("Get Compositor Stats", "adb shell dumpsys OVRCompositor"),
+            new AndroidLogcatCommandEntry("Set GPU Level", "adb shell setprop debug.oculus.gpuLevel <0-4>"),
+            new AndroidLogcatCommandEntry("Set CPU Level", "adb shell setprop debug.oculus.cpuLevel <0-4>"),
+            new AndroidLogcatCommandEntry("Enable Perf Overlay", "adb shell setprop debug.oculus.enablePerfOverlay 1"),
+            new AndroidLogcatCommandEntry("Disable Perf Overlay", "adb shell setprop debug.oculus.enablePerfOverlay 0"),
+            new AndroidLogcatCommandEntry("Set Fixed Foveation", "adb shell setprop debug.oculus.foveation.level <0-4>"),
+            new AndroidLogcatCommandEntry("Set Refresh Rate", "adb shell setprop debug.oculus.refreshRate <72|90|120>"),
+
+            // --- AAB / Bundletool ---
+            new AndroidLogcatCommandEntry("bundletool: Build Split APKs", "java -jar bundletool.jar build-apks --bundle=<path.aab> --output=<output.apks> --connected-device"),
+            new AndroidLogcatCommandEntry("bundletool: Install APKs", "java -jar bundletool.jar install-apks --apks=<path.apks>"),
+            new AndroidLogcatCommandEntry("bundletool: Get Device Spec", "java -jar bundletool.jar get-device-spec --output=<device-spec.json>"),
+        };
+    }
+}

com.unity.mobile.android-logcat/Editor/AndroidLogcatAdbCommandCatalog.cs.meta

@@ -0,0 +1,71 @@
+using System;
+using UnityEditor;
+using UnityEngine;
+
+namespace Unity.Android.Logcat
+{
+    internal class AndroidLogcatAddCommandDialog : EditorWindow
+    {
+        string m_Name = "";
+        string m_Command = "";
+        Action<AndroidLogcatCommandEntry> m_OnSave;
+        bool m_IsEdit;
+        Vector2 m_ScrollPos;
+
+        internal static void Show(Action<AndroidLogcatCommandEntry> onSave, AndroidLogcatCommandEntry existing = null)
+        {
+            var wnd = CreateInstance<AndroidLogcatAddCommandDialog>();
+            wnd.titleContent = new GUIContent(existing != null ? "Edit Command" : "Add Command");
+            wnd.m_OnSave = onSave;
+            wnd.minSize = new Vector2(400, 200);
+            wnd.maxSize = new Vector2(600, 400);
+
+            if (existing != null)
+            {
+                wnd.m_Name = existing.name;
+                wnd.m_Command = existing.command;
+                wnd.m_IsEdit = true;
+            }
+
+            wnd.ShowUtility();
+        }
+
+        void OnGUI()
+        {
+            EditorGUILayout.Space(8);
+
+            m_Name = EditorGUILayout.TextField("Name", m_Name);
+
+            EditorGUILayout.Space(4);
+            EditorGUILayout.LabelField("Commands", EditorStyles.boldLabel);
+            EditorGUILayout.LabelField("Enter one command per line. All commands run sequentially.",
+                EditorStyles.miniLabel);
+
+            m_ScrollPos = EditorGUILayout.BeginScrollView(m_ScrollPos, GUILayout.MinHeight(80), GUILayout.MaxHeight(200));
+            m_Command = EditorGUILayout.TextArea(m_Command, GUILayout.ExpandHeight(true));
+            EditorGUILayout.EndScrollView();
+
+            EditorGUILayout.Space(8);
+
+            EditorGUILayout.BeginHorizontal();
+            GUILayout.FlexibleSpace();
+
+            if (GUILayout.Button("Cancel", GUILayout.Width(80)))
+                Close();
+
+            if (GUILayout.Button(m_IsEdit ? "Save" : "Add", GUILayout.Width(80)))
+            {
+                if (string.IsNullOrWhiteSpace(m_Name) || string.IsNullOrWhiteSpace(m_Command))
+                {
+                    EditorUtility.DisplayDialog("Android Logcat", "Both name and command are required.", "OK");
+                    return;
+                }
+
+                m_OnSave?.Invoke(new AndroidLogcatCommandEntry(m_Name.Trim(), m_Command.Trim()));
+                Close();
+            }
+
+            EditorGUILayout.EndHorizontal();
+        }
+    }
+}

com.unity.mobile.android-logcat/Editor/AndroidLogcatAddCommandDialog.cs

@@ -0,0 +1,54 @@
+using System;
+using System.Collections.Generic;
+using UnityEngine;
+
+namespace Unity.Android.Logcat
+{
+    [Serializable]
+    internal class AndroidLogcatCommandEntry
+    {
+        [SerializeField] internal string name;
+        [SerializeField] internal string command;
+
+        internal AndroidLogcatCommandEntry() { }
+
+        internal AndroidLogcatCommandEntry(string name, string command)
+        {
+            this.name = name;
+            this.command = command;
+        }
+    }
+
+    [Serializable]
+    internal class AndroidLogcatCommandEntryList
+    {
+        public AndroidLogcatCommandEntry[] items = Array.Empty<AndroidLogcatCommandEntry>();
+    }
+
+    [Serializable]
+    internal class AndroidLogcatCommandExportData
+    {
+        public AndroidLogcatCommandEntry[] favorites = Array.Empty<AndroidLogcatCommandEntry>();
+        public AndroidLogcatCommandEntry[] general = Array.Empty<AndroidLogcatCommandEntry>();
+    }
+
+    internal static class AndroidLogcatCommandJsonHelper
+    {
+        internal static string ToJsonArray<T>(List<T> list)
+        {
+            var wrapper = new Wrapper<T> { items = list.ToArray() };
+            var json = JsonUtility.ToJson(wrapper);
+            var start = json.IndexOf('[');
+            var end = json.LastIndexOf(']');
+            if (start >= 0 && end > start)
+                return json.Substring(start, end - start + 1);
+            return "[]";
+        }
+
+        [Serializable]
+        private class Wrapper<T>
+        {
+            public T[] items;
+        }
+    }
+}

com.unity.mobile.android-logcat/Editor/AndroidLogcatAddCommandDialog.cs.meta

@@ -0,0 +1,106 @@
+using System.Collections.Generic;
+using System.Text;
+using UnityEditor;
+using UnityEngine;
+
+namespace Unity.Android.Logcat
+{
+    internal class AndroidLogcatCommandOutputWindow : EditorWindow
+    {
+        static AndroidLogcatCommandOutputWindow s_Instance;
+
+        Vector2 m_ScrollPos;
+        readonly List<OutputLine> m_Lines = new List<OutputLine>();
+        bool m_AutoScroll = true;
+        const int kMaxLines = 5000;
+
+        internal struct OutputLine
+        {
+            internal string text;
+            internal Color color;
+        }
+
+        internal static void Open(List<AndroidLogcatCommandsWindow.OutputLine> existingLines)
+        {
+            var wnd = GetWindow<AndroidLogcatCommandOutputWindow>();
+            wnd.titleContent = new GUIContent("Command Output");
+            wnd.minSize = new Vector2(500, 300);
+            s_Instance = wnd;
+
+            wnd.m_Lines.Clear();
+            if (existingLines != null)
+            {
+                foreach (var ol in existingLines)
+                    wnd.m_Lines.Add(new OutputLine { text = ol.text, color = ol.color });
+            }
+        }
+
+        internal static void AppendIfOpen(string text, Color color)
+        {
+            if (s_Instance == null)
+                return;
+            if (string.IsNullOrEmpty(text))
+                return;
+
+            foreach (var line in text.Split('\n'))
+            {
+                s_Instance.m_Lines.Add(new OutputLine { text = line, color = color });
+            }
+
+            while (s_Instance.m_Lines.Count > kMaxLines)
+                s_Instance.m_Lines.RemoveAt(0);
+
+            s_Instance.Repaint();
+        }
+
+        void OnEnable()
+        {
+            s_Instance = this;
+        }
+
+        void OnGUI()
+        {
+            EditorGUILayout.BeginHorizontal(EditorStyles.toolbar);
+            if (GUILayout.Button("Clear", EditorStyles.toolbarButton))
+                m_Lines.Clear();
+            if (GUILayout.Button("Copy All", EditorStyles.toolbarButton))
+                CopyAll();
+            GUILayout.FlexibleSpace();
+            m_AutoScroll = GUILayout.Toggle(m_AutoScroll, "Auto Scroll", EditorStyles.toolbarButton);
+            EditorGUILayout.EndHorizontal();
+
+            m_ScrollPos = EditorGUILayout.BeginScrollView(m_ScrollPos);
+
+            for (int i = 0; i < m_Lines.Count; i++)
+            {
+                var line = m_Lines[i];
+                var style = new GUIStyle(EditorStyles.label)
+                {
+                    wordWrap = true,
+                    richText = false
+                };
+                style.normal.textColor = line.color;
+                EditorGUILayout.LabelField(line.text, style);
+            }
+
+            EditorGUILayout.EndScrollView();
+
+            if (m_AutoScroll && Event.current.type == EventType.Repaint)
+                m_ScrollPos.y = float.MaxValue;
+        }
+
+        void CopyAll()
+        {
+            var sb = new StringBuilder();
+            foreach (var line in m_Lines)
+                sb.AppendLine(line.text);
+            EditorGUIUtility.systemCopyBuffer = sb.ToString();
+        }
+
+        void OnDestroy()
+        {
+            if (s_Instance == this)
+                s_Instance = null;
+        }
+    }
+}