Appium Architecture & Setup

# ══════════════════════════════════════════════════════════════
# PREREQUISITES
# ══════════════════════════════════════════════════════════════
# 1. Node.js installed
# 2. Appium server: npm install -g appium
# 3. UIAutomator2 driver: appium driver install uiautomator2
# 4. XCUITest driver: appium driver install xcuitest (macOS only)
# 5. Android SDK + AVD Manager (for Android emulator)
# 6. Xcode (for iOS simulator - macOS only)
# 7. Python Appium client: pip install Appium-Python-Client

# Start Appium server:
# appium server --port 4723 --address 127.0.0.1

# ══════════════════════════════════════════════════════════════
# ANDROID TEST SETUP (Python)
# ══════════════════════════════════════════════════════════════
from appium import webdriver
from appium.options import UiAutomator2Options
from appium.webdriver.common.appiumby import AppiumBy
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
import pytest

@pytest.fixture(scope="function")
def android_driver():
    options = UiAutomator2Options()
    
    # Device capabilities:
    options.platform_name = "Android"
    options.platform_version = "13"
    options.device_name = "emulator-5554"  # from 'adb devices' output
    
    # App under test:
    options.app = "/path/to/myapp.apk"     # Local APK path
    # OR if app is already installed:
    options.app_package = "com.mycompany.myapp"
    options.app_activity = "com.mycompany.myapp.MainActivity"
    
    # Appium behavior:
    options.no_reset = False        # Clear app state before each test
    options.full_reset = False      # Don't reinstall app each time
    options.auto_grant_permissions = True  # Auto-grant all permissions
    
    driver = webdriver.Remote(
        command_executor="http://127.0.0.1:4723",
        options=options
    )
    driver.implicitly_wait(10)
    yield driver
    driver.quit()

# ── FIRST ANDROID TEST ─────────────────────────────────────────
def test_android_login(android_driver):
    driver = android_driver
    
    # Find elements using AppiumBy strategies
    email_field = driver.find_element(AppiumBy.ID, "com.myapp:id/email_input")
    email_field.send_keys("alice@test.com")
    
    password_field = driver.find_element(AppiumBy.ID, "com.myapp:id/password_input")
    password_field.send_keys("Test@1234")
    
    login_btn = driver.find_element(AppiumBy.ID, "com.myapp:id/login_button")
    login_btn.click()
    
    # Wait for home screen
    wait = WebDriverWait(driver, 15)
    home_title = wait.until(
        EC.presence_of_element_located((AppiumBy.ID, "com.myapp:id/home_title"))
    )
    assert home_title.is_displayed(), "Home screen should be visible after login"

# ── iOS SETUP ─────────────────────────────────────────────────
# options.platform_name = "iOS"
# options.platform_version = "17"
# options.device_name = "iPhone 15 Pro"
# options.app = "/path/to/MyApp.app"   # Simulator build
# options.automation_name = "XCUITest"
# bundle_id = "com.mycompany.myapp"