1移動自動化簡介

移動自動化就是通過程式碼來控制手機，模擬人的動作，對手機進行一些點選，輸入等操作，那python程式碼如何能控制到手機呢？目前的思路應該是python程式碼->Appium-python庫->Appium服務->手機。也就是通過appium的庫來呼叫appium服務，讓appium服務對手機進行操作。

基於上面的思路，我們環境安裝好之後，執行程式碼之前，需要先將環境開起來，appium服務開啟，安卓模擬器開啟，就可以執行安卓自動化程式碼了。如果執行報錯沒有找到安卓裝置的話，試試看在cmd裡面輸入adb connect 裝置名，比如adb connect 127.0.0.1:62001

1.1連線手機的程式碼

寫自動化程式碼之前，首先寫一段下面的程式碼，用來連線上手機，並且連線上你需要測試的APP，如果報錯沒有找到裝置的話，按照上面說的執行adb connect 裝置名試試看。

# encoding=utf-8
from appium import webdriver

server = r'http://localhost:4723/wd/hub'      # Appium Server, 埠預設為4723
desired_capabilities = {
    'platformName': 'Android',    # 平臺
    # 需替換成你的driverName，如果不知 道自己的裝置名，用adb命令去檢視一下
    'driverName': '127.0.0.1:62001',      
    'platformVersion': '5.1.1',      # 安卓版本
    'appPackage': 'com.android.settings',      #APP包名
    'appActivity': '.Settings'       # APP啟動名
    'unicodeKeyboard': True         # 這句和下面那句是避免中文問題的
    'resetKeyboard': True
}
driver = webdriver.Remote(server, desired_capabilities) # 連線手機和APP
driver.find_element_by_id("com.android.settings:id/title").click() # 後面講
driver.quit()  # 退出driver

在上面的程式碼driver.quit()之前加入下面的程式碼，獲取當前APP的包名和啟動名

# 獲取APP的包名

print(driver.current_package)

#獲取APP的啟動名

print(driver.current_activity)

列印的結果：

com.android.settings

.SubSettings

2 UIAutomatorViewer使用

在講元素定位之前，首先說一個很有用的工具 UIAutomatorViewer，這個工具在\android-sdk-windows\tools資料夾下面，uiautomatorviewer.bat這個檔案，雙擊開啟。

第一步：開啟之後看到的介面應該是：

（這裡提示一下：如果開啟的時候報錯了，“Error obtaining UI hierarchy”錯誤，不能找到ui，一般就是因為adb被佔用了，那麼可以試著關閉adb，去cmd裡面輸入adb kill-server,再輸入adb start-server，重啟後等會再去點，如果還是不行，多等會，再不行就把appium的服務關掉）

（再提示：開啟uiantomatorviewer的時候還會開啟一個黑框，這個黑框別關）

第二步，開啟你的虛擬器或者真機中的需要測試的APP，比如我現在測試設定，我就開啟設定，如圖：

第三步：點選第一步圖示的圈紅按鈕，點選後等待一會，會出來如下圖：

第四步，出來上圖後，想要哪個按鈕的id或者name，就用滑鼠點到哪個按鈕上，比如我想要看更多按鈕的資訊，點選“更多”，就在右面介面中出來了text，id，class等資訊，其中的resourse-id就是id名。

第五步：這個工具還可以儲存當前頁面，這樣方便以後多次檢視當前頁面的控制元件內容，而不用每次去開啟APP，操作步驟，點選儲存按鈕，工具欄裡面的第四個按鈕，儲存後，會同時儲存兩個檔案，一個png檔案，一個uix檔案。儲存後怎麼開啟呢？點選工具上的第一個按鈕，open，點選後會彈出一個框，如圖：

上面那個路徑是剛才儲存的png路徑，下面是uix路徑，原來儲存的名字可能是dump開頭的，改一下名字，png和uix可以改成一樣的，這樣再次開啟的時候比較容易找。這樣開啟跟之前的方法打開出來的結果一樣。

3 appium自動化測試程式碼編寫

3.1定位元素

做自動化測試最重要的是要先定位到元素，appium定位元素和selenium類似，準確的說appium也是繼承了selenium的方法。

3.1.1通過id定位元素

driver.find_element_by_id("com.android.settings:id/title")

這個方法的引數寫的是id名，也就是resourse-id的值。這樣就找到id為"com.android.settings:id/title"的控制元件了，可以對它進行click等操作。

3.1.2通過class定位元素

