Change Log

All notable changes to this project will be documented in this file. Alamofire adheres to Semantic Versioning.

5.x Releases

5.4.x Releases - 5.4.0 | 5.4.1
5.3.x Releases - 5.3.0
5.2.x Releases - 5.2.0 | 5.2.1 | 5.2.2
5.1.x Releases - 5.1.0
5.0.x Releases - 5.0.0 | 5.0.1 | 5.0.2 | 5.0.3 | 5.0.4 | 5.0.5
5.0.0 Release Candidates - 5.0.0-rc.1 | 5.0.0-rc.2 | 5.0.0-rc.3
5.0.0 Betas - 5.0.0-beta.1 | 5.0.0-beta.2 | 5.0.0-beta.3 | 5.0.0-beta.4 | 5.0.0-beta.5 | 5.0.0-beta.6 | 5.0.0-beta.7

4.x Releases

4.9.x Releases - 4.9.0 | 4.9.1
4.8.x Releases - 4.8.0 | 4.8.1 | 4.8.2
4.7.x Releases - 4.7.0 | 4.7.1 | 4.7.2 | 4.7.3
4.6.x Releases - 4.6.0
4.5.x Releases - 4.5.0 | 4.5.1
4.4.x Releases - 4.4.0
4.3.x Releases - 4.3.0
4.2.x Releases - 4.2.0
4.1.x Releases - 4.1.0
4.0.x Releases - 4.0.0 | 4.0.1
4.0.0 Betas - 4.0.0-beta.1 | 4.0.0-beta.2

3.x Releases

3.5.x Releases - 3.5.0 | 3.5.1
3.4.x Releases - 3.4.0 | 3.4.1 | 3.4.2
3.3.x Releases - 3.3.0 | 3.3.1
3.2.x Releases - 3.2.0 | 3.2.1
3.1.x Releases - 3.1.0 | 3.1.1 | 3.1.2 | 3.1.3 | 3.1.4 | 3.1.5
3.0.x Releases - 3.0.0 | 3.0.1
3.0.0 Betas - 3.0.0-beta.1 | 3.0.0-beta.2 | 3.0.0-beta.3

2.x Releases

2.0.x Releases - 2.0.0 | 2.0.1 | 2.0.2
2.0.0 Betas - 2.0.0-beta.1 | 2.0.0-beta.2 | 2.0.0-beta.3 | 2.0.0-beta.4

1.x Releases

1.3.x Releases - 1.3.0 | 1.3.1
1.2.x Releases - 1.2.0 | 1.2.1 | 1.2.2 | 1.2.3
1.1.x Releases - 1.1.0 | 1.1.1 | 1.1.2 | 1.1.3 | 1.1.4 | 1.1.5
1.0.x Releases - 1.0.0 | 1.0.1

5.4.1

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

Updated

Project and CocoaPods installation of Obj-C header.
- Updated by Jon Shier in Pull Request #3378.

5.4.0

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

Added

URLResponseSerializer and attendant convenience methods so downloads can produce a non-optional URL.
- Added byJon Shier in Pull Request #3343.

Updated

Handing of file:// URLs, removing error added in 5.3.0 and adding support for DownloadRequest.
- Updated by Jon Shier in Pull Request #3342.

5.3.0

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

Added

Closure callback APIs for the production of URLRequests and URLSessionTasks.
- Added by Jon Shier in Pull Request #3219.
URLSessionTaskMetrics gathering on watchOS 7+.
- Added by Jon Shier in Pull Request #3321.

Updated

Project settings, GitHub Actions, tests, and formatting for newer Xcodes.
- Updated by Jon Shier in Pull Requests #3278, #3284, #3285, #3309, and #3320.
Use of URLRequest.headers extension property in URLEncoding.
- Updated by tomisacat in Pull Request #3264.
iOS example app.
- Updated by rain2540 in Pull Request #3268.
Various documentation.
- Updated by Jaydeep Vora, Minhyuk Kim, and Tieda in Pull Requests #3274, #3292, and #3317.

Fixed

Double lock crash in AuthenticationInterceptor caused by synchronous refresh implementations.
- Fixed by Jon Shier in Pull Request #3322.
Crash when requesting file:// URLs by producing validation error.
- Fixed by hyotak.yun in Pull Request #3318.
Missing rethrow of error produced when writing temporary multipart files fails.
- Fixed by sudo.park in Pull Request #3306.
Objective-C module conflicts in Xcode 12 by removing Obj-C module support.
- Fixed by Jon Shier in Pull Request #3308.

5.2.2

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

Added

macOS(Catalyst) User-Agent string.
- Added by Jon Shier in Pull Request #3236.

Updated

debugDescription of DataRequest and DownloadRequest to better handle non-text and long content, with better formatting.
- Updated by Jon Shier in Pull Request #3256.
Code to use switch instead of if else statement.
- Updated by dirtmelon in Pull Request #3214.

Fixed

Linking on some Apple OS versions when using Swift Package Manager.
- Fixed by Jon Shier in Pull Request #3259.
Reliability issues with DataStreamRequest.
- Fixed by Jon Shier in Pull Request #3216.

5.2.1

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

Updated

Usage of .background DispatchQoS to .utility to avoid low-power issues.
- Updated by Jon Shier in Pull Request #3207.

Fixed

Various memory leaks.
- Fixed by Jon Shier in Pull Request #3199.

5.2.0

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

Added

Combine support! DataResponsePublisher, DownloadResponsePublisher, and DataStreamPublisher to stream Alamofire responses.
- Added by Jon Shier in Pull Request #3160.
AuthenticationInterceptor, for easier adaptation and retry of requests with credentials.
- Added by Christian Noon in Pull Request #3164.

Updated

Response handlers to take all serializer parameters.
- Updated by Jon Shier in Pull Request #3188.
DisabledEvaluator to DisabledTrustEvaluator, deprecating the previous name.
- Updated by Florian Petit in Pull Request #3162.
Interceptor to be initialized with multiple RequestInterceptors, in addition to RequestAdapters and RequestRetriers.
- Updated by Jon Shier in Pull Request #3155.

Fixed

Minor documentation issues.
- Fixed by Jon Shier in Pull Request #3187.
Encoding of Decimal values in URLEncodedFormEncoder.
- Fixed by Jon Shier in Pull Request #3185.
Thread-safety issue in Session.
- Fixed by Jon Shier in Pull Request #3179.
Memory leak in NetworkReachabilityManager.
- Fixed by dirtmelon in Pull Reqeust #3180.

5.1.0

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

Added

RequestModifier closure to request APIs, allowing mutation of created URLRequests.
- Added by Jon Shier in Pull Request #3137.
DataStreamRequest, for streaming HTTP responses.
- Added by Jon Shier in Pull Request #3074.

Updated

Various framework internals to make porting to Linux easier.
- Updated by Jon Shier in Pull Request #3115.
Project to require Swift 5.1.
- Updated by Jon Shier in Pull Request #3066.

Fixed

Typo in ServerTrustEvaluating documentation.
- Fixed by Lucas Tavares in Pull Request #3138.

5.0.5

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

Fixed

Request casting issue on retry that could lead to incomplete retry of UploadRequests.
- Fixed by Jon Shier in Pull Request #3127.
Rare scenario where finish() could be called multiple times, leading to duplicate response handler calls.
- Fixed by Jon Shier in Pull Request #3116.

5.0.4

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

Fixed

Incompatibility with bitcode on watchOS.
- Fixed by Roman Podymov in Pull Request #3112.

5.0.3

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

Added

SwiftPM testing support.
- Added by Jon Shier in Pull Request #3102.
Documentation around the prohibition of background URLSessionConfigurations in Alamofire 5.
- Added by Teameh in Pull Request #3094.

Fixed

watchOS memory leaks due to missing didFinishCollecting event.
- Fixed by Jon Shier in Pull Request #3110.
RetryPolicy's handling of AFError.
- Fixed by Jon Shier in Pull Request #3103.
DownloadRequest cancellation reliability.
- Fixed by Jon Shier in Pull Request #3102.
-no_compact_unwind linker warning on watchOS by disabling the warning.
- Fixed by Christian Noon in Pull Request #3083.
SwiftPM package snippet in README.
- Fixed by Eddie Seay in Pull Request #3081.
Various documentation issues.
- Fixed by dirtmelon in Pull Requests #3105 and #3097.
- Fixed by Josip Ćavar in Pull Request #3095.
- Fixed by Teameh in Pull Request #3093.
- Fixed by Michael Clifford in Pull Request #3087.

5.0.2

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

Fixed

Swift 5 support for AlamofireExtension.
- Fixed by Jon Shier in Pull Request #3077.

5.0.1

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

Updated

AlamofireExtension to have public properties and initializer, and conform to @dynamicMemberLookup.
- Updated by Jon Shier in Pull Request #3075.

5.0.0

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

Added

Support for NSURLAuthenticationMethodClientCertificate when handling auth challenges using URLCredentials.
- Added by 刘富东 in Pull Request #2993.
Migration Guide for Alamofire 5.
- Added by Jon Shier in Pull Request #3061.

Updated

Advanced Usage documentation for Alamofire 5.
- Updated by Jon Shier in Pull Request #3062.
AF namespace to be a reference to Session.default.
- Updated by Jon Shier in Pull Request #3059.

Fixed

Runtime crashes due to overzealous state checking in SessionDelegate by reducing the severity of the assertions.
- Fixed by Jon Shier in Pull Request #3010.
Unwanted public attribute on _URLEncodedFormEncoder.
- Fixed by Mattt in Pull Request #3053.

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

Automatic resume() behavior to be called after the first response handler is added instead of immediately after task creation.
- Updated by Jon Shier in Pull Request #2965.

Fixed

Incorrect header convenience method in Usage documentation.
- Fixed by Sebastian in Pull Request #2952.
Unstable parameter ordering in URLEncodedFormEncoder.
- Fixed by Jon Shier in Pull Request #2961.
Xcode build issues and precompiled binary build issues by removing the dynamic bundle identifier.
- Fixed by Jon Shier in Pull Request #2966.
Build warnings for deprecated SecTrust API when building for Catalyst.
- Fixed by Jon Shier in Pull Request #2977.
Regression from Alamofire 4 causing Alamofire to reject NTLM and Negotiate authentication methods.
- Fixed by Adrian Kashivskyy in Pull Request #2975.

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

Single remaining use of Error instead of generic Failure constraint in DataResponse API.
- Fixed by Jon Shier in Pull Request #2937.

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

