python 如何做手机脚本

Python做手机脚本的方法有多种，比如使用Appium、ADB（Android Debug Bridge）、MonkeyRunner等工具。其中，Appium 是比较常见和广泛使用的方法。下面将详细介绍如何使用Appium进行手机脚本的编写和执行。

一、安装和配置环境

1、安装Python

首先，你需要安装Python。可以从Python的官方网站下载最新版本的Python，并按照提示进行安装。确保在安装时选择添加Python到系统环境变量选项。

2、安装Appium

接下来，安装Appium。你可以使用npm来安装Appium。首先确保你已经安装了Node.js，然后在命令行中运行以下命令：

npm install -g appium

3、安装Appium-Python-Client

在安装了Appium之后，你需要安装Appium-Python-Client，这是用于编写和执行Python脚本的库。你可以使用pip来安装：

pip install Appium-Python-Client

4、安装和配置Android SDK

你还需要安装Android SDK，以便使用adb命令和其他Android相关工具。你可以从Android开发者网站下载Android Studio，它包含了SDK管理器。安装完成后，通过SDK管理器下载所需的SDK工具和平台。

二、连接设备

1、启用开发者选项和USB调试

在你的Android设备上，进入设置->关于手机，连续点击“版本号”七次以启用开发者选项。然后返回设置，进入开发者选项，启用“USB调试”。

2、连接设备到电脑

使用USB数据线将你的Android设备连接到电脑。确保设备驱动程序已正确安装。你可以使用以下命令来确认设备是否已连接：

adb devices

如果设备已连接，你将看到设备的序列号出现在列表中。

三、编写和执行脚本

1、启动Appium服务器

在命令行中运行以下命令启动Appium服务器：

appium

Appium服务器启动后，将监听默认的4723端口。

2、编写Python脚本

创建一个Python脚本文件，例如test_appium.py，并编写以下内容：

from appium import webdriver
desired_caps = {
    "platformName": "Android",
    "platformVersion": "9",  # 你的设备Android版本
    "deviceName": "emulator-5554",  # 你的设备名称，可以通过adb devices命令获取
    "appPackage": "com.example.android",  # 你要测试的应用包名
    "appActivity": ".MainActivity"  # 你要测试的应用主活动
}
driver = webdriver.Remote("http://localhost:4723/wd/hub", desired_caps)
在这里编写你的测试脚本，例如点击一个按钮
element = driver.find_element_by_id("com.example.android:id/button")
element.click()
关闭Appium会话
driver.quit()

3、执行Python脚本

在命令行中运行以下命令来执行你的Python脚本：

python test_appium.py

如果一切配置正确，你的脚本将连接到Appium服务器，并在你的设备上执行相应的操作。

四、常用的Appium操作

1、查找元素

你可以使用多种方法来查找元素，例如通过ID、XPath、Class Name等：

element = driver.find_element_by_id("com.example.android:id/button")
element = driver.find_element_by_xpath("//android.widget.Button[@text='Click me']")
element = driver.find_element_by_class_name("android.widget.Button")

2、点击和输入文本

你可以使用click方法来点击元素，使用send_keys方法来输入文本：

element.click()
element.send_keys("Hello World")

3、滑动和滚动

你可以使用swipe和scroll方法来滑动和滚动屏幕：

driver.swipe(start_x=100, start_y=100, end_x=100, end_y=500, duration=800)
driver.scroll(origin_element, destination_element)

4、获取元素属性和文本

你可以使用get_attribute方法来获取元素的属性，使用text属性来获取元素的文本：

attr = element.get_attribute("contentDescription")
text = element.text

五、执行更多复杂操作

1、等待元素出现

有时你需要等待某个元素出现，你可以使用WebDriverWait和expected_conditions来实现：

from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
element = WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.ID, "com.example.android:id/button"))
)

2、切换上下文

如果你的应用包含WebView，你可以切换上下文来操作Web元素：