接著上面的程式碼：driver.find_element_by_id("com.android.settings:id/title").click()，再寫一句：

driver.find_element_by_class_name("android.widget.ImageButton").click()

引數為“class”的值。

通過class name找到返回按鈕，點選返回按鈕。

3.1.3通過xpath定位元素

driver.find_element_by_xpath("//*[contains(@text, '更多')]").click()

driver.find_element_by_xpath("//*[contains(@content-desc, '向上')]").click()

全部的測試程式碼為：

# encoding=utf-8

from appium import webdriver
import time

server = r'http://localhost:4723/wd/hub'      # Appium Server, 埠預設為4723
desired_capabilities = {
    'platformName': 'Android',
    'driverName': '127.0.0.1:62001',          # 需替換成你的driverName
    'platformVersion': '5.1.1',
    'appPackage': 'com.android.settings',
    'appActivity': '.Settings'
}
driver = webdriver.Remote(server, desired_capabilities) # 連線手機和APP
driver.find_element_by_id("com.android.settings:id/title").click()  # 點選wlan
#time.sleep(2)
driver.find_element_by_class_name("android.widget.ImageButton").click()  # 點選返回
#time.sleep(2)
driver.find_element_by_xpath("//*[contains(@text, '更多')]").click()  # 點選更多
#time.sleep(2)
driver.find_element_by_xpath("//*[contains(@content-desc, '向上')]").click()  # 點選返回
#time.sleep(2)
driver.quit()

3.2定位多個元素

上面那些方法可以定位到一個元素，那麼find_elements_by_XXX可以找到多個元素，然後通過下標找你需要的元素。

比如上面那段程式碼中的這句話：

driver.find_element_by_id("com.android.settings:id/title").click()

這裡的id其實並不是唯一的，仔細看看設定頁面的其他的元素id，id值也都是這些。

所以可以像下面這樣寫：

eles = driver.find_elements_by_id("com.android.settings:id/title")

print(type(eles))  

eles[0].click()           # 點選eles這個列表的第一個元素

eles的型別是list。

3.3 WebDriverWait顯示等待

在一個超時時間範圍內，每隔一段時間去搜索一次元素是否存在，一旦找到，就返回，沒有找到就每隔一段時間找一次，直到超時後報錯。

程式碼編寫如下：

# 建立一個WebDriverWait類的物件，傳三個引數，第一個引數為driver，第二個引數是總共查詢的時間，單位秒，第三個引數為每隔1秒的時間查詢一次，如果查詢時間超過10秒還沒找到，就報超時錯誤。

wdw = WebDriverWait(driver, 10, 1)   

# wdw物件的方法有一個until()方法，這個方法的引數是一個匿名函式，這裡的匿名函式，形參x傳入的是driver，後面的表示式就是通過xpath找到更多這個按鈕。

ele = wdw.until(lambda x:x.find_element_by_xpath("//*[contains(@text, '更多')]"))

ele.click()

使用前需要匯入包：

from selenium.webdriver.support.ui import WebDriverWait

3.4元素操作

3.4.1點選元素

click()   # 上面已經使用過

3.4.2傳送資料到輸入框

send_keys(value):

ele.send_keys(“test”)

3.4.3清空輸入框的元素

clear():

ele.clear

程式碼示例：

# encoding=utf-8

from appium import webdriver
from selenium.webdriver.support.ui import WebDriverWait
import time

server = r'http://localhost:4723/wd/hub'      # Appium Server, 埠預設為4723
desired_capabilities = {
    'platformName': 'Android',
    'driverName': '127.0.0.1:62001',          # 需替換成你的driverName
    'platformVersion': '5.1.1',
    'appPackage': 'com.android.settings',
    'appActivity': '.Settings'
}
driver = webdriver.Remote(server, desired_capabilities)
wdw = WebDriverWait(driver, 10, 1)
# 點選搜尋
serach = wdw.until(lambda x:x.find_element_by_xpath("//*[contains(@content-desc, '搜尋')]"))
serach.click()
# 輸入搜尋內容
serach_text = wdw.until(lambda x : x.find_element_by_id("android:id/search_src_text"))
serach_text.send_keys("設定")

# 清空搜尋內容
serach_text.clear()
time.sleep(3)

driver.quit()

3.4.4獲取元素的文字內容

text:

wlan_button = driver.find_element_by_id("com.android.settings:id/title")

print(wlan_button.text)

3.4.5獲取元素的屬性值

get_attribute(“屬性名稱”)：   

