bazelbuild / bazelbuild/rules_apple

Examples and/or documentation for running iOS tests on a physical device

Open
#1,215 7 comments 0 reactions 0 assignees View on GitHub
Dominant language
Starlark
Stars
593
Forks
334
Avg merge
16h 48m
Merged PRs (30d)
9

Description

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 `runner`s and `test_host`s and what they mean.
* What's required in a host `ios_application`.
* Tulsi example.
* How this all fits with [google/xctestrunner](https://github.com/google/xctestrunner).

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the existing documentation and the //examples directory for ios_unit_test, ios_ui_test, ios_unit_test_suite, and ios_ui_test_suite. Compare the requested runner and test_host cases, Tulsi, and google/xctestrunner integration, then document or add examples that cover physical-device execution and define what host ios_application configuration is required.

Written by the indexing model from the issue text.

Assessment

Tech stack
ios
Domain
documentation, mobile-dev, testing-qa
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.