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
* Update the Xcode release & deprecation policy
Update the Xcode release & deprecation policy with the new deprecation policy and ensure the rest of the document is consistent with current practices.
* Clarify Xcode image retention policy
* Modernize macOS version number
Make the documentation's examples more relevant to modern times by updating the version number used in examples.
Copy file name to clipboardExpand all lines: docs/guides/modules/execution-managed/pages/xcode-policy.adoc
+17-17Lines changed: 17 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ You will find the most up to date information on these images on the link:https:
13
13
[#xcode-image-retention-and-deprecation]
14
14
== Xcode image retention and deprecation
15
15
16
-
We aim to retain four major versions of Xcode, with more recent versions having a larger number of minor versions to choose from.
16
+
We support the three latest Xcode versions released. In addition, we will always support the latest minor release of the last four major Xcode versions.
17
17
18
18
For example, with Xcode 16 being the latest major version being released:
19
19
@@ -22,50 +22,50 @@ For example, with Xcode 16 being the latest major version being released:
22
22
| Xcode Version | Action
23
23
24
24
| Xcode 16
25
-
| We will retain all `major.minor` versions at the latest patch version
25
+
| We will retain the three latest major.minor versions at the latest patch version
26
26
27
27
| Xcode 15
28
-
| We will retain the 4 latest `major.minor` versions at the latest patch version
28
+
| We will retain the last major.minor version
29
29
30
30
| Xcode 14
31
-
| We retain a single image which will be the last stable release of Xcode 14
31
+
| We will retain the last major.minor version
32
32
33
33
| Xcode 13
34
-
| We retain a single image which will be the last stable release of Xcode 13
34
+
| We will retain the last major.minor version
35
35
|===
36
36
37
-
Future example, when Xcode 26 enters Beta:
37
+
Future example, when Xcode 26 is released:
38
38
39
39
[cols=2*, options="header"]
40
40
|===
41
41
| Xcode Version | Action
42
42
43
43
| Xcode 26
44
-
| Beta image will be released and updated as per the beta image policy
44
+
| We will support Xcode 26.0
45
45
46
46
| Xcode 16
47
-
| The latest 4 `major.minor` versions will be retained at the latest patch version, older images will be flagged for deprecation and removed when Xcode 26 reaches RC
47
+
| No change. We will continue to support the latest 3 `major.minor` versions. Older images will be flagged for deprecation and removed as Xcode 26.1 and on is released.
48
48
49
49
| Xcode 15
50
-
| All images except for the final release will be flagged for deprecation and removed when Xcode 26 reaches RC
50
+
| No change. The latest minor version release will continue to be supported.
51
51
52
52
| Xcode 14
53
-
| All images except for the final release will be flagged for deprecation and removed when Xcode 26 reaches RC
53
+
| No change. The latest minor version release will continue to be supported.
54
54
55
55
| Xcode 13
56
-
| Flagged for deprecation, removed entirely when Xcode 26 reaches RC
56
+
| Flagged for deprecation, removed entirely when Xcode 26 reaches GA
57
57
|===
58
58
59
59
Betas of new major versions of Xcode are shipped by Apple during WWDC, which usually occurs in early-mid June each year.
60
60
61
-
When an image is selected for deprecation and removal, we will create an announcement on our link:https://discuss.circleci.com/c/announcements/39[Discuss forum], along with additional outreach where possible. We will always aim to provide four weeks' notice where possible.
61
+
When an image is selected for deprecation and removal, we will create an announcement on our link:https://circleci.com/changelog/[changelog], along with additional outreach where possible. We will always aim to provide four weeks' notice where possible.
62
62
63
-
We will never automatically redirect requests for images to different `major.minor` versions, so when one of these images is removed, jobs will start to fail if the `.circleci/config.yml` has not been updated.
63
+
We will never automatically redirect requests for specific Xcode images to a different major or minor version. When an image is removed, jobs using that image will fail if the `.circleci/config.yml` has not been updated.
64
64
65
65
[#xcode-patches]
66
66
== Xcode patches
67
67
68
-
We retain the latest patch version of each Xcode `major.minor` version we support. Once a new patch version has been released, we will deprecate the previous patch version and automatically redirect all requests to the new patch version.
68
+
We retain the latest patch version of each Xcode `major.minor` version we support. Once a new patch version has been released, we will deprecate the previous patch version and automatically redirect all requests to the new patch of the same `major.minor`version.
69
69
70
70
As patches are generally backwards compatible, redirects will be put in place within 24 hours of a new patch release. If any major issues are discovered, we retain the ability to issue a rollback and make both versions temporarily available.
71
71
@@ -87,16 +87,16 @@ To read about our customer support policy regarding beta images, check out this
87
87
88
88
We closely track and monitor Apple's Xcode releases and always aim to release new images as quickly as possible. Typically we aim to support a new Xcode image within a couple of days, however note that this is not an SLA. We can not, and do not, provide an official SLA turnaround time for new Xcode images.
89
89
90
-
New images are always announced on our link:https://discuss.circleci.com/c/announcements/39[Discuss site] along with release notes, and will be added to the table of xref:using-macos.adoc#supported-xcode-versions[Xcode versions in the documentation].
90
+
New images are always announced on our link:https://circleci.com/changelog/[changelog] along with release notes, and will be added to the table of xref:using-macos.adoc#supported-xcode-versions[Xcode versions in the documentation].
91
91
92
92
[#macos-versions]
93
93
== macOS versions
94
94
95
95
Each Xcode image is built on top of a clean macOS install. We aim to keep the macOS version reasonably up to date with the latest version available. Generally our images can be up to 2 minor/patch versions behind the latest stable version.
96
96
97
-
We aim to keep the macOS version aligned across our different macOS executors (for example, Intel and M1 platforms), however this may not always be the case. Check the xref:test:testing-ios.adoc#supported-xcode-versions[Software Manifest] file for the image for the most accurate information.
97
+
We aim to keep the macOS version aligned across our different macOS executors, however this may not always be the case. Check the xref:test:testing-ios.adoc#supported-xcode-versions[Software Manifest] file for the image for the most accurate information.
98
98
99
-
When a new major version of macOS (ex: `12.0`) is released, we will start to use this version after a minimum of two minor Xcode releases have passed. This will allow for any major bugs and issues to be resolved. Release timing for this is entirely dependent on Apple's own release cycle, but will always be announced on our link:https://discuss.circleci.com/c/announcements/39[Discuss forum].
99
+
When a new major version of macOS (ex: `26.0`) is released, we will start to use this version after a minimum of two minor Xcode releases have passed.
0 commit comments