Provide a full end to end example

[jiawen]

I'm a long-time Bazel user getting into iOS development. Some of the terms are still mysterious to me. I think it would be helpful to this project and to bazelbuild/rules_apple to provide an end to end example of how to use xctestrunner.

• What is a app under test?
  • What's required? How much needs to be stubbed out?
  • Provide a minimal template that can be used directly or extended?
• What is the test bundle?
• How do they fit together with xctestrunner to run on device.
• Is it possible to build a multi-arch binary so that the same test can be run on both simulator and device?

[jiawen]

I finally got stuff running by way of Bazel's rules_apple. @albertdai Are you amenable to pull requests that clarify the command line arguments?

[jiawen]

Apple's xcode / command line documentation is surprisingly sparse on the web. The man pages seem slightly easier to digest for someone new to Apple programming.

I want to clarify in the command line args help that:

--test_bundle_path should point to a .xctest bundle (directory). Bazel builds ios_unit_test targets as .zip: you need to unzip it.
--app_under_test_path should point to a .app bundle (directory). Bazel builds ios_application targets as .ipa: you need to unzip it and pull it out of its Payload directory.

Maybe not that exact wording.

@keith FYI.

[albertdai]

Sure. I can update the document for the file type of --test_bundle_path and --app_under_test_path.

--app_under_test_path can be .app or .ipa. --test_bundle_path can be .xctest or .zip

[bartekpacia]

@albertdai I'd love to see a full usage example together with some :) Maybe also screenshots/gifs in the readme showing how the tool works?

[tirodkar]

@me11kiy could look into this. Folks, this project is currently under community maintenance and we unfortunately can't add new features or docs, but are happy to look at your PR's.

Was #39 (comment) completed?

[mchandr5]

@albertdai I'd love to see a full usage example together with some :) Maybe also screenshots/gifs in the readme showing how the tool works?

Following... It would be of great help if we get some examples.