Skip to content
This repository has been archived by the owner on Jul 29, 2024. It is now read-only.

Commit

Permalink
chore(docs): update docs to use webdriver-manager for mobile setup
Browse files Browse the repository at this point in the history
  • Loading branch information
sjelin committed Nov 11, 2016
1 parent 6b7b6fb commit 69ee43a
Showing 1 changed file with 24 additions and 89 deletions.
113 changes: 24 additions & 89 deletions docs/mobile-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,65 +7,10 @@ does not yet officially support or run its own tests against a particular config
Setting Up Protractor with Appium - Android/Chrome
-------------------------------------
###### Setup
* Install Java SDK (>1.6) and configure JAVA_HOME (Important: make sure it's not pointing to JRE).
* Follow http://spring.io/guides/gs/android/ to install and set up Android developer environment. Do not set up Android Virtual Device as instructed here.
* From commandline, ```android avd``` and then install an AVD, taking note of the following:
* Start with an ARM ABI
* Enable hardware keyboard: ```hw.keyboard=yes```
* Enable hardware battery: ```hw.battery=yes```
* Use the Host GPU
* Here's an example:

Phone:
```shell
> android list avd
Available Android Virtual Devices:
Name: LatestAndroid
Device: Nexus 5 (Google)
Path: /Users/hankduan/.android/avd/LatestAndroid.avd
Target: Android 4.4.2 (API level 19)
Tag/ABI: default/armeabi-v7a
Skin: HVGA
```

Tablet:
```shell
> android list avd
Available Android Virtual Devices:
Name: LatestTablet
Device: Nexus 10 (Google)
Path: /Users/hankduan/.android/avd/LatestTablet.avd
Target: Android 4.4.2 (API level 19)
Tag/ABI: default/armeabi-v7a
Skin: WXGA800-7in
```
* Follow http://ant.apache.org/manual/index.html to install ant and set up the environment.
* Follow http://maven.apache.org/download.cgi to install mvn (Maven) and set up the environment.
* NOTE: Appium suggests installing Maven 3.0.5 (I haven't tried later versions, but 3.0.5 works for sure).
* Install Appium using node ```npm install -g appium```. Make sure you don't install as sudo or else Appium will complain.
* You can do this either if you installed node without sudo, or you can chown the global node_modules lib and bin directories.
* Start emulator manually (at least the first time) and unlock screen.

```shell
> emulator -avd LatestAndroid
```
* Your devices should show up under adb now:

```shell
> adb devices
List of devices attached
emulator-5554 device
```
* If the AVD does not have chrome (and it probably won't if it just created), you need to install it:
* You can get v34.0.1847.114 from http://www.apk4fun.com/apk/1192/
* Once you download the apk, install to your AVD as such:

```shell
> adb install ~/Desktop/chrome-browser-google-34.0.1847.114-www.apk4fun.com.apk
2323 KB/s (30024100 bytes in 12.617s)
Success
```
* If you check your AVD now, it should have Chrome.
Use `webdriver-manager` to install `appium` and the Android SDK. See details
[on the WebDriver Manager page](
https://github.com/angular/webdriver-manager/blob/master/mobile.md).

###### Running Tests
* Ensure app is running if testing local app (Skip if testing public website):
Expand All @@ -74,23 +19,22 @@ Success
> npm start # or `./scripts/web-server.js`
Starting express web server in /workspace/protractor/testapp on port 8000
```
* If your AVD isn't already started from the setup, start it now:

```shell
> emulator -avd LatestAndroid
```
* Start Appium:
* Start appium and the Android Emulators (details [on the WebDriver Manager
page](https://github.com/angular/webdriver-manager/blob/master/mobile.md)).

```shell
> appium
info: Welcome to Appium v1.0.0-beta.1 (REV 6fcf54391fb06bb5fb03dfcf1582c84a1d9838b6)
info: Appium REST http interface listener started on 0.0.0.0:4723
info: socket.io started
> webdriver-manager start --android
```
*Note Appium listens to port 4723 instead of 4444*

* Configure protractor:

additional dependencies:
```shell
npm install --save-dev wd wd-bridge
```

Config File:
```javascript
exports.config = {
seleniumAddress: 'http://localhost:4723/wd/hub',
Expand All @@ -100,14 +44,13 @@ exports.config = {
// Reference: https://github.com/appium/sample-code/blob/master/sample-code/examples/node/helpers/caps.js
capabilities: {
browserName: 'chrome',
'appium-version': '1.0',
platformName: 'Android',
platformVersion: '4.4.2',
platformVersion: '7.0',
deviceName: 'Android Emulator',
},

baseUrl: 'http://10.0.2.2:8000',

// configuring wd in onPrepare
// wdBridge helps to bridge wd driver with other selenium clients
// See https://github.com/sebv/wd-bridge/blob/master/README.md
Expand All @@ -126,14 +69,10 @@ exports.config = {
Setting Up Protractor with Appium - iOS/Safari
-------------------------------------
###### Setup
* Install Java SDK (>1.6) and configure JAVA_HOME (Important: make sure it's not pointing to JRE).
* Follow http://ant.apache.org/manual/index.html to install ant and set up the environment.
* Follow http://maven.apache.org/download.cgi to install mvn (Maven) and set up the environment.
* NOTE: Appium suggests installing Maven 3.0.5 (I haven't tried later versions, but 3.0.5 works for sure).
* Install Appium using node ```npm install -g appium```. Make sure you don't install as sudo or else Appium will complain.
* You can do this either if you installed node without sudo, or you can chown the global node_modules lib and bin directories.
* Run the following: `appium-doctor` and `authorize_ios` (sudo if necessary)
* You need XCode >= 4.6.3, 5.1.1 recommended. Note, iOS8 (XCode 6) did not work off the shelf (see https://github.com/appium/appium/pull/3517) but this was resolved [soon after Oct 13, 2014](https://github.com/appium/appium/pull/3517#issuecomment-58940157)

Use `webdriver-manager` to install `appium` and the Android SDK. See details
[on the WebDriver Manager page](
https://github.com/angular/webdriver-manager/blob/master/mobile.md).

###### Running Tests
* Ensure app is running if testing local app (Skip if testing public website):
Expand All @@ -142,22 +81,20 @@ Setting Up Protractor with Appium - iOS/Safari
> npm start # or `./scripts/web-server.js`
Starting express web server in /workspace/protractor/testapp on port 8000
```

* Start Appium:

```shell
> appium
info: Welcome to Appium v1.0.0-beta.1 (REV 6fcf54391fb06bb5fb03dfcf1582c84a1d9838b6)
info: Appium REST http interface listener started on 0.0.0.0:4723
info: socket.io started
> webdriver-manager start
```
*Note: Appium listens to port 4723 instead of 4444.*

* Configure protractor:

additional dependencies:
```shell
npm install --save-dev wd wd-bridge
```
additional dependencies:
```shell
npm install --save-dev wd wd-bridge
```

iPhone:
```javascript
Expand All @@ -171,7 +108,6 @@ exports.config = {
// Reference: https://github.com/appium/sample-code/blob/master/sample-code/examples/node/helpers/caps.js
capabilities: {
browserName: 'safari',
'appium-version': '1.0',
platformName: 'iOS',
platformVersion: '7.1',
deviceName: 'iPhone Simulator',
Expand Down Expand Up @@ -203,7 +139,6 @@ exports.config = {
// Reference: https://github.com/appium/sample-code/blob/master/sample-code/examples/node/helpers/caps.js
capabilities: {
browserName: 'safari',
'appium-version': '1.0',
platformName: 'iOS',
platformVersion: '7.1',
deviceName: 'IPad Simulator',
Expand Down

0 comments on commit 69ee43a

Please sign in to comment.