AWS SDK for Swift Developer Guide
What is the Amazon SDK for Swift?
Welcome to the AWS SDK for Swift, a pure Swift SDK that makes it easier to
develop tools that take advantage of AWS services, including Amazon S3,
Amazon EC2, DynamoDB, and more, all using the Swift
Prerelease documentation
This is prerelease documentation for an SDK in preview release. It may be incomplete and is subject to change.
In addition, versions of the SDK prior to version 1.0.0 may have flaws, and no guarantee is made about the API’s stability. Changes can and will occur that break compatibility during the prerelease stage. These releases are not intended for use in production code!
Supported targets
Platform | Operating system(s) | Processor | Notes |
---|---|---|---|
Apple (Darwin) | macOS, iOS/iPadOS, tvOS, watchOS, and visionOS. | Intel/x86 (macOS and Simulator) and Apple Silicon (ARM). | All Apple targets support 64-bit only. The only exception is watchOS, which also supports the hybrid 64/32-bit processors used in the Series 1 through Series 3 Apple watches. |
Linux | Amazon Linux 2 and Ubuntu. | Intel/x86. | The SDK may build and function on ARM distributions, but this is not currently supported by Amazon Web Services. |
AWS Lambda | Amazon Linux 2 | Intel/x86. |
The AWS SDK for Swift is not currently built, tested, or supported on Microsoft Windows. Support for Windows targets could be added in the future if customer demand warrants it.
Get started with the SDK
To get started with the SDK, follow the Get started with the SDK for Swift tutorial.
To set up your development environment, see Setting up. Then you can test drive the SDK for Swift by creating your first project in Getting started with the AWS SDK for Swift.
For information on making requests to Amazon S3, DynamoDB, Amazon EC2, and other AWS services, see Use the SDK for Swift.
About this guide
The AWS SDK for Swift Developer Guide covers how to install, configure, and use the preview release of the AWS SDK for Swift to create applications and tools in Swift that make use of AWS services.
This guide contains the following sections:
- Set up the AWS SDK for Swift
-
Covers installing the Swift toolchain if you don’t already have it installed and configuring your system for use with the SDK and to have access to your AWS account for development and testing purposes.
- Get started with the SDK for Swift
-
Explains how to create a project that imports the SDK for Swift using the Swift Package Manager in a shell environment on Linux and macOS, as well as how to add the SDK package to an Xcode project. Also included is a guide to building a project that uses the SDK to output a list of a user's Amazon Simple Storage Service buckets.
- Use the SDK for Swift
-
Guides covering typical usage scenarios including creating service clients, performing common tasks, and more.
- SDK for Swift code examples
-
Code examples demonstrating how to use various features of the SDK for Swift, as well as how to achieve specific tasks using the SDK.
- Security in AWS SDK for Swift
-
Guides covering security topics in general, as well as considerations surrounding using the SDK for Swift in various contexts and while performing specific tasks.
- Document history for the AWS SDK for Swift Developer Guide
-
History of this document and of the SDK.
Maintenance and support for SDK major versions
For information about maintenance and support for SDK major versions and their underlying dependencies, see the following in the AWS SDKs and Tools Reference Guide.
Additional resources
In addition to this guide, the following are valuable online resources for AWS SDK for Swift developers:
Contributing to the SDK
Developers can also contribute feedback through the following channels: