Skip to content

Commit 7e62bd2

Browse files
committed
docs(docs): add docs for 0.10.0 and remove deprecated versions
1 parent e30d243 commit 7e62bd2

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

58 files changed

+794
-4218
lines changed

Diff for: docs/runner_versioned_docs/version-0.9.0/android/install.md renamed to docs/runner_versioned_docs/version-0.10.0/android/install.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ plugins {
5050
All the test tasks will start with **marathon** prefix, for example **marathonDebugAndroidTest**.
5151

5252
[1]: https://plugins.gradle.org
53-
[2]: ../intro/install.md
53+
[2]: intro/install.md
5454

5555
## Configure
5656

Diff for: docs/runner_versioned_docs/version-0.9.0/ios.md renamed to docs/runner_versioned_docs/version-0.10.0/apple.md

+14-10
Original file line numberDiff line numberDiff line change
@@ -2,23 +2,27 @@
22
title: "Overview"
33
---
44

5-
Executing tests on iOS simulators requires access to Apple hardware capable of executing tests. This can be a local macOS instance or a
6-
remote instance accessible via [secure shell][2]. For remote access file transfers are carried out incrementally using [rsync][3].
5+
Marathon supports execution of `macOS` tests for desktop apps as well as apps targeting `iOS`, `iPadOS`, `tvOS`, `visionOS` (xctest only)
6+
using simulators.
7+
8+
Test execution requires Apple hardware capable of executing tests. This can be a local macOS instance or a remote instance
9+
accessible via [secure shell][2]. For remote access file transfers are carried out incrementally using [rsync][3].
710

811
Device provider can provision simulators on-demand, reuse existing ones if they match desired configuration as well as utilize
912
pre-provisioned simulators. See documentation on [workers][1] for more information on this topic.
1013

11-
Marathon can run both XCUITests and XCTests. Test bundle requires you to specify application under test as well as test application.
12-
After preprocessing both of these inputs are distilled into an application bundle (e.g. `my.app`) and xctest bundle (e.g. `my-tests.xctest`)
13-
You can specify `.ipa` [application archives][4] as well as `.zip` with the same content as application archive. They will be searched for
14-
the
14+
Marathon is capable of executing both XCUITests and XCTests. Test bundle requires you to specify application under test as well as test
15+
application. After preprocessing both of these inputs are distilled into an application bundle (e.g. `my.app`) and xctest bundle (
16+
e.g. `my-tests.xctest`) or UI test runner app containing xctest bundle (e.g. `Magic-UITests-Runner.app`). You can
17+
specify `.ipa` [application archives][4] as well as `.zip` with the same content as application archive. They will be searched for the
1518
application and xctest bundles. If there are multiple entries matching description - marathon will fail.
1619

1720
:::tip
1821

1922
It is much easier to supply the `.app` application bundle and `.xctest` bundle directly instead of wasting time on packaging a signed
20-
application
21-
archive and depending on runtime discovery of your bundles
23+
application archive and depending on runtime discovery of your bundles
24+
25+
An exception here is if you actually need to use signed application with certain entitlements, i.e. for `macOS` desktop testing
2226

2327
:::
2428

@@ -37,14 +41,14 @@ settings:
3741
### Test plans
3842
3943
Support for Xcode test plans is intentionally missing: fundamentally test plan is a way of filtering tests and Marathon supports universal
40-
test filtering regardless of the test platform. Having multiple layers of filtering is undesirable and leading to cumbersome user
44+
test filtering regardless of the test platform. Having multiple layers of filtering is undesirable and leads to cumbersome user
4145
experience. The simplest way to achieve test plans is to provide a list of tests in a file by combining [dynamic configuration][7]
4246
and [fully-qualified-test-name filter][8] providing the external file via [values-file-filtering][9].
4347
4448
See [XcodeGen docs][6] for more information.
4549
4650
47-
[1]: ios/workers.md
51+
[1]: apple/workers.md
4852
4953
[2]: https://en.wikipedia.org/wiki/Secure_Shell
5054

0 commit comments

Comments
 (0)