node --version
npm --version

npm install -g appium

appium

pip install Appium-Python-Client

from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
from appium.options.android import UiAutomator2Options
import time
import unittest

def setup_driver():
    # 配置Appium選項(xiàng)
    options = UiAutomator2Options()
    
    # 設(shè)置設(shè)備基本信息
    options.platform_name = 'Android'
    options.platform_version = '12'  # 根據(jù)你的設(shè)備版本修改
    options.device_name = 'Android Emulator'
    options.automation_name = 'UiAutomator2'
    
    # 設(shè)置應(yīng)用信息
    options.app_package = 'com.android.calculator2'
    options.app_activity = 'com.android.calculator2.Calculator'
    
    # 其他設(shè)置
    options.no_reset = True  # 不重置應(yīng)用狀態(tài)
    
    # 連接Appium服務(wù)器
    driver = webdriver.Remote('http://localhost:4723', options=options)
    
    return driver

def calculator_operations(driver):
    """執(zhí)行計(jì)算器操作"""
    try:
        # 等待計(jì)算器加載完成
        time.sleep(2)
        
        # 定位數(shù)字按鈕和操作符
        # 注意：不同設(shè)備上的計(jì)算器應(yīng)用可能具有不同的元素ID
        # 這里使用的是Android原生計(jì)算器的元素ID
        
        # 點(diǎn)擊數(shù)字 7
        btn_7 = driver.find_element(AppiumBy.ID, 'com.android.calculator2:id/digit_7')
        btn_7.click()
        
        # 點(diǎn)擊加號
        btn_plus = driver.find_element(AppiumBy.ID, 'com.android.calculator2:id/op_add')
        btn_plus.click()
        
        # 點(diǎn)擊數(shù)字 8
        btn_8 = driver.find_element(AppiumBy.ID, 'com.android.calculator2:id/digit_8')
        btn_8.click()
        
        # 點(diǎn)擊等號
        btn_equals = driver.find_element(AppiumBy.ID, 'com.android.calculator2:id/eq')
        btn_equals.click()
        
        # 獲取結(jié)果
        result = driver.find_element(AppiumBy.ID, 'com.android.calculator2:id/result')
        calculated_result = result.text
        
        print(f"計(jì)算結(jié)果: 7 + 8 = {calculated_result}")
        
        # 驗(yàn)證結(jié)果是否正確
        expected_result = '15'
        if calculated_result == expected_result:
            print("測試通過！計(jì)算結(jié)果正確。")
        else:
            print(f"測試失?。∑谕Y(jié)果: {expected_result}, 實(shí)際結(jié)果: {calculated_result}")
            
        return calculated_result
        
    except Exception as e:
        print(f"操作過程中出現(xiàn)錯誤: {str(e)}")
        return None

class CalculatorTest(unittest.TestCase):
    """計(jì)算器測試類"""
    
    def setUp(self):
        """測試前置設(shè)置"""
        self.driver = setup_driver()
        self.driver.implicitly_wait(10)  # 設(shè)置隱式等待時間
        
    def tearDown(self):
        """測試后置清理"""
        if self.driver:
            self.driver.quit()
            
    def test_addition_operation(self):
        """測試加法運(yùn)算"""
        result = calculator_operations(self.driver)
        self.assertEqual(result, '15', "加法運(yùn)算結(jié)果不正確")
        
    def test_clear_operation(self):
        """測試清除操作"""
        try:
            # 先輸入一些數(shù)字
            btn_5 = self.driver.find_element(AppiumBy.ID, 'com.android.calculator2:id/digit_5')
            btn_5.click()
            
            # 點(diǎn)擊清除按鈕
            btn_clear = self.driver.find_element(AppiumBy.ID, 'com.android.calculator2:id/clr')
            btn_clear.click()
            
            # 驗(yàn)證顯示區(qū)域是否已清除
            result = self.driver.find_element(AppiumBy.ID, 'com.android.calculator2:id/formula')
            current_display = result.text
            
            # 清除后顯示區(qū)域應(yīng)該為空或顯示0
            self.assertTrue(not current_display or current_display == '0', 
                          "清除操作未正常工作")
            
        except Exception as e:
            self.fail(f"清除操作測試失敗: {str(e)}")

