https://github.com/couchbase-examples/android-java-cblite-userprofile-sync
Quickstart in Couchbase Lite using a standalone database with Android and Java. This tutorial will show you how to use Sync Gateway to sync information between your local database and Couchbase Server.
https://github.com/couchbase-examples/android-java-cblite-userprofile-sync
android android-java couchbase couchbase-lite couchbase-mobile java mobile
Last synced: about 1 month ago
JSON representation
Quickstart in Couchbase Lite using a standalone database with Android and Java. This tutorial will show you how to use Sync Gateway to sync information between your local database and Couchbase Server.
- Host: GitHub
- URL: https://github.com/couchbase-examples/android-java-cblite-userprofile-sync
- Owner: couchbase-examples
- License: mit
- Created: 2022-01-11T16:48:57.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-03T04:02:20.000Z (almost 2 years ago)
- Last Synced: 2024-05-03T19:18:28.612Z (almost 2 years ago)
- Topics: android, android-java, couchbase, couchbase-lite, couchbase-mobile, java, mobile
- Language: Java
- Homepage: https://developer.couchbase.com/tutorial-quickstart-android-java-sync
- Size: 1.2 MB
- Stars: 2
- Watchers: 9
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/couchbase-examples/android-java-cblite-userprofile-sync/actions/workflows/build-workflow.yml)
# Quickstart in Couchbase Lite Data Sync with Android and Java
#### Build an Android App in Java with Couchbase Lite
Couchbase Sync Gateway is a key component of the Couchbase Mobile stack. It is an internet-facing synchronization mechanism that securely syncs data across devices as well as between devices and the cloud. Couchbase Mobile is built upon a websocket based [replication protocol](https://blog.couchbase.com/data-replication-couchbase-mobile/).
The core functions of the Sync Gateway includes:
- Data Synchronization across devices and the cloud
- Authorization
- Access Control
- Data Validation
> This repo is designed to show you an app that allows users to log in and make changes to their user profile information. User profile information is persisted as a Document in the local Couchbase Lite Database. When the user logs out and logs back in again, the profile information is loaded from the Database.
Full documentation can be found on the [Couchbase Developer Portal](https://developer.couchbase.com/tutorial-quickstart-android-java-sync/).
## Prerequisites
To run this prebuilt project, you will need:
- [Android Studio Chimpmuck or above](https://developer.android.com/studio)
- [Android Studio Giraffe or above](https://developer.android.com/studio)
- Android device or emulator running API level 24 or above
- Android SDK installed and setup (> v.34.0.0)
- Android Build Tools (> v.34.0.0)
- JDK 17 (now embedded into Android Studio)
### Installing Couchbase Lite Framework
- This project already contains the appropriate additions for downloading and utilizing the Android Couchbase Lite dependency module. However, in the future, to include Couchbase Lite support within an Android app add the following within the gradle settings file (src/gradle.settings)
```
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
maven { url "https://mobile.maven.couchbase.com/maven2/dev/" } // << add this repository
google()
mavenCentral()
}
}
```
* next, be sure you are using the most recent release of Couchbase Lite Mobile for Android. In the module build file (src/app/build.gradle) check this line to verify that the version number is correct:
```
dependencies {
...
implementation 'com.couchbase.lite:couchbase-lite-android-ee:3.1.2'
}
```
## App Architecture
The sample app follows the [MVP pattern](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93presenter), separating the internal data model, from a passive view through a presenter that handles the logic of our application and acts as the conduit between the model and the view
## Try it out
* **Open src/build.gradle using Android Studio.**
* Build and run the project.
* Verify that you see the login screen.
## Conclusion
This code is an example of how to use a Sync Gateway to synchronize data between Couchbase Lite enabled clients. The [Couchbase Developer Portal](https://developer.couchbase.com/tutorial-quickstart-android-java-sync/) tutorial will discuss how to configure your Sync Gateway to enforce relevant access control, authorization and data routing between Couchbase Lite enabled clients.