Skip to content

Commit c760e13

Browse files
[EXEC-5670] Update Xcode release & deprecation policy (#9529)
* 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.
1 parent 302fbbd commit c760e13

File tree

1 file changed

+17
-17
lines changed

1 file changed

+17
-17
lines changed

docs/guides/modules/execution-managed/pages/xcode-policy.adoc

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ You will find the most up to date information on these images on the link:https:
1313
[#xcode-image-retention-and-deprecation]
1414
== Xcode image retention and deprecation
1515

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.
1717

1818
For example, with Xcode 16 being the latest major version being released:
1919

@@ -22,50 +22,50 @@ For example, with Xcode 16 being the latest major version being released:
2222
| Xcode Version | Action
2323

2424
| 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
2626

2727
| 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
2929

3030
| 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
3232

3333
| 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
3535
|===
3636

37-
Future example, when Xcode 26 enters Beta:
37+
Future example, when Xcode 26 is released:
3838

3939
[cols=2*, options="header"]
4040
|===
4141
| Xcode Version | Action
4242

4343
| Xcode 26
44-
| Beta image will be released and updated as per the beta image policy
44+
| We will support Xcode 26.0
4545

4646
| 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.
4848

4949
| 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.
5151

5252
| 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.
5454

5555
| Xcode 13
56-
| Flagged for deprecation, removed entirely when Xcode 26 reaches RC
56+
| Flagged for deprecation, removed entirely when Xcode 26 reaches GA
5757
|===
5858

5959
Betas of new major versions of Xcode are shipped by Apple during WWDC, which usually occurs in early-mid June each year.
6060

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.
6262

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.
6464

6565
[#xcode-patches]
6666
== Xcode patches
6767

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.
6969

7070
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.
7171

@@ -87,16 +87,16 @@ To read about our customer support policy regarding beta images, check out this
8787

8888
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.
8989

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].
9191

9292
[#macos-versions]
9393
== macOS versions
9494

9595
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.
9696

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.
9898

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.
100100

101101
[#exceptions]
102102
== Exceptions

0 commit comments

Comments
 (0)