cancelAllRequests method on Session to cancel all in flight requests.
- Added by Jon Shier in Pull Request #2890.
Ability to inject FileManager instance into UploadRequest.
- Added by Jon Shier in Pull Request #2898.
DataPreprocessor protocol and implementations, allowing the preprocessing of data before serialization.
- Added by Jon Shier in Pull Request #2903.
Internal URLRequest validation and error. GET requests with body data will now produce an error.
- Added by Jon Shier in Pull Request #2905.
Generic Failure constraint to DataResponse and DownloadResponse, making them DataResponse<Success, Failure: Error> and DownloadResponse<Success, Failure: Error>.
- Added by philtre in Pull Request #2893.
Precondition to ensure Session can't be used with background URLSessionConfigurations. Alamofire will explicitly support such functionality at some point in the future.
- Added by Jon Shier in Pull Request #2917.
SwiftFormat configuration and updated styling.
- Added by Jon Shier in Pull Request #2918.
AFDataResponse<Success> and AFDownloadResponse<Success> typealiases to help deal with the doubly generic responses.
- Added by Jon Shier in Pull Request #2921.

Updated

All internal Result usage to use the fully qualified type instead of AFResult.
- Updated by philtre in Pull Request #2891.
DataRequest and DownloadRequest functional API, renaming flatMap to tryMap.
- Updated by philtre in Pull Request #2892.
HTTPMethod to be a struct rather than an enum.
- Updated by Jon Shier in Pull Request #2901.
All errors produced by Alamofire to be AFError by default. All responses will now start with an AFError Failure type.
- Updated by philtre in Pull Request #2893.
NetworkReachabilityManager to simplify and modernize its API.
- Updated by Jon Shier in Pull Request #2915.
Usage.md documentation to be fully up-to-date with Alamofire 5.
- Updated by Jon Shier in Pull Request #2895.
Bundle identifiers to include the platform name, fixing ITMS-90806.
- Updated by Jonathan in Pull Request #2928.

Fixed

Thread-safety issue with serialization queue usage.
- Fixed by Jon Shier in Pull Request #2885.

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

URLEncodedFormEncoder.DataEncoding and URLEncodedFormEncoder.KeyEncoding to customize the encoding of Data and CodingKeys in URLEncodedFormEncoder.
- Added by Jon Shier in Pull Request #2858.
Asynchronous cURLDescription method to produce cURL commands for Requests which are in the process of creating their initial URLRequest.
- Added by Jon Shier in Pull Request #2863.

Updated

All inline API documentation.
- Updated by Jon Shier in Pull Request #2845.
Handling of response serializers appended after a Request has completed. This no longer produces an error but will instead trigger the normal Request lifetime methods.
- Updated by Christian Noon in Pull Request #2862.

Fixed

Empty parameters being encoded as an empty String instead of nil by URLEncodedFormEncoder.
- Fixed by David Barry in Pull Request #2818.
Handling of os_unfair_lock to prevent rare crash.
- Fixed by Jon Shier in Pull Request #2836.

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

ServerTrustEvaluation logic by simplifying public key equality checks for SecKey types.
- Updated by Aleksandar Vacić in Pull Request #2800.
Request.State access to lock access and task updates using internal locking API.
- Updated by Jon Shier in Pull Request #2814.

Fixed

Issues in DownloadRequest where some events were being duplicated and some were missing.
- Fixed by Jon Shier in Pull Request #2807.
Issue with AppStore submissions where the pre-release version in the bundle short versions string was being rejected when built with Carthage or as a submodule.
- Fixed by Christian Noon in Pull Request #2808.
Issue where response serializer completions were not called when appended to a completed Request.
- Fixed by Christian Noon in Pull Request #2810.

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

Request.didResumeTaskNotification, Request.didSuspendTaskNotification, Request.didCancelTaskNotification, and Request.didCompleteTaskNotification notifications.
- Added by Christian Noon in Pull Request #2803.
Separate URLSessionTask lifetime events to EventMonitor.
- Added by Jon Shier in Pull Request #2796.

Updated

SessionStateProvider to no longer be public and renamed the file it lives in.
- Updated by Christian Noon in Pull Request #2801.
MultipartUpload to no longer be public.
- Updated by Christian Noon in Pull Request #2805.
Request, DataRequest, UploadRequest, and DownloadRequest to longer be open, as Alamofire does not support subclassing these types.
- Updated by Christian Noon in Pull Request #2804.
Names of the notifications posted by Request to include Notification.
- Updated by Christian Noon in Pull Request #2803.
httpHeaders extensions on URLRequest, HTTPURLResponse, and URLSessionConfiguration to be headers instead.
- Updated by Christian Noon in Pull Request #2802.

Fixed

Issue in Request where calling cancel() inside a response serializer would result in the serializer running again.
- Fixed by Christian Noon in Pull Request #2778.
Issue in Session where the delegate precondition would be triggered when running with a swizzled URLSessionDelegate.
- Fixed by Christian Noon in Pull Request #2783.
Compiler error in the example app.
- Fixed by Christian Noon in Pull Request #2786.
Issues Request where certain lifetime events could be triggered more than once by repeatedly calling resume(), suspend(), or cancel().
- Fixed by Jon Shier in Pull Request #2796 in Regards to Issue #2759.
Framework version string to be compatible with TestFlight and AppStore releases.
- Fixed by Christian Noon in Pull Request #2799 in Regards to Issue #2797.

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

The AlamofireExtended protocol and used it to namespace all public extensions.
- Added by Jon Shier in Pull Request #2758.
The ability to retry requests after encountering response serialization errors.
- Added by Christian Noon in Pull Request #2716.

Updated

The switch and DispatchQueue logic throughout codebase to simplify usage patterns.
- Updated by Joan Disho and Christian Noon in Pull Requests #2691 and #2765.
The MultipartFormData data APIs by condensing them using optional parameters.
- Updated by Ernesto Rivera in Pull Request #2766.
The upload APIs for MultipartFormData to support custom boundaries.
- Updated by Christian Noon in Pull Request #2764.
The Xcode project, source code, SPM package, and podspec to support Swift 5 only.
- Updated by Christian Noon in Pull Request #2771.
The Alamofire Result type to be a new AFResult typealias on the new Swift.Result type in Swift 5 and removed all public extensions.
- Updated by Dave Camp, Eric Jensen, and Christian Noon in Pull Requests #2769 and #2774.

Fixed

Issue in RequestInterceptor closures where callback arguments were not marked as @escaping.
- Fixed by Scott Talbot in Pull Request #2747.
Issue in response serializers where emptyResponseAllowed logic was not working as expected.
- Fixed by Jon Shier in Pull Request #2772 in Regards to Issue #2770.

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

The EmptyResponse protocol, to allow any type to provides values to stand in for an empty response.
- Added by James Van Noord in Pull Request #2664.
Request and response bodies to Request's debugDescription.
- Added by rain2540 in Pull Request #2700.

Updated

Package.swift for Swift 5 support, moving Swift 4.2 support to Package@swift-4.2.swift.
- Updated by Mattt in Pull Requests #2737 and #2736.
Use of Array to Range in Request's default acceptableResponseCodes.
- Updated by StevenArmandLee in Pull Request #2720.
RetryPolicy to allow subclasses to override retry(_:, for: Session, dueTo:, completion:).
- Updated by Christian Noon in Pull Request #2713.
Alamofire's didResume notification to didFinish, which is now called when a Request finished, not when tasks resume.
- Updated by Jon Shier in Pull Request #2728.

Fixed

Requests not finishing when their controlling Session is deinitd or invalidated.
- Fixed by Jon Shier in Pull Request #2728.
Memory leak when using validate() due to reference cycle from implicit self capture when using an @autoclosure.
- Fixed by Jon Shier in Pull Request #2728.
Crash when using requestDidParseAnyResponse when using ClosureEventMonitor.
- Fixed by Jon Shier in Pull Request #2740.
RetryPolicy to properly conform to RequestInterceptor.
- Fixed by Jon Shier in Pull Request #2739.
Typos in documentation.
- Fixed by Łukasz Mróz, Jacob Wood, Paulo Henrique, and Todd Lahtinen in Pull Requests #2715, #2725, #2729, and #2697.

5.0.0-beta.2

Added

Support for controlling redirect behavior per Session and per Request using the RedirectHandler protocol.
- Added by Christian Noon in Pull Request #2699.
Support for controlling cached response behavior per Session and per Request using the CachedResponseHandler protocol.
- Added by Christian Noon in Pull Request #2701.
Support for controlling retry behavior per Session and per Request using the RequestInterceptor protocol.
- Added by Christian Noon in Pull Request #2704 in regards to Issue #2241.
The Adapter, Retrier, and Interceptor types to provide fine grained control of retry behavior.
- Added by Christian Noon in Pull Request #2704.
Support for exponential backoff retry policies through the new RetryPolicy and ConnectionLostRetryPolicy types.
- Added by Christian Noon in Pull Request #2704.

Updated

The RequestRetrier protocol to take a RetryResult in the completion closure allowing custom retry errors to be thrown.
- Updated by Christian Noon in Pull Request #2704.
The Hashable implementation on Request to use new hash(into:) API.
- Updated by Jeff Kelley in Pull Request #2696.

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

Support for Decodable response serialization with responseDecodable.
- Added by Jon Shier in Pull Requests #2265 and #2657.
Support for Brotli Content-Encoding in Alamofire's default headers.
- Added by Jon Shier in Pull Request #2346.
HTTPHeaders type and convenience APIs.
- Added by Jon Shier in Pull Request #2629.
Support for Encodable parameter types with JSONParameterEncoder and URLEncodedFormParameterEncoder.
- Added by Jon Shier in Pull Request #2637.
Customizable empty response handling in response serializers.
- Added by Jon Shier in Pull Request #2639.
EventMonitor protocol, to tap in to internal Alamofire lifetime events.
- Added by Jon Shier in Pull Request #2521.
ServerTrustFailureReason to AFError.
- Added by Jon Shier in Pull Request #2608.
Asynchronous request creation.
- Added by Jon Shier in Pull Request #2521.

Updated

ResponseSerializer and associated protocols' requirements and implementations.
- Updated by Jon Shier in Pull Requests #2265 and #2639.
RequestAdapter to allow for asynchronous adaptation.
- Updated by Jon Shier in Pull Request #2628 .
SessionManager to Session, with rewritten implementation and API.
- Updated by Jon Shier in Pull Request #2521.
Request, DataRequest, UploadRequest, and DownloadRequest with rewritten implementation and API.
- Updated by Jon Shier in Pull Request #2521.
Top level request API to be inside a real AF namespace enum rather than unnecessary Alamofire. usage.
- Updated by Jon Shier in Pull Request #2585.

Removed

Support for iOS < 10, macOS < 10.12, tvOS < 10, watchOS < 3.
- Removed by Jon Shier in Pull Requests #2254 and #2521.
Support for PropertyListSerialization and responsePropertyList.
- Removed by Jon Shier in Pull Request #2265.
Support for URLSessionStreamTask.
- Removed by Jon Shier in Pull Request #2521.
Closure override and customization API.
- Removed by Jon Shier in Pull Request #2521.
Timeline type, as Alamofire now gathers URLSessionTaskMetrics for every request.
- Removed by Jon Shier in Pull Request #2521.

4.9.1

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

Added

Support for GitHub Actions for CI.
- Added by Jon Shier in Pull Request #2979.

