connect

提示说明

• 影刀在4.7版本中添加新的手机自动化模式【U2】模式，并添加了新的接口
• 4.7之前开发的手机应用仍可以正常运行
• 新开发的编码版应用建议使用新的接口
  • 注意：新版接口使用时，请注意导入方式，请查看示例代码

connect（旧）

使用Appium模式，根据连接参数与指定的手机建立连接。

connect(appium_url, platform_name, platform_version, device_name, * , additional_capabilities=None)

参数

• appium_url：指定的Appium服务器地址，如 http://127.0.0.1:4723/wd/hub
• platform_name：指定的系统名称，如 Android 或 iOS
• platform_version：指定的系统版本, 如 8.0.1
• device_name：指定的设备型号, 如 Galaxy S4
• additional_capabilities：添加其他其他配置项，请输入一个python字典对象

返回值

• MobileSession：返回获取到的手机连接对象

示例1

与指定手机建立连接

import xbot
from xbot import print, sleep
from .import package

def main(args):
    session = xbot.mobile.connect(
        'http://127.0.0.1:4723/wd/hub', 
        'Android', 
        '8.0.1', 
        'Galaxy S4', 
        additional_capabilities = {
            'newCommandTimeout': 60
            }
        )

connect（新）

u2模式

connect(id)

参数

• id：指定的手机udid，可通过命令行执行adb devices获取

返回值

• MobileSession：返回获取到的手机连接对象

示例1

与指定手机建立连接，滑动手机屏幕，寻找相似元素，点击元素

import xbot
from xbot import print, sleep 
from .import package

from xbot.mobile import u2 # 注意，u2模式必须如此导入

def main(args):
    session = u2.connect('emulator-5554') # xbot.mobile.u2.connect()无法使用，必须如上导入
    session.swipe(300, 900, 300, 300)
    elements =  session.find_all('小红书-杭州-up相似元素组')
    print(len(elements))
    for element in elements:
        element.click(delay_after=4)
        session.back()

appium模式

使用Appium模式，与指定手机建立连接

connect(appium_url, platform_name, platform_version, device_name, * , additional_capabilities=None)

参数

• appium_url：指定的Appium服务器地址，如 http://127.0.0.1:4723/wd/hub
• platform_name：指定的系统名称，如 Android 或 iOS
• platform_version：指定的系统版本, 如 8.0.1
• device_name：指定的设备型号, 如 Galaxy S4
• additional_capabilities：添加其他其他配置项，请输入一个python字典对象

返回值

• MobileSession：返回获取到的手机连接对象

示例1

与指定手机建立连接

import xbot
from xbot import print, sleep
from .import package

from xbot.mobile import appium

def main(args):
    session = appium.connect('http://127.0.0.1:4725/wd/hub', 'Android', '7', 'XIAOMI 2')
    session.swipe(300, 900, 300, 300)
    elements =  session.find_all('小红书-杭州-up相似元素组')
    print(len(elements))
    for element in elements:
        element.click(delay_after=4)
        session.back()