devicely 2.1.7 → 2.1.9

package/scripts/shell/android_device_control.sh

@@ -1,848 +0,0 @@
-#!/bin/bash
-# Android Device Control Script
-# Complete feature parity with iOS control
-# Uses UIAutomator2 for automation
-
-# Configuration
-UIAUTOMATOR2_PORT_BASE=6790
-SCRIPT_DIR="$(dirname "$0")"
-
-# Function to find config files in multiple locations
-find_config() {
-    local filename="$1"
-    local search_paths=(
-        "$SCRIPT_DIR/$filename"
-        "$SCRIPT_DIR/../../config/$filename"
-        "$SCRIPT_DIR/../config/$filename"
-        "$HOME/.devicely/$filename"
-        "/opt/homebrew/lib/node_modules/devicely/config/$filename"
-        "$(npm root -g 2>/dev/null)/devicely/config/$filename"
-    )
-    
-    for path in "${search_paths[@]}"; do
-        if [ -f "$path" ]; then
-            echo "$path"
-            return 0
-        fi
-    done
-    
-    return 1
-}
-
-# Find config files
-CONFIG_FILE=$(find_config "devices.conf")
-if [ -z "$CONFIG_FILE" ]; then
-    # Fallback to user home directory (created by postinstall)
-    if [ -f "$HOME/.devicely/devices.conf" ]; then
-        CONFIG_FILE="$HOME/.devicely/devices.conf"
-    else
-        echo "❌ Required file not found: devices.conf"
-        echo "   Searched in: script dir, config/, ~/.devicely/, global npm"
-        exit 1
-    fi
-fi
-
-APPS_PRESETS_FILE=$(find_config "apps_presets.conf")
-if [ -z "$APPS_PRESETS_FILE" ]; then
-    if [ -f "$HOME/.devicely/apps_presets.conf" ]; then
-        APPS_PRESETS_FILE="$HOME/.devicely/apps_presets.conf"
-    else
-        echo "❌ Required file not found: apps_presets.conf"
-        echo "   Searched in: script dir, config/, ~/.devicely/, global npm"
-        exit 1
-    fi
-fi
-
-# Session management (managed by backend server)
-SCRIPT_DIR_ABS="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# Use OS temp directory for session file - works for both local and npm package
-if [[ "$OSTYPE" == "darwin"* ]]; then
-    SESSION_MAP_FILE="$TMPDIR/devicely_android_sessions.map"
-else
-    SESSION_MAP_FILE="/tmp/devicely_android_sessions.map"
-fi
-ELEMENT_CACHE_FILE="/tmp/android_elements_cache.$$"
-DEVICE_PORTS_FILE="/tmp/android_multi_ports"
-
-# Color codes for output
-GREEN='\033[0;32m'
-RED='\033[0;31m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Cleanup on exit
-cleanup() {
-    [ "$DEBUG" = "1" ] && echo -e "${YELLOW}Cleaning up Android connections...${NC}"
-    # Don't kill port forwards - keep UIAutomator2 server running for performance
-    # if [ -f "$DEVICE_PORTS_FILE" ]; then
-    #     while IFS=: read -r serial port; do
-    #         adb -s "$serial" forward --remove tcp:$port 2>/dev/null
-    #     done < "$DEVICE_PORTS_FILE"
-    # fi
-    # Don't remove session map - reuse sessions for better performance
-    # rm -f "$SESSION_MAP_FILE" "$ELEMENT_CACHE_FILE" "$DEVICE_PORTS_FILE" 2>/dev/null
-}
-trap cleanup EXIT INT TERM
-
-# Check if UIAutomator2 session is available (managed by backend server)
-init_uiautomator2() {
-    local serial=$1
-    local port=${2:-8200}  # Default port if not specified
-    
-    # Check if device has active session from backend server
-    if [ -f "$SESSION_MAP_FILE" ]; then
-        local session_info=$(grep "^$serial:" "$SESSION_MAP_FILE" 2>/dev/null | tail -1)
-        if [ -n "$session_info" ]; then
-            # Format: udid:sessionId:port
-            # For IP:PORT format (100.87.246.132:5555:sessionId:port), we need the last field
-            local stored_port=$(echo "$session_info" | awk -F':' '{print $NF}')
-            
-            # Verify port is numeric
-            if [[ "$stored_port" =~ ^[0-9]+$ ]]; then
-                echo -e "${GREEN}✓ Using UIAutomator2 session (port $stored_port)${NC}"
-                return 0
-            else
-                echo -e "${YELLOW}⚠️  Invalid session format in file${NC}"
-            fi
-        fi
-    fi
-    
-    # No session found
-    echo -e "${RED}❌ No UIAutomator2 session found for $serial${NC}"
-    echo -e "${YELLOW}Please connect device first using the web UI 'Connect' button${NC}"
-    echo -e "${YELLOW}The UIAutomator2 session will be automatically started when you connect.${NC}"
-    return 1
-}
-
-# Get or create UIAutomator2 session
-get_session() {
-    local serial=$1
-    local port=$2
-    
-    # Check if session exists in persistent file (created by backend)
-    if [ -f "$SESSION_MAP_FILE" ]; then
-        local session_info=$(grep "^$serial:" "$SESSION_MAP_FILE" 2>/dev/null | tail -1)
-        if [ -n "$session_info" ]; then
-            # Format: udid:sessionId:port
-            # For IP:PORT udid (100.87.246.132:5555:sessionId:port), extract last 2 fields
-            local stored_port=$(echo "$session_info" | awk -F':' '{print $NF}')
-            local session_id=$(echo "$session_info" | awk -F':' '{print $(NF-1)}')
-            
-            # Verify port is numeric
-            if [[ ! "$stored_port" =~ ^[0-9]+$ ]]; then
-                echo -e "${RED}❌ Invalid session format${NC}" >&2
-                return 1
-            fi
-            
-            # Use the port from the backend
-            port=$stored_port
-            
-            # Verify session is still active
-            if curl -s "http://localhost:$port/wd/hub/session/$session_id/status" &>/dev/null 2>&1; then
-                echo "$session_id"
-                return 0
-            fi
-        fi
-    fi
-    
-    # No persistent session found - need to connect device first
-    echo -e "${RED}No active session for $serial${NC}" >&2
-    echo -e "${YELLOW}Please connect device first using the web UI 'Connect' button${NC}" >&2
-    return 1
-}
-
-# Launch app
-launch_app() {
-    local serial=$1
-    local port=$2
-    local package=$3
-    local activity=$4
-    
-    echo -e "${BLUE}Launching $package...${NC}"
-    
-    # Use ADB for faster launch
-    if [ -n "$activity" ]; then
-        adb -s "$serial" shell am start -n "$package/$activity"
-    else
-        adb -s "$serial" shell monkey -p "$package" -c android.intent.category.LAUNCHER 1
-    fi
-    
-    sleep 2
-    echo -e "${GREEN}✓ App launched${NC}"
-}
-
-# Open URL in default browser
-open_url() {
-    local serial=$1
-    local url=$2
-    
-    # Add https:// if not present
-    if ! echo "$url" | grep -qE '^[a-z]+://'; then
-        url="https://$url"
-    fi
-    
-    echo -e "${BLUE}Opening URL: $url${NC}"
-    adb -s "$serial" shell am start -a android.intent.action.VIEW -d "$url"
-    sleep 2
-    echo -e "${GREEN}✓ URL opened${NC}"
-}
-
-# Close app
-close_app() {
-    local serial=$1
-    local package=$2
-    
-    echo -e "${BLUE}Closing $package...${NC}"
-    adb -s "$serial" shell am force-stop "$package"
-    echo -e "${GREEN}✓ App closed${NC}"
-}
-
-# Get UI hierarchy
-get_ui_hierarchy() {
-    local serial=$1
-    local port=$2
-    local session_id=$3
-    
-    # Get page source from UIAutomator2
-    curl -s "http://localhost:$port/wd/hub/session/$session_id/source" | python3 -c '
-import sys, json
-try:
-    data = json.load(sys.stdin)
-    print(data.get("value", ""))
-except:
-    pass
-'
-}
-
-# Get locators from current screen
-get_locators() {
-    local serial=$1
-    
-    [ "$DEBUG" = "1" ] && echo "🔍 Getting all locators from current screen..."
-    
-    # Get port from session file
-    local port=""
-    if [ -f "$SESSION_MAP_FILE" ]; then
-        local session_info=$(grep "^$serial:" "$SESSION_MAP_FILE" 2>/dev/null | tail -1)
-        if [ -n "$session_info" ]; then
-            port=$(echo "$session_info" | awk -F':' '{print $NF}')
-        fi
-    fi
-    
-    if [ -z "$port" ]; then
-        [ "$DEBUG" = "1" ] && echo -e "${RED}❌ No active session found${NC}"
-        return 1
-    fi
-    
-    # Get existing session ID
-    local session_id=$(get_session "$serial" "$port")
-    
-    if [ -z "$session_id" ] || [ "$session_id" == "None" ]; then
-        [ "$DEBUG" = "1" ] && echo -e "${RED}❌ No active UIAutomator2 session${NC}"
-        return 1
-    fi
-    
-    [ "$DEBUG" = "1" ] && echo "📱 Using session: $session_id (port: $port)"
-    [ "$DEBUG" = "1" ] && echo "📱 Fetching page source..."
-    
-    # Get page source
-    local page_source=$(curl -s "http://localhost:$port/wd/hub/session/$session_id/source" 2>/dev/null)
-    
-    if [ -n "$page_source" ] && ! echo "$page_source" | grep -q '"error"'; then
-        [ "$DEBUG" = "1" ] && echo "🔍 Extracting locators..."
-        
-        # Save page source to temp file for Python to read
-        local temp_source="/tmp/android_source_$$.json"
-        echo "$page_source" > "$temp_source"
-        
-        # Extract all locator information using Python
-        python3 << PYTHON_SCRIPT
-import sys
-import json
-import xml.etree.ElementTree as ET
-
-try:
-    with open('$temp_source') as f:
-        data = json.load(f)
-    xml_str = data.get('value', '')
-    
-    if not xml_str or len(xml_str) < 10:
-        print('\n❌ No page source found or empty XML')
-        print('💡 This may be a Camera/Video/Game app that uses native rendering')
-        print('💡 Try using coordinate-based tapping: tap X,Y')
-        sys.exit(1)
-    
-    root = ET.fromstring(xml_str)
-    locators = []
-    
-    # Extract locators from all elements
-    for elem in root.iter():
-        locator_info = {}
-        
-        # Get element class
-        elem_class = elem.get('class', '')
-        if elem_class:
-            # Shorten Android class names
-            elem_class = elem_class.split('.')[-1]
-            locator_info['type'] = elem_class
-        
-        # Get text, content-desc, resource-id
-        text = elem.get('text', '')
-        content_desc = elem.get('content-desc', '')
-        resource_id = elem.get('resource-id', '')
-        
-        # Extract just the ID part from resource-id
-        if resource_id and ':id/' in resource_id:
-            resource_id = resource_id.split(':id/')[-1]
-        
-        if text:
-            locator_info['text'] = text
-        if content_desc:
-            locator_info['content-desc'] = content_desc
-        if resource_id:
-            locator_info['resource-id'] = resource_id
-        
-        # Get properties
-        clickable = elem.get('clickable', 'false')
-        enabled = elem.get('enabled', 'true')
-        focusable = elem.get('focusable', 'false')
-        
-        locator_info['clickable'] = clickable
-        locator_info['enabled'] = enabled
-        
-        # Get coordinates from bounds [x1,y1][x2,y2]
-        bounds = elem.get('bounds', '')
-        if bounds:
-            import re
-            match = re.match(r'\[(\d+),(\d+)\]\[(\d+),(\d+)\]', bounds)
-            if match:
-                x1, y1, x2, y2 = map(int, match.groups())
-                center_x = (x1 + x2) // 2
-                center_y = (y1 + y2) // 2
-                width = x2 - x1
-                height = y2 - y1
-                locator_info['bounds'] = f'({center_x},{center_y}) {width}x{height}'
-        
-        # Only add if we have meaningful locator information
-        if text or content_desc or resource_id:
-            locators.append(locator_info)
-    
-    # Print formatted output - only in DEBUG mode
-    if locators:
-        import os
-        debug = os.environ.get('DEBUG', '0') == '1'
-        if debug:
-            print(f'\n📋 Found {len(locators)} interactive elements:\n', file=sys.stderr)
-            print('=' * 120, file=sys.stderr)
-        
-        for i, loc in enumerate(locators, 1):
-            if debug:
-                # Build single line output with Name first
-                parts = []
-                
-                # Start with number and primary identifier
-                text = loc.get('text', '')
-                desc = loc.get('content-desc', '')
-                res_id = loc.get('resource-id', '')
-                
-                # Choose primary name (prefer text, then desc, then id)
-                primary_name = text or desc or res_id or '(no name)'
-                parts.append(f'{i:3d}. 📍 {primary_name:40s}')
-                
-                # Add Type
-                elem_type = loc.get('type', 'Unknown')
-                parts.append(f'[{elem_type:15s}]')
-                
-                # Add Label/Desc if different from primary name
-                if desc and desc != primary_name:
-                    parts.append(f'Label:{desc[:30]}{"..." if len(desc) > 30 else ""}')
-                
-                # Add Value/Text if different from primary
-                if text and text != primary_name and text != desc:
-                    parts.append(f'Val:{text[:20]}{"..." if len(text) > 20 else ""}')
-                
-                # Add resource ID if not primary
-                if res_id and res_id != primary_name:
-                    parts.append(f'ID:{res_id}')
-                
-                # Add Position
-                if loc.get('bounds'):
-                    parts.append(f'@ {loc["bounds"]}')
-                
-                # Add status flags
-                flags = []
-                if loc.get('enabled') == 'true':
-                    flags.append('✓En')
-                if loc.get('clickable') == 'true':
-                    flags.append('✓Click')
-                if flags:
-                    parts.append(' '.join(flags))
-                
-                print('  ' + ' │ '.join(parts), file=sys.stderr)
-        
-        if debug:
-            print('=' * 120, file=sys.stderr)
-    
-    # Output JSON to stdout (always, regardless of DEBUG)
-    import json
-    print(json.dumps(locators))
-    
-except ET.ParseError as e:
-    import os
-    debug = os.environ.get('DEBUG', '0') == '1'
-    if debug:
-        print(f'\n❌ Error parsing XML: {e}', file=sys.stderr)
-        print('💡 The page source may be corrupted or in unexpected format', file=sys.stderr)
-    sys.exit(1)
-except Exception as e:
-    import os
-    debug = os.environ.get('DEBUG', '0') == '1'
-    if debug:
-        print(f'\n❌ Error extracting locators: {e}', file=sys.stderr)
-    sys.exit(1)
-PYTHON_SCRIPT
-        
-        local exit_code=$?
-        
-        # Cleanup temp file only (keep session alive for reuse)
-        rm -f "$temp_source"
-        
-        if [ $exit_code -eq 0 ]; then
-            [ "$DEBUG" = "1" ] && echo -e "${GREEN}✅ Locators extraction complete${NC}"
-            return 0
-        else
-            echo -e "${YELLOW}⚠️  Locators extraction completed with warnings${NC}"
-            return 0
-        fi
-    else
-        echo -e "${RED}❌ Failed to get page source from device${NC}"
-        echo -e "${YELLOW}💡 Possible reasons:${NC}"
-        echo -e "  • Camera/Video apps don't expose UI to accessibility"
-        echo -e "  • Screen may be locked"
-        echo -e "  • UIAutomator2 server not responding"
-        echo ""
-        echo -e "${BLUE}💡 Try:${NC}"
-        echo -e "  1. screenshot - Take a screenshot"
-        echo -e "  2. tap X,Y - Use coordinate-based tapping"
-        echo -e "  3. home - Go to home screen first"
-        
-        # Cleanup session
-        curl -s -X DELETE "http://localhost:$port/wd/hub/session/$session_id" > /dev/null 2>&1
-        return 1
-    fi
-}
-
-# Helper function to find element with UIAutomator2
-find_element_uia2() {
-    local session_id=$1
-    local port=$2
-    local strategy=$3
-    local selector=$4
-    local temp_file="/tmp/uia2_find_$$.json"
-    
-    # Use correct JSON keys based on strategy type
-    if [[ "$strategy" == "xpath" ]]; then
-        # XPath uses 'using' and 'value'
-        curl -s -X POST "http://localhost:$port/wd/hub/session/$session_id/element" \
-            -H "Content-Type: application/json" \
-            -d "{\"using\": \"$strategy\", \"value\": \"$selector\"}" \
-            > "$temp_file" 2>/dev/null
-    else
-        # UIAutomator uses 'strategy' and 'selector'
-        curl -s -X POST "http://localhost:$port/wd/hub/session/$session_id/element" \
-            -H "Content-Type: application/json" \
-            -d "{\"strategy\": \"$strategy\", \"selector\": \"$selector\"}" \
-            > "$temp_file" 2>/dev/null
-    fi
-    
-    local element_id=$(python3 -c "
-import json
-try:
-    with open('$temp_file') as f:
-        data = json.load(f)
-    value = data.get('value', {})
-    elem = value.get('element-6066-11e4-a52e-4f735466cecf') or value.get('ELEMENT')
-    if elem:
-        print(elem)
-except:
-    pass
-" 2>/dev/null)
-    
-    rm -f "$temp_file"
-    echo "$element_id"
-}
-
-# Click element by text or coordinates
-click_element() {
-    local serial=$1
-    local port=$2
-    local target="$3"
-    
-    # Strip surrounding quotes if present (from UI commands like click "VPN")
-    target="${target#\"}"  # Remove leading "
-    target="${target%\"}"  # Remove trailing "
-    target="${target#\'}"  # Remove leading '
-    target="${target%\'}"  # Remove trailing '
-    
-    # Check if coordinates (x,y format)
-    if [[ "$target" =~ ^[0-9]+,[0-9]+$ ]]; then
-        local x=$(echo "$target" | cut -d',' -f1)
-        local y=$(echo "$target" | cut -d',' -f2)
-        
-        echo -e "${BLUE}Clicking at coordinates ($x, $y) using ADB...${NC}"
-        adb -s "$serial" shell input tap $x $y
-        echo -e "${GREEN}✓ Click completed${NC}"
-        return 0
-    fi
-    
-    # For text-based clicking, we need UIAutomator2
-    local session_id=$(get_session "$serial" "$port")
-    if [ -z "$session_id" ]; then
-        echo -e "${YELLOW}Tip: Use coordinates (x,y) to click without UIAutomator2${NC}"
-        return 1
-    fi
-    
-    # Find element by text
-    echo -e "${BLUE}🔎 Accessibility search: '$target'${NC}"
-    
-    # Try multiple strategies (like Appium Inspector)
-    local element_id=""
-    local response=""
-    
-    # Strategy 1: Android UiAutomator text (MOST RELIABLE - what Appium uses)
-    echo -e "${BLUE}  Strategy 1: UiAutomator text()...${NC}"
-    element_id=$(find_element_uia2 "$session_id" "$port" "-android uiautomator" "new UiSelector().text(\\\"$target\\\")")
-    [ -n "$element_id" ] && echo -e "${GREEN}  ✓ Found by UiSelector.text() - Element: $element_id${NC}"
-    
-    # Strategy 2: UiAutomator textContains (partial match)
-    if [ -z "$element_id" ]; then
-        echo -e "${BLUE}  Strategy 2: UiAutomator textContains()...${NC}"
-        element_id=$(find_element_uia2 "$session_id" "$port" "-android uiautomator" "new UiSelector().textContains(\\\"$target\\\")")
-        [ -n "$element_id" ] && echo -e "${GREEN}  ✓ Found by UiSelector.textContains()${NC}"
-    fi
-    
-    # Strategy 3: UiAutomator description (content-desc)
-    if [ -z "$element_id" ]; then
-        echo -e "${BLUE}  Strategy 3: UiAutomator description()...${NC}"
-        element_id=$(find_element_uia2 "$session_id" "$port" "-android uiautomator" "new UiSelector().description(\\\"$target\\\")")
-        [ -n "$element_id" ] && echo -e "${GREEN}  ✓ Found by UiSelector.description()${NC}"
-    fi
-    
-    # Strategy 4: UiAutomator descriptionContains
-    if [ -z "$element_id" ]; then
-        echo -e "${BLUE}  Strategy 4: UiAutomator descriptionContains()...${NC}"
-        element_id=$(find_element_uia2 "$session_id" "$port" "-android uiautomator" "new UiSelector().descriptionContains(\\\"$target\\\")")
-        [ -n "$element_id" ] && echo -e "${GREEN}  ✓ Found by UiSelector.descriptionContains()${NC}"
-    fi
-    
-    # Strategy 5: UiAutomator resourceId
-    if [ -z "$element_id" ]; then
-        echo -e "${BLUE}  Strategy 5: UiAutomator resourceId()...${NC}"
-        element_id=$(find_element_uia2 "$session_id" "$port" "-android uiautomator" "new UiSelector().resourceIdMatches(\\\".*$target.*\\\")")
-        [ -n "$element_id" ] && echo -e "${GREEN}  ✓ Found by UiSelector.resourceId()${NC}"
-    fi
-    
-    # Strategy 6: XPath exact text (fallback)
-    if [ -z "$element_id" ]; then
-        echo -e "${BLUE}  Strategy 6: XPath exact text...${NC}"
-        element_id=$(find_element_uia2 "$session_id" "$port" "xpath" "//*[@text='$target']")
-        [ -n "$element_id" ] && echo -e "${GREEN}  ✓ Found by XPath text${NC}"
-    fi
-    
-    # Strategy 7: XPath content-desc
-    if [ -z "$element_id" ]; then
-        echo -e "${BLUE}  Strategy 7: XPath content-desc...${NC}"
-        element_id=$(find_element_uia2 "$session_id" "$port" "xpath" "//*[@content-desc='$target']")
-        [ -n "$element_id" ] && echo -e "${GREEN}  ✓ Found by XPath content-desc${NC}"
-    fi
-    
-    # Strategy 8: XPath partial text
-    if [ -z "$element_id" ]; then
-        echo -e "${BLUE}  Strategy 8: XPath partial text...${NC}"
-        element_id=$(find_element_uia2 "$session_id" "$port" "xpath" "//*[contains(@text, '$target')]")
-        [ -n "$element_id" ] && echo -e "${GREEN}  ✓ Found by XPath partial text${NC}"
-    fi
-    
-    if [ -z "$element_id" ]; then
-        echo -e "${RED}✗ Element not found: $target${NC}"
-        echo -e "${YELLOW}Tip: Use coordinates (x,y) to click specific locations${NC}"
-        return 1
-    fi
-    
-    echo -e "${GREEN}✓ Element found, clicking...${NC}"
-    curl -s -X POST "http://localhost:$port/wd/hub/session/$session_id/element/$element_id/click" &>/dev/null
-    
-    echo -e "${GREEN}✓ Click completed${NC}"
-}
-
-# Type text
-type_text() {
-    local serial=$1
-    local text=$2
-    
-    echo -e "${BLUE}Typing: $text${NC}"
-    
-    # Use ADB directly for text input (no UIAutomator2 needed)
-    # Replace spaces with %s for ADB compatibility
-    local formatted_text=$(echo "$text" | sed 's/ /%s/g')
-    adb -s "$serial" shell input text "$formatted_text"
-    
-    echo -e "${GREEN}✓ Text entered${NC}"
-}
-
-# Swipe gesture
-swipe() {
-    local serial=$1
-    local direction=$2
-    
-    echo -e "${BLUE}Swiping $direction...${NC}"
-    
-    # Get screen size using ADB
-    local screen_size=$(adb -s "$serial" shell wm size | grep -o '[0-9]*x[0-9]*')
-    local width=$(echo "$screen_size" | cut -d'x' -f1)
-    local height=$(echo "$screen_size" | cut -d'x' -f2)
-    
-    local x1=$((width / 2))
-    local y1=$((height / 2))
-    local x2=$x1
-    local y2=$y1
-    
-    case "$direction" in
-        up)
-            y1=$((height * 3 / 4))
-            y2=$((height / 4))
-            ;;
-        down)
-            y1=$((height / 4))
-            y2=$((height * 3 / 4))
-            ;;
-        left)
-            x1=$((width * 3 / 4))
-            x2=$((width / 4))
-            ;;
-        right)
-            x1=$((width / 4))
-            x2=$((width * 3 / 4))
-            ;;
-    esac
-    
-    adb -s "$serial" shell input swipe $x1 $y1 $x2 $y2 300
-    echo -e "${GREEN}✓ Swipe completed${NC}"
-}
-
-# Screenshot
-take_screenshot() {
-    local serial=$1
-    # Save to webapp screenshots directory
-    local screenshots_dir="$SCRIPT_DIR/webapp/backend/screenshots"
-    mkdir -p "$screenshots_dir"
-    local output="${screenshots_dir}/screenshot_android_${serial}_$(date +%Y%m%d_%H%M%S).png"
-    
-    echo -e "${BLUE}Taking screenshot...${NC}"
-    adb -s "$serial" exec-out screencap -p > "$output"
-    echo -e "${GREEN}✓ Screenshot saved: $output${NC}"
-}
-
-# Home button
-press_home() {
-    local serial=$1
-    echo -e "${BLUE}Pressing Home button...${NC}"
-    adb -s "$serial" shell input keyevent KEYCODE_HOME
-    echo -e "${GREEN}✓ Home pressed${NC}"
-}
-
-# Back button
-press_back() {
-    local serial=$1
-    echo -e "${BLUE}Pressing Back button...${NC}"
-    adb -s "$serial" shell input keyevent KEYCODE_BACK
-    echo -e "${GREEN}✓ Back pressed${NC}"
-}
-
-# Lock device
-lock_device() {
-    local serial=$1
-    echo -e "${BLUE}Locking device...${NC}"
-    adb -s "$serial" shell input keyevent KEYCODE_POWER
-    echo -e "${GREEN}✓ Device locked${NC}"
-}
-
-# Unlock device
-unlock_device() {
-    local serial=$1
-    echo -e "${BLUE}Unlocking device...${NC}"
-    adb -s "$serial" shell input keyevent KEYCODE_MENU
-    echo -e "${GREEN}✓ Device unlocked (if screen on)${NC}"
-}
-
-# Restart device
-restart_device() {
-    local serial=$1
-    echo -e "${BLUE}Restarting device...${NC}"
-    adb -s "$serial" reboot
-    echo -e "${GREEN}✓ Restart command sent${NC}"
-}
-
-# Shutdown device
-shutdown_device() {
-    local serial=$1
-    echo -e "${BLUE}Shutting down device...${NC}"
-    adb -s "$serial" shell reboot -p
-    echo -e "${GREEN}✓ Shutdown command sent${NC}"
-}
-
-# Get device info
-get_device_info() {
-    local serial=$1
-    
-    echo -e "${BLUE}Device Information:${NC}"
-    echo "Serial: $serial"
-    echo "Model: $(adb -s "$serial" shell getprop ro.product.model | tr -d '\r')"
-    echo "Android: $(adb -s "$serial" shell getprop ro.build.version.release | tr -d '\r')"
-    echo "SDK: $(adb -s "$serial" shell getprop ro.build.version.sdk | tr -d '\r')"
-    echo "Battery: $(adb -s "$serial" shell dumpsys battery | grep level | cut -d':' -f2 | tr -d ' \r')%"
-}
-
-# List installed apps
-list_apps() {
-    local serial=$1
-    echo -e "${BLUE}Installed Apps:${NC}"
-    adb -s "$serial" shell pm list packages -3 | sed 's/package://' | sort
-}
-
-# Main command processor
-process_command() {
-    local serial=$1
-    local port=$2
-    local command=$3
-    shift 3
-    local args="$@"
-    
-    case "$command" in
-        launch)
-            launch_app "$serial" "$port" "$args"
-            ;;
-        close|kill)
-            close_app "$serial" "$args"
-            ;;
-        url)
-            open_url "$serial" "$args"
-            ;;
-        click|tap)
-            click_element "$serial" "$port" "$args"
-            ;;
-        type)
-            # Use ADB directly, no port needed
-            type_text "$serial" "$args"
-            ;;
-        swipe)
-            # Use ADB directly, no port needed
-            swipe "$serial" "$args"
-            ;;
-        screenshot)
-            take_screenshot "$serial" "$args"
-            ;;
-        getLocators)
-            get_locators "$serial"
-            ;;
-        home)
-            press_home "$serial"
-            ;;
-        back)
-            press_back "$serial"
-            ;;
-        lock)
-            lock_device "$serial"
-            ;;
-        unlock)
-            unlock_device "$serial"
-            ;;
-        restart|reboot)
-            restart_device "$serial"
-            ;;
-        shutdown|poweroff)
-            shutdown_device "$serial"
-            ;;
-        info)
-            get_device_info "$serial"
-            ;;
-        listapps)
-            list_apps "$serial"
-            ;;
-        *)
-            echo -e "${RED}Unknown command: $command${NC}"
-            return 1
-            ;;
-    esac
-}
-
-# Main execution
-main() {
-    if [ $# -lt 2 ]; then
-        echo "Usage: $0 <device_serial> <command> [args...]"
-        echo ""
-        echo "Commands:"
-        echo "  launch <package> [activity]  - Launch app"
-        echo "  close <package>              - Close app"
-        echo "  url <url>                    - Open URL in browser"
-        echo "  click <text|x,y>            - Click element"
-        echo "  type <text>                  - Type text"
-        echo "  swipe <up|down|left|right>  - Swipe gesture"
-        echo "  screenshot [filename]        - Take screenshot"
-        echo "  getLocators                  - Get UI elements"
-        echo "  home                         - Press home button"
-        echo "  back                         - Press back button"
-        echo "  lock                         - Lock device"
-        echo "  unlock                       - Unlock device"
-        echo "  restart                      - Restart device"
-        echo "  shutdown                     - Shutdown device"
-        echo "  info                         - Device information"
-        echo "  listapps                     - List installed apps"
-        exit 1
-    fi
-    
-    local serial=$1
-    shift
-    
-    # Verify device is connected
-    if ! adb devices | grep -q "$serial"; then
-        echo -e "${RED}Device not found: $serial${NC}"
-        echo "Available devices:"
-        adb devices
-        exit 1
-    fi
-    
-    # Assign port and store mapping
-    local port=$((UIAUTOMATOR2_PORT_BASE))
-    echo "$serial:$port" >> "$DEVICE_PORTS_FILE"
-    
-    # Initialize UIAutomator2 ONLY if needed (for commands that require it)
-    local command=$1
-    local requires_uiautomator=false
-    
-    case "$command" in
-        click|tap|getLocators)
-            # Only require UIAutomator2 if NOT using coordinates
-            if [[ "$command" == "getLocators" ]] || ! [[ "$2" =~ ^[0-9]+,[0-9]+$ ]]; then
-                requires_uiautomator=true
-            fi
-            ;;
-    esac
-    
-    if [ "$requires_uiautomator" = true ]; then
-        echo -e "${YELLOW}Note: This command requires UIAutomator2${NC}"
-        if ! init_uiautomator2 "$serial" "$port"; then
-            echo -e "${YELLOW}Tip: Most commands (type, swipe, home, back, launch, screenshot) work without UIAutomator2${NC}"
-            exit 1
-        fi
-    fi
-    
-    # Process command
-    process_command "$serial" "$port" "$@"
-}
-
-# Run if not sourced
-if [ "${BASH_SOURCE[0]}" == "${0}" ]; then
-    main "$@"
-fi