def advanced_element_locating(driver):
    """演示高級元素定位方法"""
    
    # 1. 使用XPath定位
    # 通過文本內(nèi)容定位元素
    element_by_text = driver.find_element(AppiumBy.XPATH, "http://*[@text='確定']")
    
    # 通過部分文本內(nèi)容定位
    element_by_partial_text = driver.find_element(
        AppiumBy.XPATH, "http://*[contains(@text, '確定')]"
    )
    
    # 2. 使用Accessibility ID定位（通常對應(yīng)content-desc屬性）
    element_by_accessibility = driver.find_element(
        AppiumBy.ACCESSIBILITY_ID, "按鈕描述"
    )
    
    # 3. 使用Class Name定位
    elements_by_class = driver.find_elements(
        AppiumBy.CLASS_NAME, "android.widget.Button"
    )
    
    # 4. 使用Android UI Automator定位
    element_by_uiautomator = driver.find_element(
        AppiumBy.ANDROID_UIAUTOMATOR, 
        'new UiSelector().text("確定")'
    )
    
    return {
        'by_text': element_by_text,
        'by_partial_text': element_by_partial_text,
        'by_accessibility': element_by_accessibility,
        'by_class': elements_by_class,
        'by_uiautomator': element_by_uiautomator
    }

def gesture_operations(driver):
    """演示手勢操作"""
    
    # 獲取屏幕尺寸
    window_size = driver.get_window_size()
    screen_width = window_size['width']
    screen_height = window_size['height']
    
    # 1. 滑動操作 - 從底部滑動到頂部
    start_x = screen_width / 2
    start_y = screen_height * 0.8
    end_x = screen_width / 2
    end_y = screen_height * 0.2
    
    driver.swipe(start_x, start_y, end_x, end_y, 1000)
    
    # 2. 滾動操作
    # 滾動到指定元素
    scroll_to_element = driver.find_element(
        AppiumBy.ANDROID_UIAUTOMATOR,
        'new UiScrollable(new UiSelector().scrollable(true))'
        '.scrollIntoView(new UiSelector().text("目標(biāo)元素"))'
    )
    
    # 3. 長按操作
    element_to_long_press = driver.find_element(AppiumBy.ID, 'some.element.id')
    driver.long_press(element_to_long_press)
    
    # 4. 拖拽操作
    source_element = driver.find_element(AppiumBy.ID, 'source.element')
    target_element = driver.find_element(AppiumBy.ID, 'target.element')
    driver.drag_and_drop(source_element, target_element)

def handle_popups_and_permissions(driver):
    """處理彈窗和權(quán)限請求"""
    
    try:
        # 嘗試查找并點(diǎn)擊允許按鈕
        allow_button = driver.find_element(
            AppiumBy.ID, 'com.android.packageinstaller:id/permission_allow_button'
        )
        allow_button.click()
        print("已處理權(quán)限請求")
        
    except Exception:
        # 如果找不到特定的允許按鈕，嘗試其他方式
        try:
            # 使用文本定位允許按鈕
            allow_by_text = driver.find_element(
                AppiumBy.XPATH, "http://*[@text='允許' or @text='ALLOW']"
            )
            allow_by_text.click()
            print("通過文本定位處理了權(quán)限請求")
            
        except Exception:
            print("未找到權(quán)限請求彈窗或處理失敗")
            
    # 處理其他類型的彈窗
    try:
        # 查找確定、好的、知道了等按鈕
        confirm_buttons = [
            "確定", "確認(rèn)", "好的", "知道了", "OK", "Okay"
        ]
        
        for button_text in confirm_buttons:
            try:
                confirm_btn = driver.find_element(
                    AppiumBy.XPATH, f"http://*[@text='{button_text}']"
                )
                confirm_btn.click()
                print(f"點(diǎn)擊了 {button_text} 按鈕")
                break
            except Exception:
                continue
                
    except Exception as e:
        print(f"處理彈窗時出現(xiàn)錯誤: {str(e)}")

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

def wait_strategies(driver):
    """演示不同的等待策略"""
    
    # 1. 顯式等待 - 等待元素可點(diǎn)擊
    wait = WebDriverWait(driver, 10)
    element = wait.until(
        EC.element_to_be_clickable((AppiumBy.ID, 'some.element.id'))
    )
    element.click()
    
    # 2. 顯式等待 - 等待元素可見
    visible_element = wait.until(
        EC.visibility_of_element_located((AppiumBy.ID, 'visible.element'))
    )
    
    # 3. 顯式等待 - 等待元素存在（不一定可見）
    present_element = wait.until(
        EC.presence_of_element_located((AppiumBy.ID, 'present.element'))
    )
    
    # 4. 自定義等待條件
    def custom_condition(driver):
        """自定義等待條件"""
        try:
            element = driver.find_element(AppiumBy.ID, 'custom.element')
            return element.is_displayed()
        except Exception:
            return False
    
    custom_element = wait.until(custom_condition)
    
    return {
        'clickable': element,
        'visible': visible_element,
        'present': present_element,
        'custom': custom_element
    }

