Use AWS SDK

Amplify Android v1 is now in Maintenance Mode until May 31st, 2024. This means that we will continue to include updates to ensure compatibility with backend services and security. No new features will be introduced in v1.

Please use the latest version (v2) of Amplify Library for Android to get started.

If you are currently using v1, follow these instructions to upgrade to v2.

Amplify libraries should be used for all new cloud connected applications. If you are currently using the AWS Mobile SDK for Android, you can access the documentation here.

For advanced use cases where Amplify does not provide the functionality you're looking for, you can retrieve the escape hatch to access the underlying SDK.

The escape hatch provides access to the underlying AWSMobileClient instance.

1AWSMobileClient mobileClient = (AWSMobileClient) Amplify.Auth.getPlugin("awsCognitoAuthPlugin").getEscapeHatch();

1val cognitoAuthPlugin = Amplify.Auth.getPlugin("awsCognitoAuthPlugin")
2val mobileClient = cognitoAuthPlugin.escapeHatch as AWSMobileClient

1val cognitoAuthPlugin = Amplify.Auth.getPlugin("awsCognitoAuthPlugin")
2val mobileClient = cognitoAuthPlugin.escapeHatch as AWSMobileClient

1AWSMobileClient mobileClient =
2    (AWSMobileClient) RxAmplify.Auth.getPlugin("awsCognitoAuthPlugin").getEscapeHatch();

You can use the escape hatch to federatedSignIn with a valid token from other social providers. Find more details here

1mobileClient.federatedSignIn(IdentityProvider.FACEBOOK.toString(), "<FACEBOOK_TOKEN_HERE>", new Callback<UserStateDetails>() {
2    @Override
3    public void onResult(final UserStateDetails userStateDetails) {
4        //Handle the result
5    }
6
7    @Override
8    public void onError(Exception e) {
9        Log.e(TAG, "sign-in error", e);
10    }
11});

Listen to auth events

Under the hood