AWS Mobile App Sync Starter App for Android
This is a Starter application for using the Sample app in the AWS AppSync console when building your GraphQL API. The Sample app creates a GraphQL schema and provisions Amazon DynamoDB resources, then connects them appropriately with Resolvers. The application demonstrates GraphQL Mutations, Queries, and Offline support using AWS AppSync. You can use this for learning purposes or adapt either the application or the GraphQL Schema to meet your needs.
- GraphQL Mutations
- Create new events
- Create comments on existing events
- GraphQL Queries
- Get all events
- Get an event by Id
- Authorization
- The app uses API Key as the authorization mechanism
-
Navigate to the AWS AppSync console using the URL: http://console.aws.amazon.com/appsync/home
-
Click on
Create API
and select theSample Schema
option. Enter a API name of your choice. ClickCreate
.
-
Clone this repository:
git clone https://github.com/aws-samples/aws-mobile-appsync-events-starter-android.git
-
Open Android Studio, choose
Import project
navigate to the repository folder that was cloned and select open. -
Inside Android Studio, choose the menu
Tools > Android > Sync Project with Gradle Files
to ensure gradle is up to date and wait until this completes. -
From the homepage of your GraphQL API (you can click the name you entered in the left hand navigation) wait until the progress bar at the top has completed deploying your resources.
On this same page, the
API Details
box at the top of the page will contain theAPI URL
andAPI Key
that you will paste into theConstants.java
file.
Java code is generated from a schema file (./app/src/main/graphql/com/amazonaws/demo/appsync/schema.json
) and a .graphql file (/app/src/main/graphql/com/amazonaws/demo/appsync/events.graphql
) based on your API. The generated source is in the ./app/build/generated/source/appsync
folder of this project after a build is completed.
If you update your schema in the future, you will find updated versions of these in the AWS AppSync console under the homepage for your GraphQL API when you click the Android
tab.
- The
ListEventsActivity.java
file lists all the events accessible to the user. It returns data from the offline cache first if available and later fetches it from remote to update the local cache.
- The
ViewEventActivity.java
file lists information about an event and allows new comments to be added. New comments to the event are added while the user is viewing the event via subscriptions.
- The
AddEventActivity.java
file creates a new event using the details entered on screen.
This library is licensed under the Amazon Software License.