Flutter数据库管理插件sqlite3_flutter_libs的使用

简介

sqlite3_flutter_libs 插件本身不包含任何 Dart 代码。它为 Android、iOS、macOS、Linux 和 Windows 提供了原生的 sqlite3 库。有关如何在 Flutter 应用中实际使用此包，请参阅 sqlite3。

该包编译的 sqlite3 版本使用了推荐的编译选项，并默认包含 fts5 模块（json1 模块是最近版本 sqlite3 的默认构建的一部分）。其他模块未包含在此构建中。

Android 注意事项

包含的平台

在 Android 上，此库将为以下所有平台捆绑 sqlite3：

• arm64-v8a
• armeabi-v7a
• x86
• x86_64

如果您不打算发布到 32 位 x86 设备，则需要在 build.gradle 中应用过滤器：

android {
    defaultConfig {
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86_64'
        }
    }
}

Android 6 的问题

在 Android 6 上加载原生库时可能会出现问题。如果您遇到这些崩溃，可以尝试在 gradle.properties 文件中设置 android.bundle.enableUncompressedNativeLibs=false。请注意，这会增加应用程序安装后的大小。

或者，您可以使用 applyWorkaroundToOpenSqlite3OnOldAndroidVersions 方法。该方法会在 Java 中尝试打开 sqlite3，这似乎更可靠。加载 sqlite3 后，我们也可以在 Dart 中打开它。此方法应在使用 sqlite3 之前调用（无论是直接还是通过 package:drift 中的 NativeDatabase 间接调用）。

由于 applyWorkaroundToOpenSqlite3OnOldAndroidVersions 使用平台通道，在后台隔离区中使用它可能会有问题。我们建议在主隔离区中等待它，在启动可能使用数据库的后台隔离区之前。

提供临时路径

如果复杂的查询失败并显示 SQLITE_IOERR_GETTEMPPATH 6410 错误，您可以尝试显式设置 sqlite3 使用的临时路径。此评论包含一个实现此功能的代码片段。

示例代码

以下是一个完整的示例，演示如何在 Flutter 应用中使用 sqlite3_flutter_libs 和 sqlite3 包进行数据库操作：

pubspec.yaml

dependencies:
  flutter:
    sdk: flutter
  sqlite3_flutter_libs: ^0.5.0
  sqlite3: ^2.0.0

main.dart

import 'package:flutter/material.dart';
import 'package:sqlite3/sqlite3.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // Apply workaround for old Android versions if necessary
  await applyWorkaroundToOpenSqlite3OnOldAndroidVersions();

  runApp(MyApp());
}

Future<void> applyWorkaroundToOpenSqlite3OnOldAndroidVersions() async {
  // Implement the workaround as needed for old Android versions
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'SQLite Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'SQLite Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  late Database db;
  List<Map<String, Object?>>? items;

  @override
  void initState() {
    super.initState();
    openDatabase();
  }

  void openDatabase() {
    // Open a connection to the database (note: path should be adjusted as needed)
    db = sqlite3.open('example.db');

    // Create a table
    db.execute('''
      CREATE TABLE IF NOT EXISTS items (
        id INTEGER PRIMARY KEY,
        name TEXT NOT NULL
      )
    ''');

    // Insert some data
    db.execute("INSERT INTO items (name) VALUES ('Item 1')");
    db.execute("INSERT INTO items (name) VALUES ('Item 2')");

    // Query the database
    items = db.select('SELECT * FROM items');
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: ListView.builder(
        itemCount: items?.length ?? 0,
        itemBuilder: (context, index) {
          final item = items![index];
          return ListTile(
            title: Text(item['name'] as String),
          );
        },
      ),
    );
  }

  @override
  void dispose() {
    db.close();
    super.dispose();
  }
}

这个示例展示了如何创建一个简单的 SQLite 数据库，插入一些数据，并在 Flutter 应用中显示这些数据。请根据您的具体需求调整数据库路径和其他配置。

以上内容详细介绍了 `sqlite3_flutter_libs` 插件的使用方法，并提供了一个完整的示例代码来帮助您更好地理解其用法。希望这对您有所帮助！