How to use?
To begin with you should use this order of arguments
// iOS
xrun extension project scheme version iPhone
// macOS
xrun extension project scheme macOS
Example .xcodeproj¶
// iOS
xrun project DeliveryApp.xcodeproj DeliveryApp 17.4 15
// macOS
xrun project DeliveryApp.xcodeproj DeliveryApp macOS
Example .xcworkspace¶
// iOS
xrun workspace DeliveryApp.xcworkspace DeliveryApp 17.4 15
// macOS
xrun workspace DeliveryApp.xcworkspace DeliveryApp macOS
Example with fail¶
If you want when any test fails at the end, shows the terminal or CI as an error (it is optional if you don’t use it and even test fails not to show it at terminal or CI as an error).
// iOS
xrun workspace DeliveryApp.xcworkspace DeliveryApp 17.4 15 fail
// macOS
xrun workspace DeliveryApp.xcworkspace DeliveryApp macOS fail
Example generating pdf of the error¶
If there are errors in the tests, use generate-file to generate a results-xrun.pdf file with the error table.
// iOS
xrun workspace DeliveryApp.xcworkspace DeliveryApp 17.4 15 fail generate-file
or
xrun workspace DeliveryApp.xcworkspace DeliveryApp 17.4 15 generate-file
------------
// macOS
xrun workspace DeliveryApp.xcworkspace DeliveryApp macOS fail generate-file
or
xrun workspace DeliveryApp.xcworkspace DeliveryApp macOS generate-file
Example when tests fail
CoordinatorTests
✅ testHandleEvent (0.001 seconds)
❌ testInit, XCTAssertNil failed: "Coordinator.BaseCoordinator"
✅ testStart (0.000 seconds)
AnalyticsTests
✅ testExample (0.001 seconds)
AuthenticationTests
❌ testShouldValidateLayout, failed - Snapshot does not match reference.
🗳️ The results have been completed below
+---------+-------------+-----------------+------------------+
| Runtime | Total Tests | ✅ Passed Tests | ❌ Failed Tests |
+============================================================+
| 35.64s | 48 | 46 | 2 |
+---------+-------------+-----------------+------------------+
⚠️ Below contains the errors
+---------------------+------------------------------------------------------------------------------+
| Module | Errors found |
+====================================================================================================+
| CoordinatorTests | ❌ testInit, XCTAssertNil failed: "Coordinator.BaseCoordinator" |
|---------------------+------------------------------------------------------------------------------|
| AuthenticationTests | ❌ testShouldValidateLayout, failed - Snapshot does not match reference. |
+---------------------+------------------------------------------------------------------------------+
Last update: November 15, 2024