Updated

DataResponse and DownloadResponse debugDescription to include more useful information.
- Updated by rain2540 in Pull Request #2976.

Fixed

Dynamic bundle identifier causing issues with Xcode and precompiled binaries by removing the dynamic behavior.
- Fixed by Jon Shier in Pull Request #2967.
Compiler warnings when building for Catalyst by updating the usage of deprecated API.
- Fixed by Jon Shier in Pull Request #2979.

4.9.0

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

Added

API to cancel DownloadRequests without producing resume data.
- Added by ullstrm in Pull Request #2851.

Updated

Bundle identifiers to include the platform name, fixing ITMS-90806.
- Updated by Jonathan in Pull Request #2930.

Fixed

NetworkReachabilityManager behavior regression from 4.8.1.
- Fixed by Jon Shier in Pull Request #2931.
Memory leak when using validate().
- Fixed by Jon Shier in Pull Request #2931.

4.8.2

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

Updated

Project for compatability with Xcode 10.2.
- Updated by Jon Shier in Pull Request #2767.
MultipartFormData to have a mutable boundary.
- Updated by Ondrej Stocek in Pull Request #2705.

Fixed

Compatability with SPM from Xcode 10.2.
- Fixed by Klaas in Pull Request #2762.

4.8.1

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

Fixed

Issue where the network reachability listener closure was not being called immediately when launching an app in airplane mode.
- Fixed by Christian Noon in Pull Request #2688 regards to Issues #2275 and #2677.

4.8.0

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

Added

Optional encoding completion callback queue for multipart upload.
- Added by jaltreuter in Pull Request #2620.
Versioned Swift package manifests.
- Added by Wanbok Choi (Wayne) in Pull Request #2621 and Jon Shier in Pull Request #2648.

Updated

Project Swift version to 4.
- Updated by Jon Shier in Pull Request #2648.
Various Result methods to be throw/rethrows.
- Updated by Stéphane Copin in Pull Request #2488.
cURL representation implementation readability.
- Updated by Giulio in Pull Request #2625.

4.7.3

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

Updated

Project for Xcode 10 and Swift 4.2 beta versions.
- Updated by Jon Shier in Pull Request #2552.
Documentation styling and content.
- Updated by Constantin Lungu in Pull Request #2505, Xing He in Pull Request #2484, and Karim in Pull Request #2550.

4.7.2

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

Fixed

Leak of Requests after retry.
- Fixed by Artem Shimankski in Pull Request #2412.

4.7.1

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

Updated

Project for Xcode 9.3 and Swift 4.1 release versions.
- Updated by Jon Shier in Pull Request #2473.

Fixed

Quote escaping in cURL representation.
- Fixed by Jonah in Pull Request #2474.

4.7.0

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

Added

Open accessibility to NetworkReachabilityManager
- Added by Pär Strindevall in Pull Request #2393.
Configurable parameter encoding for URLEncoding
- Added by Morten Heiberg in Pull Request #2431.
Response Data to .DidComplete notification.
- Added by Sven Driemecker in Pull Request #2427.
Radar link for URLSessionTaskMetrics bug on watchOS.
- Added by Christian Noon in Pull Request #2387.

Updated

Project for Xcode 9.3 and Swift 4.1.
- Updated by Jon Shier in Pull Request #2441.
OS versions affected by resume data bug.
- Updated by Aaron Brager in Pull Request #2389.

Fixed

Typos in ResultTests.
- Fixed by Aleph Retamal in Pull Request #2416.

4.6.0

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

Added

Error mapping functions to Response types.
- Added by Jon Shier in Pull Request #2361.
Separation of Usage and Advanced Usage docs from README.
- Added by Jon Shier in Pull Request #2360.

Updated

Travis CI and Ruby dependencies.
- Updated by Jon Shier in Pull Requests #2361, #2302, #2345.
Swift Package Manager instructions.
- Updated by Ryosuke Hayashi in Pull Request #2341.

Fixed

#session-manager link in Advanced Usage docs.
- Fixed by Naeem Shaikh in Pull Request #2373.
Missing @discardableResult.
- Fixed by Aron Cedercrantz in Pull Request #2338.
Colon placement.
- Fixed by Issarapong Poesua in Pull Request #2329.

4.5.1

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

Added

GitHub templates for issues and pull requests.
- Added by Jon Shier in Pull Request #2179.
Jazzy docs for the release to work with GitHub Pages.
- Added by Aaron McTavish in Pull Request #2250.
Dash support for Jazzy docs.
- Added by Jon Shier.

Updated

The project to work with Xcode 9 beta 6 on Swift 3.2 and 4.0.
- Updated by Jon Shier in Pull Request #2198.
The Travis CI config to work with Xcode 9 beta 6.
- Updated by Jon Shier.
The cURL representation logic to no longer force unwrap URLCredential values.
- Updated by Andrey Chernoprudov in Pull Request #2184.
The radars section of the README to split out open vs. resolved radars.
- Updated by Christian Noon in Pull Request #2263.
The installation section of the README to use the current version.
- Updated by Kim de Vos in Pull Request #2266.

Fixed

Issue in TaskDelegate where task access was not thread safe.
- Fixed by Jon Shier in Pull Request #2190.
Issue in AF 4 migration guide where supported iOS versions was incorrect.
- Fixed by Antoine Cœur in Pull Request #2212.
Issue in README sample code where PNG representation API was incorrect.
- Fixed by Andy Ron in Pull Request #2244.
Swift 3.2+ API warnings for substring APIs.
- Fixed by htinlinn in Pull Request #2240.

4.5.0

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

Added

Missing @escaping annotation for session delegate closures.
- Added by Alexey Aleshkov in Pull Request #1951.
New mapError, flatMapError, withValue, withError, ifSuccess, and ifFailure APIs to Result.
- Added by Jon Shier in Pull Request #2135.

Updated

The Travis config file to Xcode 8.3.
- Updated by Jon Shier in Pull Request #2059.
Response serialization implementation to use separate internal variable.
- Updated by Eunju Amy Sohn in Pull Request #2125.
SessionDelegate internal implementation by removing redundant optional unwrap.
- Updated by Boris Dušek in Pull Request #2056.
The debugPrintable implementation of Request to use curl -v instead of curl -i to be more verbose.
- Updated by Simon Warta in Pull Request #2070.
The MultipartFormData contentType property to be mutable.
- Updated by Eric Desa in Pull Request #2072.
Travis CI yaml file to enable watchOS 3.2 builds.
- Updated by Jon Shier in Pull Request #2135.
Alamofire to build with Xcode 9 with Swift 3.2 and 4.0 in addition to Xcode 8.3 and Swift 3.1.
- Updated by Jon Shier in Pull Request #2163.

Removed

Custom string extension no longer needed in the test suite.
- Removed by Nicholas Maccharoli in Pull Request #1994.

Fixed

Issue in the URLProtocolTestCase where HTTP header capitalization was wrong due to httpbin.org change.
- Fixed by Natascha Fadeeva in Pull Request #2025.
Issues and typos throughout the README documentation and sample code and source code docstrings.
- Fixed by Raphael R., helloyako, DongHyuk Kim, Bas Broek, Jorge Lucena, MasahitoMizogaki, José Manuel Sánchez, SabinLee, Mat Trudel, Wolfgang Lutz, and Christian Noon in Pull Requests #1995, #1997, #1998, #2022, #2031, #2035, #2080, #2081, #2092, #2095, #2104.
Several warnings in the test suite related to Xcode 8.3.
- Fixed by Jon Shier in Pull Request #2057.
Issue where reachability calculation incorrectly reported .reachable status with [.connectionRequired, .isWWAN] combination.
- Fixed by Marco Santarossa in Pull Request #2060.

4.4.0

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

Added

A new Alamofire/Alamofire Gitter channel and also added badge to the README.
- Added by Christian Noon.
Functional extensions for Result, Data and Download Response.
- Added by Gwendal Roué in Pull Request #1836.

Fixed

Typo in the README in the Swift Package Manager section.
- Fixed by Sebastian Limbach in Pull Request #1918.
Issue in the "Modifying the Session Configuration" example code of the README where the defaultHTTPHeaders property was called incorrectly.
- Fixed by Artur Antonov in Pull Request #1927.
Issue in the "Security" section of the README where some example code was outdated.
- Fixed by Jon Shier in Pull Request #1973.
Issue in the README where the POST request with parameters example was using the wrong method.
- Fixed by Pablo Bartolome in Pull Request #1984.
Issue where taskDidComplete override closure was not calling task delegate leading to potential memory leaks.
- Fixed by Jon Shier in regards to Issue #1938.

4.3.0

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

Added

The host and path to router example in README.
- Added by Michael in Pull Request #1830.
A macOS disclaimer to download request example in README.
- Added by Christian Noon in regards to Issue #1818.
New value and error computed properties to data and download responses.
- Added by Christian Noon in Pull request #1865.
The HTTP method to the data and download response debug descriptions.
- Added by Jon Shier in Pull request #1880.
A README entry about installing through SPM.
- Added by Jon Shier in Pull request #1898.
The dependencies parameter to Package file for SPM since it's now required.
- Added by Arnaldo Capo in Pull request #1905.
TLS evaluation tests for revoked certs for no policy and default policy.
- Added by Christian Noon.
New server trust policy for revoked certificates along with matching tests.
- Added by Wataru Suzuki in Pull request #1822.

Updated

Project to Xcode 8.2 recommend settings.
- Updated by Jon Shier in Pull request #1854.
The NetworkReachabilityManager to have a public instead of open ACL.
- Updated by Christian Noon in regards to Issue #1809.
The initializers for both default responses public and added metrics parameter.
- Updated by Christian Noon in Pull Request #1865.
Internals by replacing syncResult extension with DispatchQueue sync.
- Updated by Alexander Ignition in Pull Request #1893.
TLS tests for tvOS 10.1 and added expiration test for revoked evaluation.
- Updated by Christian Noon.

Fixed

DownloadRequest sample code issue in AF 4 migration guide.
- Fixed by Luca Torella in Pull Request #1802.
URLConvertible compiler issue in the README example.
- Fixed by Wu Zhong in Pull Request #1844.
An invalid comment in AF 4 migration guide.
- Fixed by Tom Brow in Pull Request #1863.
An issue where the SessionManager did not respect retry time delay.
- Fixed by Christian Noon in Pull Request #1864 in regards to Issue #1853.
A broken reference link in the README.
- Fixed by Ulug'bek Ro'zimboyev in Pull Request #1866.
Compiler issues in RequestAdapter and RequestRetrier examples in README.
- Fixed by William Entriken in Pull Request #1916.

4.2.0

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

Added

Request property overrides to fallback on original task if available.
- Added by Aron Cedercrantz in Pull Request #1792.
Timeline generation to DefaultDataResponse and DefaultDownloadResponse.
- Added by Christian Noon.
JSON encoding encode method that takes a JSON object along with unit tests.
- Added by Christian Noon.

Updated

