Add: Waydroid emulator support

finch · finch · commit 307baf458c0a · 2025-09-11T14:41:30.000+08:00
diff --git a/module/config/argument/args.json b/module/config/argument/args.json
@@ -163,7 +163,8 @@
           "MuMuPlayer",
           "MuMuPlayerX",
           "MuMuPlayer12",
-          "MEmuPlayer"
+          "MEmuPlayer",
+          "Waydroid"
         ]
       },
       "name": {
diff --git a/module/config/argument/argument.yaml b/module/config/argument/argument.yaml
@@ -73,6 +73,7 @@ EmulatorInfo:
       MuMuPlayerX,
       MuMuPlayer12,
       MEmuPlayer,
+      Waydroid,
     ]
   name:
     value: null
diff --git a/module/config/config_generated.py b/module/config/config_generated.py
@@ -27,7 +27,7 @@ class GeneratedConfig:
     Emulator_AdbRestart = False
 
     # Group `EmulatorInfo`
-    EmulatorInfo_Emulator = 'auto'  # auto, NoxPlayer, NoxPlayer64, BlueStacks4, BlueStacks5, BlueStacks4HyperV, BlueStacks5HyperV, LDPlayer3, LDPlayer4, LDPlayer9, MuMuPlayer, MuMuPlayerX, MuMuPlayer12, MEmuPlayer
+    EmulatorInfo_Emulator = 'auto'  # auto, NoxPlayer, NoxPlayer64, BlueStacks4, BlueStacks5, BlueStacks4HyperV, BlueStacks5HyperV, LDPlayer3, LDPlayer4, LDPlayer9, MuMuPlayer, MuMuPlayerX, MuMuPlayer12, MEmuPlayer, Waydroid
     EmulatorInfo_name = None
     EmulatorInfo_path = None
 
diff --git a/module/config/i18n/en-US.json b/module/config/i18n/en-US.json
@@ -472,7 +472,8 @@
       "MuMuPlayer": "MuMu Player",
       "MuMuPlayerX": "MuMu Player X",
       "MuMuPlayer12": "MuMu Player 12",
-      "MEmuPlayer": "MEmu Player"
+      "MEmuPlayer": "MEmu Player",
+      "Waydroid": "Waydroid"
     },
     "name": {
       "name": "Emulator Instance Name",
diff --git a/module/config/i18n/ja-JP.json b/module/config/i18n/ja-JP.json
@@ -472,7 +472,8 @@
       "MuMuPlayer": "MuMuPlayer",
       "MuMuPlayerX": "MuMuPlayerX",
       "MuMuPlayer12": "MuMuPlayer12",
-      "MEmuPlayer": "MEmuPlayer"
+      "MEmuPlayer": "MEmuPlayer",
+      "Waydroid": "Waydroid"
     },
     "name": {
       "name": "EmulatorInfo.name.name",
diff --git a/module/config/i18n/zh-CN.json b/module/config/i18n/zh-CN.json
@@ -472,7 +472,8 @@
       "MuMuPlayer": "MuMu模拟器",
       "MuMuPlayerX": "MuMu模拟器X",
       "MuMuPlayer12": "MuMu模拟器12",
-      "MEmuPlayer": "逍遥模拟器"
+      "MEmuPlayer": "逍遥模拟器",
+      "Waydroid": "Waydroid模拟器"
     },
     "name": {
       "name": "模拟器实例名称",
@@ -2738,4 +2739,4 @@
       "ChooseFile": "选择文件"
     }
   }
-}
+}
diff --git a/module/config/i18n/zh-TW.json b/module/config/i18n/zh-TW.json
@@ -472,7 +472,8 @@
       "MuMuPlayer": "MuMu模擬器",
       "MuMuPlayerX": "MuMu模擬器X",
       "MuMuPlayer12": "MuMu模擬器12",
-      "MEmuPlayer": "逍遙模擬器"
+      "MEmuPlayer": "逍遙模擬器",
+      "Waydroid": "Waydroid模擬器"
     },
     "name": {
       "name": "模擬器實例名稱",
@@ -2738,4 +2739,4 @@
       "ChooseFile": "選擇檔案"
     }
   }
