| Joe Gregorio | 02f7202 | 2021-03-27 10:12:45 -0400 | [diff] [blame] | 1 | --- |
| Joe Gregorio | e296c56 | 2021-04-05 11:39:40 -0400 | [diff] [blame] | 2 | title: 'Testing on iOS' |
| 3 | linkTitle: 'Testing on iOS' |
| Joe Gregorio | 02f7202 | 2021-03-27 10:12:45 -0400 | [diff] [blame] | 4 | --- |
| 5 | |
| 6 | Before setting Skia up for automated testing from the command line, please |
| Joe Gregorio | e296c56 | 2021-04-05 11:39:40 -0400 | [diff] [blame] | 7 | follow the instructions to run Skia tests (_dm_, _nano-bench_) with the |
| 8 | mainstream iOS tool chain. See the |
| 9 | [quick start guide for ios](/docs/user/build/). |
| Joe Gregorio | 02f7202 | 2021-03-27 10:12:45 -0400 | [diff] [blame] | 10 | |
| 11 | iOS doesn't lend itself well to compiling and running from the command line. |
| 12 | Below are instructions on how to install a set of tools that make this possible. |
| Joe Gregorio | e296c56 | 2021-04-05 11:39:40 -0400 | [diff] [blame] | 13 | To see how they are used in automated testing please see the bash scripts used |
| 14 | by the buildbot recipes: |
| Eric Boren | 04fe267 | 2021-09-27 10:15:39 -0400 | [diff] [blame] | 15 | <https://github.com/google/skia/tree/main/platform_tools/ios/bin>. |
| Joe Gregorio | 02f7202 | 2021-03-27 10:12:45 -0400 | [diff] [blame] | 16 | |
| Joe Gregorio | e296c56 | 2021-04-05 11:39:40 -0400 | [diff] [blame] | 17 | ## Installation |
| 18 | |
| Joe Gregorio | 02f7202 | 2021-03-27 10:12:45 -0400 | [diff] [blame] | 19 | The key tools are |
| 20 | |
| Joe Gregorio | e296c56 | 2021-04-05 11:39:40 -0400 | [diff] [blame] | 21 | - libimobiledevice <http://www.libimobiledevice.org/>, |
| 22 | <https://github.com/libimobiledevice/libimobiledevice> |
| Joe Gregorio | 02f7202 | 2021-03-27 10:12:45 -0400 | [diff] [blame] | 23 | |
| Joe Gregorio | e296c56 | 2021-04-05 11:39:40 -0400 | [diff] [blame] | 24 | - ios-deploy <https://github.com/phonegap/ios-deploy> |
| Joe Gregorio | 02f7202 | 2021-03-27 10:12:45 -0400 | [diff] [blame] | 25 | |
| 26 | Follow these steps to install them: |
| 27 | |
| Joe Gregorio | e296c56 | 2021-04-05 11:39:40 -0400 | [diff] [blame] | 28 | - Install Brew at <http://brew.sh/> |
| 29 | - Install _libimobiledevice_ (Note: All these are part of the _libimobiledevice_ |
| 30 | project but packaged/developed under different names. The _cask_ extension to |
| 31 | _brew_ is necessary to install _osxfuse_ and _ifuse_, which allows to mount |
| 32 | the application directory on an iOS device). |
| Joe Gregorio | 02f7202 | 2021-03-27 10:12:45 -0400 | [diff] [blame] | 33 | |
| 34 | ``` |
| 35 | brew install libimobiledevice |
| 36 | brew install ideviceinstaller |
| 37 | brew install caskroom/cask/brew-cask |
| 38 | brew install Caskroom/cask/osxfuse |
| 39 | brew install ifuse |
| 40 | ``` |
| 41 | |
| Joe Gregorio | e296c56 | 2021-04-05 11:39:40 -0400 | [diff] [blame] | 42 | - Install node.js and ios-deploy |
| Joe Gregorio | 02f7202 | 2021-03-27 10:12:45 -0400 | [diff] [blame] | 43 | |
| 44 | ``` |
| 45 | $ brew update |
| 46 | $ brew install node |
| 47 | $ npm install ios-deploy |
| 48 | ``` |