The RequestRetrier example in the README to safely extract tokens.
- Updated by Pontus Andersson in Pull Request #1794.
TaskDelegate data and error properties to a public ACL.
- Updated by Christian Noon.
Multipart form data uploads to now delete temp file if encoding fails.
- Updated by Christian Noon.

Fixed

Issue where AdaptError instances were being incorrectly sent to the RequestRetrier.
- Fixed by Christian Noon in regards to Issue #1785.
Issue where TLS tests were failing on iOS 10.0 and not on iOS 10.1.
- Fixed by Christian Noon.

4.1.0

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

Added

Docstrings and a note to the README about resumeData and background session behavior.
- Added by Christian Noon in regards to Issue #1553.
Request retryCount property to support the RequestRetrier.
- Added by Christian Noon in regards to Issue #1672.

Updated

SPM package file to exclude tests since current configuration is not supported.
- Updated by Christian Noon in regards to Issue #1544.
An example in the README to use proper error checking in download response handler.
- Updated by Jon Shier in Pull Request #1722.
Embedded framework installation instructions.
- Updated by ILI4S K4RIM in Pull Request #1721.
The AF4 Migration Guide to no longer use DispatchQueue internal APIs in the example.
- Updated by Jon Shier in Pull Request #1736.
The RequestAdapter to call the RequestRetrier when an Error is thrown.
- Updated by Christian Noon in Pull Request #1682.
The SessionManager to clean up the temporary multipart form data file after upload.
- Updated by Christian Noon in regards to Issue #1742.
The deployment targets to iOS 8.0 and macOS 10.10.
- Updated by Christian Noon in Pull Request #1774.
The Travis CI yaml file to support iOS 8 simulators.
- Updated by Christian Noon in Pull Request #1774.
The iOS Example app deployment target to iOS 8.0.
- Updated by Christian Noon in Pull Request #1774.

Removed

Duplicate auto-code signing on macOS.
- Removed by Christian Noon
Duplicate code signing identities on various targets.
- Removed by Christian Noon

Fixed

A compiler error in response validation sample code in the README.
- Fixed by Vishrut Shah in Pull Request #1615.
Several internal SessionManager links that were broken in the README.
- Fixed by Vishrut Shah in Pull Request #1625.
Issue in the sample code of the README where response.error was used incorrectly.
- Fixed by Bob in Pull Request #1633.
Issue in the ServerTrustPolicy tests where a macOS 10.12 check was needed.
- Fixed by Jon Shier.
Compiler issue with DownloadRequest in AF4 Migration Guide.
- Fixed by Wolfgang Lutz in Pull Request #1670.
Test target compiler warning by not requiring app extension APIs only.
- Fixed by Christian Noon.
Typo in the HTTP Headers section of the README.
- Fixed by Carlos McEvilly in Pull Request #1734.
Incorrect response type in the response README examples.
- Fixed by Julien Chaumond in Pull Request #1760.
Xcode 8.1 compiler warnings and project suggestions.
- Fixed by Jon Shier in Pull Request #1735.
Issue where download completion could crash on a nil response.
- Fixed by Jon Shier in Pull Request #1723.
Issue in TLS tests where root certificate was missing from server trust.
- Fixed by Christian Noon.

4.0.1

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

Added

The OS_ACTIVITY_MODE environment variable to iOS, tvOS and iOS Example.
- Added by Christian Noon.
Test verifying download request can be resumed with resume data.
- Added by Christian Noon.

Updated

All instances of com.alamofire with org.alamofire throughout the project.
- Updated by Christian Noon.
Project by adding .swift-version file and re-enabling pod lib lint in Travis file.
- Updated by Thibault Vlacich in Pull Request #1534.
The entire project to use macOS in place of OS X.
- Updated by Justin Jia in Pull Request #1520.
Framework and test target override settings that duplicated the project settings.
- Updated by Christian Noon.

Fixed

Issue where the test suite was accidentally deleting contents of ~/Library/Application Support on macOS.
- Fixed by Christian Noon in regards to Issue #1512.
Typo in the migration guide around availability checks.
- Fixed by Alexsander Akers in Pull Request #1510.
Typo in the README around response handlers.
- Fixed by Glenn R. Fisher in Pull Request #1515.
Issue in the download example in the README where a to parameter was missing.
- Fixed by Julien Colin in Pull Request #1532.
Issue in AFError where wrong case was used in several property implementations.
- Fixed by Victor Chee in Pull Request #1558.
Typo in AF 4 migration guide where "enhancements" was spelled incorrectly.
- Fixed by YeralYamil in Pull Request #1590.
Typo in code sample documentation where "already" was misspelled.
- Fixed by Fuad Kamal in Pull Request #1599.
Typos in the Open Radars and Donations sections of README.
- Fixed by Brian Lu in Pull Request #1606.
Issue in DispatchQueue extension where Foundation needed to be imported for submodules.
- Fixed by CodeEagle in Pull Request #1603.
Memory leak in Validation closures where reference to self was causing retain cycle.
- Fixed by Christian Noon in regards to Issue #1551.
Compilation issue in response handler section of the README.
- Fixed by Vishrut Shah in Pull Request #1612.

4.0.0

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

Added

Internal DispatchQueue extension set of convenience properties and methods.
- Added by Christian Noon in Pull Request #1450.
RequestAdapter and RequestRetrier protocols allowing requests to be retried.
- Added by Christian Noon in Pull Request #1450.
RequestAdapter tests on all testable SessionManager request APIs.
- Added by Christian Noon in Pull Request #1450.
Added an Adapting and Retrying Requests section to the README.
- Added by Christian Noon in Pull Request #1450.
DataRequest, DownloadRequest, UploadRequest and StreamRequest subclasses.
- Added by Christian Noon in Pull Request #1455.
Top-level APIs for creating StreamRequest instances.
- Added by Christian Noon in Pull Request #1455.
Extra responseToSelector overrides for stream delegate APIs.
- Added by Christian Noon in Pull Request #1455.
A new syncResult extension to DispatchQueue to simplify thread-safe locking.
- Added by Christian Noon in Pull Request #1455.
Two serialization failure reasons to support download response serializers.
- Added by Christian Noon in Pull Request #1457.
Download response serialization tests for all serializer types.
- Added by Christian Noon in Pull Request #1457.
The dataFileNil and dataFileReadFailed cases to ResponseValidationFailureReason.
- Added by Christian Noon in Pull Request #1461.
The isWildcard property to MIMEType struct for convenience.
- Added by Christian Noon in Pull Request #1461.
Missing CustomDebugStringCovertible conformance to DownloadResponse.
- Added by Christian Noon in Pull Request #1462.
URL variants to the FileManager extension in the test suite.
- Added by Christian Noon in Pull Request #1462.
DownloadOptions option set to make moving files more robust.
- Added by Christian Noon in Pull Request #1462.
Tests validating success and failure scenarios for DownloadOptions.
- Added by Christian Noon in Pull Request #1462.
Parameter encoding failure docstrings and refactored reasons to be consistent.
- Added by Christian Noon in Pull Request #1465.
Safeguards to url parameter encoding when extracting the url request’s url.
- Added by Christian Noon in Pull Request #1465.
The new URLSessionTaskMetrics to all Response types.
- Added by Christian Noon in Pull Request #1492.
The Alamofire 4.0 Migration Guide to the README.
- Added by Christian Noon.
HTTPHeaders typealias for top-level API convenience.
- Added by Christian Noon.
Complete safeguards to URLStringConvertible, URLRequestConvertible and RequestAdapter.
- Added by Christian Noon in Pull Request #1505.
Tests around invalidURL error cases for Request creation and adaptation.
- Added by Christian Noon in Pull Request #1505.

Updated

The authorizationHeader static method over to returning optional tuple.
- Updated by Christian Noon in Pull Request #1455.
SessionManager queues to each have a unique name using a UUID suffix.
- Updated by Christian Noon in Pull Request #1455.
The progress tracking system across all Request subclasses to improve accuracy.
- Updated by Christian Noon in Pull Request #1455.
BaseTestCase to delete contents of common directories at the start of each test.
- Updated by Christian Noon in Pull Request #1457.
Response handler extensions by moving them into DataRequest and added equivalents for DownloadRequest.
- Updated by Christian Noon in Pull Request #1457.
The response serializer types to use the Protocol suffix.
- Updated by Christian Noon in Pull Request #1457.
Validation typealias to include response data in a DataRequest type.
- Updated by Christian Noon in Pull Request #1461.
Validation typealias to include temporary and destination URLs in a DownloadRequest type.
- Updated by Christian Noon in Pull Request #1461.
SessionManager APIs to all leverage TaskConvertible conformance.
- Updated by Christian Noon in Pull Request #1461.
DownloadFileDestination closures to be optional on top-level DownloadRequest APIs.
- Updated by Christian Noon in Pull Request #1462.
The request and download APIs now default to .get method and upload defaults to .post.
- Updated by Christian Noon in Pull Request #1462.
The ParameterEncoding encode API to throw instead of returning tuple.
- Updated by Christian Noon in Pull Request #1465.
The TaskDelegate to only store the url session task error if error is nil.
- Updated by Christian Noon in Pull Request #1465.
ParameterEncoding enum by switching to a protocol backed by url, json and plist structs.
- Updated by Christian Noon in Pull Request #1465.
Updated RequestRetrier completion to be escaping.
- Updated by Aron Cedercrantz in Pull Request #1489.
Code signing to automatic with no team on framework, test and app targets.
- Updated by Christian Noon.
README for Swift 3 and Alamofire 4 along with reorganization.
- Updated by Christian Noon.
README with improved Error examples as well as typo and whitespace fixes.
- Updated by Jon Shier in Pull Request #1504.
Request task property is now optional allowing errors to propagate through.
- Updated by Christian Noon in Pull Request #1505.
The Travis-CI device list in the yaml file.
- Updated by Christian Noon in Pull Request #1505.
The top-level APIs by removing external resource parameter name.
- Updated by Christian Noon in Pull Request #1505.
The URLStringCovertible by renaming to URLConvertible and removed protocol property.
- Updated by Christian Noon in Pull Request #1505.
The README and migration guide with the URLConvertible and top-level API changes.
- Updated by Christian Noon in Pull Request #1505.

Removed

Unnecessary public ACL declarations on AFError extensions.
- Removed by Christian Noon.
URLStringConvertible conformance on URLRequest.
- Removed by Christian Noon in Pull Request #1491.
Removed downloadProgress and uploadProgress Int64 variants.
- Removed by Christian Noon in regards to Issue #1467 reported by thebluepotato.
Duplicated change log message in the migration guide.
- Removed by Justin Jia in Pull Request #1503.
Code coverage generation by default to improve test suite stability.
- Removed by Christian Noon.

Fixed

