AWS SDK for React Native (developer preview)
JavaScript Java Objective-C Python
Switch branches/tags
Nothing to show
Clone or download

README.md

Attention: Please use the AWS Amplify library for React Native development of new projects on AWS.

We've also released a React Native starter kit at https://github.com/awslabs/aws-mobile-react-native-starter. This kit demonstrates a working React Native app with the following services:

  • Amazon Cognito User Pools
  • Amazon Cognito Federated Identities
  • Amazon API Gateway
  • AWS Lambda
  • Amazon DynamoDB
  • Amazon S3
  • AWS Mobile Hub

This developer preview is currently under review and we will be looking to merge the contents in the future under a single repository for all AWS React Native functionality. In the meantime, we recommend you leverage the AWS Amplify library or the AWS JavaScript SDK with React Native support.

-- AWS team (November 18th, 2017)


AWS SDK for React Native

We’re excited to offer a developer preview of the AWS SDK for React Native. The SDK includes support for the following services:

  1. Amazon S3 to store user data, including photos and videos, in the cloud. It uses the TransferUtility, which simplifies file transfers between your app and the cloud.
  2. Amazon DynamoDB to store data into a NoSQL database.
  3. AWS Lambda to run serverless code in the cloud without the need for backend infrastructure.
  4. Amazon SNS to send and receive push notifications.

The SDK core uses Amazon Cognito Identity as the authentication provider to comply with best practices for mobile app development.

Contributions

Contributions are welcome! Please report issues using the Github issue tracker. To contribute, submit a pull request to the GitHub repository with a description of your issue or suggested change. If this is a bug fix, please reference the issue and include steps to reproduce it.

Set Up your Environment

  1. Install Xcode, Android Studio, and other dependencies based on the React Native Getting Started guide.
  2. Check out the SDK source code.

Build the SDK

  1. Run npm pack for Core.
  2. Run npm install for each service.

iOS only

  1. Download the AWS Mobile SDK for iOS and extract the frameworks.
  2. For each service, copy the relevant .framework into the iOS/Frameworks folder.
  3. Build each Xcode project. You may need to adjust the header search path.

License

The source code is available under the Apache 2.0 license.