Python 实现 App 登录自动化，通常指对**移动端 App（Android/iOS）进行 UI 自动化测试/操作**，模拟用户输入账号密码、点击登录按钮等行为。主流技术方案是使用 **Appium**（跨平台的移动应用自动化框架），它基于 WebDriver 协议，支持 Python 客户端驱动真机或模拟器上的 App。 ⚠️ 注意前提： - 该方案适用于 **原生 App 或混合 App**（非纯 Webview 登录页；若登录页是 H5，也可用 WebView 调试方式，但更推荐直接用 Selenium + Chrome DevTools Protocol 处理 Webview）； - 不适用于已加固/无调试权限的生产 App（如某些银行 App 禁止自动化）； - 需要配置好开发环境（ADB、Xcode、Appium Server、对应 SDK）。 --- ### ✅ 完整解决方案：使用 Appium + Python 自动化 Android App 登录 #### 步骤概览： 1. 安装并启动 Appium Server（GUI 或 CLI）； 2. 准备被测 App（APK 文件）或已安装 App 的 `appPackage` & `appActivity`； 3. 编写 Python 脚本，配置 Desired Capabilities； 4. 定位登录元素（用户名、密码、登录按钮），执行输入与点击； 5. （可选）添加显式等待、截图、异常处理、日志等增强健壮性。 --- #### 🔧 环境准备（简要） ```bash # 1. 安装 Appium CLI（需 Node.js） npm install -g appium # 2. 启动 Appium Server（默认端口 4723） appium # 3. 安装 Python 客户端 pip install Appium-Python-Client # 4. 确保 Android 设备已连接且开启 USB 调试 adb devices # 应显示设备 ``` --- #### 🐍 Python 自动化登录脚本（Android 示例） ```python from appium import webdriver from appium.webdriver.common.appiumby import AppiumBy from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC import time # === 1. 配置 Desired Capabilities === desired_caps = { "platformName": "Android", "platformVersion": "13", # 设备系统版本（可设为""让Appium自动检测） "deviceName": "Pixel_4_API_33", # adb devices 显示的设备名（或 emulator-5554） "appPackage": "com.example.myapp", # 替换为你的 App 包名（可用 aapt dump badging xxx.apk 查看） "appActivity": ".MainActivity", # 启动 Activity（可用 adb logcat | grep START 查） "noReset": True, # 不重置 App 状态（保留登录态等） "autoGrantPermissions": True, # 自动授予运行时权限 "unicodeKeyboard": True, # 支持中文输入 "resetKeyboard": True # 执行完恢复默认键盘 } # === 2. 启动 Appium Session === driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps) try: # === 3. 显式等待：等待登录页面关键元素出现（推荐！避免 sleep 硬等待）=== wait = WebDriverWait(driver, 15) # 最多等待15秒 # 假设登录页有如下元素（请根据实际 App 的 Accessibility ID / ID / XPath 替换！） # ✅ 推荐优先使用 accessibility_id（即 content-desc）或 id（resource-id），稳定且高效 username_field = wait.until( EC.element_to_be_clickable((AppiumBy.ACCESSIBILITY_ID, "username_input")) ) password_field = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "password_input") login_button = driver.find_element(AppiumBy.ID, "com.example.myapp:id/btn_login") # === 4. 执行登录操作 === username_field.send_keys("testuser") password_field.send_keys("P@ssw0rd123") login_button.click() # === 5. 验证登录成功（例如检查跳转后是否存在“我的”tab 或欢迎文案）=== welcome_text = wait.until( EC.presence_of_element_located((AppiumBy.XPATH, "//*[@text='欢迎回来，testuser']")) ) print("✅ 登录成功！检测到欢迎文案：", welcome_text.text) except Exception as e: print("❌ 登录失败：", str(e)) driver.get_screenshot_as_file("login_failed.png") # 截图排错 raise finally: # 可选：退出会话（不关闭 App 可省略 driver.quit()） # driver.quit() pass ``` --- #### 🔍 关键说明与技巧： | 组件 | 说明 | |------|------| | `AppiumBy.ACCESSIBILITY_ID` | 对应 Android 的 `content-desc` 属性（推荐！开发应设好，比 XPath 更稳定） | | `AppiumBy.ID` | 对应 `resource-id`（如 `com.xxx:id/login_btn`），需确保唯一且未动态生成 | | `AppiumBy.XPATH` | 强大但易断裂（如 `//*[@text='登录']`），仅作兜底；避免 `//android.widget.Button[1]` 这类位置依赖 | | `WebDriverWait + expected_conditions` | **必须使用！** 避免因 App 启动慢、动画延迟导致 `NoSuchElementException` | | `noReset=True` | 防止每次重装/清除数据，提升执行速度；调试阶段可设 `False` 确保干净环境 | | 中文输入 | `unicodeKeyboard=True` + `resetKeyboard=True` 组合解决输入法乱码问题 | 📌 如何获取真实元素定位？ → 使用 **Appium Desktop Inspector**（GUI 工具）：启动 Appium Server → 点击 “Start Inspector Session” → 填写 caps → 点击 Start → 在界面中点击元素查看 `resource-id` / `content-desc` / `xpath`。 --- #### ⚠️ 常见问题与规避方案： - ❌ 元素找不到？→ 检查是否在 WebView 内（需切换上下文 `driver.contexts` → `driver.switch_to.context('WEBVIEW_xxx')`）； - ❌ 输入法弹出遮挡按钮？→ `hideKeyboard()` 或用 `adb shell input keyevent 111` 关闭； - ❌ 登录含图形验证码/短信验证？→ 自动化需对接打码平台或跳过（测试环境 mock 验证逻辑）； - ❌ App 启动后黑屏/白屏？→ 检查 `appActivity` 是否正确（常见错误：`.SplashActivity` 或 `.LoginActivity`）； - ❌ 权限拒绝导致卡住？→ `autoGrantPermissions=True` + `adb shell pm grant <pkg> android.permission.XXX` 手动授予权限。 --- #### 💡 进阶建议（生产级自动化）： - 封装 `BasePage` 类，实现 `find`, `click`, `input` 等通用方法； - 使用 `pytest` + `allure` 生成测试报告； - 整合 CI/CD（GitHub Actions / Jenkins），定时跑真机集群； - 对接企业微信/钉钉机器人，失败自动告警； - 使用 `Appium-Python-Client` 4.x+ 版本（支持 W3C WebDriver 协议，兼容性更好）。 ---