I've been using rules_apple successfully for a few projects and can run ios_unit_test in a simulator. However, there doesn't seem to be much documentation regarding how to run tests on a physical device. A great use case would be to easily measure on-device performance.

It would be tremendously helpful to have at least some documentation, if not working examples under the //examples directory.

I'm imagining something along the lines of:

• How to run a single ios_unit_test and ios_ui_test.
• How to run ios_unit_test_suite and ios_ui_test_suite.
• Examples of different runners and test_hosts and what they mean.
  • What's required in a host ios_application.
• Tulsi example.
• How this all fits with google/xctestrunner.