Skip to main content

Stack deprecation and removal policy

Abstract

On Bitrise, Android stacks are supported for around two years; Xcode stacks are deprecated gradually as new Xcode versions are released.

We don't keep all stacks around forever: our aim is to provide you with the latest tools to help you build the best app you can. However, we don't expect you to rework your build configuration every time a stack update comes out: you can keep using your reliable older stacks for a long time.

Some older stacks are frozen when a new major version of Xcode is released. When a stack is frozen, you can still keep using it, but the stack will no longer get any updates, and at that point, we strongly recommend switching to a newer, active stack.

After stacks have been frozen for a year, they are removed when the next major version of Xcode is released.

Maintaining macOS stacks

We offer a wide variety of macOS stacks in order to make sure you do not need to immediately switch when a new version comes out. Our policy is as follows:

  • Keep the three most recent major versions of Xcode.

  • Keep the two most recent minor versions for each major version of Xcode.

Example 1. Maintaining macOS stacks

When Xcode version 15.2.x is released, we will keep:

All the latest patch releases for the two most recent minor versions of Xcode 15:

  • 15.2.x

  • 15.1.x

Xcode 15.0.x will be removed.

The two latest versions from the previous two Xcode major versions:

  • Xcode 14.3.x

  • Xcode 14.2.x

  • Xcode 13.4.x (frozen)

  • Xcode 13.3.x (frozen)


Freezing and removing macOS stacks

When the first beta of the next major Xcode version is released, we freeze the minor versions of the penultimate major version. The last frozen major version of Xcode is then removed. For example, we will be removing our Xcode 13 stacks when Xcode 16.0 beta is released. We base our policy on Apple's current release cadence (first beta in June, general availability in September).

  • The life cycle of a major Xcode version on our stacks is 36 months.

  • For 24 months, the stack is active and maintained according to our stack update policy.

  • After 24 months, the stack becomes frozen for 12 months and it will no longer receive updates. At this point, we strongly recommend migrating to an active stack.

  • After the end of the 36th month, the major Xcode version is removed.

Deprecating Android & Docker stacks

An Android & Docker,on Ubuntu stack is supported for about two years, roughly in sync with Ubuntu LTS (long term support) releases.

When a previous Android & Docker,on Ubuntu stack reaches end of maintenance, we deprecate the stack and earmark it for removal. At that point you can no longer select the stack for your apps. But the apps that are already using those stacks can keep using them until removal. We will warn you of scheduled removals well in advance so you can plan for them.