如何在React Native移动应用中轻松集成本地数据库：React Native SQLite Storage完整指南

如何在React Native移动应用中轻松集成本地数据库：React Native SQLite Storage完整指南

【免费下载链接】react-native-sqlite-storageFull featured SQLite3 Native Plugin for React Native (Android and iOS)项目地址: https://gitcode.com/gh_mirrors/re/react-native-sqlite-storage

React Native SQLite Storage是一个功能全面的SQLite3原生插件，专为React Native打造，支持Android（经典和原生模式）、iOS和Windows平台。本文将为你提供一个简单快速的入门指南，帮助你在移动应用中轻松集成本地数据库功能。

🚀 为什么选择React Native SQLite Storage？

React Native SQLite Storage提供了以下核心优势：

• 跨平台支持：iOS和Android通过相同的JavaScript API实现
• 多种操作模式：Android支持纯Java和原生模式
• 完整的SQL事务支持
• 灵活的API：支持普通回调或Promises
• 预填充数据库导入功能：可从应用程序包和沙箱导入
• Windows平台支持：回调API与iOS和Android保持一致

💾 安装React Native SQLite Storage

首先，使用npm安装包：

npm install --save react-native-sqlite-storage

iOS平台配置

对于React Native 0.60及以上版本，只需运行：

cd ios && pod install && cd ..

对于React Native 0.59及以下版本，可使用CocoaPods或手动链接：

使用CocoaPods

在ios项目子目录中的Podfile添加：

pod 'React', :path => '../node_modules/react-native' pod 'react-native-sqlite-storage', :path => '../node_modules/react-native-sqlite-storage'

然后刷新Pods安装：

pod install

手动链接

如果自动链接不起作用，可以手动将SQLite Xcode项目作为依赖项目拖入你的React Native Xcode项目，并配置依赖库。配置完成后，你的项目应如下所示：

Android平台配置

对于React Native 0.60及以上版本，若要使用设备SQLite，无需额外步骤。如果希望使用库自带的SQLite（包含FTS5支持），需在react-native.config.js中添加配置。

对于React Native 0.59及以下版本，需要更新Gradle设置和应用模块Gradle构建脚本，并注册React包。

📱 基本使用方法

启用Promises

要启用Promises支持，运行：

SQLite.enablePromise(true);

打开数据库

// 基本用法 var db = SQLite.openDatabase("test.db", "1.0", "Test Database", 200000, openCB, errorCB); // 高级配置（iOS位置选择） SQLite.openDatabase({name: 'my.db', location: 'default'}, successcb, errorcb);

location选项（仅iOS）：

• default：Library/LocalDatabase子目录（iTunes不可见，iCloud不备份）
• Library：Library子目录（iCloud备份，iTunes不可见）
• Documents：Documents子目录（iTunes可见，iCloud备份）

执行SQL操作

db.transaction((tx) => { tx.executeSql('SELECT * FROM Employees', [], (tx, results) => { console.log("Query completed"); var len = results.rows.length; for (let i = 0; i < len; i++) { let row = results.rows.item(i); console.log(`Employee name: ${row.name}`); } }); });

📂 导入预填充数据库

iOS平台设置步骤

1. 创建'www'文件夹
2. 将预填充的数据库文件复制到'www'文件夹
3. 在XCode中添加文件到项目，确保选择"Create Folder References"选项：

4. 调整openDatabase调用：

// 默认方式 - 文件夹名为www且数据文件与数据库名相同 SQLite.openDatabase({name : "testDB", createFromLocation : 1}, okCallback,errorCallback); // 自定义文件夹或文件名 SQLite.openDatabase({name : "testDB", createFromLocation : "~data/mydbfile.sqlite"}, okCallback,errorCallback);

验证链接库

确保链接的框架和库包含必要的SQLite组件：

🔗 附加其他数据库

SQLite3提供了将另一个数据库附加到现有数据库实例的功能，实现跨数据库JOIN：

let dbMaster, dbSecond; dbSecond = SQLite.openDatabase({name: 'second'}, (db) => { dbMaster = SQLite.openDatabase({name: 'master'}, (db) => { dbMaster.attach( "second", "second", () => console.log("Database attached successfully"), () => console.log("ERROR")) }, (err) => console.log("Error on opening database 'master'", err) ); }, (err) => console.log("Error on opening database 'second'", err) );

查询时使用别名访问附加数据库的表：

SELECT * FROM user INNER JOIN second.subscriptions s ON s.user_id = user.id

📝 总结

React Native SQLite Storage为React Native应用提供了强大的本地数据库解决方案。通过本文的指南，你可以轻松地在iOS和Android应用中集成SQLite功能，实现数据的本地存储和管理。无论是小型应用还是复杂的企业级应用，React Native SQLite Storage都能满足你的本地数据存储需求。

要开始使用，只需通过以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/re/react-native-sqlite-storage

然后按照本文的步骤进行安装和配置，即可快速在你的React Native应用中使用SQLite数据库功能。

【免费下载链接】react-native-sqlite-storageFull featured SQLite3 Native Plugin for React Native (Android and iOS)项目地址: https://gitcode.com/gh_mirrors/re/react-native-sqlite-storage