如何在iOS和Android平台使用QML访问本地存储并实现数据读写

嘿，作为常年用QML做移动应用的开发者，我来分享几个本地存储读写的最佳方案，都是经过项目验证、适配移动端特性的，你可以根据自己的数据类型和需求来选：

这个是我处理结构化数据（比如用户记录、订单列表、复杂表单数据）的首选，底层是SQLite，性能稳定还支持事务，特别适合需要复杂查询的场景。而且在移动端，Qt会自动把数据库存在应用的私有目录里，不用手动处理权限（只要你不硬写外部存储路径），非常省心。

用法示例：
首先导入模块：

import QtQuick.LocalStorage 2.0

然后初始化数据库、创建表、读写数据：

Rectangle {
    id: root

    Component.onCompleted: {
        // 打开数据库，参数依次是：数据库名、版本、描述、预估大小
        const db = LocalStorage.openDatabaseSync("MyAppDB", "1.0", "My App's Local Database", 1000000)
        try {
            // 事务内创建表（避免重复创建）
            db.transaction(function(tx) {
                tx.executeSql('CREATE TABLE IF NOT EXISTS user (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, email TEXT)')
            })

            // 插入数据
            db.transaction(function(tx) {
                const result = tx.executeSql('INSERT INTO user (name, email) VALUES (?, ?)', ["John Doe", "john@example.com"])
                console.log("插入成功，用户ID：", result.insertId)
            })

            // 查询数据
            db.transaction(function(tx) {
                const result = tx.executeSql('SELECT * FROM user WHERE name = ?', ["John Doe"])
                if (result.rows.length > 0) {
                    const user = result.rows.item(0)
                    console.log("找到用户：", user.name, user.email)
                }
            })
        } catch (e) {
            console.log("数据库操作出错：", e)
        }
    }
}

注意：如果是大量数据操作，建议把逻辑放到WorkerScript里执行，避免阻塞UI线程——移动端对卡顿的容忍度很低，这点一定要注意。

如果只是存键值对类型的配置数据（比如用户偏好、主题设置、是否记住密码、字体大小），那Settings绝对是最方便的选择，不用写SQL，直接像操作QML属性一样读写，还会自动持久化，跨平台适配也做得很好。

用法示例：
导入模块：

import QtQuick.Controls.Settings 1.0

然后直接用Settings组件封装配置项：

Settings {
    id: appSettings
    // 指定组织名和应用名，用于区分不同应用的配置文件
    organization: "MyCompany"
    applicationName: "MyMobileApp"

    // 定义需要存储的属性，默认值会在第一次启动时生效
    property bool darkMode: false
    property string username: ""
    property int fontSize: 14
}

// 读写示例
Button {
    text: "切换深色模式"
    onClicked: {
        appSettings.darkMode = !appSettings.darkMode
        // 更改会自动保存，不需要手动写保存逻辑
    }
}

Text {
    text: appSettings.username || "未登录"
    font.pixelSize: appSettings.fontSize
    color: appSettings.darkMode ? "white" : "black"
}

这个方案的优点就是极简，不用处理任何文件或数据库逻辑，Qt帮你搞定一切，适合小量配置数据。

如果你需要存非结构化数据（比如日志文件、自定义格式的文本、JSON数据、二进制文件），那就直接用FileIO组件。不过在移动端要注意文件路径和权限：

• Android：如果要存到外部存储，需要申请对应权限（Android 13+还有更细分的权限）；私有目录不需要权限，路径可以用Qt.applicationStorageDirectory获取。
• iOS：只能操作应用沙盒内的路径，比如Documents、Library目录，外部存储需要用到iCloud或者文件共享权限。

用法示例：
导入模块：

import QtQuick.IO 1.0

读写文本文件：

FileIO {
    id: fileIO
    // 用Qt提供的路径常量，避免硬编码导致的兼容性问题
    fileName: Qt.applicationStorageDirectory + "/app_log.txt"
}

Button {
    text: "写入日志"
    onClicked: {
        fileIO.append = true // 开启追加模式，默认是覆盖
        fileIO.write("[" + new Date().toISOString() + "] 用户点击了日志按钮\n")
    }
}

Button {
    text: "读取日志"
    onClicked: {
        const content = fileIO.read()
        console.log("日志内容：", content)
    }
}

如果要处理JSON数据，可以先把QML对象转换成JSON字符串再写入：

const userData = {name: "Jane", age: 25, isActive: true}
const jsonString = JSON.stringify(userData)
fileIO.write(jsonString)

读取时再解析：

const jsonString = fileIO.read()
const userData = JSON.parse(jsonString)
console.log("用户姓名：", userData.name)

• 结构化数据优先选Local Storage：SQLite支持复杂查询、事务，适合数据量大、关系复杂的场景，移动端适配成熟。
• 配置类小数据用Settings：零学习成本，自动持久化，不用操心存储细节。
• 非结构化数据用FileIO：适合日志、自定义格式文件，记得用Qt提供的路径常量，避免权限问题。
• 避免阻塞UI：所有存储操作（尤其是大文件读写、大量数据库查询）尽量放到异步线程，比如用WorkerScript或者C++的QtConcurrent。
• 权限处理：如果要访问外部存储，一定要在AndroidManifest.xml或Info.plist里声明权限，并且在运行时请求用户授权（Android 6.0+要求）。
• 数据备份：对于重要数据，比如用户的个人信息，可以考虑结合云端备份，但本地存储还是要保证可靠性。

内容的提问来源于stack exchange，提问作者Sachintha Udara