# iOS Unit Tests

These are the unit tests for iOS engine.  They can be executed locally and are
also run in LUCI builds.

## Running Tests

To build and run the iOS tests, run the following script from the src directory:

```sh
flutter/testing/run_tests.py --type=objc
```

After the `ios_test_flutter` target is built you can also run the tests inside
of Xcode with `testing/ios/IosUnitTests/IosUnitTests.xcodeproj`.

When you load the test project [IosUnitTests.xcodeproj](IosUnitTests.xcodeproj)
into Xcode after running `run_tests.py`, only a few basic tests will appear
initially. You have to run the test suite once in Xcode for the rest to appear.
Select "iPhone 11" as the device, and press `command-u` to start all the tests
running. Once the tests are done running, the tests that ran will appear in the
sidebar, and you can pick the specific one you want to debug/run.

If you modify the test or under-test files, you'll have to run
[`run_tests.py`](../../run_tests.py) again.

## Adding Tests

When you add a new unit test file, also add a reference to that file in
[`shell/platform/darwin/ios/BUILD.gn`](../../../shell/platform/darwin/ios/BUILD.gn),
under the `sources` list of the `ios_test_flutter` target. Once it's there, it
will execute with the other tests.