value的值可以是name，text，className，resourceId

name：首先返回content-desc的值，如果沒有content-desc，就返回text屬性

text：返回text的屬性值

className：返回class屬性值，只有API在18版本以上才支援

resourceId：返回resource-id屬性值，只有API在18版本以上才支援

wdw = WebDriverWait(driver, 10, 1)

serach = wdw.until(lambda x:x.find_element_by_xpath("//*[contains(@content-desc, '搜尋')]"))

print("className:%s"%serach.get_attribute("className"))

print("resourceId:%s"%serach.get_attribute("resourceId"))

print("name:%s"%serach.get_attribute("content-desc"))  # 上面那段寫的是輸入”name”,首先返回content-desc的值，但是現在新版本輸入“name”就只返回text的值，所以如果輸入name沒有得到想要的，就試試看這樣寫get_attribute("content-desc")

print("name:%s"%serach.get_attribute("checked"))   # 返回True或者Flase，還有別的屬性也類似使用即可。

3.4.6獲取元素的位置

location:

想要獲取元素的位置，首先理解一下座標點，APP的每個控制元件元素都有一個座標點，比如下面的左上角的設定控制元件，左上角的座標點是(24,59),右下角的座標點是(84,100)。

越往右，x座標點越大，越往下，y座標點值越大。

wdw = WebDriverWait(driver, 10, 1)

serach = wdw.until(lambda x:x.find_element_by_xpath("//*[contains(@content-desc, '搜尋')]"))

print(serach.location)  # 返回一個字典：{'x': 648, 'y': 44}

3.4.7獲取控制元件的class

tag_name：

　　driver.find_element_by_name(u"選單").tag_name

3.4.8判斷該控制元件是否對使用者可見

is_displayed：

　　driver.find_element_by_id("xxx").is_displayed()    返回True或False

3.4.9獲取控制元件的大小

size：

driver.find_element_by_id("xxx").size

3.5滑動和拖拽

3.5.1 swipe：從A點滑動至B點，滑動時間為毫秒

driver.swipe(279,1081,320,354)

前面兩個值是A點的x，y座標，後面兩個值是B點的x，y座標，上面那個意思就是從下面的某個點滑動到上面某個點，模擬手機從下往上滑，第五個引數也可以寫，是個可選引數，意思是滑動總共花費的時間，單位是毫秒，有一個預設時間大約0.8s左右，比如：

driver.swipe(279,1081,320,354,5000)意思就是說從A點滑動到B點總共花費5s，可以和上面的比較一下，可以看出5s滑動的速度慢了，慣性小了。

還有一個類似的方法，按住A點後快速滑動至B點：

driver.flick(start_x, start_y, end_x, end_y)：傳入的也是AB點的座標，

3.5.2 scroll滑動事件：從一個元素滑動到另一個元素

# 找到應用元素

ying_yong = driver.find_element_by_xpath("//*[contains(@text, '應用')]")

# 找到藍芽元素

lan_ya = driver.find_element_by_xpath("//*[contains(@text, '藍芽')]")

從應用元素滑動到藍芽元素

driver.scroll(ying_yong, lan_ya)

3.5.3 drag 拖拽事件

ying_yong = driver.find_element_by_xpath("//*[contains(@text, '應用')]")

lan_ya = driver.find_element_by_xpath("//*[contains(@text, '藍芽')]")

driver.drag_and_drop(ying_yong, lan_ya)

drag和scroll的區別：drag是沒有慣性的，所謂沒有慣性的意思是每次滑動，滑動停止的位置都是一樣的，scroll從同一個元素滑動到另一個元素，多次執行的結果可能會不一樣。swipe

方法的最後一個引數時間設定的長一些，效果會等同於drag，如果不設定時間，那效果就等同於scroll。

多次滑動，可以參考下面的程式碼，要注意的是，find_element_by_xxx這個方法只找顯示在當前頁面的元素，不會找沒有顯示在當前頁面的元素。

ying_yong = driver.find_element_by_xpath("//*[contains(@text, '應用')]")
lan_ya = driver.find_element_by_xpath("//*[contains(@text, '藍芽')]")
driver.drag_and_drop(ying_yong, lan_ya)
# 下面這個按鈕不可以放到上面去，因為上句話是滑動，備份和重置按鈕只有在滑動後才能看到
bei_fen = driver.find_element_by_xpath("//*[contains(@text, '備份')]")

driver.drag_and_drop(bei_fen, ying_yong)

