Skip to content

SKILL.md

Latest commit

 

History

History
39 lines (29 loc) · 2.03 KB

SKILL.md

File metadata and controls

39 lines (29 loc) · 2.03 KB
name description version
ios-instrumented-tests
This skill should be used when the user asks about "running iOS tests", "iOS instrumented tests", "how to run ios tests", "launch specific ios test" and these tests are located in the "compose/ui/ui/src/uikitInstrumentedTest" directory.
1.0.0

iOS Instrumented tests are designed to run XCTests written on Kotlin using the iOS Simulator as an environment.

iOS Instrumented Tests — Compose Multiplatform Core

Perform steps exactly in the following order:

Configure which tests should be started

In the file compose/ui/ui/src/uikitInstrumentedTest/kotlin/androidx/compose/ui/Configuration.kt write all tests that must be launched. Add corresponding imports in the header. Save the file. If it's needed to run all instrumented, pass nothing to the setupXCTestSuite. Follow the examples in commented code in the file. Note: configuration can launch either entire test classes or multiple test cases from a single test class only.

Running All iOS Tests

  1. Get a list of all devices and select the most appropriate one. Prefer the latest iPhone with the latest iOS if nothing else said. Select and remember corresponding simulator id for the next step.
xcrun xctrace list devices
  1. Navigate to the launcher repository root:
cd compose/ui/ui/src/uikitInstrumentedTest/launcher
  1. Build and run tests
xcodebuild test -scheme Launcher -project Launcher.xcodeproj -destination 'platform=iOS Simulator,id=<Simulator ID>'

Key Test Source Locations

(from the repository root) compose/ui/ui/src/uikitInstrumentedTest/kotlin/androidx/compose/ui/Configuration.kt - location of the configuration file which determines which tests to run. compose/ui/ui/src/uikitInstrumentedTest/kotlin/androidx/compose/ui/test - Test environment and utilities to configure tests testutils/testutils-xctest/ - Contains a Kotlin wrapper that allows converting Kotlin tests to XCTests as well as an Objective-C project that provides API for low-level touches and other input gesture simulation.