-}
+}
diff --git a/module/device/device.py b/module/device/device.py
@@ -3,7 +3,7 @@
 
 from lxml import etree
 
-from module.device.env import IS_WINDOWS
+from module.device.env import IS_LINUX, IS_WINDOWS
 # Patch pkg_resources before importing adbutils and uiautomator2
 from module.device.pkg_resources import get_distribution
 
@@ -89,7 +89,7 @@ def __init__(self, *args, **kwargs):
                     raise RequestHumanTakeover
 
         # Auto-fill emulator info
-        if IS_WINDOWS and self.config.EmulatorInfo_Emulator == 'auto':
+        if (IS_WINDOWS or IS_LINUX) and self.config.EmulatorInfo_Emulator == 'auto':
             _ = self.emulator_instance
 
         self.screenshot_interval_set()
diff --git a/module/device/platform/__init__.py b/module/device/platform/__init__.py
@@ -1,6 +1,8 @@
-from module.device.env import IS_WINDOWS
+from module.device.env import IS_LINUX, IS_WINDOWS
 
 if IS_WINDOWS:
     from module.device.platform.platform_windows import PlatformWindows as Platform
+elif IS_LINUX:
+    from module.device.platform.platform_linux import PlatformLinux as Platform
 else:
     from module.device.platform.platform_base import PlatformBase as Platform
diff --git a/module/device/platform/emulator_base.py b/module/device/platform/emulator_base.py
@@ -161,6 +161,7 @@ class EmulatorBase:
     MuMuPlayer12 = 'MuMuPlayer12'
     MuMuPlayerFamily = [MuMuPlayer, MuMuPlayerX, MuMuPlayer12]
     MEmuPlayer = 'MEmuPlayer'
+    Waydroid = 'Waydroid'
 
     @classmethod
     def path_to_type(cls, path: str) -> str:
diff --git a/module/device/platform/emulator_linux.py b/module/device/platform/emulator_linux.py
@@ -0,0 +1,180 @@
+import os
+import subprocess
+import typing as t
+
+# module/device/platform/emulator_base.py
+# module/device/platform/emulator_windows.py
+# Will be used in Alas Easy Install, they shouldn't import any Alas modules.
+from module.device.platform.emulator_base import (
+    EmulatorBase,
+    EmulatorInstanceBase,
+    EmulatorManagerBase,
+    remove_duplicated_path,
+)
+from module.device.platform.utils import cached_property
+
+
+def get_waydroid_ip() -> str:
+    """
+    Need to make sure waydroid is running
+
+    Returns:
+        waydroid IP address
+    """
+
+    """
+    $ waydroid --version
+    1.4.3
+    $ waydroid status
+    Session:	RUNNING
+    Container:	RUNNING
+    Vendor type:	MAINLINE
+    IP address:	192.168.240.112
+    Session user:	docker(1000)
+    Wayland display:	wayland-0
+    """
+    waydroid_status = subprocess.check_output(["waydroid", "status"], text=True)
+    ip_address_line = None
+    for line in waydroid_status.splitlines():
+        if line.startswith("IP address:"):
+            ip_address_line = line
+            break
+    if ip_address_line is None or ip_address_line.endswith("UNKNOWN"):
+        return "192.168.240.112"
+    return ip_address_line.removeprefix("IP address:").strip()
+
+
+class EmulatorInstance(EmulatorInstanceBase):
+    @cached_property
+    def emulator(self):
+        """
+        Returns:
+            Emulator:
+        """
+        return Emulator(self.path)
+
+
+class Emulator(EmulatorBase):
+    @classmethod
+    def path_to_type(cls, path: str) -> str:
+        """
+        Args:
+            path: Path to .exe file, case insensitive
+
+        Returns:
+            str: Emulator type, such as Emulator.NoxPlayer
+        """
+        folder, exe = os.path.split(path)
+        folder, dir1 = os.path.split(folder)
+        folder, dir2 = os.path.split(folder)
+        exe = exe.lower()
+        dir1 = dir1.lower()
+        dir2 = dir2.lower()
+
+        if exe == "waydroid":
+            return cls.Waydroid
+
+        return ""
+
+    def iter_instances(self):
+        """
+        Yields:
+            EmulatorInstance: Emulator instances found in this emulator
+        """
+        if self == Emulator.Waydroid:
+            # MuMu has no multi instances, on 7555 only
+            yield EmulatorInstance(
+                serial=f"{get_waydroid_ip()}:5555",
+                name="",
+                path=self.path,
+            )
+
+
+class EmulatorManager(EmulatorManagerBase):
+    @staticmethod
+    def get_install_emulator() -> list[str]:
+        """
+        Args:
+            path (str): f'SOFTWARE\\leidian\\ldplayer'
+            key (str): 'InstallDir'
+
+        Returns:
+            list[str]: Installation dir or None
+        """
+        result = []
+        exe = subprocess.check_output(
+            ["type", "-p", "waydroid"], shell="/usr/bin/bash", text=True
+        )
+        if os.path.exists(exe):
+            result.add(exe)
+
+        return result
+
+    @staticmethod
+    def iter_running_emulator():
+        """
+        Yields:
+            str: Path to emulator executables, may contains duplicate values
+        """
+        try:
+            import psutil
+        except ModuleNotFoundError:
+            return
+        # Since this is a one-time-usage, we access psutil._psplatform.Process directly
+        # to bypass the call of psutil.Process.is_running().
+        # This only costs about 0.017s.
+        for pid in psutil.pids():
+            proc = psutil._psplatform.Process(pid)
+            try:
+                exe = proc.cmdline()
+            except (psutil.AccessDenied, psutil.NoSuchProcess):
+                # psutil.AccessDenied
+                # NoSuchProcess: process no longer exists (pid=xxx)
+                continue
+
+            if len(exe) == 0:
+                continue
+            if len(exe) >= 1 and Emulator.is_emulator(exe[0]):
+                yield exe[0]
+            # /usr/bin/python3 /usr/bin/waydroid show-full-ui
+            if len(exe) >= 2 and Emulator.is_emulator(exe[1]):
+                yield exe[1]
+
+    @cached_property
+    def all_emulators(self) -> t.List[Emulator]:
+        """
+        Get all emulators installed on current computer.
+        """
+        exe = set([])
+
+        for file in EmulatorManager.get_install_emulator():
+            if Emulator.is_emulator(file) and os.path.exists(file):
+                exe.add(file)
+
+        # Running
+        for file in EmulatorManager.iter_running_emulator():
+            if os.path.exists(file):
+                exe.add(file)
+
+        # De-redundancy
+        exe = [Emulator(path).path for path in exe if Emulator.is_emulator(path)]
+        exe = [Emulator(path) for path in remove_duplicated_path(exe)]
+        return exe
+
+    @cached_property
+    def all_emulator_instances(self) -> t.List[EmulatorInstance]:
+        """
+        Get all emulator instances installed on current computer.
+        """
+        instances = []
+        for emulator in self.all_emulators:
+            instances += list(emulator.iter_instances())
+
+        instances: t.List[EmulatorInstance] = sorted(instances, key=lambda x: str(x))
+        return instances
+
+
+if __name__ == "__main__":
+    self = EmulatorManager()
+    for emu in self.all_emulator_instances:
+        print(emu)
diff --git a/module/device/platform/platform_linux.py b/module/device/platform/platform_linux.py

Original file line number	Diff line number	Diff line change
`@@ -73,6 +73,7 @@ EmulatorInfo:`
`73`	`73`	`MuMuPlayerX,`
`74`	`74`	`MuMuPlayer12,`
`75`	`75`	`MEmuPlayer,`
	`76`	`+ Waydroid,`
`76`	`77`	`]`
`77`	`78`	`name:`
`78`	`79`	`value: null`