Fixed URLEncoding issue around NSNumber parameter encoding.
- Fixed by Christian Noon in regards to Issue #1458 reported by Dhanush Balachandran.
Issue where MultipartFormData temp directory creation needed to be done serially.
- Fixed by Christian Noon in regards to Issue #1333 reported by Fernando Mazzon.
Issue in resume data tests where request was being cancelled multiple times.
- Fixed by Christian Noon.

4.0.0-beta.2

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

Fixed

Build issue with Manager class due to cherry picked change that merged incorrectly.
- Fixed by Christian Noon in regards to Issue #1438.

4.0.0-beta.1

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

Added

discardableResult annotations to all top-level Request APIs.
- Added by Christian Noon.

Updated

All source, test and example logic as well as project settings to compile against the Xcode 8 beta releases.
- Updated by Kevin Harwood, Jon Shier and Christian Noon.
Deployment targets to iOS 9.0, macOS 10.11, tvOS 9.0 and watchOS 2.0.
- Updated by Christian Noon.
Notifications to use nested structs inside Notification.Name namespace.
- Updated by Christian Noon.
The Manager class to SessionManager to be more descriptive.
- Updated by Christian Noon in Pull Request #1385.
The SessionDelegate, TaskDelegate and subclasses by pulling them into the global namespace.
- Updated by Christian Noon in Pull Request #1385.
All the Core APIs and documentation to match Swift 3 API design guidelines.
- Updated by Christian Noon in Pull Request #1385.
The SessionDelegate to store Request instances internally to prepare for retry logic.
- Updated by Christian Noon in Pull Request #1391.
The podspec to 4.0.0-beta.1 and bumped the deployment targets.
- Updated by Jon Shier in Pull Request #1401.
The parameter order of custom URLRequest initializer to match other APIs.
- Updated by Christian Noon.
The travis yaml file for Xcode 8.
- Updated by Christian Noon.
The Error enum to AFError which now conforms to the new Error protocol.
- Updated by Jon Shier in Pull Request #1419.

Fixed

Typo in a parameter name in the MultipartFormData Swift 3 API refactor.
- Fixed by Joshua Hudson in Pull Request #1395.

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

Assorted memory leaks caused by underlying Swift runtime bugs.
- Fixed by Jon Shier in regards to Issue #1626.
Issue in the test suite logic on macOS 10.12.
- Fixed by Jon Shier.

3.5.0

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

Updated

The User-Agent header generation formatting and also added docs and tests.
- Updated by Jon Shier in Pull Request #1456 in regards to Issue #1452.
All source, test and example logic as well as project settings to compile against Xcode 7 and 8 against Swift 2.2 or 2.3 respectively.
- Updated by Kevin Harwood, Jon Shier and Christian Noon.
The Travis CI yaml file to support both Xcode 7.3 and 8 simultaneously.
- Updated by Christian Noon.

Fixed

A TLS evaluation test that could fail with a different error when behind a proxy.
- Fixed by Christian Noon.

3.4.2

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

Added

Added Cleanup Whitespace target to remove excess whitespace from Swift files.
- Added by Christian Noon.

Updated

All TLS evaluation tests from disig.sk to badssl.com to be more reliant and robust.
- Updated by Christian Noon.
Internal URLRequest method to maintain mutable variant data on an NSURLRequest passed into the top-level APIs.
- Updated by Greedwolf DSS in Pull Request #1330.
The User-Agent header to include version and build numbers.
- Updated by Sergey Demchenko in Pull Request #1420.

Removed

All excess whitespace from Swift files using the Cleanup Whitespace target.
- Removed by Christian Noon.

Fixed

Request debug description tests to no longer require parameters in a specific order.
- Fixed by Marius Serban in Pull Request #1318.
Small ACL issue in code sample of the Handling Errors section of the README.
- Fixed by Adrian Brink in Pull Request #1315.

3.4.1

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

Added

Rdar 26761490 to the list of rdars affecting Alamofire.
- Added by Christian Noon in Pull Request #1262.
A new debugDescription test for a MultipartFormData Request with duplicate headers.
- Added by Christian Noon in regards to Issue #1303.

Updated

CocoaPod installation instructions in README to be compatible with 1.x.
- Updated by Luis Ferro in Pull Request #1288.
The README to reflect the best error practices in response serializers.
- Updated by Jon Shier in Pull Request #1273.
The generation of the User-Agent header to use non-localized sources.
- Updated by Jon Shier in Pull Request #1292 in regards to Issue #1269.
The Generic Response Object Serialization section of the README to use protocol extension.
- Updated by Raphael Oliveira in Pull Request #1257.
Reachability by removing explicit IPv6 logic since OS handles this automatically.
- Updated by Christian Noon in Pull Request #1308 in regards to Issue #1228.
Host manager reachability test to use different hostname to improve test reliability.
- Updated by Christian Noon in Pull Request #1308.

Removed

ReleaseTest configuration and updated Travis-CI yaml file to enable testability directly.
- Removed by Christian Noon.

Fixed

Memory leak in Timeline description and debugDescription due to string interpolation.
- Fixed by Christian Noon in Pull Request #1262 in regards to Issue #1232.

3.4.0

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

Added

Status code and content type values into validation NSError userInfo dictionaries.
- Added by Cédric Luthi in Pull Request #1166.
New authorizationHeader API to generate base64 encoded authorization header.
- Added by Cédric Luthi in Pull Request #1187.

Updated

URLProtocol tests to demonstrate using NSURLProtocol with NSURLSession.
- Updated by Christian Noon in regards to Issue #1160.
The SesionDelegate to no longer be final to allow subclassing.
- Updated by Christian Noon in Pull Request #1172 in regards to Issue #1145.
The SessionDelegate subscript public to allow full control when subclassing.
- Updated by Christian Noon in Pull Request #1172.
The Response Serialization section of the README to include validation examples.
- Updated by Christian Noon in regards to Issue #1213.
The delegate guard in the Manager initializer in front of property assignment.
- Updated by Broccoliii in Pull Request #1226.
Header example in the README to use Accept header instead of Content-Type.
- Updated by Christian Noon in regards to Pull Request #1229.

Deprecated

The errorWithCode APIs and updated NSURLError* domains to NSURLErrorDomain.
- Deprecated by Cédric Luthi in Pull Request #1166.

Fixed

Issue where Requests with invalid credentials were not terminating with 401 status code.
- Fixed by Cédric Luthi in Pull Request #1164 in regards to Issue #1159.
Issue in URLProtocol test where config headers are not passed prior to iOS 9.0.
- Fixed by Christian Noon.
Issue where Request cURLRepresentation method was not coalescing duplicate headers.
- Fixed by Chris Richards in Pull Request #1186 in regards to Issue #1184.
Issue where incorrect dash in License file was breaking markdown parsing.
- Fixed by Gemma Barlow in Pull Request #1218.
Issue where internal quotes were not escaped correctly in cURL output.
- Fixed by Christian Noon.

3.3.1

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

Added

Tests for the SessionDelegate redirect with completion override closure.
- Added by Kevin Harwood in Pull Request #1141.
Tests for all the SessionDelegate override closures.
- Added by Christian Noon.

Updated

The authentication test cases to clear out all cookies to help stabilize Travis-CI.
- Updated by Christian Noon.
The cache test check for no store header to use availability checks.
- Updated by Christian Noon.

Fixed

The respondsToSelector check for the new HTTP redirect closure with completion.
- Fixed by Kevin Harwood in Pull Request #1141 in regards to Issue #1140.
Issue where the challenge and response SessionDelegate override closures were not called.
- Fixed by Christian Noon.
Typo in the Travis YAML file that was causing all tests to always fail on iOS 9.1.
- Fixed by Christian Noon.
Race condition in the cache tests that was causing random failures on Travis-CI.
- Fixed by Christian Noon.

3.3.0

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

Added

Added override closures for all SessionDelegate APIs with completion handlers.
- Added by Christian Noon in Pull Request #1099.

Updated

The User-Agent header implementation to use more aggressive type-safety checks.
- Updated by Christian Noon in regards to Issue #1100.
All shared response serializers to accept a custom queue for execution.
- Updated by Luca Torella in Pull Request #1112.
The network reachability manager to use IPv4 on iOS 8.x and OSX 10.9.x.
- Updated by Christian Noon in regards to Issue #1086.
All source, test and example code to compile against Swift 2.2.
- Updated by James Barrow and Dominik Hadl in Pull Requests #1030 and #1128.
The Travis CI YAML file to use Xcode 7.3 and also updated matrix targets.
- Updated by Christian Noon.

Fixed

Issue in JSON response serialization test case where the wrong serializer was being tested.
- Fixed by Gregory J.H. Rho in Pull Request #1108.
Issue where multipart form data encoding was unnecessarily scheduling input and output streams with the current runloop.
- Fixed by Brian King in Pull Request #1121.

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

StringResponseSerializer implementation to build with the latest Swift toolchain.
- Updated by Chris Cieslak in Pull Request #1050.
Expanded the Component Libraries section and moved it up in the README.
- Updated by Christian Noon.

Fixed

Issue where JSON and plist custom content types were not retained during parameter encoding.
- Fixed by Christian Noon in Pull Request #1088.

3.2.0

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

Added

Notifications that post when an NSURLSessionTask changes state to allow support for the network activity indicator.
- Added by Christian Noon.
Timeline struct to capture timings throughout the lifecycle of a Request.
- Added by Christian Noon in Pull Request #1054.
A new Timeline section to the README.
- Added by Christian Noon in Pull Request #1054.
NetworkReachabilityManager to listen for reachability status changes.
- Added by Christian Noon in Pull Request #1053.
Unit tests for all the testable network reachability manager APIs.
- Added by Christian Noon in Pull Request #1053.
A new Network Reachability section to the README.
- Added by Christian Noon in Pull Request #1053.

Updated

The NSURLSessionStream APIs to support tvOS.
- Updated by Christian Noon.
The ParameterEncoding encode method to allow empty parameters to still be encoded.
- Updated by Christian Noon in regards to Issues #1032 and #1049.

Fixed

Broken CocoaDocs generation by moving iOS Example project into Examples folder.
- Fixed by Jon Shier in Pull Request #1027 in regards to Issue #1025.

3.1.5

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

Added

Package.swift to the project to support Swift Package Manager (SPM).
- Added by Kyle Fuller in Pull Request #979.
Safeguards to the Request class's debugDescription property.
- Added by tokorom in Pull Request #983.

Updated

Accept-Language header generation to use functional style.
- Updated by Dapeng Gao in Pull Request #982.
Accept-Encoding and Accept-Language header values to have separator spaces between values.
- Updated by Christian Noon.
Copyright headers to include 2016! 🎉🎉🎉
- Updated by Christian Noon.

3.1.4

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

Added

NSTemporaryExceptionMinimumTLSVersion documentation to the ATS section in the README.
- Added by Marandon Antoine in Pull Request #952.
Added ReleaseTest configuration to allow running tests against optimized build.
- Added by Christian Noon.

Updated

