[REQ-24] iOS Inspector

.gitignore

@@ -63,4 +63,7 @@ Apps/Windows/inspector.exe
 Apps/Windows/Element.xml
 Framework/settings.conf.lock
 Framework/Built_In_Automation/Desktop/Linux/latest_app.txt
-**/linux_screen.png
+**/linux_screen.png
+**/ios_screen.png
+**/ios_ui.xml
+**/ui.xml

node_cli.py

@@ -38,7 +38,7 @@
 from Framework.install_handler.android.java import update_java_path
 from settings import ZEUZ_NODE_PRIVATE_RSA_KEYS_DIR
 from Framework.install_handler.long_poll_handler import InstallHandler
-from server.mobile import upload_android_ui_dump
+from server.mobile import upload_android_ui_dump, upload_ios_ui_dump
 from Framework.install_handler.android.android_sdk import update_android_sdk_path
 
 def adjust_python_path():
@@ -1348,6 +1348,7 @@ async def main():
     update_outdated_modules()
     asyncio.create_task(start_server())
     asyncio.create_task(upload_android_ui_dump())
+    asyncio.create_task(upload_ios_ui_dump())
     asyncio.create_task(delete_old_automationlog_folders())
     await destroy_session()
 

server/mobile.py

@@ -4,29 +4,48 @@
 import os
 import shutil
 import subprocess
+import base64
+import json
 from typing import Literal
+import asyncio
+import socket
+import xml.etree.ElementTree as ET
 
 import requests
 from androguard.core.apk import APK
 from fastapi import APIRouter, UploadFile, File
 from pydantic import BaseModel
 
+import sys
+import logging
 from Framework.Utilities import CommonUtil, ConfigModule
 from settings import ZEUZ_NODE_DOWNLOADS_DIR
 
+sys.path.append(os.path.join(os.path.dirname(__file__), '..', 'Framework', 'Built_In_Automation', 'Mobile', 'CrossPlatform', 'Appium'))
 ADB_PATH = "adb"  # Ensure ADB is in PATH
 UI_XML_PATH = "ui.xml"
 SCREENSHOT_PATH = "screen.png"
+IOS_SCREENSHOT_PATH = "ios_screen.png"
+IOS_XML_PATH = "ios_ui.xml"
 
 router = APIRouter(prefix="/mobile", tags=["mobile"])
 
 
+def is_wda_running(port: int) -> bool:
+    """Check if WebDriverAgent is running on given port."""
+    try:
+        response = requests.get(f"http://localhost:{port}/status", timeout=1)
+        return response.status_code == 200
+    except:
+        return False
+
+
 class InspectorResponse(BaseModel):
     """Response model for the /inspector endpoint."""
-
     status: Literal["ok", "error"] = "ok"
     ui_xml: str | None = None
     screenshot: str | None = None  # Base64 encoded image
+    bundle_identifier: str | None = None
     error: str | None = None
 
 
@@ -36,8 +55,15 @@ class DeviceInfo(BaseModel):
     serial: str
     status: str
     name: str | None = None
-    # model: str | None = None
-    # product: str | None = None
+
+
+class IOSDeviceInfo(BaseModel):
+    """Model for iOS device information."""
+    udid: str
+    name: str
+    state: str
+    runtime: str
+    device_type: str
 
 
 @router.get("/devices", response_model=list[DeviceInfo])
@@ -68,6 +94,35 @@ def get_devices():
         return []
 
 
+@router.get("/ios/devices", response_model=list[IOSDeviceInfo])
+def get_ios_devices():
+    """Get list of booted iOS simulators only."""
+    try:
+        result = subprocess.run(
+            ["xcrun", "simctl", "list", "devices", "-j"],
+            capture_output=True, text=True, check=True
+        )
+
+        devices_data = json.loads(result.stdout)
+        ios_devices = []
+
+        for runtime, devices in devices_data.get("devices", {}).items():
+            for device in devices:
+                # Only return booted devices
+                if device.get("isAvailable", False) and device.get("state") == "Booted":
+                    ios_devices.append(IOSDeviceInfo(
+                        udid=device["udid"],
+                        name=device["name"],
+                        state=device["state"],
+                        runtime=runtime,
+                        device_type=device.get("deviceTypeIdentifier", "Unknown")
+                    ))
+
+        return ios_devices
+    except Exception as e:
+        return []
+
+
 @router.get("/inspect")
 def inspect(device_serial: str | None = None):
     """Get the Mobile DOM and screenshot."""