#!/usr/bin/env python3
"""
Appium手機(jī)操作示例
作者：你的名字
日期：2024年1月
描述：使用Python和Appium操作手機(jī)計(jì)算器應(yīng)用
"""

import time
import unittest
import logging
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
from appium.options.android import UiAutomator2Options
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.common.exceptions import TimeoutException, NoSuchElementException


# 配置日志
logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)
logger = logging.getLogger(__name__)


class MobileAutomationFramework:
    """移動自動化框架類"""
    
    def __init__(self, server_url='http://localhost:4723'):
        self.server_url = server_url
        self.driver = None
        self.wait = None
        
    def setup_driver(self, capabilities_dict=None):
        """設(shè)置Appium驅(qū)動"""
        
        if capabilities_dict is None:
            # 默認(rèn)配置 - Android計(jì)算器
            capabilities_dict = {
                'platformName': 'Android',
                'platformVersion': '12',
                'deviceName': 'Android Emulator',
                'automationName': 'UiAutomator2',
                'appPackage': 'com.android.calculator2',
                'appActivity': 'com.android.calculator2.Calculator',
                'noReset': True,
                'newCommandTimeout': 300
            }
        
        try:
            options = UiAutomator2Options()
            for key, value in capabilities_dict.items():
                setattr(options, key, value)
                
            logger.info("正在連接Appium服務(wù)器...")
            self.driver = webdriver.Remote(self.server_url, options=options)
            
            # 設(shè)置顯式等待
            self.wait = WebDriverWait(self.driver, 15)
            
            logger.info("Appium驅(qū)動設(shè)置成功")
            return True
            
        except Exception as e:
            logger.error(f"設(shè)置Appium驅(qū)動失敗: {str(e)}")
            return False
    
    def teardown(self):
        """清理資源"""
        if self.driver:
            self.driver.quit()
            logger.info("Appium驅(qū)動已關(guān)閉")
    
    def find_element_with_wait(self, by, value, timeout=15):
        """帶等待的元素查找"""
        wait = WebDriverWait(self.driver, timeout)
        return wait.until(EC.presence_of_element_located((by, value)))
    
    def safe_click(self, by, value, timeout=15):
        """安全的點(diǎn)擊操作"""
        try:
            element = self.find_element_with_wait(by, value, timeout)
            element.click()
            logger.info(f"成功點(diǎn)擊元素: {value}")
            return True
        except Exception as e:
            logger.error(f"點(diǎn)擊元素失敗: {value}, 錯誤: {str(e)}")
            return False
    
    def take_screenshot(self, filename=None):
        """截取屏幕截圖"""
        if filename is None:
            filename = f"screenshot_{int(time.time())}.png"
        
        try:
            self.driver.save_screenshot(filename)
            logger.info(f"截圖已保存: {filename}")
            return True
        except Exception as e:
            logger.error(f"截圖失敗: {str(e)}")
            return False
    
    def get_page_source(self):
        """獲取頁面源代碼"""
        try:
            return self.driver.page_source
        except Exception as e:
            logger.error(f"獲取頁面源代碼失敗: {str(e)}")
            return None


class CalculatorAutomation(MobileAutomationFramework):
    """計(jì)算器自動化類"""
    
    def __init__(self):
        super().__init__()
        self.number_mapping = {
            '0': 'digit_0', '1': 'digit_1', '2': 'digit_2',
            '3': 'digit_3', '4': 'digit_4', '5': 'digit_5',
            '6': 'digit_6', '7': 'digit_7', '8': 'digit_8',
            '9': 'digit_9'
        }
        self.operator_mapping = {
            '+': 'op_add', '-': 'op_sub', 
            '*': 'op_mul', '/': 'op_div'
        }
    
    def input_number(self, number):
        """輸入數(shù)字"""
        if not isinstance(number, (int, str)):
            raise ValueError("數(shù)字必須是整數(shù)或字符串")
        
        number_str = str(number)
        for digit in number_str:
            if digit in self.number_mapping:
                element_id = f"com.android.calculator2:id/{self.number_mapping[digit]}"
                self.safe_click(AppiumBy.ID, element_id)
                time.sleep(0.1)  # 短暫延遲，確保輸入穩(wěn)定
            else:
                logger.warning(f"無法識別的數(shù)字: {digit}")
    
    def input_operator(self, operator):
        """輸入操作符"""
        if operator not in self.operator_mapping:
            raise ValueError(f"不支持的操作符: {operator}")
        
        element_id = f"com.android.calculator2:id/{self.operator_mapping[operator]}"
        self.safe_click(AppiumBy.ID, element_id)
    
    def calculate(self, num1, operator, num2):
        """執(zhí)行計(jì)算"""
        logger.info(f"執(zhí)行計(jì)算: {num1} {operator} {num2}")
        
        # 輸入第一個數(shù)字
        self.input_number(num1)
        
        # 輸入操作符
        self.input_operator(operator)
        
        # 輸入第二個數(shù)字
        self.input_number(num2)
        
        # 點(diǎn)擊等號
        self.safe_click(AppiumBy.ID, 'com.android.calculator2:id/eq')
        
        # 獲取結(jié)果
        return self.get_result()
    
    def get_result(self):
        """獲取計(jì)算結(jié)果"""
        try:
            result_element = self.find_element_with_wait(
                AppiumBy.ID, 'com.android.calculator2:id/result'
            )
            result = result_element.text
            logger.info(f"計(jì)算結(jié)果: {result}")
            return result
        except Exception as e:
            logger.error(f"獲取結(jié)果失敗: {str(e)}")
            return None
    
    def clear_calculator(self):
        """清除計(jì)算器"""
        self.safe_click(AppiumBy.ID, 'com.android.calculator2:id/clr')
        logger.info("計(jì)算器已清除")


