You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit dcf736f
Browse filesBrowse the repository at this point in the historyBrowse files
* docs: remove iOS 17, iPhone 15, iPhone 16 Plus/Pro/Pro Max and iPad Pro 6th gen; the iOS default is iPhone 16 / iOS 26
* docs: keep iOS 17, iPhone 16 Pro and 16 Pro Max as deprecated until 9 November
A usage check found that iOS 17, iPhone 16 Pro and iPhone 16 Pro Max
each still carry 1% or more of 7-day usage, so under the support policy
they are not removed today. They are deprecated, with removal targeted
for 9 November 2026, subject to change based on usage. iPhone 15,
iPhone 16 Plus and iPad Pro (6th Generation) were removed on 2 November
2026, and the iOS default is still iPhone 16 / iOS 26 from today.
- Devices & OS Versions: the 17 row is back as 17.5 (deprecated), with
a note that it runs only on iPhone 14 and a deprecation hint; the
iPhone 16 Pro and 16 Pro Max rows are back as before, marked
deprecated, with their own hint; iPhone 14 offers 17 and 18 again.
The removal sentence names only the three devices that went.
- GitHub Actions and EAS Workflows: the option lists include
iphone-16-pro, iphone-16-pro-max and 17 again, marked deprecated like
pixel-7. The ios-version default stays 26.
Examples that the previous commit moved onto current devices stay
there, so none of them points at a deprecated device.
iPads use their full model name and the generic tablet its emulator profile, so the value isn't always your device flag. Print it once before you name your folders: add `- evalScript: ${console.log('DCD_DEVICE=' + DCD_DEVICE)}` to a flow and look for the `JsConsole` line in the run's Maestro log.
125
+
iPads use their full model name (`--ios-device ipad-pro-m5-13 --ios-version 26` is `ipad-pro-13-inch-m5-ios-26`) and the generic tablet its emulator profile, so the value isn't always your device flag. Print it once before you name your folders: add `- evalScript: ${console.log('DCD_DEVICE=' + DCD_DEVICE)}` to a flow and look for the `JsConsole` line in the run's Maestro log.
126
126
127
127
`DCD_PLATFORM` (`android` or `ios`) is available too. Passing either yourself with `--env` overrides the built-in value. See [Built-in Variables](../configuration/environment-variables.md#built-in-variables).
Copy file name to clipboardExpand all lines: configuration/environment-variables.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -66,7 +66,7 @@ DeviceCloud also sets these variables on every run, so a flow can adapt to the d
66
66
67
67
| Variable | Value |
68
68
| --- | --- |
69
-
|`DCD_DEVICE`| The device and OS version, lowercased and hyphenated — for example `pixel-8-api-34`, `pixel-8-api-34-play` on a Google Play device, `iphone-16-ios-18` or `ipad-pro-12-9-inch-6th-generation-ios-26`. |
69
+
|`DCD_DEVICE`| The device and OS version, lowercased and hyphenated — for example `pixel-8-api-34`, `pixel-8-api-34-play` on a Google Play device, `iphone-16-ios-18` or `iphone-17-ios-26`. |
70
70
|`DCD_PLATFORM`|`android` or `ios`. |
71
71
72
72
Passing your own value with `-e` overrides the built-in one. [Visual Testing](../advanced/visual-testing.md#per-device-baselines) uses `DCD_DEVICE` to pick a baseline per device.
Copy file name to clipboardExpand all lines: getting-started/devices-configuration.md
+33-36Lines changed: 33 additions & 36 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,11 +10,7 @@ If you don't specify a device or OS version, then you will be allocated the defa
10
10
11
11
**Android:** Pixel 10 (API level 36)
12
12
13
-
**iOS:** iPhone 14 (iOS 17) 
14
-
15
-
::: warning
16
-
On the 2nd November the default is moving to iPhone 16 on iOS 26.
17
-
:::
13
+
**iOS:** iPhone 16 (iOS 26)
18
14
19
15
### Android API Levels
20
16
@@ -73,58 +69,59 @@ Pixel 6 Pro, Pixel 7 Pro and Generic Tablet on API level 33 were removed on 26 O
73
69
74
70
### iOS Versions
75
71
76
-
DeviceCloud will default to iOS 17 unless you pass the `--ios-version` flag. Pair it with an `--ios-device` that runs that version (see [iOS Devices](devices-configuration.md#ios-devices)), as the default iPhone 14 only runs iOS 17 and 18:
72
+
DeviceCloud will default to iOS 26 unless you pass the `--ios-version` flag. The default iPhone 16 runs iOS 18, 26 and 27, so a run that sets only the version runs on iPhone 16. To run that version on another device, pass an `--ios-device` that runs it as well (see [iOS Devices](devices-configuration.md#ios-devices)):
The default version of iOS is changing to 26 on the 2nd November.
84
-
:::
85
-
86
-
| id | Version |
87
-
| ---- | ----------------- |
78
+
| id | Version |
79
+
| ---- | ----------------------------- |
88
80
|`27`| 27.0 (27.1 on the iPhone Duo) |
89
-
|`26`| 26.5 |
90
-
|`18`| 18.6 |
91
-
|`17`| 17.5 (deprecated) |
81
+
|`26`| 26.5 |
82
+
|`18`| 18.6 |
83
+
|`17`| 17.5 (deprecated) |
84
+
85
+
iOS 17 runs only on iPhone 14, so pass `--ios-device iphone-14` with `--ios-version 17`.
92
86
93
87
::: warning
94
-
iOS 17 is deprecated and we're targeting removal on the 2nd November. This date is subject to change based on usage.
88
+
iOS 17 is deprecated and we're targeting removal on the 9th November. This date is subject to change based on usage.
95
89
:::
96
90
97
91
### iOS Devices
98
92
99
-
DeviceCloud will default to iPhone 14 unless you pass the `--ios-device` flag. Pass `--ios-version` with it, choosing one of the versions in the device's row:
93
+
DeviceCloud will default to iPhone 16 unless you pass the `--ios-device` flag. Pass `--ios-version` with it, choosing one of the versions in the device's row:
|`ipad-pro-m5-13`| iPad Pro 13-inch (M5) | 2064 x 2752 | 26, 27 |
119
-
|`ipad-pro-m5-11`| iPad Pro 11-inch (M5) | 1668 x 2420 | 26, 27 |
120
-
|`ipad-pro-6th-gen`| iPad Pro (6th Generation) (deprecated) | 2048 x 2732 | 18, 26, 27 |
99
+
::: info
100
+
A run that sets only the device runs on iOS 26, so a device that doesn't offer iOS 26 needs `--ios-version` as well, for example `--ios-device iphone-14` with `--ios-version 17` or `18`, or `--ios-device iphone-18-pro --ios-version 27`. Without it, the run is rejected.
|`ipad-pro-m5-13`| iPad Pro 13-inch (M5) | 2064 x 2752 | 26, 27 |
115
+
|`ipad-pro-m5-11`| iPad Pro 11-inch (M5) | 1668 x 2420 | 26, 27 |
121
116
122
117
iPad and iPhone Duo runs are billed at the Advanced iOS rate, see [pricing](../billing/test-run-billing.md).
123
118
124
119
::: warning
125
-
iPhone 15, iPhone 16 Plus, iPhone 16 Pro, iPhone 16 Pro Max and iPad Pro (6th Generation) are deprecated and we're targeting removal on the 2nd November. This date is subject to change based on usage.
120
+
iPhone 16 Pro and iPhone 16 Pro Max are deprecated and we're targeting removal on the 9th November. This date is subject to change based on usage.
126
121
:::
127
122
123
+
iPhone 15, iPhone 16 Plus and iPad Pro (6th Generation) were removed on 2 November 2026.
124
+
128
125
#### Foldables
129
126
130
127
The iPhone Duo starts folded, on its cover screen, and the Pixel 10 Pro Fold starts unfolded. A flow can fold or unfold either part-way through a run, and tap or take screenshots on whichever screen is active. See [Foldable Devices](../configuration/foldable-devices.md).
@@ -168,7 +165,7 @@ We will always aim to support the latest versions of iOS and additionally contin
168
165
169
166
It may be possible in some cases to provide support for a beta version however this will be on a case-by-case basis; please contact our Support team if you would like to request this.
170
167
171
-
The default configuration will always be the latest even-numbered base iPhone we support running the previous version of iOS, i.e. iPhone 16 running iOS 26. Before we change the default, we will always provide a minimum of 30 days notice. The default becomes iPhone 16 / iOS 26 on 2 November 2026.
168
+
The default configuration will always be the latest even-numbered base iPhone we support running the previous version of iOS, i.e. iPhone 16 running iOS 26. Before we change the default, we will always provide a minimum of 30 days notice. The default has been iPhone 16 / iOS 26 since 2 November 2026.
0 commit comments