3.5.4綜合應用1

如果頁面上有”關於手機”元素，就點選，否則就向下翻頁，直到找到”關於手機”元素，點選它,，再判斷關於手機頁面是否有“5.1.1”。

# encoding=utf-8
from appium import webdriver
from selenium.webdriver.support.ui import WebDriverWait
import time

server = r'http://localhost:4723/wd/hub'      # Appium Server, 埠預設為4723
desired_capabilities = {
    'platformName': 'Android',
    'deviceName': '127.0.0.1:62001',          # 需替換成你的deviceName
    'platformVersion': '5.1.1',
    'appPackage': 'com.android.settings',
    'appActivity': '.Settings'
}
driver = webdriver.Remote(server, desired_capabilities)

while True:
    try:
        about_button = driver.find_element_by_xpath("//*[contains(@text, '關於')]")
        about_button.click()
        time.sleep(2)
        break
    except Exception:
        # 向下翻頁
        # 這裡還要注意，翻完頁之後，上一頁的最下面的元素還應該在頁面上，以免丟失元素
        driver.swipe(320,1081,320,500,3000)
        # 判斷關於我們頁面是否有5.1.1
        eles = driver.find_elements_by_id("android:id/summary")
        for i in eles:
            # if "5.1" in i.text:   # 判斷只要包含5.1就可以
            if i.text == "5.1.1":  # 判斷i.text必須等於5.1.1
                print("有5.1.1")
                break
        else:
            print("沒有")

driver.quit()

for...else...語法：for迴圈正常執行完畢的情況下（沒有執行break語句），繼續執行else語法，如果不是正常執行完畢的，即執行了break語言，就不執行else語句了。

3.6高階手勢 TouchAction

TouchAction是AppiumDriver的輔助類，主要針對手勢操作，比如滑動、長按、拖動等，原理是將一系列動作放在一個鏈條中傳送到伺服器，伺服器接收到該鏈條後，解析各個動作，逐個執行。

3.6.1手指輕敲

模擬手機輕輕點選一下螢幕的操作方法為：

tap(element=None, x=None, y=None, count=1)

其中element是被定位到的元素，x，y是敲擊的座標點

然後使用perform()方法傳送命令到伺服器執行

from appium import webdriver

from appium.webdriver.common.touch_action import TouchAction  # 導包

 

server = r'http://localhost:4723/wd/hub'      # Appium Server, 埠預設為4723

desired_capabilities = {

    'platformName': 'Android',

    'deviceName': '127.0.0.1:62001',          # 需替換成你的deviceName

    'platformVersion': '5.1.1',

    'appPackage': 'com.android.settings',

    'appActivity': '.Settings'

}

driver = webdriver.Remote(server, desired_capabilities)

tc = TouchAction(driver)   # 建立TouchAction類物件

 

# more_button = driver.find_element_by_xpath("//*[contains(@text, '更多')]")  

# tc.tap(more_button).perform()  # 可以直接傳入找到的元素

tc.tap(x=108, y=445).perform()  # 也可以不找元素，直接傳入座標

3.6.2手指按下和抬起

# 前面的程式碼都一樣
driver = webdriver.Remote(server, desired_capabilities)
more_button = driver.find_element_by_xpath("//*[contains(@text, '更多')]")
tc = TouchAction(driver)
tc.tap(more_button).perform()
# tc.press(x=24, y=478).perform()   # 按下某個點，不鬆開
tc.press(x=24, y=478).wait(5000).release().perform()   # 按下某個點，等待5秒鐘後，鬆開。可以理解為長按

用到的方法：

press(element=None, x=None, y=None, count=1)：長按

wait(time)：等待多少毫秒

release()：釋放

3.6.3長按 long_press

方法：

TouchAction(driver).long_presss(el=None, x=None, y=None, duration=1000)

el意思是可以傳入一個查詢到的元素，

x,y意思是傳入座標點

duration，是長按的時間，單位毫秒，預設1s

 

driver = webdriver.Remote(server, desired_capabilities)

tc = TouchAction(driver)

driver.find_element_by_xpath("//*[contains(@text, 'WLAN')]").click()

time.sleep(2)

tc.long_press(driver.find_element_by_xpath("//*[contains(@text, 'SSID')]")).perform()

3.6.4移動move_to()方法

move_to(el=None, x=None, y=None)：

這個方法跟前面的方法類似，第一個引數可以傳入一個找到的元素，第二個和第三個元素可以傳入座標點，選擇哪種方法都可以。

