Change Log

All notable changes to this project will be documented in this file. Aside from features marked [🔥 Experimental 🔥], Alamofire adheres to Semantic Versioning. [🔥 Experimental 🔥] features may require breaking changes in minor, rather than major, releases. This will be rare and compatibility should be preserved in most cases, but cannot be guaranteed.

5.x Releases

4.x Releases

3.x Releases

2.x Releases

1.x Releases


5.7.1

Released on 2023-05-10. All issues associated with this milestone can be found using this filter.

Updated

5.7.0

Released on 2023-05-09. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


5.6.4

Released on 2022-11-21. All issues associated with this milestone can be found using this filter.

Fixed

5.6.3

Released on 2022-11-20. All issues associated with this milestone can be found using this filter.

Updated

Fixed

5.6.2

Released on 2022-07-17. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

5.6.1

Released on 2022-04-17. All issues associated with this milestone can be found using this filter.

Fixed

5.6.0

Released on 2022-04-13. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


5.5.0

Released on 2021-12-13. All issues associated with this milestone can be found using this filter.

Added

Updated

Deprecated

Fixed


5.4.4

Released on 2021-09-20. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

5.4.3

Released on 2021-04-21. All issues associated with this milestone can be found using this filter.

Fixed

5.4.2

Released on 2021-04-03. All issues associated with this milestone can be found using this filter.

Updated

Fixed

5.4.1

Released on 2020-12-20. All issues associated with this milestone can be found using this filter.

Updated

5.4.0

Released on 2020-10-17. All issues associated with this milestone can be found using this filter.

Added

Updated


5.3.0

Released on 2020-10-17. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


5.2.2

Released on 2020-07-17. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

5.2.1

Released on 2020-05-25. All issues associated with this milestone can be found using this filter.

Updated

Fixed

5.2.0

Released on 2020-05-16. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


5.1.0

Released on 2020-04-04. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


5.0.5

Released on 2020-03-23. All issues associated with this milestone can be found using this filter.

Fixed

5.0.4

Released on 2020-03-15. All issues associated with this milestone can be found using this filter.

Fixed

5.0.3

Released on 2020-03-14. All issues associated with this milestone can be found using this filter.

Added

Fixed

5.0.2

Released on 2020-02-23. All issues associated with this milestone can be found using this filter.

Fixed

5.0.1

Released on 2020-02-23. All issues associated with this milestone can be found using this filter.

Updated

5.0.0

Released on 2020-02-14. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


5.0.0-rc.3

Released on 2019-10-26. All issues associated with this milestone can be found using this filter. Note: Alamofire 5 is now API stable.

Updated

Fixed

5.0.0-rc.2

Released on 2019-09-08. All issues associated with this milestone can be found using this filter. Note: Alamofire 5 is now API stable.

Fixed

5.0.0-rc.1

Released on 2019-09-04. All issues associated with this milestone can be found using this filter. Note: Alamofire 5 is now API stable.

Added

Updated

Fixed

5.0.0-beta.7

Released on 2019-07-29. All issues associated with this milestone can be found using this filter. Note: Alamofire will not be following semantic versioning during the beta process. There may be breaking changes until 5.0.0 is released.

Added

Updated

Fixed

5.0.0-beta.6

Released on 2019-04-23. All issues associated with this milestone can be found using this filter. Note: Alamofire will not be following semantic versioning during the beta process. There may be breaking changes until 5.0.0 is released.

Updated

Fixed

5.0.0-beta.5

Released on 2019-04-12. All issues associated with this milestone can be found using this filter. Note: Alamofire will not be following semantic versioning during the beta process. There may be breaking changes until 5.0.0 is released.

Added

Updated

Fixed

5.0.0-beta.4

Released on 2019-03-29. All issues associated with this milestone can be found using this filter. Note: Alamofire will not be following semantic versioning during the beta process. There may be breaking changes until 5.0.0 is released.

Added

Updated

Fixed

5.0.0-beta.3

Released on 2019-01-07. All issues associated with this milestone can be found using this filter. Note: Alamofire will not be following semantic versioning during the beta process. There may be breaking changes until 5.0.0 is released.

Added

Updated

Fixed

5.0.0-beta.2

Released on 2019-01-07. All issues associated with this milestone can be found using this filter. Note: Alamofire will not be following semantic versioning during the beta process. There may be breaking changes until 5.0.0 is released.

Added

Updated

5.0.0-beta.1

Released on 2018-12-06. All issues associated with this milestone can be found using this filter. Note: Alamofire will not be following semantic versioning during the beta process. There may be breaking changes until 5.0.0 is released.

Added

Updated

Removed


4.9.1

Released on 2019-10-26. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

4.9.0

Released on 2019-09-03. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

4.8.2

Released on 2019-03-27. All issues associated with this milestone can be found using this filter.

Updated

Fixed

4.8.1

Released on 2019-01-15. All issues associated with this milestone can be found using this filter.

Fixed

4.8.0

Released on 2018-11-24. All issues associated with this milestone can be found using this filter.

Added

Updated


4.7.3

Released on 2018-7-8. All issues associated with this milestone can be found using this filter.

Updated

4.7.2

Released on 2018-4-15. All issues associated with this milestone can be found using this filter.

Fixed

4.7.1

Released on 2018-3-31. All issues associated with this milestone can be found using this filter.

Updated

Fixed

4.7.0

Released on 2018-3-5. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


4.6.0

Released on 2017-12-3. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


4.5.1

Released on 2017-09-06. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

4.5.0

Released on 2017-06-16. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

Fixed


4.4.0

Released on 2017-02-26. All issues associated with this milestone can be found using this filter.

Added

Fixed


4.3.0

Released on 2017-01-15. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


4.2.0

Released on 2016-11-20. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


4.1.0

