| # Developing Chrome for iOS with the Xcode IDE |
| |
| This document contains notes used during a presentation about how to use Xcode |
| to develop Chrome for iOS. |
| |
| ## Background |
| |
| ### .xcodeproj |
| |
| * Open all.xcodeproj only. |
| * Generated from BUILD.gn files. |
| * Don't make changes to it as it is a "fake" representation of the project |
| - changes will not be committed |
| - changes will be overwritten without warning |
| * Modify BUILD files instead |
| * Added BUILD.gn files/`source_sets` need to be referenced from other ones as |
| a `dep` in order for it to be shown in xcode. |
| |
| ### Adding new files |
| |
| * Create new files with `tools/boilerplate.py` |
| * Add files to BUILD.gn `mate ios/chrome/...BUILD.gn` |
| * Add new source_set target as a dep of another target |
| * Execute `gclient runhooks` or `gclient sync` |
| |
| ### Simulators |
| |
| * Simulators build for Mac architecture, not emulators. Fast, generally good |
| for most development |
| * To run on device, need provisioning profiles and certificate |
| |
| ## Xcode |
| |
| * Project location is `src/out/build/`, open `all.xcodeproj` |
| * Choose "Automatically generate targets" after a `gclient sync` |
| * Start typing while dropdowns are presented to filter the displayed items |
| |
| ### Targets |
| |
| * `chrome' is the main application target |
| * `ios_web_shell` and `ios_web_view_shell` test lower level of application |
| |
| ### Tests |
| |
| * Unittests/Inttests |
| - Add flags to specify tests to run (Option-Click on unittest target name, |
| select Run from left panel, add to "Arguments Passed on Launch") |
| - `gtest_filter=TestClass.*` |
| - `gtest_repeat=20` |
| - Full list of options available by sending an unknown option |
| |
| * EarlGrey |
| - EG1 deprecated |
| - EG2 are current UI tests |
| - A separate "test" process communicates with "the app". |
| - EDO is term for "distant object" on "the other side". |
| - egtest files can run under both EG1 and EG2 with correct setup in |
| BUILD.gn because the layer of helpers encapsulate the necessary |
| differences. |
