1. 前言
在AirtestIDE1.2.13版本中，我們新增了1個 安卓手機設置初始化的功能 （以下簡稱手機初始化功能），能夠在手機已經打開 USB調試、且已安裝 PocoService 的前提下，自動 進行一些手機相關設置項的自動設置工作。
比如有時候，我們會忘記設置pocoservice的自啓動、啓用Yosemite輸入法或者關閉安全鍵盤等，甚至新手同學可能並不知道要對哪些設置項進行操作，就可以使用1.2.13提供的手機初始化功能來幫助我們自動進行設置。
2. 準備工作
請務必確認以下所有步驟都已完成，否則無法使用手機初始化功能進行自動初始化：
1）打開USB調試
打開手機的開發者選項開關，然後在開發者選項中打開USB調試開關。
2）使用USB連接手機並信任設備
使用USB連接手機，當手機彈出信任彈窗時，點擊信任。
3）adb devices能看到手機
確認電腦上能夠用 adb devices 指令，看到手機出現在列表中。
4）確認手機設置
- 部分品牌如OPPO/VIVO/Realme手機，需要事先登錄賬號才能夠進行APK的安裝，請務必提前登錄賬號，以方便後續安裝apk步驟的進行（Yosemite.apk和pocoservice.apk）
- 小米手機需要確認【USB調試（安全設置）-允許模擬點擊】選項已經開啓
3. 如何使用
1）初始化功能入口
準備工作做好之後，我們可以在AirtestIDE的設備窗裏，點擊 刷新ADB ，等待刷出待測設備列表之後，再點擊 connect 右側的下拉按鈕，選擇 Init Device按鈕：
之後會彈出一個手機初始化功能的窗口：
在這個彈窗裏，我們可以事先填入安裝apk時需要輸入的密碼，之後點擊 開始初始化 ，在安裝apk時會自動幫我們輸入安裝密碼（無需我們人工處理）。
當然我們也可以不填入安裝密碼並點擊 開始初始化 ，這樣在安裝apk時，就需要人工輸入安裝密碼完成相應apk的安裝（pocoservice.apk和Yosemite.apk）。
2）簡單演示初始化功能
這裏我們簡單展示下手機初始化功能的效果：
3）如何停止初始化
點擊 停止運行 的按鈕即可停止自動初始化，快捷鍵是 shift+F5 。
4）結果查看
初始化功能結束後，會將該品牌的設置項都顯示在終端中，同時也會列出失敗的項目，部分失敗原因是本機型沒有相關設置項、或是無需設置，這種情況可以人工檢查複覈後忽略就行。
部分失敗原因是因爲我們預先寫好的規則中不包括該機型的相關設置，如果遇到了此種情況，可以將該機型+對應的正確設置方法反饋給我們（ https://airtest.netease.com/issue_create ），我們將會及時更新規則和相關文檔。
以下述初始化功能的log爲例：
----------------------- * * * -----------------------
OPPO手機的設置項：
- 連接模式-傳輸文件
- 【需手動設置】請事先登錄好OPPO賬號
- 【需手動設置】開發者選項開啓方式：連續點擊【設置-系統管理-關於手機-版本信息-軟件版本】
- 設置-電池-應用耗電管理-pocoservice-允許應用自啓動，允許完全後臺行爲
- 設置-其他設置-開發者選項-禁止權限監控 打開，充電時屏幕不休眠 打開
- 設置-其他設置-鍵盤與輸入法-管理輸入法-yosemite 啓用
- 設置-其他設置-鍵盤與輸入法-輸入密碼時啓用安全鍵盤 關閉
- 設置-安全與隱私-允許安裝未知來源的應用 打開 （不是所有機型都有）
- 【無需設置】如OPPO出現10分鐘斷連的情況，不要插拔手機，直接在屏幕上方下拉的選項裏再次打開 USB調試
----------------------- 以下步驟設置失敗： -----------------------
- 設置-安全與隱私-允許安裝未知來源的應用 打開
（本選項不是所有的機型都有）
錯誤原因：
Cannot find any visible node by query UIObjectProxy of "text=安全與隱私"
我們可以根據log中列出的選項，檢查手機上的各個選項是否正確被處理了。
出現錯誤的可能原因：
- 該手機並沒有相關的設置項，由於機型版本不同，導致設置項在同一品牌手機上也有很大差異，有些選項如果找不到可以忽略
- 部分手機有相關選項，但因爲機型或系統版本不同，導致我們目前的規則並沒有能夠覆蓋到該款手機，若出現該情況，可以將手機機型和對應的設置反饋給我們
- 部分選項不是必須的，如果不做處理，可能影響很小，可以視情況忽略（例如充電時保持屏幕常亮、或是監控ADB安裝應用等選項，並非必須要處理的選項）
- 幾乎絕大多數品牌手機都需要允許PocoSerivce.apk能夠在後臺啓動，部分手機可能在還沒來得及做出修改前，poco進程就被手機殺後臺了，可能需要手工處理（例如一加8T）
4. 注意事項
1）初始化功能做的事情
- 先進行手機圖像查看、點擊操作的初始化
- 安裝PocoService.apk，這個步驟可能需要人工在手機上進行安裝確認或輸入密碼
- 安裝Yosemite.apk，此步驟同樣可能需要人工確認
- 根據各品牌手機的一些設置規則，依次進行手機設置的修改，部分手機可能會因爲PocoService被手機自動殺後臺，導致初始化失敗，可以嘗試重複運行、或是人工設置
2）支持的品牌
以下是當前支持的品牌：
- 三星
- 華爲（包含榮耀）
- OPPO
- VIVO
- 一加
- Realme真我（大體與OPPO類似）
- 小米
- 魅族
3）相關設置項
本功能會關閉手機很多安全性相關的選項，主要爲自動化測試提供方便，如果是自己平時使用的手機，請先閱讀好下方的各個配置項列表，確認內容無誤後再運行:
小米手機（請務必登錄賬號先進行設置！！！！）
- 【需手動設置】需要插入sim卡並登錄小米賬號（小米開啓權限時需要插入SIM卡，完成選項開啓後可以拔卡）
- 【需手動設置】開啓開發者選項：連續點擊【設置 - 我的設備 - 全部參數 - MIUI版本】
- 【需手動設置】設置開發者選項：（根據MIUI版本不同，描述可能不一樣）
- 開啓【USB調試】、【USB安裝】、【USB調試（安全設置）-允許模擬點擊】
- 禁用開發者選項底部【啓動MIUI優化】、【高風險功能開啓提醒】
- 禁用手機管家-應用管理-權限-右上角的設置- 【應用權限監控】和 【USB安裝管理】
- 啓用手機管家-應用管理-權限-自啓動管理-PocoService，允許PocoService自啓動
- 語言與輸入法：關閉【安全鍵盤】，在輸入法管理中，啓用【Yosemite輸入法】
- 如果手機依然無法看到屏幕，可以檢查Yosemite.apk是否成功安裝（可以手動安裝），並且對應的權限都開啓了
華爲手機的設置項
- 【手動設置】USB模式-文件，若開啓了僅充電模式下允許調試才能直連
- 設置-高級設置-語言和輸入法-安全輸入 關閉 （不同機型該選項有不同入口）
- 設置-開發者選項-監控 ADB 安裝應用 關閉
- 設置-開發者選項-“僅充電”模式下允許 ADB 調試 打開
- 手機管家（大於8.0版本）-應用啓動管理-PocoService允許自啓動和後臺活動
OPPO手機的設置項
- 【需手動設置】請事先登錄好OPPO賬號
- 設置-電池-應用耗電管理-pocoservice-允許應用自啓動，允許完全後臺行爲
- 設置-其他設置-開發者選項-禁止權限監控 打開
- 設置-其他設置-鍵盤與輸入法-管理輸入法-yosemite 啓用
- 設置-其他設置-鍵盤與輸入法-輸入密碼時啓用安全鍵盤 關閉
- 【手動設置】如OPPO出現10分鐘斷連的情況，不要插拔手機，直接在屏幕上方下拉的選項裏再次打開 USB調試
VIVO手機的設置項
- 【需手動設置】請事先登錄好VIVO賬號
- 【需手動設置】設置-開發者選項-USB模擬點擊 打開（如有）
- 電池-後臺高耗電-> PocoService 開啓
- 設置-輸入法-安全輸入 關閉
- 開發者選項-安全權限 打開（暫未添加）
- 設置-安全與隱私-防止惡意截屏錄屏 關閉
- 設置-更多設置（或系統管理）-開發者選項->通過USB驗證應用 關閉
- 【可選】開發者選項-不鎖定屏幕 開啓 （此選項能避免長時間連接時，手機自動關閉開發者選項的問題，若需要長期連接可以開啓）
三星手機
- 【需手動設置】插入USB時，允許訪問手機數據
- 【需手動設置】選擇安裝PocoService（如果是國際版，可能會被google play檢測）
- 設置-顯示-屏幕分辨率-WQHD+-應用-確定，將分辨率調到最大
- 【暫未實現】部分型號手機在開發者選項中，打開未知來源、取消權限監控。
Realme真我（與OPPO基本一致）
- 【需手動設置】請事先登錄好Realme賬號
- 設置-電池-應用耗電管理-pocoservice-允許應用自啓動，允許完全後臺行爲
- 設置-其他設置-開發者選項-禁止權限監控 打開（必須），充電時屏幕不休眠 打開（非必須）
- 設置-其他設置-鍵盤與輸入法-【管理輸入法-yosemite】 啓用， 【輸入密碼時啓用安全鍵盤】 關閉
一加手機的設置項
- 【可能需手動設置】設置-電池-電池優化-PocoService-不優化 （可能在設置成功前，進程就已經被手機終止了，因此本選項可能需要手工進行設置）
- 設置-其他設置-鍵盤與輸入法-輸入密碼時啓用安全鍵盤 關閉
- 設置-其他設置-鍵盤與輸入法-管理輸入法-Yosemite輸入法 啓用
- 設置-其他設置-開發者選項-禁止權限監控 打開， 充電時屏幕不休眠 打開（非必選）
魅族手機的設置項
- 手機管家-權限管理-後臺管理-PocoService-允許後臺運行
- 手機管家-USB安裝管理-USB安裝管理 取消選中，可以在安裝apk時不再出現彈窗
- 設置-語言和時間-Yosemite輸入法 勾選，取消密碼安全保護
Airtest官網：https://airtest.netease.com/
Airtest教程官網：https://airtest.doc.io.netease.com/
搭建企業私有云服務：https://airlab.163.com/b2b
官方答疑 Q 羣：117973773
呀，這麼認真都看到這裏啦，幫忙點個推薦支持一下唄，灰常感謝~