doc-detective-common 4.21.0 → 4.23.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +538 -338
- package/dist/schemas/schemas.json +538 -338
- package/dist/types/generated/config_v3.d.ts +5 -5
- package/dist/types/generated/context_v3.d.ts +5 -5
- package/dist/types/generated/report_v3.d.ts +5 -5
- package/dist/types/generated/resolvedTests_v3.d.ts +10 -10
- package/dist/types/generated/spec_v3.d.ts +5 -5
- package/dist/types/generated/startSurface_v3.d.ts +7 -7
- package/dist/types/generated/step_v3.d.ts +7 -7
- package/dist/types/generated/test_v3.d.ts +19 -19
- package/package.json +1 -1
|
@@ -2507,7 +2507,7 @@
|
|
|
2507
2507
|
]
|
|
2508
2508
|
},
|
|
2509
2509
|
"browsers": {
|
|
2510
|
-
"description": "Browsers to run tests on.",
|
|
2510
|
+
"description": "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
|
|
2511
2511
|
"anyOf": [
|
|
2512
2512
|
{
|
|
2513
2513
|
"type": "string",
|
|
@@ -2518,7 +2518,7 @@
|
|
|
2518
2518
|
"safari",
|
|
2519
2519
|
"webkit"
|
|
2520
2520
|
],
|
|
2521
|
-
"$comment": "`safari` is
|
|
2521
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
2522
2522
|
},
|
|
2523
2523
|
{
|
|
2524
2524
|
"type": "object",
|
|
@@ -2537,7 +2537,7 @@
|
|
|
2537
2537
|
"safari",
|
|
2538
2538
|
"webkit"
|
|
2539
2539
|
],
|
|
2540
|
-
"$comment": "`safari` is
|
|
2540
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
2541
2541
|
},
|
|
2542
2542
|
"explicit": {
|
|
2543
2543
|
"type": "boolean",
|
|
@@ -2597,7 +2597,7 @@
|
|
|
2597
2597
|
"safari",
|
|
2598
2598
|
"webkit"
|
|
2599
2599
|
],
|
|
2600
|
-
"$comment": "`safari` is
|
|
2600
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
2601
2601
|
},
|
|
2602
2602
|
{
|
|
2603
2603
|
"type": "object",
|
|
@@ -2616,7 +2616,7 @@
|
|
|
2616
2616
|
"safari",
|
|
2617
2617
|
"webkit"
|
|
2618
2618
|
],
|
|
2619
|
-
"$comment": "`safari` is
|
|
2619
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
2620
2620
|
},
|
|
2621
2621
|
"explicit": {
|
|
2622
2622
|
"type": "boolean",
|
|
@@ -2792,7 +2792,7 @@
|
|
|
2792
2792
|
]
|
|
2793
2793
|
},
|
|
2794
2794
|
"device": {
|
|
2795
|
-
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android`). Same shape as `startSurface.device`.",
|
|
2795
|
+
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.",
|
|
2796
2796
|
"examples": [
|
|
2797
2797
|
"pixel7",
|
|
2798
2798
|
{
|
|
@@ -2831,7 +2831,7 @@
|
|
|
2831
2831
|
"transform": [
|
|
2832
2832
|
"trim"
|
|
2833
2833
|
],
|
|
2834
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
2834
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
2835
2835
|
},
|
|
2836
2836
|
"deviceType": {
|
|
2837
2837
|
"type": "string",
|
|
@@ -2844,11 +2844,11 @@
|
|
|
2844
2844
|
"osVersion": {
|
|
2845
2845
|
"type": "string",
|
|
2846
2846
|
"minLength": 1,
|
|
2847
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
2847
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
2848
2848
|
},
|
|
2849
2849
|
"headless": {
|
|
2850
2850
|
"type": "boolean",
|
|
2851
|
-
"description": "Run the Android emulator without a window.
|
|
2851
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
2852
2852
|
},
|
|
2853
2853
|
"orientation": {
|
|
2854
2854
|
"type": "string",
|
|
@@ -2902,7 +2902,7 @@
|
|
|
2902
2902
|
"safari",
|
|
2903
2903
|
"webkit"
|
|
2904
2904
|
],
|
|
2905
|
-
"$comment": "`safari` is
|
|
2905
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
2906
2906
|
},
|
|
2907
2907
|
"browser": {
|
|
2908
2908
|
"type": "object",
|
|
@@ -2921,7 +2921,7 @@
|
|
|
2921
2921
|
"safari",
|
|
2922
2922
|
"webkit"
|
|
2923
2923
|
],
|
|
2924
|
-
"$comment": "`safari` is
|
|
2924
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
2925
2925
|
},
|
|
2926
2926
|
"explicit": {
|
|
2927
2927
|
"type": "boolean",
|
|
@@ -3061,6 +3061,26 @@
|
|
|
3061
3061
|
}
|
|
3062
3062
|
}
|
|
3063
3063
|
]
|
|
3064
|
+
},
|
|
3065
|
+
{
|
|
3066
|
+
"platforms": "android"
|
|
3067
|
+
},
|
|
3068
|
+
{
|
|
3069
|
+
"platforms": [
|
|
3070
|
+
"windows",
|
|
3071
|
+
"mac",
|
|
3072
|
+
"android",
|
|
3073
|
+
"ios"
|
|
3074
|
+
],
|
|
3075
|
+
"browsers": "chrome"
|
|
3076
|
+
},
|
|
3077
|
+
{
|
|
3078
|
+
"platforms": "ios",
|
|
3079
|
+
"browsers": "safari",
|
|
3080
|
+
"device": {
|
|
3081
|
+
"name": "test-iphone",
|
|
3082
|
+
"deviceType": "phone"
|
|
3083
|
+
}
|
|
3064
3084
|
}
|
|
3065
3085
|
]
|
|
3066
3086
|
}
|
|
@@ -38797,7 +38817,7 @@
|
|
|
38797
38817
|
"startSurface": {
|
|
38798
38818
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
38799
38819
|
"title": "startSurface",
|
|
38800
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
38820
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
38801
38821
|
"components": {
|
|
38802
38822
|
"schemas": {
|
|
38803
38823
|
"appDescriptor": {
|
|
@@ -38849,15 +38869,15 @@
|
|
|
38849
38869
|
"install": {
|
|
38850
38870
|
"type": "string",
|
|
38851
38871
|
"minLength": 1,
|
|
38852
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
38872
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
38853
38873
|
},
|
|
38854
38874
|
"activity": {
|
|
38855
38875
|
"type": "string",
|
|
38856
38876
|
"minLength": 1,
|
|
38857
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
38877
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
38858
38878
|
},
|
|
38859
38879
|
"device": {
|
|
38860
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
38880
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
38861
38881
|
"anyOf": [
|
|
38862
38882
|
{
|
|
38863
38883
|
"type": "string",
|
|
@@ -38890,7 +38910,7 @@
|
|
|
38890
38910
|
"transform": [
|
|
38891
38911
|
"trim"
|
|
38892
38912
|
],
|
|
38893
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
38913
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
38894
38914
|
},
|
|
38895
38915
|
"deviceType": {
|
|
38896
38916
|
"type": "string",
|
|
@@ -38903,11 +38923,11 @@
|
|
|
38903
38923
|
"osVersion": {
|
|
38904
38924
|
"type": "string",
|
|
38905
38925
|
"minLength": 1,
|
|
38906
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
38926
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
38907
38927
|
},
|
|
38908
38928
|
"headless": {
|
|
38909
38929
|
"type": "boolean",
|
|
38910
|
-
"description": "Run the Android emulator without a window.
|
|
38930
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
38911
38931
|
},
|
|
38912
38932
|
"orientation": {
|
|
38913
38933
|
"type": "string",
|
|
@@ -39079,7 +39099,7 @@
|
|
|
39079
39099
|
"transform": [
|
|
39080
39100
|
"trim"
|
|
39081
39101
|
],
|
|
39082
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
39102
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
39083
39103
|
},
|
|
39084
39104
|
"deviceType": {
|
|
39085
39105
|
"type": "string",
|
|
@@ -39092,11 +39112,11 @@
|
|
|
39092
39112
|
"osVersion": {
|
|
39093
39113
|
"type": "string",
|
|
39094
39114
|
"minLength": 1,
|
|
39095
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
39115
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
39096
39116
|
},
|
|
39097
39117
|
"headless": {
|
|
39098
39118
|
"type": "boolean",
|
|
39099
|
-
"description": "Run the Android emulator without a window.
|
|
39119
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
39100
39120
|
},
|
|
39101
39121
|
"orientation": {
|
|
39102
39122
|
"type": "string",
|
|
@@ -39195,15 +39215,15 @@
|
|
|
39195
39215
|
"install": {
|
|
39196
39216
|
"type": "string",
|
|
39197
39217
|
"minLength": 1,
|
|
39198
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
39218
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
39199
39219
|
},
|
|
39200
39220
|
"activity": {
|
|
39201
39221
|
"type": "string",
|
|
39202
39222
|
"minLength": 1,
|
|
39203
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
39223
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
39204
39224
|
},
|
|
39205
39225
|
"device": {
|
|
39206
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
39226
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
39207
39227
|
"anyOf": [
|
|
39208
39228
|
{
|
|
39209
39229
|
"type": "string",
|
|
@@ -39236,7 +39256,7 @@
|
|
|
39236
39256
|
"transform": [
|
|
39237
39257
|
"trim"
|
|
39238
39258
|
],
|
|
39239
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
39259
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
39240
39260
|
},
|
|
39241
39261
|
"deviceType": {
|
|
39242
39262
|
"type": "string",
|
|
@@ -39249,11 +39269,11 @@
|
|
|
39249
39269
|
"osVersion": {
|
|
39250
39270
|
"type": "string",
|
|
39251
39271
|
"minLength": 1,
|
|
39252
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
39272
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
39253
39273
|
},
|
|
39254
39274
|
"headless": {
|
|
39255
39275
|
"type": "boolean",
|
|
39256
|
-
"description": "Run the Android emulator without a window.
|
|
39276
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
39257
39277
|
},
|
|
39258
39278
|
"orientation": {
|
|
39259
39279
|
"type": "string",
|
|
@@ -80988,7 +81008,7 @@
|
|
|
80988
81008
|
"startSurface": {
|
|
80989
81009
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
80990
81010
|
"title": "startSurface",
|
|
80991
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
81011
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
80992
81012
|
"components": {
|
|
80993
81013
|
"schemas": {
|
|
80994
81014
|
"appDescriptor": {
|
|
@@ -81040,15 +81060,15 @@
|
|
|
81040
81060
|
"install": {
|
|
81041
81061
|
"type": "string",
|
|
81042
81062
|
"minLength": 1,
|
|
81043
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
81063
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
81044
81064
|
},
|
|
81045
81065
|
"activity": {
|
|
81046
81066
|
"type": "string",
|
|
81047
81067
|
"minLength": 1,
|
|
81048
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
81068
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
81049
81069
|
},
|
|
81050
81070
|
"device": {
|
|
81051
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
81071
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
81052
81072
|
"anyOf": [
|
|
81053
81073
|
{
|
|
81054
81074
|
"type": "string",
|
|
@@ -81081,7 +81101,7 @@
|
|
|
81081
81101
|
"transform": [
|
|
81082
81102
|
"trim"
|
|
81083
81103
|
],
|
|
81084
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
81104
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
81085
81105
|
},
|
|
81086
81106
|
"deviceType": {
|
|
81087
81107
|
"type": "string",
|
|
@@ -81094,11 +81114,11 @@
|
|
|
81094
81114
|
"osVersion": {
|
|
81095
81115
|
"type": "string",
|
|
81096
81116
|
"minLength": 1,
|
|
81097
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
81117
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
81098
81118
|
},
|
|
81099
81119
|
"headless": {
|
|
81100
81120
|
"type": "boolean",
|
|
81101
|
-
"description": "Run the Android emulator without a window.
|
|
81121
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
81102
81122
|
},
|
|
81103
81123
|
"orientation": {
|
|
81104
81124
|
"type": "string",
|
|
@@ -81270,7 +81290,7 @@
|
|
|
81270
81290
|
"transform": [
|
|
81271
81291
|
"trim"
|
|
81272
81292
|
],
|
|
81273
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
81293
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
81274
81294
|
},
|
|
81275
81295
|
"deviceType": {
|
|
81276
81296
|
"type": "string",
|
|
@@ -81283,11 +81303,11 @@
|
|
|
81283
81303
|
"osVersion": {
|
|
81284
81304
|
"type": "string",
|
|
81285
81305
|
"minLength": 1,
|
|
81286
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
81306
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
81287
81307
|
},
|
|
81288
81308
|
"headless": {
|
|
81289
81309
|
"type": "boolean",
|
|
81290
|
-
"description": "Run the Android emulator without a window.
|
|
81310
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
81291
81311
|
},
|
|
81292
81312
|
"orientation": {
|
|
81293
81313
|
"type": "string",
|
|
@@ -81386,15 +81406,15 @@
|
|
|
81386
81406
|
"install": {
|
|
81387
81407
|
"type": "string",
|
|
81388
81408
|
"minLength": 1,
|
|
81389
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
81409
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
81390
81410
|
},
|
|
81391
81411
|
"activity": {
|
|
81392
81412
|
"type": "string",
|
|
81393
81413
|
"minLength": 1,
|
|
81394
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
81414
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
81395
81415
|
},
|
|
81396
81416
|
"device": {
|
|
81397
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
81417
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
81398
81418
|
"anyOf": [
|
|
81399
81419
|
{
|
|
81400
81420
|
"type": "string",
|
|
@@ -81427,7 +81447,7 @@
|
|
|
81427
81447
|
"transform": [
|
|
81428
81448
|
"trim"
|
|
81429
81449
|
],
|
|
81430
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
81450
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
81431
81451
|
},
|
|
81432
81452
|
"deviceType": {
|
|
81433
81453
|
"type": "string",
|
|
@@ -81440,11 +81460,11 @@
|
|
|
81440
81460
|
"osVersion": {
|
|
81441
81461
|
"type": "string",
|
|
81442
81462
|
"minLength": 1,
|
|
81443
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
81463
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
81444
81464
|
},
|
|
81445
81465
|
"headless": {
|
|
81446
81466
|
"type": "boolean",
|
|
81447
|
-
"description": "Run the Android emulator without a window.
|
|
81467
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
81448
81468
|
},
|
|
81449
81469
|
"orientation": {
|
|
81450
81470
|
"type": "string",
|
|
@@ -87078,7 +87098,7 @@
|
|
|
87078
87098
|
]
|
|
87079
87099
|
},
|
|
87080
87100
|
"browsers": {
|
|
87081
|
-
"description": "Browsers to run tests on.",
|
|
87101
|
+
"description": "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
|
|
87082
87102
|
"anyOf": [
|
|
87083
87103
|
{
|
|
87084
87104
|
"type": "string",
|
|
@@ -87089,7 +87109,7 @@
|
|
|
87089
87109
|
"safari",
|
|
87090
87110
|
"webkit"
|
|
87091
87111
|
],
|
|
87092
|
-
"$comment": "`safari` is
|
|
87112
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
87093
87113
|
},
|
|
87094
87114
|
{
|
|
87095
87115
|
"type": "object",
|
|
@@ -87108,7 +87128,7 @@
|
|
|
87108
87128
|
"safari",
|
|
87109
87129
|
"webkit"
|
|
87110
87130
|
],
|
|
87111
|
-
"$comment": "`safari` is
|
|
87131
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
87112
87132
|
},
|
|
87113
87133
|
"explicit": {
|
|
87114
87134
|
"type": "boolean",
|
|
@@ -87168,7 +87188,7 @@
|
|
|
87168
87188
|
"safari",
|
|
87169
87189
|
"webkit"
|
|
87170
87190
|
],
|
|
87171
|
-
"$comment": "`safari` is
|
|
87191
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
87172
87192
|
},
|
|
87173
87193
|
{
|
|
87174
87194
|
"type": "object",
|
|
@@ -87187,7 +87207,7 @@
|
|
|
87187
87207
|
"safari",
|
|
87188
87208
|
"webkit"
|
|
87189
87209
|
],
|
|
87190
|
-
"$comment": "`safari` is
|
|
87210
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
87191
87211
|
},
|
|
87192
87212
|
"explicit": {
|
|
87193
87213
|
"type": "boolean",
|
|
@@ -87363,7 +87383,7 @@
|
|
|
87363
87383
|
]
|
|
87364
87384
|
},
|
|
87365
87385
|
"device": {
|
|
87366
|
-
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android`). Same shape as `startSurface.device`.",
|
|
87386
|
+
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.",
|
|
87367
87387
|
"examples": [
|
|
87368
87388
|
"pixel7",
|
|
87369
87389
|
{
|
|
@@ -87402,7 +87422,7 @@
|
|
|
87402
87422
|
"transform": [
|
|
87403
87423
|
"trim"
|
|
87404
87424
|
],
|
|
87405
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
87425
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
87406
87426
|
},
|
|
87407
87427
|
"deviceType": {
|
|
87408
87428
|
"type": "string",
|
|
@@ -87415,11 +87435,11 @@
|
|
|
87415
87435
|
"osVersion": {
|
|
87416
87436
|
"type": "string",
|
|
87417
87437
|
"minLength": 1,
|
|
87418
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
87438
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
87419
87439
|
},
|
|
87420
87440
|
"headless": {
|
|
87421
87441
|
"type": "boolean",
|
|
87422
|
-
"description": "Run the Android emulator without a window.
|
|
87442
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
87423
87443
|
},
|
|
87424
87444
|
"orientation": {
|
|
87425
87445
|
"type": "string",
|
|
@@ -87473,7 +87493,7 @@
|
|
|
87473
87493
|
"safari",
|
|
87474
87494
|
"webkit"
|
|
87475
87495
|
],
|
|
87476
|
-
"$comment": "`safari` is
|
|
87496
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
87477
87497
|
},
|
|
87478
87498
|
"browser": {
|
|
87479
87499
|
"type": "object",
|
|
@@ -87492,7 +87512,7 @@
|
|
|
87492
87512
|
"safari",
|
|
87493
87513
|
"webkit"
|
|
87494
87514
|
],
|
|
87495
|
-
"$comment": "`safari` is
|
|
87515
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
87496
87516
|
},
|
|
87497
87517
|
"explicit": {
|
|
87498
87518
|
"type": "boolean",
|
|
@@ -87632,6 +87652,26 @@
|
|
|
87632
87652
|
}
|
|
87633
87653
|
}
|
|
87634
87654
|
]
|
|
87655
|
+
},
|
|
87656
|
+
{
|
|
87657
|
+
"platforms": "android"
|
|
87658
|
+
},
|
|
87659
|
+
{
|
|
87660
|
+
"platforms": [
|
|
87661
|
+
"windows",
|
|
87662
|
+
"mac",
|
|
87663
|
+
"android",
|
|
87664
|
+
"ios"
|
|
87665
|
+
],
|
|
87666
|
+
"browsers": "chrome"
|
|
87667
|
+
},
|
|
87668
|
+
{
|
|
87669
|
+
"platforms": "ios",
|
|
87670
|
+
"browsers": "safari",
|
|
87671
|
+
"device": {
|
|
87672
|
+
"name": "test-iphone",
|
|
87673
|
+
"deviceType": "phone"
|
|
87674
|
+
}
|
|
87635
87675
|
}
|
|
87636
87676
|
]
|
|
87637
87677
|
},
|
|
@@ -99969,7 +100009,7 @@
|
|
|
99969
100009
|
]
|
|
99970
100010
|
},
|
|
99971
100011
|
"browsers": {
|
|
99972
|
-
"description": "Browsers to run tests on.",
|
|
100012
|
+
"description": "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
|
|
99973
100013
|
"anyOf": [
|
|
99974
100014
|
{
|
|
99975
100015
|
"type": "string",
|
|
@@ -99980,7 +100020,7 @@
|
|
|
99980
100020
|
"safari",
|
|
99981
100021
|
"webkit"
|
|
99982
100022
|
],
|
|
99983
|
-
"$comment": "`safari` is
|
|
100023
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
99984
100024
|
},
|
|
99985
100025
|
{
|
|
99986
100026
|
"type": "object",
|
|
@@ -99999,7 +100039,7 @@
|
|
|
99999
100039
|
"safari",
|
|
100000
100040
|
"webkit"
|
|
100001
100041
|
],
|
|
100002
|
-
"$comment": "`safari` is
|
|
100042
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
100003
100043
|
},
|
|
100004
100044
|
"explicit": {
|
|
100005
100045
|
"type": "boolean",
|
|
@@ -100059,7 +100099,7 @@
|
|
|
100059
100099
|
"safari",
|
|
100060
100100
|
"webkit"
|
|
100061
100101
|
],
|
|
100062
|
-
"$comment": "`safari` is
|
|
100102
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
100063
100103
|
},
|
|
100064
100104
|
{
|
|
100065
100105
|
"type": "object",
|
|
@@ -100078,7 +100118,7 @@
|
|
|
100078
100118
|
"safari",
|
|
100079
100119
|
"webkit"
|
|
100080
100120
|
],
|
|
100081
|
-
"$comment": "`safari` is
|
|
100121
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
100082
100122
|
},
|
|
100083
100123
|
"explicit": {
|
|
100084
100124
|
"type": "boolean",
|
|
@@ -100254,7 +100294,7 @@
|
|
|
100254
100294
|
]
|
|
100255
100295
|
},
|
|
100256
100296
|
"device": {
|
|
100257
|
-
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android`). Same shape as `startSurface.device`.",
|
|
100297
|
+
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.",
|
|
100258
100298
|
"examples": [
|
|
100259
100299
|
"pixel7",
|
|
100260
100300
|
{
|
|
@@ -100293,7 +100333,7 @@
|
|
|
100293
100333
|
"transform": [
|
|
100294
100334
|
"trim"
|
|
100295
100335
|
],
|
|
100296
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
100336
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
100297
100337
|
},
|
|
100298
100338
|
"deviceType": {
|
|
100299
100339
|
"type": "string",
|
|
@@ -100306,11 +100346,11 @@
|
|
|
100306
100346
|
"osVersion": {
|
|
100307
100347
|
"type": "string",
|
|
100308
100348
|
"minLength": 1,
|
|
100309
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
100349
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
100310
100350
|
},
|
|
100311
100351
|
"headless": {
|
|
100312
100352
|
"type": "boolean",
|
|
100313
|
-
"description": "Run the Android emulator without a window.
|
|
100353
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
100314
100354
|
},
|
|
100315
100355
|
"orientation": {
|
|
100316
100356
|
"type": "string",
|
|
@@ -100364,7 +100404,7 @@
|
|
|
100364
100404
|
"safari",
|
|
100365
100405
|
"webkit"
|
|
100366
100406
|
],
|
|
100367
|
-
"$comment": "`safari` is
|
|
100407
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
100368
100408
|
},
|
|
100369
100409
|
"browser": {
|
|
100370
100410
|
"type": "object",
|
|
@@ -100383,7 +100423,7 @@
|
|
|
100383
100423
|
"safari",
|
|
100384
100424
|
"webkit"
|
|
100385
100425
|
],
|
|
100386
|
-
"$comment": "`safari` is
|
|
100426
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
100387
100427
|
},
|
|
100388
100428
|
"explicit": {
|
|
100389
100429
|
"type": "boolean",
|
|
@@ -100523,6 +100563,26 @@
|
|
|
100523
100563
|
}
|
|
100524
100564
|
}
|
|
100525
100565
|
]
|
|
100566
|
+
},
|
|
100567
|
+
{
|
|
100568
|
+
"platforms": "android"
|
|
100569
|
+
},
|
|
100570
|
+
{
|
|
100571
|
+
"platforms": [
|
|
100572
|
+
"windows",
|
|
100573
|
+
"mac",
|
|
100574
|
+
"android",
|
|
100575
|
+
"ios"
|
|
100576
|
+
],
|
|
100577
|
+
"browsers": "chrome"
|
|
100578
|
+
},
|
|
100579
|
+
{
|
|
100580
|
+
"platforms": "ios",
|
|
100581
|
+
"browsers": "safari",
|
|
100582
|
+
"device": {
|
|
100583
|
+
"name": "test-iphone",
|
|
100584
|
+
"deviceType": "phone"
|
|
100585
|
+
}
|
|
100526
100586
|
}
|
|
100527
100587
|
]
|
|
100528
100588
|
}
|
|
@@ -136259,7 +136319,7 @@
|
|
|
136259
136319
|
"startSurface": {
|
|
136260
136320
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
136261
136321
|
"title": "startSurface",
|
|
136262
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
136322
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
136263
136323
|
"components": {
|
|
136264
136324
|
"schemas": {
|
|
136265
136325
|
"appDescriptor": {
|
|
@@ -136311,15 +136371,15 @@
|
|
|
136311
136371
|
"install": {
|
|
136312
136372
|
"type": "string",
|
|
136313
136373
|
"minLength": 1,
|
|
136314
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
136374
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
136315
136375
|
},
|
|
136316
136376
|
"activity": {
|
|
136317
136377
|
"type": "string",
|
|
136318
136378
|
"minLength": 1,
|
|
136319
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
136379
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
136320
136380
|
},
|
|
136321
136381
|
"device": {
|
|
136322
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
136382
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
136323
136383
|
"anyOf": [
|
|
136324
136384
|
{
|
|
136325
136385
|
"type": "string",
|
|
@@ -136352,7 +136412,7 @@
|
|
|
136352
136412
|
"transform": [
|
|
136353
136413
|
"trim"
|
|
136354
136414
|
],
|
|
136355
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
136415
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
136356
136416
|
},
|
|
136357
136417
|
"deviceType": {
|
|
136358
136418
|
"type": "string",
|
|
@@ -136365,11 +136425,11 @@
|
|
|
136365
136425
|
"osVersion": {
|
|
136366
136426
|
"type": "string",
|
|
136367
136427
|
"minLength": 1,
|
|
136368
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
136428
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
136369
136429
|
},
|
|
136370
136430
|
"headless": {
|
|
136371
136431
|
"type": "boolean",
|
|
136372
|
-
"description": "Run the Android emulator without a window.
|
|
136432
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
136373
136433
|
},
|
|
136374
136434
|
"orientation": {
|
|
136375
136435
|
"type": "string",
|
|
@@ -136541,7 +136601,7 @@
|
|
|
136541
136601
|
"transform": [
|
|
136542
136602
|
"trim"
|
|
136543
136603
|
],
|
|
136544
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
136604
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
136545
136605
|
},
|
|
136546
136606
|
"deviceType": {
|
|
136547
136607
|
"type": "string",
|
|
@@ -136554,11 +136614,11 @@
|
|
|
136554
136614
|
"osVersion": {
|
|
136555
136615
|
"type": "string",
|
|
136556
136616
|
"minLength": 1,
|
|
136557
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
136617
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
136558
136618
|
},
|
|
136559
136619
|
"headless": {
|
|
136560
136620
|
"type": "boolean",
|
|
136561
|
-
"description": "Run the Android emulator without a window.
|
|
136621
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
136562
136622
|
},
|
|
136563
136623
|
"orientation": {
|
|
136564
136624
|
"type": "string",
|
|
@@ -136657,15 +136717,15 @@
|
|
|
136657
136717
|
"install": {
|
|
136658
136718
|
"type": "string",
|
|
136659
136719
|
"minLength": 1,
|
|
136660
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
136720
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
136661
136721
|
},
|
|
136662
136722
|
"activity": {
|
|
136663
136723
|
"type": "string",
|
|
136664
136724
|
"minLength": 1,
|
|
136665
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
136725
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
136666
136726
|
},
|
|
136667
136727
|
"device": {
|
|
136668
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
136728
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
136669
136729
|
"anyOf": [
|
|
136670
136730
|
{
|
|
136671
136731
|
"type": "string",
|
|
@@ -136698,7 +136758,7 @@
|
|
|
136698
136758
|
"transform": [
|
|
136699
136759
|
"trim"
|
|
136700
136760
|
],
|
|
136701
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
136761
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
136702
136762
|
},
|
|
136703
136763
|
"deviceType": {
|
|
136704
136764
|
"type": "string",
|
|
@@ -136711,11 +136771,11 @@
|
|
|
136711
136771
|
"osVersion": {
|
|
136712
136772
|
"type": "string",
|
|
136713
136773
|
"minLength": 1,
|
|
136714
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
136774
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
136715
136775
|
},
|
|
136716
136776
|
"headless": {
|
|
136717
136777
|
"type": "boolean",
|
|
136718
|
-
"description": "Run the Android emulator without a window.
|
|
136778
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
136719
136779
|
},
|
|
136720
136780
|
"orientation": {
|
|
136721
136781
|
"type": "string",
|
|
@@ -178450,7 +178510,7 @@
|
|
|
178450
178510
|
"startSurface": {
|
|
178451
178511
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
178452
178512
|
"title": "startSurface",
|
|
178453
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
178513
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
178454
178514
|
"components": {
|
|
178455
178515
|
"schemas": {
|
|
178456
178516
|
"appDescriptor": {
|
|
@@ -178502,15 +178562,15 @@
|
|
|
178502
178562
|
"install": {
|
|
178503
178563
|
"type": "string",
|
|
178504
178564
|
"minLength": 1,
|
|
178505
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
178565
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
178506
178566
|
},
|
|
178507
178567
|
"activity": {
|
|
178508
178568
|
"type": "string",
|
|
178509
178569
|
"minLength": 1,
|
|
178510
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
178570
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
178511
178571
|
},
|
|
178512
178572
|
"device": {
|
|
178513
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
178573
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
178514
178574
|
"anyOf": [
|
|
178515
178575
|
{
|
|
178516
178576
|
"type": "string",
|
|
@@ -178543,7 +178603,7 @@
|
|
|
178543
178603
|
"transform": [
|
|
178544
178604
|
"trim"
|
|
178545
178605
|
],
|
|
178546
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
178606
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
178547
178607
|
},
|
|
178548
178608
|
"deviceType": {
|
|
178549
178609
|
"type": "string",
|
|
@@ -178556,11 +178616,11 @@
|
|
|
178556
178616
|
"osVersion": {
|
|
178557
178617
|
"type": "string",
|
|
178558
178618
|
"minLength": 1,
|
|
178559
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
178619
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
178560
178620
|
},
|
|
178561
178621
|
"headless": {
|
|
178562
178622
|
"type": "boolean",
|
|
178563
|
-
"description": "Run the Android emulator without a window.
|
|
178623
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
178564
178624
|
},
|
|
178565
178625
|
"orientation": {
|
|
178566
178626
|
"type": "string",
|
|
@@ -178732,7 +178792,7 @@
|
|
|
178732
178792
|
"transform": [
|
|
178733
178793
|
"trim"
|
|
178734
178794
|
],
|
|
178735
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
178795
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
178736
178796
|
},
|
|
178737
178797
|
"deviceType": {
|
|
178738
178798
|
"type": "string",
|
|
@@ -178745,11 +178805,11 @@
|
|
|
178745
178805
|
"osVersion": {
|
|
178746
178806
|
"type": "string",
|
|
178747
178807
|
"minLength": 1,
|
|
178748
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
178808
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
178749
178809
|
},
|
|
178750
178810
|
"headless": {
|
|
178751
178811
|
"type": "boolean",
|
|
178752
|
-
"description": "Run the Android emulator without a window.
|
|
178812
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
178753
178813
|
},
|
|
178754
178814
|
"orientation": {
|
|
178755
178815
|
"type": "string",
|
|
@@ -178848,15 +178908,15 @@
|
|
|
178848
178908
|
"install": {
|
|
178849
178909
|
"type": "string",
|
|
178850
178910
|
"minLength": 1,
|
|
178851
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
178911
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
178852
178912
|
},
|
|
178853
178913
|
"activity": {
|
|
178854
178914
|
"type": "string",
|
|
178855
178915
|
"minLength": 1,
|
|
178856
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
178916
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
178857
178917
|
},
|
|
178858
178918
|
"device": {
|
|
178859
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
178919
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
178860
178920
|
"anyOf": [
|
|
178861
178921
|
{
|
|
178862
178922
|
"type": "string",
|
|
@@ -178889,7 +178949,7 @@
|
|
|
178889
178949
|
"transform": [
|
|
178890
178950
|
"trim"
|
|
178891
178951
|
],
|
|
178892
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
178952
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
178893
178953
|
},
|
|
178894
178954
|
"deviceType": {
|
|
178895
178955
|
"type": "string",
|
|
@@ -178902,11 +178962,11 @@
|
|
|
178902
178962
|
"osVersion": {
|
|
178903
178963
|
"type": "string",
|
|
178904
178964
|
"minLength": 1,
|
|
178905
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
178965
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
178906
178966
|
},
|
|
178907
178967
|
"headless": {
|
|
178908
178968
|
"type": "boolean",
|
|
178909
|
-
"description": "Run the Android emulator without a window.
|
|
178969
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
178910
178970
|
},
|
|
178911
178971
|
"orientation": {
|
|
178912
178972
|
"type": "string",
|
|
@@ -184602,7 +184662,7 @@
|
|
|
184602
184662
|
]
|
|
184603
184663
|
},
|
|
184604
184664
|
"browsers": {
|
|
184605
|
-
"description": "Browsers to run tests on.",
|
|
184665
|
+
"description": "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
|
|
184606
184666
|
"anyOf": [
|
|
184607
184667
|
{
|
|
184608
184668
|
"type": "string",
|
|
@@ -184613,7 +184673,7 @@
|
|
|
184613
184673
|
"safari",
|
|
184614
184674
|
"webkit"
|
|
184615
184675
|
],
|
|
184616
|
-
"$comment": "`safari` is
|
|
184676
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
184617
184677
|
},
|
|
184618
184678
|
{
|
|
184619
184679
|
"type": "object",
|
|
@@ -184632,7 +184692,7 @@
|
|
|
184632
184692
|
"safari",
|
|
184633
184693
|
"webkit"
|
|
184634
184694
|
],
|
|
184635
|
-
"$comment": "`safari` is
|
|
184695
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
184636
184696
|
},
|
|
184637
184697
|
"explicit": {
|
|
184638
184698
|
"type": "boolean",
|
|
@@ -184692,7 +184752,7 @@
|
|
|
184692
184752
|
"safari",
|
|
184693
184753
|
"webkit"
|
|
184694
184754
|
],
|
|
184695
|
-
"$comment": "`safari` is
|
|
184755
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
184696
184756
|
},
|
|
184697
184757
|
{
|
|
184698
184758
|
"type": "object",
|
|
@@ -184711,7 +184771,7 @@
|
|
|
184711
184771
|
"safari",
|
|
184712
184772
|
"webkit"
|
|
184713
184773
|
],
|
|
184714
|
-
"$comment": "`safari` is
|
|
184774
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
184715
184775
|
},
|
|
184716
184776
|
"explicit": {
|
|
184717
184777
|
"type": "boolean",
|
|
@@ -184887,7 +184947,7 @@
|
|
|
184887
184947
|
]
|
|
184888
184948
|
},
|
|
184889
184949
|
"device": {
|
|
184890
|
-
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android`). Same shape as `startSurface.device`.",
|
|
184950
|
+
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.",
|
|
184891
184951
|
"examples": [
|
|
184892
184952
|
"pixel7",
|
|
184893
184953
|
{
|
|
@@ -184926,7 +184986,7 @@
|
|
|
184926
184986
|
"transform": [
|
|
184927
184987
|
"trim"
|
|
184928
184988
|
],
|
|
184929
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
184989
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
184930
184990
|
},
|
|
184931
184991
|
"deviceType": {
|
|
184932
184992
|
"type": "string",
|
|
@@ -184939,11 +184999,11 @@
|
|
|
184939
184999
|
"osVersion": {
|
|
184940
185000
|
"type": "string",
|
|
184941
185001
|
"minLength": 1,
|
|
184942
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
185002
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
184943
185003
|
},
|
|
184944
185004
|
"headless": {
|
|
184945
185005
|
"type": "boolean",
|
|
184946
|
-
"description": "Run the Android emulator without a window.
|
|
185006
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
184947
185007
|
},
|
|
184948
185008
|
"orientation": {
|
|
184949
185009
|
"type": "string",
|
|
@@ -184997,7 +185057,7 @@
|
|
|
184997
185057
|
"safari",
|
|
184998
185058
|
"webkit"
|
|
184999
185059
|
],
|
|
185000
|
-
"$comment": "`safari` is
|
|
185060
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
185001
185061
|
},
|
|
185002
185062
|
"browser": {
|
|
185003
185063
|
"type": "object",
|
|
@@ -185016,7 +185076,7 @@
|
|
|
185016
185076
|
"safari",
|
|
185017
185077
|
"webkit"
|
|
185018
185078
|
],
|
|
185019
|
-
"$comment": "`safari` is
|
|
185079
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
185020
185080
|
},
|
|
185021
185081
|
"explicit": {
|
|
185022
185082
|
"type": "boolean",
|
|
@@ -185156,6 +185216,26 @@
|
|
|
185156
185216
|
}
|
|
185157
185217
|
}
|
|
185158
185218
|
]
|
|
185219
|
+
},
|
|
185220
|
+
{
|
|
185221
|
+
"platforms": "android"
|
|
185222
|
+
},
|
|
185223
|
+
{
|
|
185224
|
+
"platforms": [
|
|
185225
|
+
"windows",
|
|
185226
|
+
"mac",
|
|
185227
|
+
"android",
|
|
185228
|
+
"ios"
|
|
185229
|
+
],
|
|
185230
|
+
"browsers": "chrome"
|
|
185231
|
+
},
|
|
185232
|
+
{
|
|
185233
|
+
"platforms": "ios",
|
|
185234
|
+
"browsers": "safari",
|
|
185235
|
+
"device": {
|
|
185236
|
+
"name": "test-iphone",
|
|
185237
|
+
"deviceType": "phone"
|
|
185238
|
+
}
|
|
185159
185239
|
}
|
|
185160
185240
|
]
|
|
185161
185241
|
}
|
|
@@ -185444,7 +185524,7 @@
|
|
|
185444
185524
|
]
|
|
185445
185525
|
},
|
|
185446
185526
|
"browsers": {
|
|
185447
|
-
"description": "Browsers to run tests on.",
|
|
185527
|
+
"description": "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
|
|
185448
185528
|
"anyOf": [
|
|
185449
185529
|
{
|
|
185450
185530
|
"type": "string",
|
|
@@ -185455,7 +185535,7 @@
|
|
|
185455
185535
|
"safari",
|
|
185456
185536
|
"webkit"
|
|
185457
185537
|
],
|
|
185458
|
-
"$comment": "`safari` is
|
|
185538
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
185459
185539
|
},
|
|
185460
185540
|
{
|
|
185461
185541
|
"type": "object",
|
|
@@ -185474,7 +185554,7 @@
|
|
|
185474
185554
|
"safari",
|
|
185475
185555
|
"webkit"
|
|
185476
185556
|
],
|
|
185477
|
-
"$comment": "`safari` is
|
|
185557
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
185478
185558
|
},
|
|
185479
185559
|
"explicit": {
|
|
185480
185560
|
"type": "boolean",
|
|
@@ -185534,7 +185614,7 @@
|
|
|
185534
185614
|
"safari",
|
|
185535
185615
|
"webkit"
|
|
185536
185616
|
],
|
|
185537
|
-
"$comment": "`safari` is
|
|
185617
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
185538
185618
|
},
|
|
185539
185619
|
{
|
|
185540
185620
|
"type": "object",
|
|
@@ -185553,7 +185633,7 @@
|
|
|
185553
185633
|
"safari",
|
|
185554
185634
|
"webkit"
|
|
185555
185635
|
],
|
|
185556
|
-
"$comment": "`safari` is
|
|
185636
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
185557
185637
|
},
|
|
185558
185638
|
"explicit": {
|
|
185559
185639
|
"type": "boolean",
|
|
@@ -185729,7 +185809,7 @@
|
|
|
185729
185809
|
]
|
|
185730
185810
|
},
|
|
185731
185811
|
"device": {
|
|
185732
|
-
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android`). Same shape as `startSurface.device`.",
|
|
185812
|
+
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.",
|
|
185733
185813
|
"examples": [
|
|
185734
185814
|
"pixel7",
|
|
185735
185815
|
{
|
|
@@ -185768,7 +185848,7 @@
|
|
|
185768
185848
|
"transform": [
|
|
185769
185849
|
"trim"
|
|
185770
185850
|
],
|
|
185771
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
185851
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
185772
185852
|
},
|
|
185773
185853
|
"deviceType": {
|
|
185774
185854
|
"type": "string",
|
|
@@ -185781,11 +185861,11 @@
|
|
|
185781
185861
|
"osVersion": {
|
|
185782
185862
|
"type": "string",
|
|
185783
185863
|
"minLength": 1,
|
|
185784
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
185864
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
185785
185865
|
},
|
|
185786
185866
|
"headless": {
|
|
185787
185867
|
"type": "boolean",
|
|
185788
|
-
"description": "Run the Android emulator without a window.
|
|
185868
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
185789
185869
|
},
|
|
185790
185870
|
"orientation": {
|
|
185791
185871
|
"type": "string",
|
|
@@ -185839,7 +185919,7 @@
|
|
|
185839
185919
|
"safari",
|
|
185840
185920
|
"webkit"
|
|
185841
185921
|
],
|
|
185842
|
-
"$comment": "`safari` is
|
|
185922
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
185843
185923
|
},
|
|
185844
185924
|
"browser": {
|
|
185845
185925
|
"type": "object",
|
|
@@ -185858,7 +185938,7 @@
|
|
|
185858
185938
|
"safari",
|
|
185859
185939
|
"webkit"
|
|
185860
185940
|
],
|
|
185861
|
-
"$comment": "`safari` is
|
|
185941
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
185862
185942
|
},
|
|
185863
185943
|
"explicit": {
|
|
185864
185944
|
"type": "boolean",
|
|
@@ -185998,6 +186078,26 @@
|
|
|
185998
186078
|
}
|
|
185999
186079
|
}
|
|
186000
186080
|
]
|
|
186081
|
+
},
|
|
186082
|
+
{
|
|
186083
|
+
"platforms": "android"
|
|
186084
|
+
},
|
|
186085
|
+
{
|
|
186086
|
+
"platforms": [
|
|
186087
|
+
"windows",
|
|
186088
|
+
"mac",
|
|
186089
|
+
"android",
|
|
186090
|
+
"ios"
|
|
186091
|
+
],
|
|
186092
|
+
"browsers": "chrome"
|
|
186093
|
+
},
|
|
186094
|
+
{
|
|
186095
|
+
"platforms": "ios",
|
|
186096
|
+
"browsers": "safari",
|
|
186097
|
+
"device": {
|
|
186098
|
+
"name": "test-iphone",
|
|
186099
|
+
"deviceType": "phone"
|
|
186100
|
+
}
|
|
186001
186101
|
}
|
|
186002
186102
|
]
|
|
186003
186103
|
}
|
|
@@ -222374,7 +222474,7 @@
|
|
|
222374
222474
|
"startSurface": {
|
|
222375
222475
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
222376
222476
|
"title": "startSurface",
|
|
222377
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
222477
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
222378
222478
|
"components": {
|
|
222379
222479
|
"schemas": {
|
|
222380
222480
|
"appDescriptor": {
|
|
@@ -222426,15 +222526,15 @@
|
|
|
222426
222526
|
"install": {
|
|
222427
222527
|
"type": "string",
|
|
222428
222528
|
"minLength": 1,
|
|
222429
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
222529
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
222430
222530
|
},
|
|
222431
222531
|
"activity": {
|
|
222432
222532
|
"type": "string",
|
|
222433
222533
|
"minLength": 1,
|
|
222434
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
222534
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
222435
222535
|
},
|
|
222436
222536
|
"device": {
|
|
222437
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
222537
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
222438
222538
|
"anyOf": [
|
|
222439
222539
|
{
|
|
222440
222540
|
"type": "string",
|
|
@@ -222467,7 +222567,7 @@
|
|
|
222467
222567
|
"transform": [
|
|
222468
222568
|
"trim"
|
|
222469
222569
|
],
|
|
222470
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
222570
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
222471
222571
|
},
|
|
222472
222572
|
"deviceType": {
|
|
222473
222573
|
"type": "string",
|
|
@@ -222480,11 +222580,11 @@
|
|
|
222480
222580
|
"osVersion": {
|
|
222481
222581
|
"type": "string",
|
|
222482
222582
|
"minLength": 1,
|
|
222483
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
222583
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
222484
222584
|
},
|
|
222485
222585
|
"headless": {
|
|
222486
222586
|
"type": "boolean",
|
|
222487
|
-
"description": "Run the Android emulator without a window.
|
|
222587
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
222488
222588
|
},
|
|
222489
222589
|
"orientation": {
|
|
222490
222590
|
"type": "string",
|
|
@@ -222656,7 +222756,7 @@
|
|
|
222656
222756
|
"transform": [
|
|
222657
222757
|
"trim"
|
|
222658
222758
|
],
|
|
222659
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
222759
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
222660
222760
|
},
|
|
222661
222761
|
"deviceType": {
|
|
222662
222762
|
"type": "string",
|
|
@@ -222669,11 +222769,11 @@
|
|
|
222669
222769
|
"osVersion": {
|
|
222670
222770
|
"type": "string",
|
|
222671
222771
|
"minLength": 1,
|
|
222672
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
222772
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
222673
222773
|
},
|
|
222674
222774
|
"headless": {
|
|
222675
222775
|
"type": "boolean",
|
|
222676
|
-
"description": "Run the Android emulator without a window.
|
|
222776
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
222677
222777
|
},
|
|
222678
222778
|
"orientation": {
|
|
222679
222779
|
"type": "string",
|
|
@@ -222772,15 +222872,15 @@
|
|
|
222772
222872
|
"install": {
|
|
222773
222873
|
"type": "string",
|
|
222774
222874
|
"minLength": 1,
|
|
222775
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
222875
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
222776
222876
|
},
|
|
222777
222877
|
"activity": {
|
|
222778
222878
|
"type": "string",
|
|
222779
222879
|
"minLength": 1,
|
|
222780
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
222880
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
222781
222881
|
},
|
|
222782
222882
|
"device": {
|
|
222783
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
222883
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
222784
222884
|
"anyOf": [
|
|
222785
222885
|
{
|
|
222786
222886
|
"type": "string",
|
|
@@ -222813,7 +222913,7 @@
|
|
|
222813
222913
|
"transform": [
|
|
222814
222914
|
"trim"
|
|
222815
222915
|
],
|
|
222816
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
222916
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
222817
222917
|
},
|
|
222818
222918
|
"deviceType": {
|
|
222819
222919
|
"type": "string",
|
|
@@ -222826,11 +222926,11 @@
|
|
|
222826
222926
|
"osVersion": {
|
|
222827
222927
|
"type": "string",
|
|
222828
222928
|
"minLength": 1,
|
|
222829
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
222929
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
222830
222930
|
},
|
|
222831
222931
|
"headless": {
|
|
222832
222932
|
"type": "boolean",
|
|
222833
|
-
"description": "Run the Android emulator without a window.
|
|
222933
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
222834
222934
|
},
|
|
222835
222935
|
"orientation": {
|
|
222836
222936
|
"type": "string",
|
|
@@ -228159,7 +228259,7 @@
|
|
|
228159
228259
|
"safari",
|
|
228160
228260
|
"webkit"
|
|
228161
228261
|
],
|
|
228162
|
-
"$comment": "`safari` is
|
|
228262
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
228163
228263
|
},
|
|
228164
228264
|
"explicit": {
|
|
228165
228265
|
"type": "boolean",
|
|
@@ -263864,7 +263964,7 @@
|
|
|
263864
263964
|
"startSurface": {
|
|
263865
263965
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
263866
263966
|
"title": "startSurface",
|
|
263867
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
263967
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
263868
263968
|
"components": {
|
|
263869
263969
|
"schemas": {
|
|
263870
263970
|
"appDescriptor": {
|
|
@@ -263916,15 +264016,15 @@
|
|
|
263916
264016
|
"install": {
|
|
263917
264017
|
"type": "string",
|
|
263918
264018
|
"minLength": 1,
|
|
263919
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
264019
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
263920
264020
|
},
|
|
263921
264021
|
"activity": {
|
|
263922
264022
|
"type": "string",
|
|
263923
264023
|
"minLength": 1,
|
|
263924
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
264024
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
263925
264025
|
},
|
|
263926
264026
|
"device": {
|
|
263927
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
264027
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
263928
264028
|
"anyOf": [
|
|
263929
264029
|
{
|
|
263930
264030
|
"type": "string",
|
|
@@ -263957,7 +264057,7 @@
|
|
|
263957
264057
|
"transform": [
|
|
263958
264058
|
"trim"
|
|
263959
264059
|
],
|
|
263960
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
264060
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
263961
264061
|
},
|
|
263962
264062
|
"deviceType": {
|
|
263963
264063
|
"type": "string",
|
|
@@ -263970,11 +264070,11 @@
|
|
|
263970
264070
|
"osVersion": {
|
|
263971
264071
|
"type": "string",
|
|
263972
264072
|
"minLength": 1,
|
|
263973
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
264073
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
263974
264074
|
},
|
|
263975
264075
|
"headless": {
|
|
263976
264076
|
"type": "boolean",
|
|
263977
|
-
"description": "Run the Android emulator without a window.
|
|
264077
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
263978
264078
|
},
|
|
263979
264079
|
"orientation": {
|
|
263980
264080
|
"type": "string",
|
|
@@ -264146,7 +264246,7 @@
|
|
|
264146
264246
|
"transform": [
|
|
264147
264247
|
"trim"
|
|
264148
264248
|
],
|
|
264149
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
264249
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
264150
264250
|
},
|
|
264151
264251
|
"deviceType": {
|
|
264152
264252
|
"type": "string",
|
|
@@ -264159,11 +264259,11 @@
|
|
|
264159
264259
|
"osVersion": {
|
|
264160
264260
|
"type": "string",
|
|
264161
264261
|
"minLength": 1,
|
|
264162
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
264262
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
264163
264263
|
},
|
|
264164
264264
|
"headless": {
|
|
264165
264265
|
"type": "boolean",
|
|
264166
|
-
"description": "Run the Android emulator without a window.
|
|
264266
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
264167
264267
|
},
|
|
264168
264268
|
"orientation": {
|
|
264169
264269
|
"type": "string",
|
|
@@ -264262,15 +264362,15 @@
|
|
|
264262
264362
|
"install": {
|
|
264263
264363
|
"type": "string",
|
|
264264
264364
|
"minLength": 1,
|
|
264265
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
264365
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
264266
264366
|
},
|
|
264267
264367
|
"activity": {
|
|
264268
264368
|
"type": "string",
|
|
264269
264369
|
"minLength": 1,
|
|
264270
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
264370
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
264271
264371
|
},
|
|
264272
264372
|
"device": {
|
|
264273
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
264373
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
264274
264374
|
"anyOf": [
|
|
264275
264375
|
{
|
|
264276
264376
|
"type": "string",
|
|
@@ -264303,7 +264403,7 @@
|
|
|
264303
264403
|
"transform": [
|
|
264304
264404
|
"trim"
|
|
264305
264405
|
],
|
|
264306
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
264406
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
264307
264407
|
},
|
|
264308
264408
|
"deviceType": {
|
|
264309
264409
|
"type": "string",
|
|
@@ -264316,11 +264416,11 @@
|
|
|
264316
264416
|
"osVersion": {
|
|
264317
264417
|
"type": "string",
|
|
264318
264418
|
"minLength": 1,
|
|
264319
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
264419
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
264320
264420
|
},
|
|
264321
264421
|
"headless": {
|
|
264322
264422
|
"type": "boolean",
|
|
264323
|
-
"description": "Run the Android emulator without a window.
|
|
264423
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
264324
264424
|
},
|
|
264325
264425
|
"orientation": {
|
|
264326
264426
|
"type": "string",
|
|
@@ -270503,7 +270603,7 @@
|
|
|
270503
270603
|
]
|
|
270504
270604
|
},
|
|
270505
270605
|
"browsers": {
|
|
270506
|
-
"description": "Browsers to run tests on.",
|
|
270606
|
+
"description": "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
|
|
270507
270607
|
"anyOf": [
|
|
270508
270608
|
{
|
|
270509
270609
|
"type": "string",
|
|
@@ -270514,7 +270614,7 @@
|
|
|
270514
270614
|
"safari",
|
|
270515
270615
|
"webkit"
|
|
270516
270616
|
],
|
|
270517
|
-
"$comment": "`safari` is
|
|
270617
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
270518
270618
|
},
|
|
270519
270619
|
{
|
|
270520
270620
|
"type": "object",
|
|
@@ -270533,7 +270633,7 @@
|
|
|
270533
270633
|
"safari",
|
|
270534
270634
|
"webkit"
|
|
270535
270635
|
],
|
|
270536
|
-
"$comment": "`safari` is
|
|
270636
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
270537
270637
|
},
|
|
270538
270638
|
"explicit": {
|
|
270539
270639
|
"type": "boolean",
|
|
@@ -270593,7 +270693,7 @@
|
|
|
270593
270693
|
"safari",
|
|
270594
270694
|
"webkit"
|
|
270595
270695
|
],
|
|
270596
|
-
"$comment": "`safari` is
|
|
270696
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
270597
270697
|
},
|
|
270598
270698
|
{
|
|
270599
270699
|
"type": "object",
|
|
@@ -270612,7 +270712,7 @@
|
|
|
270612
270712
|
"safari",
|
|
270613
270713
|
"webkit"
|
|
270614
270714
|
],
|
|
270615
|
-
"$comment": "`safari` is
|
|
270715
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
270616
270716
|
},
|
|
270617
270717
|
"explicit": {
|
|
270618
270718
|
"type": "boolean",
|
|
@@ -270788,7 +270888,7 @@
|
|
|
270788
270888
|
]
|
|
270789
270889
|
},
|
|
270790
270890
|
"device": {
|
|
270791
|
-
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android`). Same shape as `startSurface.device`.",
|
|
270891
|
+
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.",
|
|
270792
270892
|
"examples": [
|
|
270793
270893
|
"pixel7",
|
|
270794
270894
|
{
|
|
@@ -270827,7 +270927,7 @@
|
|
|
270827
270927
|
"transform": [
|
|
270828
270928
|
"trim"
|
|
270829
270929
|
],
|
|
270830
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
270930
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
270831
270931
|
},
|
|
270832
270932
|
"deviceType": {
|
|
270833
270933
|
"type": "string",
|
|
@@ -270840,11 +270940,11 @@
|
|
|
270840
270940
|
"osVersion": {
|
|
270841
270941
|
"type": "string",
|
|
270842
270942
|
"minLength": 1,
|
|
270843
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
270943
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
270844
270944
|
},
|
|
270845
270945
|
"headless": {
|
|
270846
270946
|
"type": "boolean",
|
|
270847
|
-
"description": "Run the Android emulator without a window.
|
|
270947
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
270848
270948
|
},
|
|
270849
270949
|
"orientation": {
|
|
270850
270950
|
"type": "string",
|
|
@@ -270898,7 +270998,7 @@
|
|
|
270898
270998
|
"safari",
|
|
270899
270999
|
"webkit"
|
|
270900
271000
|
],
|
|
270901
|
-
"$comment": "`safari` is
|
|
271001
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
270902
271002
|
},
|
|
270903
271003
|
"browser": {
|
|
270904
271004
|
"type": "object",
|
|
@@ -270917,7 +271017,7 @@
|
|
|
270917
271017
|
"safari",
|
|
270918
271018
|
"webkit"
|
|
270919
271019
|
],
|
|
270920
|
-
"$comment": "`safari` is
|
|
271020
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
270921
271021
|
},
|
|
270922
271022
|
"explicit": {
|
|
270923
271023
|
"type": "boolean",
|
|
@@ -271057,6 +271157,26 @@
|
|
|
271057
271157
|
}
|
|
271058
271158
|
}
|
|
271059
271159
|
]
|
|
271160
|
+
},
|
|
271161
|
+
{
|
|
271162
|
+
"platforms": "android"
|
|
271163
|
+
},
|
|
271164
|
+
{
|
|
271165
|
+
"platforms": [
|
|
271166
|
+
"windows",
|
|
271167
|
+
"mac",
|
|
271168
|
+
"android",
|
|
271169
|
+
"ios"
|
|
271170
|
+
],
|
|
271171
|
+
"browsers": "chrome"
|
|
271172
|
+
},
|
|
271173
|
+
{
|
|
271174
|
+
"platforms": "ios",
|
|
271175
|
+
"browsers": "safari",
|
|
271176
|
+
"device": {
|
|
271177
|
+
"name": "test-iphone",
|
|
271178
|
+
"deviceType": "phone"
|
|
271179
|
+
}
|
|
271060
271180
|
}
|
|
271061
271181
|
]
|
|
271062
271182
|
}
|
|
@@ -271345,7 +271465,7 @@
|
|
|
271345
271465
|
]
|
|
271346
271466
|
},
|
|
271347
271467
|
"browsers": {
|
|
271348
|
-
"description": "Browsers to run tests on.",
|
|
271468
|
+
"description": "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
|
|
271349
271469
|
"anyOf": [
|
|
271350
271470
|
{
|
|
271351
271471
|
"type": "string",
|
|
@@ -271356,7 +271476,7 @@
|
|
|
271356
271476
|
"safari",
|
|
271357
271477
|
"webkit"
|
|
271358
271478
|
],
|
|
271359
|
-
"$comment": "`safari` is
|
|
271479
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
271360
271480
|
},
|
|
271361
271481
|
{
|
|
271362
271482
|
"type": "object",
|
|
@@ -271375,7 +271495,7 @@
|
|
|
271375
271495
|
"safari",
|
|
271376
271496
|
"webkit"
|
|
271377
271497
|
],
|
|
271378
|
-
"$comment": "`safari` is
|
|
271498
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
271379
271499
|
},
|
|
271380
271500
|
"explicit": {
|
|
271381
271501
|
"type": "boolean",
|
|
@@ -271435,7 +271555,7 @@
|
|
|
271435
271555
|
"safari",
|
|
271436
271556
|
"webkit"
|
|
271437
271557
|
],
|
|
271438
|
-
"$comment": "`safari` is
|
|
271558
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
271439
271559
|
},
|
|
271440
271560
|
{
|
|
271441
271561
|
"type": "object",
|
|
@@ -271454,7 +271574,7 @@
|
|
|
271454
271574
|
"safari",
|
|
271455
271575
|
"webkit"
|
|
271456
271576
|
],
|
|
271457
|
-
"$comment": "`safari` is
|
|
271577
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
271458
271578
|
},
|
|
271459
271579
|
"explicit": {
|
|
271460
271580
|
"type": "boolean",
|
|
@@ -271630,7 +271750,7 @@
|
|
|
271630
271750
|
]
|
|
271631
271751
|
},
|
|
271632
271752
|
"device": {
|
|
271633
|
-
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android`). Same shape as `startSurface.device`.",
|
|
271753
|
+
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.",
|
|
271634
271754
|
"examples": [
|
|
271635
271755
|
"pixel7",
|
|
271636
271756
|
{
|
|
@@ -271669,7 +271789,7 @@
|
|
|
271669
271789
|
"transform": [
|
|
271670
271790
|
"trim"
|
|
271671
271791
|
],
|
|
271672
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
271792
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
271673
271793
|
},
|
|
271674
271794
|
"deviceType": {
|
|
271675
271795
|
"type": "string",
|
|
@@ -271682,11 +271802,11 @@
|
|
|
271682
271802
|
"osVersion": {
|
|
271683
271803
|
"type": "string",
|
|
271684
271804
|
"minLength": 1,
|
|
271685
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
271805
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
271686
271806
|
},
|
|
271687
271807
|
"headless": {
|
|
271688
271808
|
"type": "boolean",
|
|
271689
|
-
"description": "Run the Android emulator without a window.
|
|
271809
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
271690
271810
|
},
|
|
271691
271811
|
"orientation": {
|
|
271692
271812
|
"type": "string",
|
|
@@ -271740,7 +271860,7 @@
|
|
|
271740
271860
|
"safari",
|
|
271741
271861
|
"webkit"
|
|
271742
271862
|
],
|
|
271743
|
-
"$comment": "`safari` is
|
|
271863
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
271744
271864
|
},
|
|
271745
271865
|
"browser": {
|
|
271746
271866
|
"type": "object",
|
|
@@ -271759,7 +271879,7 @@
|
|
|
271759
271879
|
"safari",
|
|
271760
271880
|
"webkit"
|
|
271761
271881
|
],
|
|
271762
|
-
"$comment": "`safari` is
|
|
271882
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
271763
271883
|
},
|
|
271764
271884
|
"explicit": {
|
|
271765
271885
|
"type": "boolean",
|
|
@@ -271899,6 +272019,26 @@
|
|
|
271899
272019
|
}
|
|
271900
272020
|
}
|
|
271901
272021
|
]
|
|
272022
|
+
},
|
|
272023
|
+
{
|
|
272024
|
+
"platforms": "android"
|
|
272025
|
+
},
|
|
272026
|
+
{
|
|
272027
|
+
"platforms": [
|
|
272028
|
+
"windows",
|
|
272029
|
+
"mac",
|
|
272030
|
+
"android",
|
|
272031
|
+
"ios"
|
|
272032
|
+
],
|
|
272033
|
+
"browsers": "chrome"
|
|
272034
|
+
},
|
|
272035
|
+
{
|
|
272036
|
+
"platforms": "ios",
|
|
272037
|
+
"browsers": "safari",
|
|
272038
|
+
"device": {
|
|
272039
|
+
"name": "test-iphone",
|
|
272040
|
+
"deviceType": "phone"
|
|
272041
|
+
}
|
|
271902
272042
|
}
|
|
271903
272043
|
]
|
|
271904
272044
|
}
|
|
@@ -308275,7 +308415,7 @@
|
|
|
308275
308415
|
"startSurface": {
|
|
308276
308416
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
308277
308417
|
"title": "startSurface",
|
|
308278
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
308418
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
308279
308419
|
"components": {
|
|
308280
308420
|
"schemas": {
|
|
308281
308421
|
"appDescriptor": {
|
|
@@ -308327,15 +308467,15 @@
|
|
|
308327
308467
|
"install": {
|
|
308328
308468
|
"type": "string",
|
|
308329
308469
|
"minLength": 1,
|
|
308330
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
308470
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
308331
308471
|
},
|
|
308332
308472
|
"activity": {
|
|
308333
308473
|
"type": "string",
|
|
308334
308474
|
"minLength": 1,
|
|
308335
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
308475
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
308336
308476
|
},
|
|
308337
308477
|
"device": {
|
|
308338
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
308478
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
308339
308479
|
"anyOf": [
|
|
308340
308480
|
{
|
|
308341
308481
|
"type": "string",
|
|
@@ -308368,7 +308508,7 @@
|
|
|
308368
308508
|
"transform": [
|
|
308369
308509
|
"trim"
|
|
308370
308510
|
],
|
|
308371
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
308511
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
308372
308512
|
},
|
|
308373
308513
|
"deviceType": {
|
|
308374
308514
|
"type": "string",
|
|
@@ -308381,11 +308521,11 @@
|
|
|
308381
308521
|
"osVersion": {
|
|
308382
308522
|
"type": "string",
|
|
308383
308523
|
"minLength": 1,
|
|
308384
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
308524
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
308385
308525
|
},
|
|
308386
308526
|
"headless": {
|
|
308387
308527
|
"type": "boolean",
|
|
308388
|
-
"description": "Run the Android emulator without a window.
|
|
308528
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
308389
308529
|
},
|
|
308390
308530
|
"orientation": {
|
|
308391
308531
|
"type": "string",
|
|
@@ -308557,7 +308697,7 @@
|
|
|
308557
308697
|
"transform": [
|
|
308558
308698
|
"trim"
|
|
308559
308699
|
],
|
|
308560
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
308700
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
308561
308701
|
},
|
|
308562
308702
|
"deviceType": {
|
|
308563
308703
|
"type": "string",
|
|
@@ -308570,11 +308710,11 @@
|
|
|
308570
308710
|
"osVersion": {
|
|
308571
308711
|
"type": "string",
|
|
308572
308712
|
"minLength": 1,
|
|
308573
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
308713
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
308574
308714
|
},
|
|
308575
308715
|
"headless": {
|
|
308576
308716
|
"type": "boolean",
|
|
308577
|
-
"description": "Run the Android emulator without a window.
|
|
308717
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
308578
308718
|
},
|
|
308579
308719
|
"orientation": {
|
|
308580
308720
|
"type": "string",
|
|
@@ -308673,15 +308813,15 @@
|
|
|
308673
308813
|
"install": {
|
|
308674
308814
|
"type": "string",
|
|
308675
308815
|
"minLength": 1,
|
|
308676
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
308816
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
308677
308817
|
},
|
|
308678
308818
|
"activity": {
|
|
308679
308819
|
"type": "string",
|
|
308680
308820
|
"minLength": 1,
|
|
308681
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
308821
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
308682
308822
|
},
|
|
308683
308823
|
"device": {
|
|
308684
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
308824
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
308685
308825
|
"anyOf": [
|
|
308686
308826
|
{
|
|
308687
308827
|
"type": "string",
|
|
@@ -308714,7 +308854,7 @@
|
|
|
308714
308854
|
"transform": [
|
|
308715
308855
|
"trim"
|
|
308716
308856
|
],
|
|
308717
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
308857
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
308718
308858
|
},
|
|
308719
308859
|
"deviceType": {
|
|
308720
308860
|
"type": "string",
|
|
@@ -308727,11 +308867,11 @@
|
|
|
308727
308867
|
"osVersion": {
|
|
308728
308868
|
"type": "string",
|
|
308729
308869
|
"minLength": 1,
|
|
308730
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
308870
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
308731
308871
|
},
|
|
308732
308872
|
"headless": {
|
|
308733
308873
|
"type": "boolean",
|
|
308734
|
-
"description": "Run the Android emulator without a window.
|
|
308874
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
308735
308875
|
},
|
|
308736
308876
|
"orientation": {
|
|
308737
308877
|
"type": "string",
|
|
@@ -314060,7 +314200,7 @@
|
|
|
314060
314200
|
"safari",
|
|
314061
314201
|
"webkit"
|
|
314062
314202
|
],
|
|
314063
|
-
"$comment": "`safari` is
|
|
314203
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
314064
314204
|
},
|
|
314065
314205
|
"explicit": {
|
|
314066
314206
|
"type": "boolean",
|
|
@@ -349765,7 +349905,7 @@
|
|
|
349765
349905
|
"startSurface": {
|
|
349766
349906
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
349767
349907
|
"title": "startSurface",
|
|
349768
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
349908
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
349769
349909
|
"components": {
|
|
349770
349910
|
"schemas": {
|
|
349771
349911
|
"appDescriptor": {
|
|
@@ -349817,15 +349957,15 @@
|
|
|
349817
349957
|
"install": {
|
|
349818
349958
|
"type": "string",
|
|
349819
349959
|
"minLength": 1,
|
|
349820
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
349960
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
349821
349961
|
},
|
|
349822
349962
|
"activity": {
|
|
349823
349963
|
"type": "string",
|
|
349824
349964
|
"minLength": 1,
|
|
349825
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
349965
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
349826
349966
|
},
|
|
349827
349967
|
"device": {
|
|
349828
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
349968
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
349829
349969
|
"anyOf": [
|
|
349830
349970
|
{
|
|
349831
349971
|
"type": "string",
|
|
@@ -349858,7 +349998,7 @@
|
|
|
349858
349998
|
"transform": [
|
|
349859
349999
|
"trim"
|
|
349860
350000
|
],
|
|
349861
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
350001
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
349862
350002
|
},
|
|
349863
350003
|
"deviceType": {
|
|
349864
350004
|
"type": "string",
|
|
@@ -349871,11 +350011,11 @@
|
|
|
349871
350011
|
"osVersion": {
|
|
349872
350012
|
"type": "string",
|
|
349873
350013
|
"minLength": 1,
|
|
349874
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
350014
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
349875
350015
|
},
|
|
349876
350016
|
"headless": {
|
|
349877
350017
|
"type": "boolean",
|
|
349878
|
-
"description": "Run the Android emulator without a window.
|
|
350018
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
349879
350019
|
},
|
|
349880
350020
|
"orientation": {
|
|
349881
350021
|
"type": "string",
|
|
@@ -350047,7 +350187,7 @@
|
|
|
350047
350187
|
"transform": [
|
|
350048
350188
|
"trim"
|
|
350049
350189
|
],
|
|
350050
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
350190
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
350051
350191
|
},
|
|
350052
350192
|
"deviceType": {
|
|
350053
350193
|
"type": "string",
|
|
@@ -350060,11 +350200,11 @@
|
|
|
350060
350200
|
"osVersion": {
|
|
350061
350201
|
"type": "string",
|
|
350062
350202
|
"minLength": 1,
|
|
350063
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
350203
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
350064
350204
|
},
|
|
350065
350205
|
"headless": {
|
|
350066
350206
|
"type": "boolean",
|
|
350067
|
-
"description": "Run the Android emulator without a window.
|
|
350207
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
350068
350208
|
},
|
|
350069
350209
|
"orientation": {
|
|
350070
350210
|
"type": "string",
|
|
@@ -350163,15 +350303,15 @@
|
|
|
350163
350303
|
"install": {
|
|
350164
350304
|
"type": "string",
|
|
350165
350305
|
"minLength": 1,
|
|
350166
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
350306
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
350167
350307
|
},
|
|
350168
350308
|
"activity": {
|
|
350169
350309
|
"type": "string",
|
|
350170
350310
|
"minLength": 1,
|
|
350171
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
350311
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
350172
350312
|
},
|
|
350173
350313
|
"device": {
|
|
350174
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
350314
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
350175
350315
|
"anyOf": [
|
|
350176
350316
|
{
|
|
350177
350317
|
"type": "string",
|
|
@@ -350204,7 +350344,7 @@
|
|
|
350204
350344
|
"transform": [
|
|
350205
350345
|
"trim"
|
|
350206
350346
|
],
|
|
350207
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
350347
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
350208
350348
|
},
|
|
350209
350349
|
"deviceType": {
|
|
350210
350350
|
"type": "string",
|
|
@@ -350217,11 +350357,11 @@
|
|
|
350217
350357
|
"osVersion": {
|
|
350218
350358
|
"type": "string",
|
|
350219
350359
|
"minLength": 1,
|
|
350220
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
350360
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
350221
350361
|
},
|
|
350222
350362
|
"headless": {
|
|
350223
350363
|
"type": "boolean",
|
|
350224
|
-
"description": "Run the Android emulator without a window.
|
|
350364
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
350225
350365
|
},
|
|
350226
350366
|
"orientation": {
|
|
350227
350367
|
"type": "string",
|
|
@@ -359617,7 +359757,7 @@
|
|
|
359617
359757
|
]
|
|
359618
359758
|
},
|
|
359619
359759
|
"browsers": {
|
|
359620
|
-
"description": "Browsers to run tests on.",
|
|
359760
|
+
"description": "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
|
|
359621
359761
|
"anyOf": [
|
|
359622
359762
|
{
|
|
359623
359763
|
"type": "string",
|
|
@@ -359628,7 +359768,7 @@
|
|
|
359628
359768
|
"safari",
|
|
359629
359769
|
"webkit"
|
|
359630
359770
|
],
|
|
359631
|
-
"$comment": "`safari` is
|
|
359771
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
359632
359772
|
},
|
|
359633
359773
|
{
|
|
359634
359774
|
"type": "object",
|
|
@@ -359647,7 +359787,7 @@
|
|
|
359647
359787
|
"safari",
|
|
359648
359788
|
"webkit"
|
|
359649
359789
|
],
|
|
359650
|
-
"$comment": "`safari` is
|
|
359790
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
359651
359791
|
},
|
|
359652
359792
|
"explicit": {
|
|
359653
359793
|
"type": "boolean",
|
|
@@ -359707,7 +359847,7 @@
|
|
|
359707
359847
|
"safari",
|
|
359708
359848
|
"webkit"
|
|
359709
359849
|
],
|
|
359710
|
-
"$comment": "`safari` is
|
|
359850
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
359711
359851
|
},
|
|
359712
359852
|
{
|
|
359713
359853
|
"type": "object",
|
|
@@ -359726,7 +359866,7 @@
|
|
|
359726
359866
|
"safari",
|
|
359727
359867
|
"webkit"
|
|
359728
359868
|
],
|
|
359729
|
-
"$comment": "`safari` is
|
|
359869
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
359730
359870
|
},
|
|
359731
359871
|
"explicit": {
|
|
359732
359872
|
"type": "boolean",
|
|
@@ -359902,7 +360042,7 @@
|
|
|
359902
360042
|
]
|
|
359903
360043
|
},
|
|
359904
360044
|
"device": {
|
|
359905
|
-
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android`). Same shape as `startSurface.device`.",
|
|
360045
|
+
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.",
|
|
359906
360046
|
"examples": [
|
|
359907
360047
|
"pixel7",
|
|
359908
360048
|
{
|
|
@@ -359941,7 +360081,7 @@
|
|
|
359941
360081
|
"transform": [
|
|
359942
360082
|
"trim"
|
|
359943
360083
|
],
|
|
359944
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
360084
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
359945
360085
|
},
|
|
359946
360086
|
"deviceType": {
|
|
359947
360087
|
"type": "string",
|
|
@@ -359954,11 +360094,11 @@
|
|
|
359954
360094
|
"osVersion": {
|
|
359955
360095
|
"type": "string",
|
|
359956
360096
|
"minLength": 1,
|
|
359957
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
360097
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
359958
360098
|
},
|
|
359959
360099
|
"headless": {
|
|
359960
360100
|
"type": "boolean",
|
|
359961
|
-
"description": "Run the Android emulator without a window.
|
|
360101
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
359962
360102
|
},
|
|
359963
360103
|
"orientation": {
|
|
359964
360104
|
"type": "string",
|
|
@@ -360012,7 +360152,7 @@
|
|
|
360012
360152
|
"safari",
|
|
360013
360153
|
"webkit"
|
|
360014
360154
|
],
|
|
360015
|
-
"$comment": "`safari` is
|
|
360155
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
360016
360156
|
},
|
|
360017
360157
|
"browser": {
|
|
360018
360158
|
"type": "object",
|
|
@@ -360031,7 +360171,7 @@
|
|
|
360031
360171
|
"safari",
|
|
360032
360172
|
"webkit"
|
|
360033
360173
|
],
|
|
360034
|
-
"$comment": "`safari` is
|
|
360174
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
360035
360175
|
},
|
|
360036
360176
|
"explicit": {
|
|
360037
360177
|
"type": "boolean",
|
|
@@ -360171,6 +360311,26 @@
|
|
|
360171
360311
|
}
|
|
360172
360312
|
}
|
|
360173
360313
|
]
|
|
360314
|
+
},
|
|
360315
|
+
{
|
|
360316
|
+
"platforms": "android"
|
|
360317
|
+
},
|
|
360318
|
+
{
|
|
360319
|
+
"platforms": [
|
|
360320
|
+
"windows",
|
|
360321
|
+
"mac",
|
|
360322
|
+
"android",
|
|
360323
|
+
"ios"
|
|
360324
|
+
],
|
|
360325
|
+
"browsers": "chrome"
|
|
360326
|
+
},
|
|
360327
|
+
{
|
|
360328
|
+
"platforms": "ios",
|
|
360329
|
+
"browsers": "safari",
|
|
360330
|
+
"device": {
|
|
360331
|
+
"name": "test-iphone",
|
|
360332
|
+
"deviceType": "phone"
|
|
360333
|
+
}
|
|
360174
360334
|
}
|
|
360175
360335
|
]
|
|
360176
360336
|
}
|
|
@@ -360459,7 +360619,7 @@
|
|
|
360459
360619
|
]
|
|
360460
360620
|
},
|
|
360461
360621
|
"browsers": {
|
|
360462
|
-
"description": "Browsers to run tests on.",
|
|
360622
|
+
"description": "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
|
|
360463
360623
|
"anyOf": [
|
|
360464
360624
|
{
|
|
360465
360625
|
"type": "string",
|
|
@@ -360470,7 +360630,7 @@
|
|
|
360470
360630
|
"safari",
|
|
360471
360631
|
"webkit"
|
|
360472
360632
|
],
|
|
360473
|
-
"$comment": "`safari` is
|
|
360633
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
360474
360634
|
},
|
|
360475
360635
|
{
|
|
360476
360636
|
"type": "object",
|
|
@@ -360489,7 +360649,7 @@
|
|
|
360489
360649
|
"safari",
|
|
360490
360650
|
"webkit"
|
|
360491
360651
|
],
|
|
360492
|
-
"$comment": "`safari` is
|
|
360652
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
360493
360653
|
},
|
|
360494
360654
|
"explicit": {
|
|
360495
360655
|
"type": "boolean",
|
|
@@ -360549,7 +360709,7 @@
|
|
|
360549
360709
|
"safari",
|
|
360550
360710
|
"webkit"
|
|
360551
360711
|
],
|
|
360552
|
-
"$comment": "`safari` is
|
|
360712
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
360553
360713
|
},
|
|
360554
360714
|
{
|
|
360555
360715
|
"type": "object",
|
|
@@ -360568,7 +360728,7 @@
|
|
|
360568
360728
|
"safari",
|
|
360569
360729
|
"webkit"
|
|
360570
360730
|
],
|
|
360571
|
-
"$comment": "`safari` is
|
|
360731
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
360572
360732
|
},
|
|
360573
360733
|
"explicit": {
|
|
360574
360734
|
"type": "boolean",
|
|
@@ -360744,7 +360904,7 @@
|
|
|
360744
360904
|
]
|
|
360745
360905
|
},
|
|
360746
360906
|
"device": {
|
|
360747
|
-
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android`). Same shape as `startSurface.device`.",
|
|
360907
|
+
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.",
|
|
360748
360908
|
"examples": [
|
|
360749
360909
|
"pixel7",
|
|
360750
360910
|
{
|
|
@@ -360783,7 +360943,7 @@
|
|
|
360783
360943
|
"transform": [
|
|
360784
360944
|
"trim"
|
|
360785
360945
|
],
|
|
360786
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
360946
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
360787
360947
|
},
|
|
360788
360948
|
"deviceType": {
|
|
360789
360949
|
"type": "string",
|
|
@@ -360796,11 +360956,11 @@
|
|
|
360796
360956
|
"osVersion": {
|
|
360797
360957
|
"type": "string",
|
|
360798
360958
|
"minLength": 1,
|
|
360799
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
360959
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
360800
360960
|
},
|
|
360801
360961
|
"headless": {
|
|
360802
360962
|
"type": "boolean",
|
|
360803
|
-
"description": "Run the Android emulator without a window.
|
|
360963
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
360804
360964
|
},
|
|
360805
360965
|
"orientation": {
|
|
360806
360966
|
"type": "string",
|
|
@@ -360854,7 +361014,7 @@
|
|
|
360854
361014
|
"safari",
|
|
360855
361015
|
"webkit"
|
|
360856
361016
|
],
|
|
360857
|
-
"$comment": "`safari` is
|
|
361017
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
360858
361018
|
},
|
|
360859
361019
|
"browser": {
|
|
360860
361020
|
"type": "object",
|
|
@@ -360873,7 +361033,7 @@
|
|
|
360873
361033
|
"safari",
|
|
360874
361034
|
"webkit"
|
|
360875
361035
|
],
|
|
360876
|
-
"$comment": "`safari` is
|
|
361036
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
360877
361037
|
},
|
|
360878
361038
|
"explicit": {
|
|
360879
361039
|
"type": "boolean",
|
|
@@ -361013,6 +361173,26 @@
|
|
|
361013
361173
|
}
|
|
361014
361174
|
}
|
|
361015
361175
|
]
|
|
361176
|
+
},
|
|
361177
|
+
{
|
|
361178
|
+
"platforms": "android"
|
|
361179
|
+
},
|
|
361180
|
+
{
|
|
361181
|
+
"platforms": [
|
|
361182
|
+
"windows",
|
|
361183
|
+
"mac",
|
|
361184
|
+
"android",
|
|
361185
|
+
"ios"
|
|
361186
|
+
],
|
|
361187
|
+
"browsers": "chrome"
|
|
361188
|
+
},
|
|
361189
|
+
{
|
|
361190
|
+
"platforms": "ios",
|
|
361191
|
+
"browsers": "safari",
|
|
361192
|
+
"device": {
|
|
361193
|
+
"name": "test-iphone",
|
|
361194
|
+
"deviceType": "phone"
|
|
361195
|
+
}
|
|
361016
361196
|
}
|
|
361017
361197
|
]
|
|
361018
361198
|
}
|
|
@@ -397389,7 +397569,7 @@
|
|
|
397389
397569
|
"startSurface": {
|
|
397390
397570
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
397391
397571
|
"title": "startSurface",
|
|
397392
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
397572
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
397393
397573
|
"components": {
|
|
397394
397574
|
"schemas": {
|
|
397395
397575
|
"appDescriptor": {
|
|
@@ -397441,15 +397621,15 @@
|
|
|
397441
397621
|
"install": {
|
|
397442
397622
|
"type": "string",
|
|
397443
397623
|
"minLength": 1,
|
|
397444
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
397624
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
397445
397625
|
},
|
|
397446
397626
|
"activity": {
|
|
397447
397627
|
"type": "string",
|
|
397448
397628
|
"minLength": 1,
|
|
397449
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
397629
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
397450
397630
|
},
|
|
397451
397631
|
"device": {
|
|
397452
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
397632
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
397453
397633
|
"anyOf": [
|
|
397454
397634
|
{
|
|
397455
397635
|
"type": "string",
|
|
@@ -397482,7 +397662,7 @@
|
|
|
397482
397662
|
"transform": [
|
|
397483
397663
|
"trim"
|
|
397484
397664
|
],
|
|
397485
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
397665
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
397486
397666
|
},
|
|
397487
397667
|
"deviceType": {
|
|
397488
397668
|
"type": "string",
|
|
@@ -397495,11 +397675,11 @@
|
|
|
397495
397675
|
"osVersion": {
|
|
397496
397676
|
"type": "string",
|
|
397497
397677
|
"minLength": 1,
|
|
397498
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
397678
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
397499
397679
|
},
|
|
397500
397680
|
"headless": {
|
|
397501
397681
|
"type": "boolean",
|
|
397502
|
-
"description": "Run the Android emulator without a window.
|
|
397682
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
397503
397683
|
},
|
|
397504
397684
|
"orientation": {
|
|
397505
397685
|
"type": "string",
|
|
@@ -397671,7 +397851,7 @@
|
|
|
397671
397851
|
"transform": [
|
|
397672
397852
|
"trim"
|
|
397673
397853
|
],
|
|
397674
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
397854
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
397675
397855
|
},
|
|
397676
397856
|
"deviceType": {
|
|
397677
397857
|
"type": "string",
|
|
@@ -397684,11 +397864,11 @@
|
|
|
397684
397864
|
"osVersion": {
|
|
397685
397865
|
"type": "string",
|
|
397686
397866
|
"minLength": 1,
|
|
397687
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
397867
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
397688
397868
|
},
|
|
397689
397869
|
"headless": {
|
|
397690
397870
|
"type": "boolean",
|
|
397691
|
-
"description": "Run the Android emulator without a window.
|
|
397871
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
397692
397872
|
},
|
|
397693
397873
|
"orientation": {
|
|
397694
397874
|
"type": "string",
|
|
@@ -397787,15 +397967,15 @@
|
|
|
397787
397967
|
"install": {
|
|
397788
397968
|
"type": "string",
|
|
397789
397969
|
"minLength": 1,
|
|
397790
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
397970
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
397791
397971
|
},
|
|
397792
397972
|
"activity": {
|
|
397793
397973
|
"type": "string",
|
|
397794
397974
|
"minLength": 1,
|
|
397795
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
397975
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
397796
397976
|
},
|
|
397797
397977
|
"device": {
|
|
397798
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
397978
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
397799
397979
|
"anyOf": [
|
|
397800
397980
|
{
|
|
397801
397981
|
"type": "string",
|
|
@@ -397828,7 +398008,7 @@
|
|
|
397828
398008
|
"transform": [
|
|
397829
398009
|
"trim"
|
|
397830
398010
|
],
|
|
397831
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
398011
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
397832
398012
|
},
|
|
397833
398013
|
"deviceType": {
|
|
397834
398014
|
"type": "string",
|
|
@@ -397841,11 +398021,11 @@
|
|
|
397841
398021
|
"osVersion": {
|
|
397842
398022
|
"type": "string",
|
|
397843
398023
|
"minLength": 1,
|
|
397844
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
398024
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
397845
398025
|
},
|
|
397846
398026
|
"headless": {
|
|
397847
398027
|
"type": "boolean",
|
|
397848
|
-
"description": "Run the Android emulator without a window.
|
|
398028
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
397849
398029
|
},
|
|
397850
398030
|
"orientation": {
|
|
397851
398031
|
"type": "string",
|
|
@@ -403174,7 +403354,7 @@
|
|
|
403174
403354
|
"safari",
|
|
403175
403355
|
"webkit"
|
|
403176
403356
|
],
|
|
403177
|
-
"$comment": "`safari` is
|
|
403357
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
403178
403358
|
},
|
|
403179
403359
|
"explicit": {
|
|
403180
403360
|
"type": "boolean",
|
|
@@ -438879,7 +439059,7 @@
|
|
|
438879
439059
|
"startSurface": {
|
|
438880
439060
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
438881
439061
|
"title": "startSurface",
|
|
438882
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
439062
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
438883
439063
|
"components": {
|
|
438884
439064
|
"schemas": {
|
|
438885
439065
|
"appDescriptor": {
|
|
@@ -438931,15 +439111,15 @@
|
|
|
438931
439111
|
"install": {
|
|
438932
439112
|
"type": "string",
|
|
438933
439113
|
"minLength": 1,
|
|
438934
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
439114
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
438935
439115
|
},
|
|
438936
439116
|
"activity": {
|
|
438937
439117
|
"type": "string",
|
|
438938
439118
|
"minLength": 1,
|
|
438939
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
439119
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
438940
439120
|
},
|
|
438941
439121
|
"device": {
|
|
438942
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
439122
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
438943
439123
|
"anyOf": [
|
|
438944
439124
|
{
|
|
438945
439125
|
"type": "string",
|
|
@@ -438972,7 +439152,7 @@
|
|
|
438972
439152
|
"transform": [
|
|
438973
439153
|
"trim"
|
|
438974
439154
|
],
|
|
438975
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
439155
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
438976
439156
|
},
|
|
438977
439157
|
"deviceType": {
|
|
438978
439158
|
"type": "string",
|
|
@@ -438985,11 +439165,11 @@
|
|
|
438985
439165
|
"osVersion": {
|
|
438986
439166
|
"type": "string",
|
|
438987
439167
|
"minLength": 1,
|
|
438988
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
439168
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
438989
439169
|
},
|
|
438990
439170
|
"headless": {
|
|
438991
439171
|
"type": "boolean",
|
|
438992
|
-
"description": "Run the Android emulator without a window.
|
|
439172
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
438993
439173
|
},
|
|
438994
439174
|
"orientation": {
|
|
438995
439175
|
"type": "string",
|
|
@@ -439161,7 +439341,7 @@
|
|
|
439161
439341
|
"transform": [
|
|
439162
439342
|
"trim"
|
|
439163
439343
|
],
|
|
439164
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
439344
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
439165
439345
|
},
|
|
439166
439346
|
"deviceType": {
|
|
439167
439347
|
"type": "string",
|
|
@@ -439174,11 +439354,11 @@
|
|
|
439174
439354
|
"osVersion": {
|
|
439175
439355
|
"type": "string",
|
|
439176
439356
|
"minLength": 1,
|
|
439177
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
439357
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
439178
439358
|
},
|
|
439179
439359
|
"headless": {
|
|
439180
439360
|
"type": "boolean",
|
|
439181
|
-
"description": "Run the Android emulator without a window.
|
|
439361
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
439182
439362
|
},
|
|
439183
439363
|
"orientation": {
|
|
439184
439364
|
"type": "string",
|
|
@@ -439277,15 +439457,15 @@
|
|
|
439277
439457
|
"install": {
|
|
439278
439458
|
"type": "string",
|
|
439279
439459
|
"minLength": 1,
|
|
439280
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
439460
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
439281
439461
|
},
|
|
439282
439462
|
"activity": {
|
|
439283
439463
|
"type": "string",
|
|
439284
439464
|
"minLength": 1,
|
|
439285
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
439465
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
439286
439466
|
},
|
|
439287
439467
|
"device": {
|
|
439288
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
439468
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
439289
439469
|
"anyOf": [
|
|
439290
439470
|
{
|
|
439291
439471
|
"type": "string",
|
|
@@ -439318,7 +439498,7 @@
|
|
|
439318
439498
|
"transform": [
|
|
439319
439499
|
"trim"
|
|
439320
439500
|
],
|
|
439321
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
439501
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
439322
439502
|
},
|
|
439323
439503
|
"deviceType": {
|
|
439324
439504
|
"type": "string",
|
|
@@ -439331,11 +439511,11 @@
|
|
|
439331
439511
|
"osVersion": {
|
|
439332
439512
|
"type": "string",
|
|
439333
439513
|
"minLength": 1,
|
|
439334
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
439514
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
439335
439515
|
},
|
|
439336
439516
|
"headless": {
|
|
439337
439517
|
"type": "boolean",
|
|
439338
|
-
"description": "Run the Android emulator without a window.
|
|
439518
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
439339
439519
|
},
|
|
439340
439520
|
"orientation": {
|
|
439341
439521
|
"type": "string",
|
|
@@ -445175,7 +445355,7 @@
|
|
|
445175
445355
|
"startSurface_v3": {
|
|
445176
445356
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
445177
445357
|
"title": "startSurface",
|
|
445178
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
445358
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
445179
445359
|
"components": {
|
|
445180
445360
|
"schemas": {
|
|
445181
445361
|
"appDescriptor": {
|
|
@@ -445227,15 +445407,15 @@
|
|
|
445227
445407
|
"install": {
|
|
445228
445408
|
"type": "string",
|
|
445229
445409
|
"minLength": 1,
|
|
445230
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
445410
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
445231
445411
|
},
|
|
445232
445412
|
"activity": {
|
|
445233
445413
|
"type": "string",
|
|
445234
445414
|
"minLength": 1,
|
|
445235
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
445415
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
445236
445416
|
},
|
|
445237
445417
|
"device": {
|
|
445238
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
445418
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
445239
445419
|
"anyOf": [
|
|
445240
445420
|
{
|
|
445241
445421
|
"type": "string",
|
|
@@ -445268,7 +445448,7 @@
|
|
|
445268
445448
|
"transform": [
|
|
445269
445449
|
"trim"
|
|
445270
445450
|
],
|
|
445271
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
445451
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
445272
445452
|
},
|
|
445273
445453
|
"deviceType": {
|
|
445274
445454
|
"type": "string",
|
|
@@ -445281,11 +445461,11 @@
|
|
|
445281
445461
|
"osVersion": {
|
|
445282
445462
|
"type": "string",
|
|
445283
445463
|
"minLength": 1,
|
|
445284
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
445464
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
445285
445465
|
},
|
|
445286
445466
|
"headless": {
|
|
445287
445467
|
"type": "boolean",
|
|
445288
|
-
"description": "Run the Android emulator without a window.
|
|
445468
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
445289
445469
|
},
|
|
445290
445470
|
"orientation": {
|
|
445291
445471
|
"type": "string",
|
|
@@ -445457,7 +445637,7 @@
|
|
|
445457
445637
|
"transform": [
|
|
445458
445638
|
"trim"
|
|
445459
445639
|
],
|
|
445460
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
445640
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
445461
445641
|
},
|
|
445462
445642
|
"deviceType": {
|
|
445463
445643
|
"type": "string",
|
|
@@ -445470,11 +445650,11 @@
|
|
|
445470
445650
|
"osVersion": {
|
|
445471
445651
|
"type": "string",
|
|
445472
445652
|
"minLength": 1,
|
|
445473
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
445653
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
445474
445654
|
},
|
|
445475
445655
|
"headless": {
|
|
445476
445656
|
"type": "boolean",
|
|
445477
|
-
"description": "Run the Android emulator without a window.
|
|
445657
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
445478
445658
|
},
|
|
445479
445659
|
"orientation": {
|
|
445480
445660
|
"type": "string",
|
|
@@ -445573,15 +445753,15 @@
|
|
|
445573
445753
|
"install": {
|
|
445574
445754
|
"type": "string",
|
|
445575
445755
|
"minLength": 1,
|
|
445576
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
445756
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
445577
445757
|
},
|
|
445578
445758
|
"activity": {
|
|
445579
445759
|
"type": "string",
|
|
445580
445760
|
"minLength": 1,
|
|
445581
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
445761
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
445582
445762
|
},
|
|
445583
445763
|
"device": {
|
|
445584
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
445764
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
445585
445765
|
"anyOf": [
|
|
445586
445766
|
{
|
|
445587
445767
|
"type": "string",
|
|
@@ -445614,7 +445794,7 @@
|
|
|
445614
445794
|
"transform": [
|
|
445615
445795
|
"trim"
|
|
445616
445796
|
],
|
|
445617
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
445797
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
445618
445798
|
},
|
|
445619
445799
|
"deviceType": {
|
|
445620
445800
|
"type": "string",
|
|
@@ -445627,11 +445807,11 @@
|
|
|
445627
445807
|
"osVersion": {
|
|
445628
445808
|
"type": "string",
|
|
445629
445809
|
"minLength": 1,
|
|
445630
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
445810
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
445631
445811
|
},
|
|
445632
445812
|
"headless": {
|
|
445633
445813
|
"type": "boolean",
|
|
445634
|
-
"description": "Run the Android emulator without a window.
|
|
445814
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
445635
445815
|
},
|
|
445636
445816
|
"orientation": {
|
|
445637
445817
|
"type": "string",
|
|
@@ -481255,7 +481435,7 @@
|
|
|
481255
481435
|
"startSurface": {
|
|
481256
481436
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
481257
481437
|
"title": "startSurface",
|
|
481258
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
481438
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
481259
481439
|
"components": {
|
|
481260
481440
|
"schemas": {
|
|
481261
481441
|
"appDescriptor": {
|
|
@@ -481307,15 +481487,15 @@
|
|
|
481307
481487
|
"install": {
|
|
481308
481488
|
"type": "string",
|
|
481309
481489
|
"minLength": 1,
|
|
481310
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
481490
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
481311
481491
|
},
|
|
481312
481492
|
"activity": {
|
|
481313
481493
|
"type": "string",
|
|
481314
481494
|
"minLength": 1,
|
|
481315
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
481495
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
481316
481496
|
},
|
|
481317
481497
|
"device": {
|
|
481318
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
481498
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
481319
481499
|
"anyOf": [
|
|
481320
481500
|
{
|
|
481321
481501
|
"type": "string",
|
|
@@ -481348,7 +481528,7 @@
|
|
|
481348
481528
|
"transform": [
|
|
481349
481529
|
"trim"
|
|
481350
481530
|
],
|
|
481351
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
481531
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
481352
481532
|
},
|
|
481353
481533
|
"deviceType": {
|
|
481354
481534
|
"type": "string",
|
|
@@ -481361,11 +481541,11 @@
|
|
|
481361
481541
|
"osVersion": {
|
|
481362
481542
|
"type": "string",
|
|
481363
481543
|
"minLength": 1,
|
|
481364
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
481544
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
481365
481545
|
},
|
|
481366
481546
|
"headless": {
|
|
481367
481547
|
"type": "boolean",
|
|
481368
|
-
"description": "Run the Android emulator without a window.
|
|
481548
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
481369
481549
|
},
|
|
481370
481550
|
"orientation": {
|
|
481371
481551
|
"type": "string",
|
|
@@ -481537,7 +481717,7 @@
|
|
|
481537
481717
|
"transform": [
|
|
481538
481718
|
"trim"
|
|
481539
481719
|
],
|
|
481540
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
481720
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
481541
481721
|
},
|
|
481542
481722
|
"deviceType": {
|
|
481543
481723
|
"type": "string",
|
|
@@ -481550,11 +481730,11 @@
|
|
|
481550
481730
|
"osVersion": {
|
|
481551
481731
|
"type": "string",
|
|
481552
481732
|
"minLength": 1,
|
|
481553
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
481733
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
481554
481734
|
},
|
|
481555
481735
|
"headless": {
|
|
481556
481736
|
"type": "boolean",
|
|
481557
|
-
"description": "Run the Android emulator without a window.
|
|
481737
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
481558
481738
|
},
|
|
481559
481739
|
"orientation": {
|
|
481560
481740
|
"type": "string",
|
|
@@ -481653,15 +481833,15 @@
|
|
|
481653
481833
|
"install": {
|
|
481654
481834
|
"type": "string",
|
|
481655
481835
|
"minLength": 1,
|
|
481656
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
481836
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
481657
481837
|
},
|
|
481658
481838
|
"activity": {
|
|
481659
481839
|
"type": "string",
|
|
481660
481840
|
"minLength": 1,
|
|
481661
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
481841
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
481662
481842
|
},
|
|
481663
481843
|
"device": {
|
|
481664
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
481844
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
481665
481845
|
"anyOf": [
|
|
481666
481846
|
{
|
|
481667
481847
|
"type": "string",
|
|
@@ -481694,7 +481874,7 @@
|
|
|
481694
481874
|
"transform": [
|
|
481695
481875
|
"trim"
|
|
481696
481876
|
],
|
|
481697
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
481877
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
481698
481878
|
},
|
|
481699
481879
|
"deviceType": {
|
|
481700
481880
|
"type": "string",
|
|
@@ -481707,11 +481887,11 @@
|
|
|
481707
481887
|
"osVersion": {
|
|
481708
481888
|
"type": "string",
|
|
481709
481889
|
"minLength": 1,
|
|
481710
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
481890
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
481711
481891
|
},
|
|
481712
481892
|
"headless": {
|
|
481713
481893
|
"type": "boolean",
|
|
481714
|
-
"description": "Run the Android emulator without a window.
|
|
481894
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
481715
481895
|
},
|
|
481716
481896
|
"orientation": {
|
|
481717
481897
|
"type": "string",
|
|
@@ -487764,7 +487944,7 @@
|
|
|
487764
487944
|
]
|
|
487765
487945
|
},
|
|
487766
487946
|
"browsers": {
|
|
487767
|
-
"description": "Browsers to run tests on.",
|
|
487947
|
+
"description": "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
|
|
487768
487948
|
"anyOf": [
|
|
487769
487949
|
{
|
|
487770
487950
|
"type": "string",
|
|
@@ -487775,7 +487955,7 @@
|
|
|
487775
487955
|
"safari",
|
|
487776
487956
|
"webkit"
|
|
487777
487957
|
],
|
|
487778
|
-
"$comment": "`safari` is
|
|
487958
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
487779
487959
|
},
|
|
487780
487960
|
{
|
|
487781
487961
|
"type": "object",
|
|
@@ -487794,7 +487974,7 @@
|
|
|
487794
487974
|
"safari",
|
|
487795
487975
|
"webkit"
|
|
487796
487976
|
],
|
|
487797
|
-
"$comment": "`safari` is
|
|
487977
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
487798
487978
|
},
|
|
487799
487979
|
"explicit": {
|
|
487800
487980
|
"type": "boolean",
|
|
@@ -487854,7 +488034,7 @@
|
|
|
487854
488034
|
"safari",
|
|
487855
488035
|
"webkit"
|
|
487856
488036
|
],
|
|
487857
|
-
"$comment": "`safari` is
|
|
488037
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
487858
488038
|
},
|
|
487859
488039
|
{
|
|
487860
488040
|
"type": "object",
|
|
@@ -487873,7 +488053,7 @@
|
|
|
487873
488053
|
"safari",
|
|
487874
488054
|
"webkit"
|
|
487875
488055
|
],
|
|
487876
|
-
"$comment": "`safari` is
|
|
488056
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
487877
488057
|
},
|
|
487878
488058
|
"explicit": {
|
|
487879
488059
|
"type": "boolean",
|
|
@@ -488049,7 +488229,7 @@
|
|
|
488049
488229
|
]
|
|
488050
488230
|
},
|
|
488051
488231
|
"device": {
|
|
488052
|
-
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android`). Same shape as `startSurface.device`.",
|
|
488232
|
+
"description": "Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.",
|
|
488053
488233
|
"examples": [
|
|
488054
488234
|
"pixel7",
|
|
488055
488235
|
{
|
|
@@ -488088,7 +488268,7 @@
|
|
|
488088
488268
|
"transform": [
|
|
488089
488269
|
"trim"
|
|
488090
488270
|
],
|
|
488091
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
488271
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
488092
488272
|
},
|
|
488093
488273
|
"deviceType": {
|
|
488094
488274
|
"type": "string",
|
|
@@ -488101,11 +488281,11 @@
|
|
|
488101
488281
|
"osVersion": {
|
|
488102
488282
|
"type": "string",
|
|
488103
488283
|
"minLength": 1,
|
|
488104
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
488284
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
488105
488285
|
},
|
|
488106
488286
|
"headless": {
|
|
488107
488287
|
"type": "boolean",
|
|
488108
|
-
"description": "Run the Android emulator without a window.
|
|
488288
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
488109
488289
|
},
|
|
488110
488290
|
"orientation": {
|
|
488111
488291
|
"type": "string",
|
|
@@ -488159,7 +488339,7 @@
|
|
|
488159
488339
|
"safari",
|
|
488160
488340
|
"webkit"
|
|
488161
488341
|
],
|
|
488162
|
-
"$comment": "`safari` is
|
|
488342
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
488163
488343
|
},
|
|
488164
488344
|
"browser": {
|
|
488165
488345
|
"type": "object",
|
|
@@ -488178,7 +488358,7 @@
|
|
|
488178
488358
|
"safari",
|
|
488179
488359
|
"webkit"
|
|
488180
488360
|
],
|
|
488181
|
-
"$comment": "`safari` is
|
|
488361
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
488182
488362
|
},
|
|
488183
488363
|
"explicit": {
|
|
488184
488364
|
"type": "boolean",
|
|
@@ -488318,6 +488498,26 @@
|
|
|
488318
488498
|
}
|
|
488319
488499
|
}
|
|
488320
488500
|
]
|
|
488501
|
+
},
|
|
488502
|
+
{
|
|
488503
|
+
"platforms": "android"
|
|
488504
|
+
},
|
|
488505
|
+
{
|
|
488506
|
+
"platforms": [
|
|
488507
|
+
"windows",
|
|
488508
|
+
"mac",
|
|
488509
|
+
"android",
|
|
488510
|
+
"ios"
|
|
488511
|
+
],
|
|
488512
|
+
"browsers": "chrome"
|
|
488513
|
+
},
|
|
488514
|
+
{
|
|
488515
|
+
"platforms": "ios",
|
|
488516
|
+
"browsers": "safari",
|
|
488517
|
+
"device": {
|
|
488518
|
+
"name": "test-iphone",
|
|
488519
|
+
"deviceType": "phone"
|
|
488520
|
+
}
|
|
488321
488521
|
}
|
|
488322
488522
|
]
|
|
488323
488523
|
}
|
|
@@ -524694,7 +524894,7 @@
|
|
|
524694
524894
|
"startSurface": {
|
|
524695
524895
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
524696
524896
|
"title": "startSurface",
|
|
524697
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
524897
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
524698
524898
|
"components": {
|
|
524699
524899
|
"schemas": {
|
|
524700
524900
|
"appDescriptor": {
|
|
@@ -524746,15 +524946,15 @@
|
|
|
524746
524946
|
"install": {
|
|
524747
524947
|
"type": "string",
|
|
524748
524948
|
"minLength": 1,
|
|
524749
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
524949
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
524750
524950
|
},
|
|
524751
524951
|
"activity": {
|
|
524752
524952
|
"type": "string",
|
|
524753
524953
|
"minLength": 1,
|
|
524754
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
524954
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
524755
524955
|
},
|
|
524756
524956
|
"device": {
|
|
524757
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
524957
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
524758
524958
|
"anyOf": [
|
|
524759
524959
|
{
|
|
524760
524960
|
"type": "string",
|
|
@@ -524787,7 +524987,7 @@
|
|
|
524787
524987
|
"transform": [
|
|
524788
524988
|
"trim"
|
|
524789
524989
|
],
|
|
524790
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
524990
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
524791
524991
|
},
|
|
524792
524992
|
"deviceType": {
|
|
524793
524993
|
"type": "string",
|
|
@@ -524800,11 +525000,11 @@
|
|
|
524800
525000
|
"osVersion": {
|
|
524801
525001
|
"type": "string",
|
|
524802
525002
|
"minLength": 1,
|
|
524803
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
525003
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
524804
525004
|
},
|
|
524805
525005
|
"headless": {
|
|
524806
525006
|
"type": "boolean",
|
|
524807
|
-
"description": "Run the Android emulator without a window.
|
|
525007
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
524808
525008
|
},
|
|
524809
525009
|
"orientation": {
|
|
524810
525010
|
"type": "string",
|
|
@@ -524976,7 +525176,7 @@
|
|
|
524976
525176
|
"transform": [
|
|
524977
525177
|
"trim"
|
|
524978
525178
|
],
|
|
524979
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
525179
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
524980
525180
|
},
|
|
524981
525181
|
"deviceType": {
|
|
524982
525182
|
"type": "string",
|
|
@@ -524989,11 +525189,11 @@
|
|
|
524989
525189
|
"osVersion": {
|
|
524990
525190
|
"type": "string",
|
|
524991
525191
|
"minLength": 1,
|
|
524992
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
525192
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
524993
525193
|
},
|
|
524994
525194
|
"headless": {
|
|
524995
525195
|
"type": "boolean",
|
|
524996
|
-
"description": "Run the Android emulator without a window.
|
|
525196
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
524997
525197
|
},
|
|
524998
525198
|
"orientation": {
|
|
524999
525199
|
"type": "string",
|
|
@@ -525092,15 +525292,15 @@
|
|
|
525092
525292
|
"install": {
|
|
525093
525293
|
"type": "string",
|
|
525094
525294
|
"minLength": 1,
|
|
525095
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
525295
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
525096
525296
|
},
|
|
525097
525297
|
"activity": {
|
|
525098
525298
|
"type": "string",
|
|
525099
525299
|
"minLength": 1,
|
|
525100
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
525300
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
525101
525301
|
},
|
|
525102
525302
|
"device": {
|
|
525103
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
525303
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
525104
525304
|
"anyOf": [
|
|
525105
525305
|
{
|
|
525106
525306
|
"type": "string",
|
|
@@ -525133,7 +525333,7 @@
|
|
|
525133
525333
|
"transform": [
|
|
525134
525334
|
"trim"
|
|
525135
525335
|
],
|
|
525136
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
525336
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
525137
525337
|
},
|
|
525138
525338
|
"deviceType": {
|
|
525139
525339
|
"type": "string",
|
|
@@ -525146,11 +525346,11 @@
|
|
|
525146
525346
|
"osVersion": {
|
|
525147
525347
|
"type": "string",
|
|
525148
525348
|
"minLength": 1,
|
|
525149
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
525349
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
525150
525350
|
},
|
|
525151
525351
|
"headless": {
|
|
525152
525352
|
"type": "boolean",
|
|
525153
|
-
"description": "Run the Android emulator without a window.
|
|
525353
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
525154
525354
|
},
|
|
525155
525355
|
"orientation": {
|
|
525156
525356
|
"type": "string",
|
|
@@ -530479,7 +530679,7 @@
|
|
|
530479
530679
|
"safari",
|
|
530480
530680
|
"webkit"
|
|
530481
530681
|
],
|
|
530482
|
-
"$comment": "`safari` is
|
|
530682
|
+
"$comment": "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
|
|
530483
530683
|
},
|
|
530484
530684
|
"explicit": {
|
|
530485
530685
|
"type": "boolean",
|
|
@@ -566184,7 +566384,7 @@
|
|
|
566184
566384
|
"startSurface": {
|
|
566185
566385
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
566186
566386
|
"title": "startSurface",
|
|
566187
|
-
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator
|
|
566387
|
+
"description": "Open (provision) a surface and register it by name so later steps can target it with `surface`. Phases A1–A2 ship the desktop native app branch: launch a Windows or macOS application by executable path, `.app` path, bundle ID, or UWP AppUserModelID. macOS additionally requires the Accessibility permission for the process that runs Doc Detective (System Settings → Privacy & Security → Accessibility); without it the context lands as SKIPPED with a walkthrough. Phase A3 adds Android apps on a managed emulator, and phase A4 adds iOS app surfaces on macOS via XCUITest/simctl. Browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.",
|
|
566188
566388
|
"components": {
|
|
566189
566389
|
"schemas": {
|
|
566190
566390
|
"appDescriptor": {
|
|
@@ -566236,15 +566436,15 @@
|
|
|
566236
566436
|
"install": {
|
|
566237
566437
|
"type": "string",
|
|
566238
566438
|
"minLength": 1,
|
|
566239
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
566439
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
566240
566440
|
},
|
|
566241
566441
|
"activity": {
|
|
566242
566442
|
"type": "string",
|
|
566243
566443
|
"minLength": 1,
|
|
566244
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
566444
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
566245
566445
|
},
|
|
566246
566446
|
"device": {
|
|
566247
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
566447
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
566248
566448
|
"anyOf": [
|
|
566249
566449
|
{
|
|
566250
566450
|
"type": "string",
|
|
@@ -566277,7 +566477,7 @@
|
|
|
566277
566477
|
"transform": [
|
|
566278
566478
|
"trim"
|
|
566279
566479
|
],
|
|
566280
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
566480
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
566281
566481
|
},
|
|
566282
566482
|
"deviceType": {
|
|
566283
566483
|
"type": "string",
|
|
@@ -566290,11 +566490,11 @@
|
|
|
566290
566490
|
"osVersion": {
|
|
566291
566491
|
"type": "string",
|
|
566292
566492
|
"minLength": 1,
|
|
566293
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
566493
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
566294
566494
|
},
|
|
566295
566495
|
"headless": {
|
|
566296
566496
|
"type": "boolean",
|
|
566297
|
-
"description": "Run the Android emulator without a window.
|
|
566497
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
566298
566498
|
},
|
|
566299
566499
|
"orientation": {
|
|
566300
566500
|
"type": "string",
|
|
@@ -566466,7 +566666,7 @@
|
|
|
566466
566666
|
"transform": [
|
|
566467
566667
|
"trim"
|
|
566468
566668
|
],
|
|
566469
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
566669
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
566470
566670
|
},
|
|
566471
566671
|
"deviceType": {
|
|
566472
566672
|
"type": "string",
|
|
@@ -566479,11 +566679,11 @@
|
|
|
566479
566679
|
"osVersion": {
|
|
566480
566680
|
"type": "string",
|
|
566481
566681
|
"minLength": 1,
|
|
566482
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
566682
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
566483
566683
|
},
|
|
566484
566684
|
"headless": {
|
|
566485
566685
|
"type": "boolean",
|
|
566486
|
-
"description": "Run the Android emulator without a window.
|
|
566686
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
566487
566687
|
},
|
|
566488
566688
|
"orientation": {
|
|
566489
566689
|
"type": "string",
|
|
@@ -566582,15 +566782,15 @@
|
|
|
566582
566782
|
"install": {
|
|
566583
566783
|
"type": "string",
|
|
566584
566784
|
"minLength": 1,
|
|
566585
|
-
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch.
|
|
566785
|
+
"description": "Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Supported on Android and iOS app surfaces."
|
|
566586
566786
|
},
|
|
566587
566787
|
"activity": {
|
|
566588
566788
|
"type": "string",
|
|
566589
566789
|
"minLength": 1,
|
|
566590
|
-
"description": "Android main activity override (defaults to the package's launcher activity).
|
|
566790
|
+
"description": "Android main activity override (defaults to the package's launcher activity). Android-only."
|
|
566591
566791
|
},
|
|
566592
566792
|
"device": {
|
|
566593
|
-
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it.
|
|
566793
|
+
"description": "Device the app runs on. Omit for a host desktop app, or (in a mobile context) to use the context's default device. A string references a device by name; an object refines it. Supported on Android and iOS mobile targets.",
|
|
566594
566794
|
"anyOf": [
|
|
566595
566795
|
{
|
|
566596
566796
|
"type": "string",
|
|
@@ -566623,7 +566823,7 @@
|
|
|
566623
566823
|
"transform": [
|
|
566624
566824
|
"trim"
|
|
566625
566825
|
],
|
|
566626
|
-
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain
|
|
566826
|
+
"description": "Device name and registry identity — the same name resolves to the same device. Reference form: names an existing AVD (Android) / simulator (iOS) to reuse. If no device by this name exists, Doc Detective creates one under this name using `deviceType`/`osVersion` (or their defaults), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`)."
|
|
566627
566827
|
},
|
|
566628
566828
|
"deviceType": {
|
|
566629
566829
|
"type": "string",
|
|
@@ -566636,11 +566836,11 @@
|
|
|
566636
566836
|
"osVersion": {
|
|
566637
566837
|
"type": "string",
|
|
566638
566838
|
"minLength": 1,
|
|
566639
|
-
"description": "Platform version used when creating a device; must match an installed
|
|
566839
|
+
"description": "Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version."
|
|
566640
566840
|
},
|
|
566641
566841
|
"headless": {
|
|
566642
566842
|
"type": "boolean",
|
|
566643
|
-
"description": "Run the Android emulator without a window.
|
|
566843
|
+
"description": "Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable."
|
|
566644
566844
|
},
|
|
566645
566845
|
"orientation": {
|
|
566646
566846
|
"type": "string",
|