# 获取所有上下文
contexts = driver.contexts
print(contexts)
切换到WebView上下文
driver.switch_to.context("WEBVIEW_com.example.android")
执行Web操作
element = driver.find_element_by_css_selector("button")
element.click()
切换回原生上下文
driver.switch_to.context("NATIVE_APP")

3、处理弹窗和警告

如果你的应用会弹出对话框或者警告，你可以使用alert方法来处理：

alert = driver.switch_to.alert
alert.accept()  # 接受弹窗
alert.dismiss()  # 取消弹窗
alert.send_keys("input text")  # 输入文本

六、使用Page Object Model

Page Object Model (POM) 是一种设计模式，用于提高自动化测试代码的可维护性和可读性。你可以将每个页面的元素和操作封装到一个类中。

1、创建页面类

创建一个页面类，例如MainPage.py：

class MainPage:
    def __init__(self, driver):
        self.driver = driver
        self.button = "com.example.android:id/button"
    def click_button(self):
        self.driver.find_element_by_id(self.button).click()

2、在测试脚本中使用页面类

在你的测试脚本中使用页面类：

from appium import webdriver
from MainPage import MainPage
desired_caps = {
    "platformName": "Android",
    "platformVersion": "9",
    "deviceName": "emulator-5554",
    "appPackage": "com.example.android",
    "appActivity": ".MainActivity"
}
driver = webdriver.Remote("http://localhost:4723/wd/hub", desired_caps)
main_page = MainPage(driver)
main_page.click_button()
driver.quit()

七、使用Appium Inspector

Appium Inspector 是一个GUI工具，用于检查应用的元素和生成代码。你可以从Appium Desktop客户端中启动Appium Inspector。

1、启动Appium Desktop

下载并安装Appium Desktop客户端。启动Appium Desktop，并点击“Start Server”启动Appium服务器。

2、启动Appium Inspector

在Appium Desktop客户端中，点击“Start Inspector Session”。填写Desired Capabilities，例如：

{ "platformName": "Android", "platformVersion": "9", "deviceName": "emulator-5554", "appPackage": "com.example.android", "appActivity": ".MainActivity" }

点击“Start Session”开始会话。

3、检查元素和生成代码

在Appium Inspector中，你可以查看应用的页面结构、元素属性，并生成相应的代码片段。这有助于你编写和调试脚本。

八、使用CI/CD集成自动化测试

为了在持续集成/持续交付（CI/CD）管道中执行自动化测试，你可以将Appium测试集成到CI工具中，例如Jenkins、GitLab CI等。

1、配置CI环境

在你的CI环境中，安装所需的依赖项，例如Python、Appium、Android SDK等。确保能够连接到测试设备（例如通过ADB）。

2、编写CI脚本

编写CI脚本来执行Appium测试。例如，在Jenkins中，你可以编写一个Pipeline脚本：

pipeline {
    agent any
    stages {
        stage('Setup') {
            steps {
                sh 'pip install Appium-Python-Client'
                sh 'sdkmanager "platform-tools"'
            }
        }
        stage('Test') {
            steps {
                sh 'python test_appium.py'
            }
        }
    }
}

3、配置和运行CI任务

在CI工具中，配置和运行任务。CI工具将自动执行你的Appium测试，并报告测试结果。

九、调试和日志记录

1、启用Appium日志

你可以启用Appium日志来调试问题。在启动Appium服务器时，添加--log-level参数：

appium --log-level debug

2、捕获和分析日志

在测试脚本中，你可以捕获并分析日志信息。例如：

import logging
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
logger.info("Starting Appium test")
try:
    driver = webdriver.Remote("http://localhost:4723/wd/hub", desired_caps)
    logger.info("Appium session started")
    element = driver.find_element_by_id("com.example.android:id/button")
    element.click()
    logger.info("Button clicked")
finally:
    driver.quit()
    logger.info("Appium session ended")