android-frame/frame/storage/CLAUDE.md

Storage 模块

模块概述

Storage 模块提供统一的存储管理功能，封装了 SharedPreferences、文件存储等常用的本地存储方案，提供简洁的 API 和类型安全的数据存取接口。

主要功能

1. SharedPreferences 封装

• 类型安全的数据存取
• 同步和异步操作支持
• 自动序列化/反序列化

2. 文件存储管理

• 统一的文件存储接口
• 支持多种数据格式
• 文件读写操作封装

3. 存储服务抽象

• StorageService 统一入口
• 可扩展的存储后端
• 配置化存储策略

核心接口

interface StorageService {
    // SharedPreferences 操作
    fun putString(key: String, value: String)
    fun getString(key: String, defaultValue: String = ""): String
    fun putInt(key: String, value: Int)
    fun getInt(key: String, defaultValue: Int = 0): Int
    fun putBoolean(key: String, value: Boolean)
    fun getBoolean(key: String, defaultValue: Boolean = false): Boolean
    
    // 文件操作
    fun writeFile(fileName: String, content: String)
    fun readFile(fileName: String): String?
    
    // 清理操作
    fun clear()
    fun remove(key: String)
}

使用方式

// 获取存储服务
val storage = StorageService.getInstance()

// 存储基本类型
storage.putString("user_name", "张三")
storage.putInt("user_age", 25)
storage.putBoolean("is_login", true)

// 读取数据
val userName = storage.getString("user_name")
val userAge = storage.getInt("user_age")
val isLogin = storage.getBoolean("is_login")

// 文件操作
storage.writeFile("config.json", jsonString)
val config = storage.readFile("config.json")

构建配置

implementation "com.wenext.android:frame-storage:6.0.0"