@@ -92,6 +147,98 @@ def inspect(device_serial: str | None = None):
         return InspectorResponse(status="error", error=str(e))
 
 
+
+@router.post("/ios/start-services")
+def start_ios_services():
+    try:
+        ios_devices = get_ios_devices()
+        if not ios_devices:
+            return {"status": "error", "error": "No booted iOS simulators"}
+
+        device_udid = ios_devices[0].udid
+
+        # Check if WDA is already running
+        wda_port = 8100
+        tries = 0
+        while tries < 20:
+            if not is_wda_running(wda_port):
+                break
+            wda_port += 2
+            tries += 1
+
+        if tries >= 20:
+            return {"status": "error", "error": "No available WDA ports"}
+
+        result = subprocess.run(
+            ["xcrun", "simctl", "launch", device_udid, "com.facebook.WebDriverAgentRunner.xctrunner"],
+            capture_output=True, text=True
+        )
+
+        if result.returncode != 0:
+            return {"status": "error", "error": f"Failed to launch WDA."}
+
+        return {"status": "ok", "port": wda_port}
+
+    except Exception as e:
+        logging.exception("Failed to start iOS services")
+        return {"status": "error", "error": "Failed to start iOS services"}
+
+
+def extract_bundle_id_from_xml(xml_content: str) -> str | None:
+    try:
+        root = ET.fromstring(xml_content)
+        return root.get('bundleId')
+    except Exception:
+        return None
+
+
+@router.get("/ios/inspect")
+def inspect_ios(device_udid: str | None = None):
+    """Get iOS simulator screenshot and XML hierarchy."""
+    try:
+        if not device_udid:
+            ios_devices = get_ios_devices()
+            if not ios_devices:
+                return InspectorResponse(
+                    status="error",
+                    error="No iOS simulators available"
+                )
+
+            # Find first booted device
+            booted_devices = [d for d in ios_devices if d.state == "Booted"]
+            if not booted_devices:
+                return InspectorResponse(
+                    status="error",
+                    error="No booted iOS simulators found. Please start an iOS simulator."
+                )
+            device_udid = booted_devices[0].udid
+
+        capture_ios_ui_dump(device_udid)
+        capture_ios_screenshot(device_udid)
+
+        with open(IOS_XML_PATH, 'r', encoding='utf-8') as xml_file:
+            xml_content = xml_file.read()
+
+        # Extract bundle identifier from XML content
+        bundle_id = extract_bundle_id_from_xml(xml_content)
+
+        with open(IOS_SCREENSHOT_PATH, 'rb') as img_file:
+            screenshot_bytes = img_file.read()
+            screenshot_base64 = base64.b64encode(screenshot_bytes).decode('utf-8')
+
+        return InspectorResponse(
+            status="ok",
+            ui_xml=xml_content,
+            screenshot=screenshot_base64,
+            bundle_identifier=bundle_id
+        )
+    except Exception as e:
+        return InspectorResponse(
+            status="error",
+            error=str(e)
+        )
+
+
 @router.get("/dump/driver")
 def dump_driver():
     """Dump the current driver."""
@@ -167,6 +314,101 @@ def capture_screenshot(device_serial: str | None = None):
             return
 
 
