Photo on kobiton.com

前言

上禮拜因為小弟愚鈍，在某個地方卡了特別久
所以只有非常簡單的介紹了一下 appium desktop 的安裝

而這禮拜的內容，將著重在 Start Appium Desktop Session
但是此篇的內容小弟會先以 MacOS 與 Android 的真機來做實作

本週學習重點

• Start Session 的前置作業 (JDK, SDK, Carthage)
• 使用 appium-doctor 檢查環境配置
• 使用 adb 來獲取 Session 的相關資訊

Appium Desktop Session 的前置作業

安裝 Homebrew (for MacOS)

使用 Mac 但是沒裝過 Homebrew 的大哥大姐
小弟在這邊 建議可以安裝一下
因為用 brew 指令在 Mac 上安裝軟體 相當的方便

如果不確定是否已經安裝可以透過查詢版本來確認
$ brew --version

至於安裝的話可以到 Homebrew 的官網看看 >>> 點我前往官網
也可以直接透過下面的指令進行安裝
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

安裝 node.js

如果不確定是否已經安裝可以透過查詢版本來確認
$ node -v 和 $ npm -v

安裝的話可以到 nodejs 官方網站進行安裝 >>> 點我前往官網
也可以直貼透過指令用剛剛安裝的 Homebrew 進行安裝
$ brew install node

安裝 appium-doctor

如果不確定是否已經安裝可以透過查詢版本來確認
$ appium-doctor --version

基於上週已經成功安裝 appium desktop
為了確保當前環境是否滿足 appium 的執行環境
此時就可以透過 appium-doctor 來檢查
$ npm install appium-doctor -g

安裝完成後可以透過指令來檢查 iOS 或 Android 執行環境

• iOS: appium-doctor --ios
• Android: appium-doctor --android

設置 Appium desktop 測試環境所需工具

安裝 Java Developer Kit (JDK)

如果不確定是否已經安裝可以透過查詢版本來確認
$ java --version

Java SE-下載|Oracle技術網|甲骨文
可以依照自己的作業系統，安裝想要的版本
小弟是直接裝最新版的 Java SE 14

安裝 Android Software Development Kit (SDK)

下載Android Studio和SDK工具| Android開發人員
下載完成後將 Android Studio 拉近 Applications

點擊 Android Studio 的 logo 來啟動 Android Studio
使用預設的方式來安裝 SDK，也可以透過 configuration 來重新下載

配置 JAVA 與 Android 的環境變數

使用指令開啟 profile 檔案，並且新增 PATH
小弟這邊適用 vi 文字編輯器
如果習慣使用 nano 的大哥大姐
也可以將下方指令的 vi 改為 nano
$ vi ~/.profile
開啟後就可以開始配置環境變數了
要記得改 user name 跟 jdk 的版本喔

export ANDROID_HOME=/Users/ronhsieh/Library/Android/sdk/
export PATH=$PATH:/Users/ronhsieh/Library/Android/sdk/build-tools/
export PATH=$PATH:/Users/ronhsieh/Library/Android/sdk/platform-tools
export PATH=$PATH:/Users/ronhsieh/Library/Android/sdk/tools

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-14.jdk/Contents/Home
export PATH=${PATH}$JAVA_HOME/bin

完成編輯後，可以重新開啟 cmd 或是透過下面指令來更新配置內容
$ source ~/.profile

安裝 Carthage

如果不確定是否已經安裝可以透過查詢版本來確認
$ Carthage version

還沒安裝的話，可以透過指令使用 Homebrew 進行安裝
$ brew install carthage

Appium Desktop Session 設置

開啟 Appium Desktop

開啟在上週，安裝的 Appium Desktop
在啟動 Server 前點擊下方的 Edit Configurations (可做可不做)
輸入 ANDROID_HOME, JAVA_HOME 的 Path

設定完之後就可以啟動 Server 了

開啟 Inspector Session

點擊 Appium log 頁面中 右上角的 Inspector Session

開啟新視窗後，完成左下角 Desired Capabilities 的設定

完成設定後也可以透過右下角的 Save As... 儲存

• deviceName
  使用的手機或模擬器類型
  可以透過 $ adb devices 指令獲取
  <<<小弟是使用真機，所以在下指令前以用 USB 將手機與 Mac 連結>>>
• platformName
  使用的手機操作系統
  iOS, Android, 或者 FirefoxOS
• platformVersion
  手機操作系統的版本
  可至手機"設定"中"關於手機"的"軟體資訊"中查看
• appPackage
  執行的 Android 應用程式 package 名稱
  可以透過 $ adb shell pm list packages 指令獲取所有 packages
• appActivity
  從 app package 中所要啟動的 Android acticity
  可以透過 $ adb shell dumpsys window windows |grep -E ' mObscuringWindow' 指令獲取

小弟這邊是使用 Android 的內建計算機做示範
mObscuringWindow=Window{5966b99 u0 com.sec.android.app.popupcalculator/com.sec.android.app.popupcalculator.Calculator}
前面的 com.sec.android.app.popupcalculator 為 appPackage
後面的 com.sec.android.app.popupcalculator.Calculator 為 appActivity

結尾

在上述的操作中使用的是真機
但是小弟不確定手機未開啟 開發人員選項 是否會受影響
如果有大哥大姐未開啟 開發人員選項 也可以正常執行的話
再麻煩告訴小弟一聲

另外開啟手機的"開發人員選項"的方式為
進入手機"設定"中"關於手機"的"軟體資訊"輕觸版本號碼八次"

以上是這週的 Appium Desktop Sesstion 的介紹
如果有疑問或是有錯誤，還請各位大哥大姐提點。
小弟將繼續往下週邁進。 ─=≡Σ((( つ•̀ω•́)つ

參考文件：

官方網站 (載點)

• The Missing Package Manager for macOS (or Linux) — Homebrew
• Node.js
• appium-doctor - npm
• Java SE - Downloads | Oracle Technology Network | Oracle
• Download Android Studio and SDK tools | Android Developers

相關文章

• mac OS 下超詳細搭建 Appiumm 自動化測試環境 - IT閱讀
• MAC本上appium連線真機 - IT閱讀
• appium/caps.md at master · appium/appium

相關影片

• Appium Python Tutorial - Appium Desired Capabilities For Android
• Python自动化测试零基础入门到高级 Appium全解析