假如想要更改解鎖圖案為如圖的樣子：

程式碼可以如下：

# encoding=utf-8

from appium import webdriver

from appium.webdriver.common.touch_action import TouchAction

from selenium.webdriver.support.wait import WebDriverWait

 

server = r'http://localhost:4723/wd/hub'      # Appium Server, 埠預設為4723

desired_capabilities = {

    'platformName': 'Android',

    'deviceName': '127.0.0.1:62001',          # 需替換成你的deviceName

    'platformVersion': '5.1.1',

    'appPackage': 'com.android.settings',

    'appActivity':'.ChooseLockPattern'    # 活動名，解鎖圖案的頁面

}

driver = webdriver.Remote(server, desired_capabilities)

wdw = WebDriverWait(driver, 10, 1)

tc = TouchAction(driver)

 

tc.press(x=120, y=418)\

    .move_to(x=360, y=418)\

    .move_to(x=601, y=418)\

    .move_to(x=600, y=656)\

    .move_to(x=360, y=665)\

    .move_to(x=360, y=895)\

    .move_to(x=120, y=650)\

    .release()\

    .perform()

 

ps：這裡需要注意一點，用UIAutomatorViewer工具找各個點的座標找不到，這時候要用什麼找呢？可以開啟手機的開發者模式，用手機自帶的指標位置功能。

開啟方式：

進入設定->關於手機->多次點選版本號，就打開了開發者模式，找到”開發者選項”，按照圖示開啟：

 move_to需要注意：

tc.press(x=120, y=418).wait(1000).move_to(x=360, y=418).release().perform()

tc.press(x=120, y=418).move_to(x=360, y=418).wait(1000).release().perform()

上面這兩種寫法，wait放置的地方不同，move_to出來的結果有可能不一樣，上面這種寫法就可以，下面那個就會滑偏，原因：第一個寫法是因為指令碼直接轉換成了swipe的操作，認為是從哪裡滑動到哪裡，座標點都是絕對座標。

第二種寫法會被認為是相對座標，第二個座標點就被appium改成相對於前面的座標點的座標了。

appium1.8版本以上的應該就不會這樣了，兩種寫法都是按照絕對座標去滑動。

3.7針對手機操作的API

3.7.1獲取手機時間

device_time:

print(driver.device_time)

返回時間：2020-01-31T22:04:54+08:00

3.7.2獲取手機解析度

get_window_size():

print(driver.get_window_size())

返回一個字典：{'width': 720, 'height': 1280}

3.7.3開啟通知欄

open_notifications():

driver.open_notifications()

關閉的話點選手機的返回就可以

3.7.4返回網路的連線型別

network_connection：

'''返回一個指定網路連線型別的整數位掩碼（android）'''，即下面的方法裡面提到的數字

用法：driver.network_connection

3.7.5設定網路的連線（android）

set_network_connection(connectionType)：

這個方法的引數可以直接寫，0、1、2、4、6這幾個數字，也可以寫具體名如下：

    NO_CONNECTION = 0

    AIRPLANE_MODE = 1

    WIFI_ONLY = 2

    DATA_ONLY = 4

    ALL_NETWORK_ON = 6

比如：

driver.set_network_connection(1)

等同於

driver.set_network_connection(ConnectionType.ALL_NETWORK_ON)

3.7.6截圖

get_screenshot_as_file(路徑)：

把當前的頁面截圖放到對應路徑中。

截圖的方法：

driver.get_screenshot_as_file(“../xxx.png”)

比如出現bug的時候可以截圖，或者有一些輸入需要確認是否輸入正確等都可以截圖等case執行完畢後確認。

3.7.7檢查app是否已安裝

is_app_installed:

driver.is_app_installed("com.android.xxx")

3.7.8安裝app

install_app：

driver.install_app(app_path)

3.7.9刪除app

remove_app：

driver.remove_app(app_path)

3.7.10關掉app

close_app:

　　driver.close_app ()

3.7.11 keyevent()方法,通過keycode操作手機

keyevent(keycode):

driver.keyevent(24)  # 音量加

如果在連線手機的程式碼裡面，有automationName=’Uiautomator2’這樣的配置，則應該使用下面這個指令：

press_keycode(keycode)  

driver.press_keycode(24)  # 音量加

3.7.12 keycode列表

基本按鍵

手柄按鍵

電話按鍵

控制按鍵

組合鍵

符號

小鍵盤

功能鍵

多媒體鍵

其他