You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
To get started with the AWS SDK for iOS, you can set up the SDK and start building a new project, or you integrate the SDK in an existing project. You can also run the samples to get a sense of how the SDK works.
11
11
@@ -18,7 +18,7 @@ At the AWS GitHub repo, you can check out the [SDK source code](https://github.c
18
18
19
19
For more information, see [AWS Mobile SDK for iOS Developer Guide](http://docs.aws.amazon.com/mobile/sdkforios/developerguide/).
20
20
21
-
##Include the SDK for iOS in an Existing Application
21
+
##Include the SDK for iOS in an Existing Application
22
22
23
23
The [samples](https://github.com/awslabs/aws-sdk-ios-samples) included with the SDK for iOS are standalone projects that are already set up for you. You can also integrate the SDK for iOS with your own existing project. There are three ways to import the AWS Mobile SDK for iOS into your project:
24
24
@@ -28,7 +28,7 @@ The [samples](https://github.com/awslabs/aws-sdk-ios-samples) included with the
28
28
29
29
You should use one of these three ways to import the AWS Mobile SDK but not multiple. Importing the SDK in multiple ways loads duplicate copies of the SDK into the project and causes compiler errors.
30
30
31
-
###CocoaPods
31
+
###CocoaPods
32
32
33
33
1. The AWS Mobile SDK for iOS is available through [CocoaPods](http://cocoapods.org). If you have not installed CocoaPods, install CocoaPods by running the command:
34
34
@@ -82,7 +82,7 @@ You should use one of these three ways to import the AWS Mobile SDK but not mult
82
82
ld: library not found for -lPods-AWSCore
83
83
clang: error: linker command failed with exit code 1 (use -v to see invocation)
84
84
85
-
###Carthage
85
+
###Carthage
86
86
87
87
1. Install the latest version of [Carthage](https://github.com/Carthage/Carthage#installing-carthage).
88
88
@@ -129,7 +129,7 @@ You should use one of these three ways to import the AWS Mobile SDK but not mult
129
129
Input Files: Empty
130
130
Output Files: Empty
131
131
132
-
###Frameworks
132
+
###Frameworks
133
133
134
134
1. Download the SDK from our [AWS Mobile SDK](http://aws.amazon.com/mobile/sdk) page. The SDK is stored in a compressed file archive named `aws-ios-sdk-#.#.#` (where `#.#.#` represents the version number, so for version 2.5.0, the filename is `aws-ios-sdk-2.5.0`).
135
135
@@ -168,11 +168,11 @@ You should use one of these three ways to import the AWS Mobile SDK but not mult
168
168
Input Files: Empty
169
169
Output Files: Empty
170
170
171
-
##Update the SDK to a Newer Version
171
+
##Update the SDK to a Newer Version
172
172
173
173
When we release a new version of the SDK, you can pick up the changes as described below.
174
174
175
-
###CocoaPods
175
+
###CocoaPods
176
176
177
177
1. Run the following command in your project directory. CocoaPods automatically picks up the new changes.
178
178
@@ -182,13 +182,13 @@ When we release a new version of the SDK, you can pick up the changes as describ
1. Run the following command in your project directory. Carthage automatically picks up the new changes.
188
188
189
189
$ carthage update
190
190
191
-
###Frameworks
191
+
###Frameworks
192
192
193
193
1. In Xcode select the following frameworks in **Project Navigator** and hit **delete** on your keyboard. Then select **Move to Trash**:
194
194
@@ -213,7 +213,7 @@ When we release a new version of the SDK, you can pick up the changes as describ
213
213
214
214
1. Follow the installation process above to include the new version of the SDK.
215
215
216
-
##Preparing your apps for iOS 9
216
+
##Preparing your apps for iOS 9
217
217
The release of iOS 9 includes changes that might impact how your apps interact with some AWS services. If you compile your apps with Apple’s iOS 9 SDK (or Xcode 7), Apple’s [App Transport Security (ATS)](https://developer.apple.com/library/prerelease/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html) feature may affect the ability of apps to connect to certain AWS service endpoints. In order to ensure affected apps continue to successfully connect to AWS endpoints, you’ll need to configure them to interact properly with Apple’s ATS by adding these properties to your `Info.plist` file:
218
218
219
219
<key>NSAppTransportSecurity</key>
@@ -243,7 +243,7 @@ The release of iOS 9 includes changes that might impact how your apps interact w
243
243
244
244
For more information, see [Preparing Your Apps for iOS 9](http://docs.aws.amazon.com/mobile/sdkforios/developerguide/ats.html).
245
245
246
-
##Getting Started with Swift
246
+
##Getting Started with Swift
247
247
248
248
1. Import the AWSCore header in the application delegate.
249
249
@@ -288,7 +288,7 @@ For more information, see [Preparing Your Apps for iOS 9](http://docs.aws.amazon
288
288
289
289
**Note**: Most of the service client classes have a singleton method to get a default client. The naming convention is `+ defaultSERVICENAME` (e.g. `+ defaultDynamoDB` in the above code snippet). This singleton method creates a service client with `defaultServiceConfiguration`, which you set up in step 5, and maintains a strong reference to the client.
290
290
291
-
##Getting Started with Objective-C
291
+
##Getting Started with Objective-C
292
292
293
293
1. Import the AWSCore header in the application delegate.
294
294
@@ -326,11 +326,11 @@ For more information, see [Preparing Your Apps for iOS 9](http://docs.aws.amazon
326
326
327
327
**Note**: Most of the service client classes have a singleton method to get a default client. The naming convention is `+ defaultSERVICENAME` (e.g. `+ defaultS3TransferManager` in the above code snippet). This singleton method creates a service client with `defaultServiceConfiguration`, which you set up in step 5, and maintains a strong reference to the client.
328
328
329
-
##AWSTask
329
+
##AWSTask
330
330
331
331
With native AWSTask support in the SDK for iOS, you can chain async requests instead of nesting them. It makes the logic cleaner, while keeping the code more readable. Read [Working with AWSTask](http://docs.aws.amazon.com/mobile/sdkforios/developerguide/awstask.html) to learn how to use AWSTask.
332
332
333
-
##Logging
333
+
##Logging
334
334
335
335
Changing log levels during development may make debugging easier. You can change the log level by importing AWSCore.h and calling:
336
336
@@ -362,80 +362,80 @@ The following logging level options are available:
362
362
363
363
We recommend setting the log level to `None` before publishing to the Apple App Store.
364
364
365
-
##Sample Apps
365
+
##Sample Apps
366
366
367
367
The AWS SDK for iOS includes sample apps that demonstrate common use cases.
368
368
369
-
###Cognito Your User Pools Sample ([Swift](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/CognitoYourUserPools-Sample/Swift/), [Objective-C](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/CognitoYourUserPools-Sample/Objective-C/))
369
+
###Cognito Your User Pools Sample ([Swift](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/CognitoYourUserPools-Sample/Swift/), [Objective-C](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/CognitoYourUserPools-Sample/Objective-C/))
370
370
371
371
This sample demonstrates how sign up and sign in a user to display an authenticated portion of your app.
This sample demonstrates how to securely manage and sync your mobile app data and create unique identities via login providers including Facebook, Google, and Login with Amazon.
###S3 Transfer Manager Sample ([Swift](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/S3TransferManager-Sample/Swift/), [Objective-C](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/S3TransferManager-Sample/Objective-C/))
391
+
###S3 Transfer Manager Sample ([Swift](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/S3TransferManager-Sample/Swift/), [Objective-C](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/S3TransferManager-Sample/Objective-C/))
392
392
393
393
This sample demonstrates how to upload / download multiple files simultaneously using S3 Transfer Manager. It also shows how to pause, resume, and cancel file upload / download.
###SNS Mobile Push and Mobile Analytics Sample ([Swift](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/SNS-MobileAnalytics-Sample/Swift/), [Objective-C](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/SNS-MobileAnalytics-Sample/Objective-C/))
410
+
###SNS Mobile Push and Mobile Analytics Sample ([Swift](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/SNS-MobileAnalytics-Sample/Swift/), [Objective-C](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/SNS-MobileAnalytics-Sample/Objective-C/))
411
411
412
412
This sample demonstrates how to set up Amazon SNS Mobile Push and record events using Amazon Mobile Analytics.
413
413
414
-
####AWS Services Demonstrated:
414
+
####AWS Services Demonstrated:
415
415
416
416
*[Amazon SNS Mobile Push](http://aws.amazon.com/sns/)
417
417
*[Amazon Mobile Analytics](http://aws.amazon.com/mobileanalytics/)
###IoT Temperature Control Sample ([Swift](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/IoTTemperatureControl-Sample/Swift/))
429
+
###IoT Temperature Control Sample ([Swift](https://github.com/awslabs/aws-sdk-ios-samples/tree/master/IoTTemperatureControl-Sample/Swift/))
430
430
431
431
This sample demonstrates accessing device shadows using Cognito authentication; it works in conjunction with the Temperature Control Example Program in the [AWS IoT JavaScript SDK for Embedded Devices](https://github.com/aws/aws-iot-device-sdk-js).
The AWS Mobile SDK for iOS zip file includes documentation in the DocSets format that you can view within Xcode. The easiest way to install the documentation is to use the Mac OS X terminal.
441
441
@@ -455,14 +455,14 @@ The AWS Mobile SDK for iOS zip file includes documentation in the DocSets format
455
455
456
456
1. If Xcode was running during this procedure, restart Xcode. To browse the documentation, go to **Help**, click **Documentation and API Reference**, and select **AWS Mobile SDK for iOS v2.5.0 Documentation** (where '2.5.0' is the appropriate version number).
457
457
458
-
##Talk to Us
458
+
##Talk to Us
459
459
460
460
Visit our GitHub [Issues](https://github.com/aws/aws-sdk-ios/issues) to leave feedback and to connect with other users of the SDK.
0 commit comments