class TestCalculatorOperations(unittest.TestCase):
    """計(jì)算器操作測試類"""
    
    @classmethod
    def setUpClass(cls):
        """測試類設(shè)置"""
        cls.calculator = CalculatorAutomation()
        success = cls.calculator.setup_driver()
        if not success:
            raise Exception("無法初始化Appium驅(qū)動")
    
    @classmethod
    def tearDownClass(cls):
        """測試類清理"""
        cls.calculator.teardown()
    
    def setUp(self):
        """單個測試設(shè)置"""
        # 確保每次測試前計(jì)算器是清除狀態(tài)
        self.calculator.clear_calculator()
        time.sleep(1)
    
    def test_addition(self):
        """測試加法"""
        result = self.calculator.calculate(15, '+', 7)
        self.assertEqual(result, '22', "加法測試失敗")
    
    def test_subtraction(self):
        """測試減法"""
        result = self.calculator.calculate(20, '-', 8)
        self.assertEqual(result, '12', "減法測試失敗")
    
    def test_multiplication(self):
        """測試乘法"""
        result = self.calculator.calculate(6, '*', 9)
        self.assertEqual(result, '54', "乘法測試失敗")
    
    def test_division(self):
        """測試除法"""
        result = self.calculator.calculate(56, '/', 7)
        self.assertEqual(result, '8', "除法測試失敗")
    
    def test_complex_operation(self):
        """測試復(fù)雜運(yùn)算"""
        # 15 + 27 - 8
        self.calculator.input_number(15)
        self.calculator.input_operator('+')
        self.calculator.input_number(27)
        self.calculator.input_operator('-')
        self.calculator.input_number(8)
        self.calculator.safe_click(AppiumBy.ID, 'com.android.calculator2:id/eq')
        
        result = self.calculator.get_result()
        self.assertEqual(result, '34', "復(fù)雜運(yùn)算測試失敗")


def main():
    """主函數(shù)"""
    logger.info("開始Appium手機(jī)操作演示")
    
    # 創(chuàng)建計(jì)算器自動化實(shí)例
    calculator = CalculatorAutomation()
    
    try:
        # 設(shè)置驅(qū)動
        if not calculator.setup_driver():
            logger.error("無法啟動Appium驅(qū)動，程序退出")
            return
        
        # 執(zhí)行一系列測試計(jì)算
        test_calculations = [
            (8, '+', 4),
            (15, '-', 6),
            (7, '*', 9),
            (81, '/', 9)
        ]
        
        for num1, op, num2 in test_calculations:
            result = calculator.calculate(num1, op, num2)
            expected = str(eval(f"{num1}{op}{num2}"))
            
            if result == expected:
                logger.info(f"? {num1} {op} {num2} = {result} (正確)")
            else:
                logger.error(f"? {num1} {op} {num2} = {result} (期望: {expected})")
        
        # 截取屏幕截圖
        calculator.take_screenshot("calculator_final_state.png")
        
        logger.info("Appium手機(jī)操作演示完成")
        
    except Exception as e:
        logger.error(f"程序執(zhí)行過程中出現(xiàn)錯誤: {str(e)}")
        
    finally:
        # 確保資源被正確清理
        calculator.teardown()


if __name__ == "__main__":
    # 可以直接運(yùn)行演示
    main()
    
    # 或者運(yùn)行單元測試
    # unittest.main(verbosity=2)