Carthage instructions in the README to clearly callout the carthage update command.
- Updated by vlad in Pull Request #955.
ParameterEncoding to early out when passed an empty parameters dictionary.
- Updated by Anthony Miller in Pull Request #954.
The certificatesInBundle to support cer, crt and der extensions.
- Updated by Jacob Jennings in Pull Request #956.
The ENABLE_TESTABILITY flag to NO for Release configuration and disabled tests for non-test builds to better support Carthage.
- Updated by Jed Lewison in Pull Request #953.
The server certificates for the TLS tests and added all certificates to all test targets.
- Updated by Christian Noon.
The Travis-CI configuration to Xcode 7.2, iOS 9.2, tvOS 9.1 and watchOS 2.1.
- Updated by Christian Noon.

Removed

SecCertificate array Swift workaround in ServerTrustPolicy for Xcode 7.2.
- Removed by Christian Noon.

3.1.3

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

Added

Custom Info.plist for tvOS setting the UIRequiredDeviceCapabilities to arm64.
- Added by Simon Støvring in Pull Request #913.

Updated

All code samples in the README to use https instead of http.
- Updated by Tomonobu Sato in Pull Request #912.

3.1.2

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

Updated

Code signing on iOS simulator builds to not sign simulator builds.
- Updated by John Heaton in Pull Request #903.
Code signing on watchOS and tvOS simulators builds to not sign simulator builds.
- Updated by Christian Noon.

3.1.1

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

Added

Support for 204 response status codes in the response serializers.
- Added by Christian Noon in Pull Request #889.
ATS section to the README explaining how to configure the settings.
- Added by Christian Noon in regards to Issue #876.

Updated

Several unnecessary uses of NSString with String.
- Updated by Nicholas Maccharoli in Pull Request #885.
Content type validation to always succeeds when server data is nil or zero length.
- Updated by Christian Noon in Pull Request #890.

Removed

The mention of rdar://22307360 from the README since Xcode 7.1 has been released.
- Removed by Elvis Nuñez in Pull Request #891.
An unnecessary availability check now that Xcode 7.1 is out of beta.
- Removed by Christian Noon.
The playground from the project due to instability reasons.
- Removed by Christian Noon.
The data length checks in the responseData and responseString serializers.
- Removed by Christian Noon in Pull Request #889.

3.1.0

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

Added

New tvOS framework and test targets to the project.
- Added by Bob Scarano in Pull Request #767.
The tvOS deployment target to the podspec.
- Added by Christian Noon.
The BITCODE_GENERATION_MODE user defined setting to tvOS framework target.
- Added by Christian Noon.

Updated

The README to include tvOS and bumped the required version of Xcode.
- Updated by Christian Noon.
The default tvOS and watchOS deployment targets in the Xcode project.
- Updated by Christian Noon.
The APPLICATION_EXTENSION_API_ONLY enabled flag to YES in the tvOS framework target.
- Updated by James Barrow in Pull Request #771.
The Travis-CI yaml file to run watchOS and tvOS builds and tests on xcode7.1 osx_image.
- Updated by Christian Noon.

3.0.1

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

Added

Tests around content type validation with accept parameters.
- Added by Christian Noon.

Fixed

Content type validation issue where parameter parsing on ; was incorrect.
- Fixed by Christian Noon.

3.0.0

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

Updated

Downloading a File code sample in the README to compile against Swift 2.0.
- Updated by Screon in Pull Request #827.
Download code samples in the README to use response serializer.
- Updated by Christian Noon.
CocoaPods and Carthage installation instructions for 3.0.
- Updated by Christian Noon.
Carthage description and installation instructions in the README.
- Updated by Ashton Williams in Pull Request #843.
URL encoding internals to leverage the dictionary keys lazy evaluation.
- Updated by Christian Noon.

Fixed

Small typo in the Alamofire 3.0 Migration Guide Response section.
- Fixed by neugartf in Pull Request #826.
User defined BITCODE_GENERATION_MODE setting for Carthage builds.
- Fixed by Christian Noon in regards to Issue #835.

3.0.0-beta.3

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

Updated

The Response initializer to have a public ACL instead of internal.
- Updated by Christian Noon.

3.0.0-beta.2

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

Added

Tests around the header behavior for redirected requests.
- Added by Christian Noon in regards to Issue #798.
A migration guide for Alamofire 3.0 documenting all API changes.
- Added by Christian Noon.

Updated

Response initializer to have internal ACL.
- Updated by Christian Noon.
All sample code in the README to conform to the Alamofire 3.0 APIs.
- Updated by Christian Noon.
URL percent escaping to only batch on OS's where required improving overall performance.
- Updated by Christian Noon.
Basic auth example in the README to compile on Swift 2.0.
- Updated by David F. Muir V in Pull Request #810.

Fixed

Compiler errors in the playground due to the new response serializer APIs.
- Fixed by Christian Noon.

3.0.0-beta.1

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

Added

A new Response struct to simplify response serialization.
- Added by Christian Noon in Pull Request #792.
A new initializer to the Manager allowing dependency injection of the underlying NSURLSession.
- Added by Christian Noon in Pull Request #795.
Tests around the new Manager initialization methods.

Updated

Result type to take two generic parameters (Value and Error) where Error conforms to ErrorType.
- Updated by Christian Noon in Pull Request #791.
All response serializers to now return the original server data as NSData?.
- Updated by Christian Noon in Pull Request #791.
The TaskDelegate to store an error as an NSError instead of ErrorType.
- Updated by Christian Noon in Pull Request #791.
The ValidationResult failure case to require an NSError instead of ErrorType.
- Updated by Christian Noon in Pull Request #791.
All tests around response serialization and Result type usage.
- Updated by Christian Noon in Pull Request #791.
All response serializers to use the new Response type.
- Updated by Christian Noon in Pull Request - #792.
The designated initializer for a Manager to accept a SessionDelegate parameter allowing dependency injection for better background session support.
- Updated by Christian Noon in Pull Request #795.

2.0.2

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

Updated

The Embedded Framework documentation to include git init info.
- Updated by Christian Noon in regards to Issue #782.

Fixed

Alamofire iOS framework target by adding Alamofire iOS Tests as Target Dependency.
- Fixed by Nicky Gerritsen in Pull Request #780.
Percent encoding issue for long Chinese strings using URL parameter encoding.
- Fixed by Christian Noon in regards to Issue #206.

2.0.1

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

Updated

The CocoaPods installation instructions in the README.
- Updated by Christian Noon.
The Carthage installation instructions in the README.
- Updated by Gustavo Barbosa in Pull Request #759.

Fixed

The link to the 2.0 migration guide in the README.
- Fixed by Dwight Watson in Pull Request #750.
Issue where NTLM authentication credentials were not used for authentication challenges.
- Fixed by Christian Noon in regards to Issue #721.

2.0.0

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

Added

A new URLEncodedInURL case to the ParameterEncoding for encoding in the URL.
- Added by Christian Noon in Pull Request #742.

2.0.0-beta.4

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

Added

The parameters and encoding parameters to download APIs.
- Added by Christian Noon in regards to Issue #719.
Section to the README about wildcard domain matching with server trust policies.
- Added by Sai in Pull Request #718.
A UTF-8 charset to Content-Type header for a URL encoded body.
- Added by Cheolhee Han in Pull Request #731.
Tests around posting unicode parameters with URL encoding.
- Added by Christian Noon in regards to Pull Request #731.
Tests for uploading base 64 encoded image data inside JSON.
- Added by Christian Noon in regards to Issue #738.
An Alamofire 2.0 migration guide document to the new Documentation folder.
- Added by Christian Noon.
A Migration Guides section to the README with link to 2.0 guide.
- Added by Christian Noon.

Updated

Response serialization to prevent unnecessary call to response serializer.
- Updated by Julien Ducret in Pull Request #716.
Travis-CI yaml file to support iOS 9, OSX 10.11 and Xcode 7.
- Updated by Christian Noon.
Result types to store an ErrorType instead of NSError.
- Updated by Christian Noon in regards to Issue #732.
Docstrings on the download method to be more accurate.
- Updated by Christian Noon.
The README to require Xcode 7 beta 6.
- Updated by Christian Noon.
The background session section of the README to use non-deprecated API.
- Updated by David F. Muir V in Pull Request #724.
The playground to use the Result type.
- Updated by Jonas Schmid in Pull Request #726.
Updated progress code samples in the README to show how to call onto the main queue.
- Updated by Christian Noon.

Removed

The AFNetworking sections from the FAQ in the README.
- Removed by Christian Noon.

Fixed

Issue on Windows where the wildcarded cert name in the test suite included asterisk.
- Fixed by Christian Noon in regards to Issue #723.
Crash when multipart form data was uploaded from in-memory data on background session.
- Fixed by Christian Noon in regards to Issue #740.
Issue where the background session completion handler was not called on the main queue.
- Fixed by Christian Noon in regards to Issue #728.

2.0.0-beta.3

Released on 2015-08-25.

Removed

The override for NSMutableURLRequest for the URLRequestConvertible protocol conformance that could cause unwanted URL request referencing.
- Removed by Christian Noon.

2.0.0-beta.2

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

Added

Host and certificate chain validation section to the README.
- Added by Christian Noon.
Tests verifying configuration headers are sent with all configuration types.
- Added by Christian Noon in regards to Issue #692.
New rdar to the list in the README about the #available check issue.
- Added by Christian Noon.
Override for NSMutableURLRequest for the URLRequestConvertible protocol.
- Added by Christian Noon.

Updated

The README to note that CocoaPods 0.38.2 is required.
- Updated by Christian Noon in regards to Issue #682.
The README to include note about keeping a reference to the Manager.
- Updated by Christian Noon in regards to Issue #681.
Server trust host validation over to use SSL policy evaluation.
- Updated by Christian Noon.
The documentation for the URLRequestConvertible section in the README.
- Updated by Christian Noon.
The ServerTrustPolicyManager to be more flexible by using public ACL.
- Updated by Jan Riehn in Pull Request #696.
The ServerTrustPolicyManager policies property to use public ACL and added docstrings.
- Updated by Christian Noon.
The Ono response serializer example for Swift 2.0 in the README.
- Updated by Christian Noon in regards to Issue #700.
Result failure case to store an ErrorType instead of NSError.
- Updated by Christian Noon in regards to Issue #703.
All source code to compile with Xcode 7 beta 6.
- Updated by Michael Gray in Pull Request #707.

Removed

The required declaration on the Manager init method.
- Removed by Christian Noon in regards to Issue #672.

Fixed

Issue where the TaskDelegate operation queue would leak if the task was never started.
- Fixed by Christian Noon.
Compiler issue on OS X target when creating background configurations in the test suite.
- Fixed by Christian Noon in regards to Issue #693.

2.0.0-beta.1

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

Added