+def capture_ios_screenshot(device_udid: str):
+    try:
+        screenshot_path = os.path.abspath(IOS_SCREENSHOT_PATH)
+
+        if os.path.exists(screenshot_path):
+            os.remove(screenshot_path)
+
+        result = subprocess.run(
+            ["xcrun", "simctl", "io", device_udid, "screenshot", "--type=png", screenshot_path],
+            capture_output=True, text=True, check=True
+        )
+
+        if not os.path.exists(screenshot_path):
+            raise Exception("Screenshot file was not created")
+
+        return True
+    except subprocess.CalledProcessError as e:
+        raise Exception(f"Failed to capture iOS screenshot: {e.stderr}")
+    except Exception as e:
+        raise Exception(f"Failed to capture iOS screenshot: {str(e)}")
+
+
+def get_real_ios_hierarchy(device_udid: str):
+    try:
+        import requests
+
+        wda_port = 8100
+        tries = 0
+
+        while tries < 20:
+            try:
+                wda_url = f"http://localhost:{wda_port}"
+
+                # Quick status check
+                status_response = requests.get(f"{wda_url}/status", timeout=1)
+                if status_response.status_code != 200:
+                    wda_port += 2
+                    tries += 1
+                    continue
+
+                # existing sessions first
+                sessions_response = requests.get(f"{wda_url}/sessions", timeout=1)
+                if sessions_response.status_code == 200:
+                    sessions = sessions_response.json()
+                    if sessions and len(sessions) > 0:
+                        session_id = sessions[0]['id']
+                        source_response = requests.get(f"{wda_url}/session/{session_id}/source", timeout=3)
+                        if source_response.status_code == 200:
+                            return source_response.text
+
+                # direct source
+                source_response = requests.get(f"{wda_url}/source", timeout=2)
+                if source_response.status_code == 200:
+                    return source_response.text
+
+            except:
+                wda_port += 2
+                tries += 1
+                continue
+
+    except:
+        pass
+
+    return None
+
+
+def capture_ios_ui_dump(device_udid: str):
+    real_hierarchy = get_real_ios_hierarchy(device_udid)
+    if real_hierarchy:
+        try:
+            import json
+            json_data = json.loads(real_hierarchy)
+            xml_content = json_data.get("value", real_hierarchy)
+        except:
+            xml_content = real_hierarchy
+
+        with open(IOS_XML_PATH, 'w', encoding='utf-8') as xml_file:
+            xml_file.write(xml_content)
+        return
+
+    # Fallback to Appium driver
+    try:
+        from Framework.Built_In_Automation.Mobile.CrossPlatform.Appium.BuiltInFunctions import appium_driver
+        if appium_driver is not None:
+            page_src = appium_driver.page_source
+            with open(IOS_XML_PATH, 'w', encoding='utf-8') as xml_file:
+                xml_file.write(page_src)
+            return
+    except:
+        pass
+
+    # No real source available
+    raise Exception("iOS service error. Make sure simulator is running.")
+
+
 async def upload_android_ui_dump():
     prev_xml_hash = ""
     while True:
@@ -214,6 +456,49 @@ async def upload_android_ui_dump():
         await asyncio.sleep(5)
 
 
+async def upload_ios_ui_dump():
+    prev_xml_hash = ""
+    while True:
+        try:
+            ios_devices = get_ios_devices()
+            if not ios_devices:
+                await asyncio.sleep(5)
+                continue
+
+            device_udid = ios_devices[0].udid
+            capture_ios_ui_dump(device_udid)
+
+            try:
+                with open(IOS_XML_PATH, 'r', encoding='utf-8') as xml_file:
+                    xml_content = xml_file.read()
+                    xml_content = xml_content.replace("<?xml version='1.0' encoding='UTF-8' standalone='yes' ?>", "", 1)
+                    new_xml_hash = hashlib.sha256(xml_content.encode('utf-8')).hexdigest()
+                    # Don't upload if the content hasn't changed
+                    if prev_xml_hash == new_xml_hash:
+                        await asyncio.sleep(5)
+                        continue
+                    prev_xml_hash = new_xml_hash
+
+            except FileNotFoundError:
+                await asyncio.sleep(5)
+                continue
+
+            url = ConfigModule.get_config_value("Authentication", "server_address").strip() + "/node_ai_contents/"
+            apiKey = ConfigModule.get_config_value("Authentication", "api-key").strip()
+            res = requests.post(
+                url,
+                headers={"X-Api-Key": apiKey},
+                json={
+                    "dom_mob": {"dom": xml_content},
+                    "node_id": CommonUtil.MachineInfo().getLocalUser().lower()
+                })
+            if res.ok:
+                CommonUtil.ExecLog("", "UI dump uploaded successfully", iLogLevel=1)
+        except Exception as e:
+            CommonUtil.ExecLog("", f"Error uploading iOS UI dump: {str(e)}", iLogLevel=3)
+        await asyncio.sleep(5)
+
+
 @router.post("/apk-upload")
 def handle_apk_upload(file: UploadFile = File(...)):
     dir_path = f"{ZEUZ_NODE_DOWNLOADS_DIR}/apk"