backend/e2e/docs/mobile-safari.md (view raw)
1### Mobile Safari
2
3To run the tests with Mobile Safari on iOS Simulator, follow these steps:
4
51. Install [Xcode](https://itunes.apple.com/us/app/xcode/id497799835) from the
6 Mac App Store.
7
82. Install the Xcode Command Line Tools:
9
10 ```sh
11 xcode-select --install
12 ```
13
143. Install [Node.JS](https://nodejs.org/) and
15 [Carthage](https://github.com/Carthage/Carthage) via
16 [Homebrew](https://brew.sh/):
17
18 ```sh
19 brew install node carthage
20 ```
21
224. Make sure the necessary [Appium](https://appium.io/) dependencies for iOS
23 testing are installed:
24
25 ```sh
26 npx appium-doctor --ios
27 ```
28
295. Install [Appium](https://appium.io/) as global NPM package:
30
31 ```sh
32 npm install -g appium
33 ```
34
356. Add the `example` host to your `/etc/hosts` file:
36
37 ```sh
38 printf '127.0.0.1\t%s\n' example | sudo tee -a /etc/hosts
39 ```
40
417. Start `appium` with the provided helper script:
42
43 ```sh
44 bin/appium.sh
45 ```
46
478. Run the tests with Mobile Safari:
48
49 ```sh
50 docker-compose run --rm wdio conf/mobile-safari.js
51 ```
52
53 To run the tests in landscape orientation, provide the `ORIENTATION`
54 environment variable:
55
56 ```sh
57 ORIENTATION=LANDSCAPE docker-compose run --rm wdio conf/mobile-safari.js
58 ```
59
60 To use a different iOS device than defined in the config, provide the
61 `DEVICE_NAME` environment variable:
62
63 ```sh
64 DEVICE_NAME='iPad Pro (11-inch)' \
65 docker-compose run --rm wdio conf/mobile-safari.js
66 ```
67
68 To use a different iOS version than defined in the config, provide the
69 `PLATFORM_VERSION` environment variable:
70
71 ```sh
72 PLATFORM_VERSION=12.1 docker-compose run --rm wdio conf/mobile-safari.js
73 ```