iapp如何新建数据库？教程详解

在iapp（一款Android平台的应用开发工具）中新建数据库，主要依赖其内置的SQLite数据库操作功能，以下是详细步骤和注意事项，适用于iapp V5及以上版本：

新建数据库的核心步骤

1. 创建数据库文件
   在onCreate（应用初始化事件）或按钮点击事件中，使用以下代码创建/打开数据库：

   -- 定义数据库路径（默认在应用私有目录）
   path = "%data_dir%/my_database.db"
   -- 打开或创建数据库
   db = sqlite3.open(path)

2. 执行建表SQL语句
   数据库创建后需通过SQL语句定义表结构：

   sql = [[
     CREATE TABLE IF NOT EXISTS users (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
       name TEXT NOT NULL,
       age INTEGER
     );
   ]]
   -- 执行SQL
   db.exec(sql)

3. 关闭数据库连接
   操作完成后关闭连接（建议在onDestroy事件中调用）：

   db.close()

完整操作示例

-- 点击按钮创建数据库
function btn_create.onClick()
  -- 打开数据库
  path = "%data_dir%/user_data.db"
  db = sqlite3.open(path)
  -- 创建数据表
  sql = [[
    CREATE TABLE IF NOT EXISTS books (
      book_id INTEGER PRIMARY KEY,
      title TEXT,
      author TEXT,
      price REAL
    );
  ]]
  db.exec(sql)
  -- 插入示例数据
  db.exec("INSERT INTO books (title, author, price) VALUES ('iapp指南', '张三', 29.9);")
  -- 关闭连接
  db.close()
  tw("数据库创建成功！路径："..path)
end

关键注意事项

1. 数据库路径选择

   

   • %data_dir%：应用私有目录（无需权限）
   • %sdcard_dir%：SD卡路径（需Android读写权限）
   • 推荐：敏感数据存私有目录，大文件存SD卡

2. 避免重复打开数据库
   多次操作时复用连接对象，勿重复调用 sqlite3.open()，否则可能导致锁冲突。

3. SQL注入防护
   使用参数化查询处理用户输入：

   stmt = db.prepare("INSERT INTO users (name) VALUES (?)")
   stmt.bind_text(1, user_input)  -- 绑定参数
   stmt.step()  -- 执行

4. 错误处理
   添加异常捕获：

   ok, err = pcall(function()
     db.exec("INVALID SQL")  -- 错误SQL示例
   end)
   if not ok then
     tw("出错："..err)
   end

常见问题解决

• 数据库无法创建
  检查路径权限，Android 6.0+ 需动态申请 WRITE_EXTERNAL_STORAGE 权限。

• 表已存在报错
  使用 CREATE TABLE IF NOT EXISTS 替代 CREATE TABLE。

• 中文乱码
  建表时指定字符集（iapp默认UTF-8）：

  CREATE TABLE data (content TEXT COLLATE UTF8CI);

进阶操作建议

1. 数据库升级
   在 onUpgrade 事件中比较版本号，执行 ALTER TABLE 语句。

2. 数据备份
   复制数据库文件到SD卡：

   file.copy("%data_dir%/my_db.db", "%sdcard_dir%/backup.db")

3. 可视化查看
   导出 .db 文件到电脑，用 SQLiteBrowser 工具分析。

通过以上步骤,您可高效管理iapp的本地数据存储，实际开发中，建议封装数据库操作函数（如 initDB()、queryDB()）提升代码复用性，遇到复杂场景时，参考iapp官方文档的 sqlite3 接口说明。

引用说明：本文操作基于iapp V5.0.8官方手册及SQLite3语法规范，适用于Android 5.0+系统。