A watchOS deployment target to the podspec.
- Added by Kyle Fuller in Pull Request #574.
Full screen support in the iOS Example App.
- Added by Corinne Krych in Pull Request #612.
Temporary workaround for SecCertificate array compiler crash.
- Added by Robert Rasmussen in Issue #610.
Result and Error types to refactor response validation and serialization.
- Added by Christian Noon in Pull Request #627.
Tests around response data, string and json serialization result behavior.
- Added by Christian Noon in Pull Request #627.
CustomStringConvertible and CustomDebugStringConvertible conformance to the Result enumeration.
- Added by Christian Noon in Pull Request #648.
A Resume Data section to the README inside the Downloads section.
- Added by Christian Noon in Pull Request #648.
A watchOS framework target to the project.
- Added by Tobias Ottenweller in Pull Request #616.
Result tests pushing code coverage for Result enum to 100%.
- Added by Christian Noon.
Tests around all response serializer usage.
- Added by Christian Noon.
Public docstrings for all public SessionDelegate methods.
- Added by Christian Noon.
A section to the README that calls out all open rdars affecting Alamofire.
- Added by Christian Noon.
Test for wildcard validation that contains response with nil MIME type.
- Added by Christian Noon in Pull Request #662.
Support for stream tasks in iOS 9+ and OSX 10.11+.
- Added by Christian Noon in Pull Request #659.

Updated

All logic to compile against Swift 2.0.
- Updated by Christian Noon.
All logic to use the latest Swift 2.0 conventions.
- Updated by Christian Noon.
All public docstrings to the latest Swift 2.0 syntax.
- Updated by Christian Noon.
URLRequestConvertible to return an NSMutableURLRequest.
- Updated by Christian Noon.
All HTTP requests to HTTPS to better align with ATS.
- Updated by Christian Noon.
The escape method in ParameterEncoding to use non-deprecated methods.
- Updated by Christian Noon.
All source code and docstrings to fit roughly within 120 characters.
- Updated by Christian Noon.
The MultipartFormData encoding to leverage Swift 2.0 error handling.
- Updated by Christian Noon.
All README code samples to match the latest Swift 2.0 API changes.
- Updated by Christian Noon in Pull Request #648.
All frameworks to enable code coverage generation.
- Updated by Christian Noon.
All frameworks to set the enable testability flag to YES for release builds.
- Updated by Christian Noon in regard to Issue #652.
ParameterEncoding to leverage guard for parameters to increase safety.
- Updated by Christian Noon.
iOS Example App to use optional bind around response to safely extract headers.
- Updated by John Pope in Pull Request #665.
The queryComponents and escape methods in ParameterEncoding to public to better support .Custom encoding.
- Updated by Christian Noon in Pull Request #660.
The static error convenience functions to a public ACL.
- Updated by Christian Noon in regards to Issue #668.

Removed

Explicit string values in ParameterEncoding since they are now implied.
- Removed by Christian Noon.
An OSX cookie check in the CustomDebugStringConvertible conformance of a Request.
- Removed by Christian Noon.

Fixed

Issue in automatic validation tests where mutable URL request was not used.
- Fixed by Christian Noon.
Potential crash cases in Validation MIME type logic exposed by chaining.
- Fixed by Christian Noon.
Compiler issue in the iOS Example App around Result type usage.
- Fixed by Jan Kase in Pull Request #639.
The error code in the custom response serializers section of the README.
- Fixed by Christian Noon.

1.3.1

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

Fixed

Issue where a completed task was not released by the SessionDelegate if the task override closure was set.
- Fixed by Christian Noon in regards to Issue #622.

1.3.0

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

Added

Test case around NSURLProtocol checking header passthrough behaviors.
- Added by Christian Noon in regards to Issue #473.
Stream method on Request to receive data incrementally from data responses.
- Added by Peter Sobot in Pull Request #512.
Example to the README demonstrating how to use the responseCollection serializer.
- Added by Josh Brown in Pull Request #532.
Link to the README to the CocoaDocs documentation for Alamofire.
- Added by Robert in Pull Request #541.
Support for uploading MultipartFormData in-memory and streaming from disk.
- Added by Christian Noon in Pull Request #539.
Tests for uploading MultipartFormData with complete code coverage.
- Added by Christian Noon in Pull Request #539.
The iOS 8.4 simulator to the Travis CI builds by switching to the Xcode 6.4 build.
- Added by Syo Ikeda in Pull Request #568.
Tests for the custom header support with complete code coverage.
- Added by Christian Noon in Pull Request #586.
Section to the README about new HTTP header support in the global functions.
- Added by Christian Noon.
Basic auth Authorization header example to the README.
- Added by Christian Noon.
TLS certificate and public key pinning support through the ServerTrustPolicy.
- Added by Christian Noon in Pull Request #581.
Tests for TLS certificate and public key pinning with complete code coverage.
- Added by Christian Noon in Pull Request #581.
Security section to the README detailing various server trust policies.
- Added by Christian Noon in Pull Request #581.
The resumeData property to Request to expose outside data response serializer.
- Added by Christian Noon in Pull Request #595.
Download request sample to iOS example app.
- Added by Kengo Yokoyama in Pull Request #579.

Updated

The INFOPLIST_FILE Xcode project setting to be a relative path.
- Updated by Christian Noon.
Exposed persistence parameter for basic auth credentials.
- Updated by Christian Noon in regard to Issue #537.
The Travis CI builds to run a full pod lib lint pass on the source.
- Updated by Kyle Fuller in Pull Request #542.
All cases of force unwrapping with optional binding and where clause when applicable.
- Updated by Syo Ikeda in Pull Request #557.
The ParameterEncoding encode return tuple to return a mutable URL request.
- Updated by Petr Korolev in Pull Request #478.
The URLRequest convenience method to return a mutable NSURLRequest.
- Updated by Christian Noon.
The request / download / upload methods to support custom headers.
- Updated by Christian Noon in Pull Request #586.
The global request / download / upload method external parameters convention.
- Updated by Christian Noon in Pull Request #586.
Response serialization to use generics and a ResponseSerializer protocol.
- Updated by Christian Noon in Pull Request #593.
Download task delegate to store resume data for a failed download if available.
- Updated by Christian Noon in Pull Request #595.
The TaskDelegate.queue to public to allow custom request extension operations.
- Updated by Christian Noon in Pull Request #590.
The README code samples for Advanced Response Serialization.
- Updated by Christian Noon.

Removed

An unnecessary NSURLSessionConfiguration type declaration that can be inferred.
- Removed by Avismara in Pull Request #576.
Unnecessary respondsToSelector overrides for SessionDelegate methods.
- Removed by Christian Noon in Pull Request #590.
Unnecessary calls to self throughout source, test and example logic.
- Removed by Christian Noon.

Fixed

Random test suite basic auth failures by clearing credentials in setUp method.
- Fixed by Christian Noon.
Error where wildcard was failing due to missing response MIME type.
- Fixed by Christian Noon in Pull Request #598.
Typo in the basic auth headers example code in the README.
- Fixed by 蒲公英の生活 in Pull Request #605.
Issue where the example app was printing elapsed time in optional form.
- Fixed by Christian Noon.

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.

The global request / download / upload external parameter naming conventions were not consistent nor did they match the Manager equivalents. By making them consistent across the board, this introduced the possibility that you "may" need to make slight modifications to your global function calls.
In order to support generic response serializers, the lowest level Request.response method had to be converted to a generic method leveraging the new ResponseSerializer protocol. This has many advantages, the most obvious being that the response convenience method now returns an NSData? optional instead of an AnyObject? optional. Nice!

Please note that every effort is taken to maintain proper semantic versioning. In these two rare cases, it was deemed to be in the best interest of the community to slightly break semantic versioning to unify naming conventions as well as expose a much more powerful form of response serialization.

If you have any issues, please don't hesitate to reach out through GitHub or Twitter.

1.2.3

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

Added

Tests for data task progress closure and NSProgress updates.
- Added by Christian Noon in Pull Request #494.
More robust tests around download and upload progress.
- Added by Christian Noon in Pull Request #494.
More robust redirect tests around default behavior and task override closures.
- Added by Christian Noon in Pull Request #507.
The "[" and "]" to the legal escape characters and added more documentation.
- Added by Christian Noon in Pull Request #504.
Percent escaping tests around reserved / unreserved / illegal characters.
- Added by Christian Noon in Pull Request #504.
Tests for various Cache-Control headers with different request cache policies.
- Added by Christian Noon in Pull Request #505.
Link to Carthage in the README.
- Added by Josh Brown in Pull Request #520.

Updated

iOS 7 instructions to cover multiple Swift files in the README.
- Updated by Sébastien Michoy in regards to Issue #479.
All tests to follow the Given / When / Then structure.
- Updated by Christian Noon in Pull Request #489.
All tests to be crash safe.
- Updated by Christian Noon in Pull Request #489.
The OS X tests so that they are all passing again.
- Updated by Christian Noon in Pull Request #489.
Re-enabled Travis-CI tests for both iOS and Mac OS X.
- Updated by Christian Noon in Pull Request #506.
Travis-CI test suite to run all tests in both debug and release.
- Updated by Christian Noon in Pull Request #506.
Travis-CI test suite to run all tests on iOS 8.1, 8.2 and 8.3 as well as Mac OS X 10.10.
- Updated by Christian Noon in Pull Request #506.
Travis-CI test suite to run pod lib lint against the latest version of CocoaPods.
- Updated by Christian Noon in Pull Request #506.

Fixed

Random deinitialization test failure by handling task state race condition.
- Fixed by Christian Noon.
Typo in the API Parameter Abstraction in the README.
- Fixed by Josh Brown in Pull Request #500.
Cookies are now only applied in the DebugPrintable API when appropriate.
- Fixed by Alex Plescan in Pull Request #516.

1.2.2

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

Added

Contributing Guidelines document to the project.
- Added by Mattt Thompson.
Documentation to the URLStringConvertible protocol around RFC specs.
- Added by Mattt Thompson in regards to Issue #464.
The Carthage/Build ignore flag to the .gitignore file.
- Added by Tomáš Slíž in Pull Request #451.
The .DS_Store ignore flag to the .gitignore file.
- Added by Christian Noon.
Response status code asserts for redirect tests.
- Added by Christian Noon.
A CHANGELOG to the project documenting each official release.
- Added by Christian Noon.

Updated

SessionDelegate override closure properties to match the method signatures.
- Updated by Christian Noon in Pull Request #456.
Documentation for the Printable protocol on Request to reference output stream rather than the specific OutputStreamType.
- Updated by Mattt Thompson.
Deployment targets to iOS 8.0 and OS X 10.9 for the respective frameworks.
- Updated by Christian Noon.
SessionDelegate willPerformHTTPRedirection method to accept optional return type from override closure.
- Updated by Chungsub Kim in Pull Request #469.
Embedded Framework and Source File documentation in the README.
- Updated by Christian Noon in regards to Issue #427.
Alamofire source to be split into multiple core files and feature files.
- Updated by Christian Noon in Pull Request #471.
TaskDelegate override closure signatures and delegate method implementations.
- Updated by Christian Noon.

Removed

