{"id":23770886,"url":"https://github.com/aws-amplify/amplify-android","last_synced_at":"2025-05-15T02:06:07.744Z","repository":{"id":37285681,"uuid":"177009933","full_name":"aws-amplify/amplify-android","owner":"aws-amplify","description":"The fastest and easiest way to use AWS from your Android app.","archived":false,"fork":false,"pushed_at":"2025-05-12T18:20:31.000Z","size":65742,"stargazers_count":260,"open_issues_count":91,"forks_count":123,"subscribers_count":50,"default_branch":"main","last_synced_at":"2025-05-12T18:24:35.590Z","etag":null,"topics":["amplify","android","aws","aws-amplify"],"latest_commit_sha":null,"homepage":"https://docs.amplify.aws/lib/q/platform/android/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aws-amplify.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-03-21T19:19:24.000Z","updated_at":"2025-05-06T16:36:03.000Z","dependencies_parsed_at":"2024-02-05T15:59:55.228Z","dependency_job_id":"a0434a07-5788-4bf8-bb5d-a3aa14fdeadb","html_url":"https://github.com/aws-amplify/amplify-android","commit_stats":null,"previous_names":[],"tags_count":274,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-amplify%2Famplify-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-amplify%2Famplify-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-amplify%2Famplify-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-amplify%2Famplify-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws-amplify","download_url":"https://codeload.github.com/aws-amplify/amplify-android/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254259370,"owners_count":22040819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amplify","android","aws","aws-amplify"],"created_at":"2025-01-01T03:17:19.911Z","updated_at":"2025-05-15T02:06:07.739Z","avatar_url":"https://github.com/aws-amplify.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"## Amplify for Android\n\u003cimg src=\"https://s3.amazonaws.com/aws-mobile-hub-images/aws-amplify-logo.png\" alt=\"AWS Amplify\" width=\"550\"\u003e\n\n[![DiscordChat](https://img.shields.io/discord/308323056592486420?logo=discord)](https://discord.gg/jWVbPfC)\n[![GitHub release](https://img.shields.io/github/release/aws-amplify/amplify-android.svg)](https://github.com/aws-amplify/amplify-android/releases)\n[![Maven Central](https://img.shields.io/maven-central/v/com.amplifyframework/core.svg)](https://search.maven.org/search?q=g:com.amplifyframework%20a:core)\n-------------------------------------------------------\n\nThe Amplify Android library is AWS' preferred mechanism for interacting\nwith AWS services from an Android device.\n\nThe library provides a high-level interface to perform different\n**categories** of cloud operations. Each category may be fulfilled by a\n**plugin**, which you configure during setup.\n\nThe default plugins that we provide are designed to facilitate\ninteraction with Amazon Web Services (AWS). But, the Amplify Framework\nis designed to be extensible to any other backend or service.\n\nTo familiarize yourself with Amplify, checkout our [Getting Started\nGuide](https://docs.amplify.aws/start/q/integration/android).\n\n## Categories\n\n| Category                                                                                                     | AWS Provider | Description                                                                                   |\n|--------------------------------------------------------------------------------------------------------------|--------------|-----------------------------------------------------------------------------------------------|\n| **[Authentication](https://docs.amplify.aws/lib/devpreview/getting-started/q/platform/android)**             | Cognito      | Building blocks to create auth experiences                                                    |\n| **[Storage](https://docs.amplify.aws/lib/storage/getting-started/q/platform/android)**                       | S3           | Manages content in public, protected, private storage buckets                                 |\n| **[DataStore](https://docs.amplify.aws/lib/datastore/getting-started/q/platform/android)**                   | AppSync      | Programming model for shared and distributed data, with simple online/offline synchronization |\n| **[API (GraphQL)](https://docs.amplify.aws/lib/graphqlapi/getting-started/q/platform/android)**              | AppSync      | Interact with your GraphQL or AppSync endpoint                                                |\n| **[API (REST)](https://docs.amplify.aws/lib/restapi/getting-started/q/platform/android)**                    | API Gateway  | Sigv4 signing and AWS auth for API Gateway and other REST endpoints                           |\n| **[Analytics](https://docs.amplify.aws/lib/analytics/getting-started/q/platform/android)**                   | Pinpoint     | Collect Analytics data for your app including tracking user sessions                          |\n| **[Geo](https://docs.amplify.aws/lib/geo/getting-started/q/platform/android)**                               | Location     | Add maps to your app with APIs and map UI components                                          |\n| **[Predictions](https://docs.amplify.aws/lib/predictions/getting-started/q/platform/android)**               | Various*     | Connect your app with machine learning services like NLP, computer vision, TTS, and more.     |\n| **[Push Notifications](https://docs.amplify.aws/lib/push-notifications/getting-started/q/platform/android)** | Pinpoint     | Segment users, trigger push notifications, and record metrics                                 |\n\n\\* Predictions utilizes a range of Amazon's Machine Learning services,\nincluding: Amazon Comprehend, Amazon Polly, Amazon Rekognition, Amazon\nTextract, and Amazon Translate.\n\nAll services and features not listed above are supported via the [Kotlin SDK](https://github.com/awslabs/aws-sdk-kotlin) or if supported by a category can be accessed via the Escape Hatch like below:\n\n### Kotlin\n\n```kotlin\nval s3StoragePlugin = Amplify.Storage.getPlugin(\"awsS3StoragePlugin\")\nval s3Client = s3StoragePlugin.escapeHatch as S3Client\n```\n\n### Java\n\n```java\nAWSS3StoragePlugin plugin = (AWSS3StoragePlugin) Amplify.Storage.getPlugin(\"awsS3StoragePlugin\");\nS3Client s3Client = plugin.getEscapeHatch();\n```\n\n## Platform Support\n\nThe Amplify Framework supports Android API level 24 (Android 7.0) and above.\n\n## Using Amplify from Your App\n\nFor step-by-step setup instructions, checkout our [Project Setup\nguide](https://docs.amplify.aws/lib/project-setup/prereq/q/platform/android).\n\n### Specifying Gradle Dependencies\n\nTo begin, include Amplify from your `app` module's `build.gradle`\ndependencies section:\n\n```groovy\ndependencies {\n    // Only specify modules that provide functionality your app will use\n    implementation 'com.amplifyframework:aws-analytics-pinpoint:2.27.3'\n    implementation 'com.amplifyframework:aws-api:2.27.3'\n    implementation 'com.amplifyframework:aws-auth-cognito:2.27.3'\n    implementation 'com.amplifyframework:aws-datastore:2.27.3'\n    implementation 'com.amplifyframework:aws-predictions:2.27.3'\n    implementation 'com.amplifyframework:aws-storage-s3:2.27.3'\n    implementation 'com.amplifyframework:aws-geo-location:2.27.3'\n    implementation 'com.amplifyframework:aws-push-notifications-pinpoint:2.27.3'\n}\n```\n\n### Java 8 Requirement\n\nAmplify Android _requires_ Java 8 features. Please add a `compileOptions`\nblock inside your app's `build.gradle`, as below:\n\n```gradle\nandroid {\n    compileOptions {\n        coreLibraryDesugaringEnabled true\n        sourceCompatibility JavaVersion.VERSION_11\n        targetCompatibility JavaVersion.VERSION_11\n    }\n}\n```\nIn the same file, add core library desugaring in your `dependencies`\nblock:\n```gradle\ndependencies {\n    // Add this line\n    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.0.10'\n}\n```\n\n### Kotlin \u0026 Rx Support\n\nAmplify's default interface renders results through async callbacks. We also provide optional, adapter APIs which better integrate with RxJava and Kotlin:\n\n - [Using RxJava with Amplify](https://docs.amplify.aws/lib/project-setup/rxjava/q/platform/android)\n - [Kotlin Coroutines Support](https://docs.amplify.aws/lib/project-setup/coroutines/q/platform/android)\n\n### Semantic versioning\n\nWe follow [semantic versioning](https://semver.org/) for our releases.\n\n#### Semantic versioning and enumeration cases\n\nWhen Amplify adds a new a new enumeration class entry or sealed class subtype, we\nwill publish a new **minor** version of the library.\n\nApplications that use a `when` expression to evaluate all members of an enumerated\ntype can add an `else` branch to prevent new cases from causing compile warnings\n or errors.\n\n#### Semantic versioning and dependencies update\n\nWe follow [semantic versioning for updating our dependencies](https://semver.org/#what-should-i-do-if-i-update-my-own-dependencies-without-changing-the-public-api). This includes updating the Kotlin language version.\n\n## License\n\nThis library is licensed under the [Apache 2.0 License](./LICENSE).\n\n## Report a Bug\n\n[![Open Bugs](https://img.shields.io/github/issues/aws-amplify/amplify-android/bug?color=d73a4a\u0026label=bugs)](https://github.com/aws-amplify/amplify-android/issues?q=is%3Aissue+is%3Aopen+label%3Abug)\n[![Open Questions](https://img.shields.io/github/issues/aws-amplify/amplify-android/question?color=558dfd\u0026label=questions)](https://github.com/aws-amplify/amplify-android/issues?q=is%3Aissue+label%3A%22question%22+is%3Aopen)\n[![Feature Requests](https://img.shields.io/github/issues/aws-amplify/amplify-android/feature-request?color=ff9001\u0026label=feature%20requests)](https://github.com/aws-amplify/amplify-android/issues?q=is%3Aissue+label%3A%22feature-request%22+is%3Aopen+)\n[![Closed Issues](https://img.shields.io/github/issues-closed/aws-amplify/amplify-android?color=%2325CC00)](https://github.com/aws-amplify/amplify-android/issues?q=is%3Aissue+is%3Aclosed+)\n\nWe appreciate your feedback – comments, questions, and bug reports. Please\n[submit a GitHub issue](https://github.com/aws-amplify/amplify-android/issues),\nand we'll get back to you.\n\n## Contribute to the Project\n\nWe welcome any and all contributions from the community! Make sure you read through our [Contribution Guidelines](./CONTRIBUTING.md) before submitting any PR's. Thanks! ♥️\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-amplify%2Famplify-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws-amplify%2Famplify-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-amplify%2Famplify-android/lists"}