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 --iosAndroid: 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-toolsexport PATH=$PATH:/Users/ronhsieh/Library/Android/sdk/toolsexport JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-14.jdk/Contents/Homeexport 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, 或者 FirefoxOSplatformVersion
手机操作系统的版本
可至手机"设定"中"关于手机"的"软体资讯"中查看appPackage
执行的 Android 应用程式 package 名称
可以透过 $ adb shell pm list packages 指令获取所有 packagesappActivity
从 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) — HomebrewNode.jsappium-doctor - npmJava SE - Downloads | Oracle Technology Network | OracleDownload 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 AndroidPython自动化测试零基础入门到高级 Appium全解析