Travis-CI build status from the README until Xcode 6.3 is supported.
- Removed by Mattt Thompson.
Unnecessary parentheses from closure parameters and typealiases.
- Removed by Christian Noon.

Fixed

SessionDelegate override closure documentation.
- Fixed by Siemen Sikkema in Pull Request #448.
Some inaccurate documentation on several of the public SessionDelegate closures.
- Fixed by Christian Noon in Pull Request #456.
A deinit race condition where the task delegate queue could fail to dispatch_release.
- Fixed by Christian Noon in Pull Request #379.
TaskDelegate to only set qualityOfService for NSOperationQueue on iOS 8+.
- Fixed by Christian Noon in regards to Issue #472.
Expectation order issue in the redirect tests.
- Fixed by Christian Noon.
DataTaskDelegate behavior ensuring NSProgress values and progress override closures are always updated and executed.
- Fixed by Christian Noon in regards to Issue #407.

1.2.1

Released on 2015-04-21.

Added

Redirect tests for the SessionDelegate.
- Added by Jonathan Hersh in Pull Request #424.
TLS evaluation test case.
- Added by Mattt Thompson.
Additional guards to ensure unique task identifiers for upload and download tasks.
- Added by Mattt Thompson in regards to Issue #393.

Updated

Required Xcode version to Xcode to 6.3 in the README.
- Updated by Mattt Thompson.
SSL validation to use default system validation by default.
- Updated by Michael Thole in Pull Request #394.

1.2.0

Released on 2015-04-09.

Added

New testURLParameterEncodeStringWithSlashKeyStringWithQuestionMarkValueParameter test.
- Added by Mattt Thompson in regards to Issue #370.
New backgroundCompletionHandler property to the Manager called when the session background tasks finish.
- Added by Christian Noon in Pull Request #317.

Updated

Request computed property progress to no longer be an optional type.
- Updated by Pitiphong Phongpattranont in Pull Request #404.
All logic to Swift 1.2.
- Updated by Aron Cedercrantz and Mattt Thompson.
The responseString serializer to respect server provided character encoding with overrideable configuration, default string response serialization to ISO-8859-1, as per the HTTP/1.1 specification.
- Updated by Kyle Fuller and Mattt Thompson in Pull Request #359 which also resolved Issue #358.
SessionDelegate methods to first call the override closures if set.
- Updated by Christian Noon in Pull Request #317.
SessionDelegate and all override closures to a public ACL allowing for customization.
- Updated by Christian Noon in Pull Request #317.
SessionDelegate class to final.
- Updated by Mattt Thompson.
SessionDelegate header documentation for method override properties.
- Updated by Mattt Thompson.
Xcode project to set APPLICATION_EXTENSION_API_ONLY to YES for OS X target.
- Updated by Mattt Thompson.

Removed

Ambiguous response serializer methods that collided with default parameters.
- Removed by Christian Noon in Pull Request #408.
SessionDelegate initializer and replaced with default property value.
- Removed by Mattt Thompson.

Fixed

Async tests where asserts were potentially not being run by by moving expectation.fullfill() to end of closures.
- Fixed by Nate Cook in Pull Request #420.
Small grammatical error in the ParameterEncoding section of the README.
- Fixed by Aaron Brager in Pull Request #416.
Typo in a download test comment.
- Fixed by Aaron Brager in Pull Request #413.
Signature mismatch in the dataTaskDidBecomeDownloadTask override closure.
- Fixed by Christian Noon in Pull Request #317.
Issue in the SessionDelegate where the DataTaskDelegate was not being called.
- Fixed by Christian Noon in Pull Request #317.

1.1.5

Released on 2015-03-26.

Added

Convenience upload functions to the Manager.
- Added by Olivier Bohrer in Pull Request #334.
Info to the README about Swift 1.2 support.
- Added by Mattt Thompson.

Updated

All request / upload / download methods on Manager to match the top-level functions.
- Updated by Mattt Thompson.
The testDownloadRequest to no longer remove the downloaded file.
- Updated by Mattt Thompson.
Ono XML response serializer example in the README.
- Updated by Mattt Thompson.
Travis-CI settings to only build the master branch.
- Updated by Mattt Thompson.
Code signing identities for the frameworks and targets to better support Carthage.
- Updated by Christian Noon in Pull Request #400.
iOS deployment target to iOS 8.0 for iOS target and tests.
- Updated by Christian Noon in Pull Request #401.
Legal characters to be escaped according to RFC 3986 Section 3.4.
- Updated by Stephane Lizeray in Pull Request #370.

Fixed

Travis-CI scheme issue, added podspec linting and added ENV variables.
- Fixed by Jonathan Hersh in Pull Request #351.
Code sample in the README in the Manual Parameter Encoding section.
- Fixed by Petr Korolev in Pull Request #381.

1.1.4

Released on 2015-01-30.

Added

Podspec argument requires_arc to the podspec file.
- Added by Mattt Thompson.
Support for Travis-CI for automated testing purposes.
- Added by Kyle Fuller in Pull Request #279.

Updated

Installation instructions in the README to include CocoaPods, Carthage and Embedded Frameworks.
- Updated by Mattt Thompson.
Travis-CI to use Xcode 6.1.1.
- Updated by Mattt Thompson.
The download method on Manager to use Request.DownloadFileDestination typealias.
- Updated by Alexander Strakovich in Pull Request #318.
RequestTests to no longer delete all cookies in default session configuration.
- Updated by Mattt Thompson.
Travis-CI yaml file to only build the active architecture.
- Updated by Mattt Thompson.
Deployment targets to iOS 7.0 and Mac OS X 10.9.
- Updated by Mattt Thompson.

Removed

The tearDown method in the AlamofireDownloadResponseTestCase.
- Removed by Mattt Thompson.

Fixed

Small formatting issue in the CocoaPods Podfile example in the README.
- Fixed by rborkow in Pull Request #313.
Several issues with the iOS and OSX targets in the Xcode project.
- Fixed by Mattt Thompson.
The testDownloadRequest in DownloadTests by adding .json file extension.
- Fixed by Martin Kavalar in Pull Request #302.
The AlamofireRequestDebugDescriptionTestCase on OSX.
- Fixed by Mattt Thompson.
Spec validation error with CocoaPods 0.36.0.beta-1 by disabling -b flags in cURL debug on OSX.
- Fixed by Mattt Thompson.
Travis-CI build issue by adding suppport for an iOS Example scheme.
- Fixed by Yasuharu Ozaki in Pull Request #322.

1.1.3

Released on 2015-01-09.

Added

Podspec file to support CocoaPods deployment.
- Added by Marius Rackwitz in Pull Request #218.
Shared scheme to support Carthage deployments.
- Added by Yosuke Ishikawa in Pull Request #228.
New target for Alamofire OSX framework.
- Added by Martin Kavalar in Pull Request #293.

Updated

Upload and Download progress state to be updated before calling progress closure.
- Updated by Alexander Strakovich in Pull Request #278.

Fixed

Some casting code logic in the Generic Response Object Serialization example in the README.
- Fixed by Philip Heinser in Pull Request #258.
Indentation formatting of the responseString parameter documentation.
- Fixed by Ah.Miao in Pull Request #291.

1.1.2

Released on 2014-12-21.

Added

POST request JSON response test.
- Added by Mattt Thompson.

Updated

The response object example to use a failable initializer in the README.
- Updated by Mattt Thompson in regards to Issue #230.
Router example in the README by removing extraneous force unwrap.
- Updated by Arnaud Mesureur in Pull Request #247.
Xcode project APPLICATION_EXTENSION_API_ONLY flag to YES.
- Updated by Michael Latta in Pull Request #273.
Default HTTP header creation by moving it into a public class method.
- Updated by Christian Noon in Pull Request #261.

Fixed

Upload stream method to set HTTPBodyStream for streamed request.
- Fixed by Florent Vilmart and Mattt Thompson in Pull Request #241.
ParameterEncoding to compose percent-encoded query strings from percent-encoded components.
- Fixed by Oleh Sannikov in Pull Request #249.
Serialization handling of NSData with 0 bytes.
- Fixed by Mike Owens in Pull Request #254.
Issue where suggestedDownloadDestination parameters were being ignored.
- Fixed by Christian Noon in Pull Request #257.
Crash caused by Manager deinitialization and added documentation.
- Fixed by Mattt Thompson in regards to Issue #269.

1.1.1

Released on 2014-11-20.

Updated

Dispatch-based synchronized access to subdelegates.
- Updated by Mattt Thompson in regards to Pull Request #175.
iOS 7 instructions in the README.
- Updated by Mattt Thompson.
CRUD example in the README to work on Xcode 6.1.
- Updated by John Beynon in Pull Request #187.
The cURL example annotation in the README to pick up bash syntax highlighting.
- Updated by Samuel E. Giddins in Pull Request #208.

Fixed

Out-of-memory exception by replacing stringByAddingPercentEncodingWithAllowedCharacters with CFURLCreateStringByAddingPercentEscapes.
- Fixed by Mattt Thompson in regards to Issue #206.
Several issues in the README examples where an NSURL initializer needs to be unwrapped.
- Fixed by Mattt Thompson in regards to Pull Request #213.
Possible exception when force unwrapping optional header properties.
- Fixed by Mattt Thompson.
Optional cookie entry in cURL output.
- Fixed by Mattt Thompson in regards to Issue #226.
Optional textLabel property on cells in the example app.
- Fixed by Mattt Thompson.

1.1.0

Released on 2014-10-20.

Updated

Project to support Swift 1.1 and Xcode 6.1.
- Updated by Aral Balkan, Ross Kimes, Orta Therox, Nico du Plessis and Mattt Thompson.

1.0.1

Released on 2014-10-20.

Added

Tests for upload and download with progress.
- Added by Mattt Thompson.
Test for question marks in url encoded query.
- Added by Mattt Thompson.
The NSURLSessionConfiguration headers to cURL representation.
- Added by Matthias Ryne Cheow in Pull Request #140.
Parameter encoding tests for key/value pairs containing spaces.
- Added by Mattt Thompson.
Percent character encoding for the + character.
- Added by Niels van Hoorn in Pull Request #167.
Escaping for quotes to support JSON in cURL commands.
- Added by John Gibb in Pull Request #178.
The request method to the Manager bringing it more inline with the top-level methods.
- Added by Brian Smith.

Fixed

Parameter encoding of ampersands and escaping of characters.
- Fixed by Mattt Thompson in regards to Issues #146 and #162.
Parameter encoding of HTTPBody from occurring twice.
- Fixed by Yuri in Pull Request #153.
Extraneous dispatch to background by using weak reference for delegate in response.
- Fixed by Mattt Thompson.
Response handler threading issue by adding a subdelegateQueue to the SessionDelegate.
- Fixed by Essan Parto in Pull Request #171.
Challenge issue where basic auth credentials were not being unwrapped.
- Fixed by Mattt Thompson.

1.0.0

Released on 2014-09-25.

Added

Initial release of Alamofire.
- Added by Mattt Thompson.