Couchbase Lite is a NoSQL database designed for mobile and embedded devices, allowing seamless data management even in offline environments. Today, I’m excited to introduce the new React Native – Native Module for Couchbase Lite, now available in public beta on NPM.
Why React Native with Expo?
Building mobile apps with vanilla React Native can be quite challenging due to the complexities around managing routing, modules, and app infrastructure. This is where frameworks like Expo step in to make development more approachable. Expo has become the most popular framework for React Native apps, and the React Native team now recommends using it for new projects, especially for its rich SDK and ease of use.
Our Native Module is designed to work seamlessly with both Expo and React Native apps. For Expo users, running the app in dev-client mode will give access to native modules, making it easier to integrate with Couchbase Lite. Here’s a detailed installation guide for getting started.
Repository & open source project
You can access the React Native – Native Module for Couchbase Lite repository. Being an open-source project, all the project boards and issues are tracked through GitHub. We encourage developers to check out the project, report issues, and contribute.
A key example is the expo-cbl-travel project, which showcases Couchbase Lite’s features like replication, SQL++ querying, and Full-Text Search (FTS). This project is designed to work with Couchbase Capella App Services. We’ve made it easy for developers by providing a step-by-step guide to set up Couchbase Capella’s Free-Tier for use with the mobile app. You can find the expo-cbl-travel repository 여기. You can watch the walkthrough video here:
A Simple Example with Couchbase Lite
Here’s a brief example of how easy it is to interact with Couchbase Lite using the React Native Module. This demonstrates opening a database, retrieving a document, modifying it, and saving the changes:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 |
가져오기 { Database, DatabaseConfiguration, FileSystem, 가변 문서 } 에서 ‘cbl-reactnative’; //get a file path that you can write the database file to for each platform 상수 fileSystem = 새로운 FileSystem(); 상수 directoryPath = await fileSystem.getDefaultPath(); 상수 dc = 새로운 DatabaseConfiguration(); dc.setDirectory(directoryPath); // Open (or create) a database 상수 데이터베이스 = 새로운 Database(‘myDatabase’, dc); 상수 컬렉션 = await 데이터베이스.createCollection(“myCollection”, “myScope”); //create document 상수 documentId = ‘doc-1’; 상수 mutableDoc = 새로운 가변 문서(documentId); mutableDoc.setString(‘firstName’, ‘Denis’); //save it to the database await 컬렉션.save(mutableDoc); // Get a document by ID 하다 document = 컬렉션.document(documentId); 하다 mutableDoc2 = 가변 문서.fromDocument(document); 만약 (mutableDoc2) { // Modify the document mutableDocument2.setString(‘lastName’, ‘Doe’); mutableDocument2.setInt(‘age‘, 30); // Save the document database.save(mutableDocument2); console.log(‘문서 updated successfully!‘); } 그 외 { 콘솔.로그(`문서 ~와 함께 ID ${documentId} not found.`); } // Close the database when done 데이터베이스.close(); |
In this example:
- A new database called my-database is created (or opened if it already exists)
- We create a Mutable document with the ID doc-1
- We modify the document by adding a firstName field and setting the value
- We then save the document
- Next we get the document back from the database
- If the document exists, we modify its name and age properties
- The modified document is then saved back to the database
This simple code snippet demonstrates the power of Couchbase Lite for handling local data efficiently. More complex scenarios, such as querying data, handling replication, or using Full-Text Search (FTS), can be explored through our 문서화.
Current issues and future enhancements
We are actively working to address known issues:
- Change listeners: We are currently fixing issues which will make change listeners functional in the next update.
- Date Query Parameters on Android: There are minor issues with parsing dates on Android, which we plan to resolve soon.
The public beta version (0.2.0) is currently based on Couchbase Lite 3.1.x, and we’ll be upgrading to Couchbase Lite 3.2 in the near future.
How you can help
We invite developers to try the beta, build sample apps, and provide feedback. Your input is invaluable in helping us identify and fix issues quickly. You can submit issues or suggestions on our GitHub issues page.
댓글 남기기
댓글을 달기 위해서는 로그인해야합니다.