Released on 2016-11-15. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

Fixed


4.0.1

Released on 2016-09-24. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

4.0.0

Released on 2016-09-11. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

Fixed


4.0.0-beta.2

Released on 2016-08-29. All issues associated with this milestone can be found using this filter.

Fixed

4.0.0-beta.1

Released on 2016-08-28. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

Upgrade Notes

This release requires Xcode 8.0 beta 6+ because it has been completely refactored to compile against Swift 3.0. Any older versions of Xcode will NOT COMPILE.

This release is the start of the Alamofire 4.0.0 beta releases. We still have quite a few large changes we're trying to squeeze in before the Xcode 8 GM drops, so the APIs will continue to change over the next few weeks. Please keep in mind that each beta will likely bring new APIs and also refactor others. The betas WILL NOT follow semantic versioning. We'll most likely conform to semantic versioning once we start releasing the RCs unless we run into a major unforeseen issue.

We'd really appreciate everyone trying out the betas and letting us know if you find issues. We want to address every possible issue prior to the official Alamofire 4.0.0 release.


3.5.1

Released on 2016-10-01. All issues associated with this milestone can be found using this filter.

Fixed

3.5.0

Released on 2016-09-07. All issues associated with this milestone can be found using this filter.

Updated

Fixed


3.4.2

Released on 2016-08-28. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

Fixed

3.4.1

Released on 2016-06-12. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

Fixed

3.4.0

Released on 2016-05-08. All issues associated with this milestone can be found using this filter.

Added

Updated

Deprecated

Fixed


3.3.1

Released on 2016-04-06. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

3.3.0

Released on 2016-03-23. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

Upgrade Notes

This release requires Xcode 7.3+ otherwise the Swift 2.2 changes will NOT COMPILE. There are several reasons why this was deployed as a MINOR and not MAJOR release. First off, the public API changes of this release are fully backwards compatible. There are no breaking API changes in the public APIs. Strictly following semver dictates that this is a MINOR, not MAJOR release.

See semver for more info.

We also realize that this can be frustrating for those out there not ready to upgrade to Xcode 7.3. Please know that we consider each release version carefully before deploying. Our decision to bump the MINOR version was not only due to strictly following semver, but also because it's difficult and undesirable for all OSS libraries to bump MAJOR versions each time the Swift APIs are incremented. Alamofire would have had to go through 6 additional MAJOR versions if this was the policy. That would mean we'd already be running on Alamofire 10.x. Incrementing MAJOR versions this quickly is disruptive to the community and would cause even more confusion. Instead, we try to carefully plan our MAJOR version releases and accompany them with detailed Migration Guides to help make the transition as smooth as possible.

If anyone has additional questions, please feel free to open an issue and we'll be more than happy to discuss further.


3.2.1

Released on 2016-02-27. All issues associated with this milestone can be found using this filter.

Updated

Fixed

3.2.0

Released on 2016-02-07. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed


3.1.5

Released on 2016-01-17. All issues associated with this milestone can be found using this filter.

Added

Updated

3.1.4

Released on 2015-12-16. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

3.1.3

Released on 2015-11-22. All issues associated with this milestone can be found using this filter.

Added

Updated

3.1.2

Released on 2015-11-06. All issues associated with this milestone can be found using this filter.

Updated

3.1.1

Released on 2015-10-31. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

3.1.0

Released on 2015-10-22. All issues associated with this milestone can be found using this filter.

Added

Updated


3.0.1

Released on 2015-10-19. All issues associated with this milestone can be found using this filter.

Added

Fixed

3.0.0

Released on 2015-10-10. All issues associated with this milestone can be found using this filter.

Updated

Fixed


3.0.0-beta.3

Released on 2015-09-27. All issues associated with this milestone can be found using this filter.

Updated

3.0.0-beta.2

Released on 2015-09-26. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

3.0.0-beta.1

Released on 2015-09-21. All issues associated with this milestone can be found using this filter.

Added

Updated


2.0.2

Released on 2015-09-20. All issues associated with this milestone can be found using this filter.

Updated

Fixed

2.0.1

Released on 2015-09-16. All issues associated with this milestone can be found using this filter.

Updated

Fixed

2.0.0

Released on 2015-09-09. All issues associated with this milestone can be found using this filter.

Added


2.0.0-beta.4

Released on 2015-09-06. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

Fixed

2.0.0-beta.3

Released on 2015-08-25.

Removed

2.0.0-beta.2

Released on 2015-08-24. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

Fixed

2.0.0-beta.1

Released on 2015-08-10. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

Fixed


1.3.1

Released on 2015-08-10. All issues associated with this milestone can be found using this filter.

Fixed

1.3.0

Released on 2015-07-24. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

Fixed

Upgrade Notes

There are a couple changes in the 1.3.0 release that are not fully backwards compatible and need to be called out.


1.2.3

Released on 2015-06-12. All issues associated with this milestone can be found using this filter.

Added

Updated

Fixed

1.2.2

Released on 2015-05-13. All issues associated with this milestone can be found using this filter.

Added

Updated

Removed

Fixed

1.2.1

Released on 2015-04-21.

Added

Updated

1.2.0

Released on 2015-04-09.

Added

Updated

Removed

Fixed


1.1.5

Released on 2015-03-26.

Added

Updated

Fixed

1.1.4

Released on 2015-01-30.

Added

Updated

Removed

Fixed

1.1.3

Released on 2015-01-09.

Added

Updated

Fixed

1.1.2

Released on 2014-12-21.

Added

Updated

Fixed

1.1.1

Released on 2014-11-20.

Updated

Fixed

1.1.0

Released on 2014-10-20.

Updated


1.0.1

Released on 2014-10-20.

Added

Fixed

1.0.0

Released on 2014-09-25.

Added