docs: 增加注释
This commit is contained in:
parent
8bc3e987aa
commit
4c1aa501e6
@ -24,40 +24,66 @@ import com.yovinchen.bookkeeping.ui.navigation.MainNavigation
|
||||
import com.yovinchen.bookkeeping.ui.theme.BookkeepingTheme
|
||||
import com.yovinchen.bookkeeping.utils.FilePickerUtil
|
||||
|
||||
/**
|
||||
* 全局文件选择器启动器
|
||||
* 用于在整个应用程序中共享同一个文件选择器实例
|
||||
*/
|
||||
private var filePickerLauncher: ActivityResultLauncher<Array<String>>? = null
|
||||
|
||||
/**
|
||||
* 获取预先注册的文件选择器启动器的扩展函数
|
||||
*
|
||||
* @return 预先注册的文件选择器启动器
|
||||
* @throws IllegalStateException 如果文件选择器未初始化
|
||||
*/
|
||||
fun ComponentActivity.getPreregisteredFilePickerLauncher(): ActivityResultLauncher<Array<String>> {
|
||||
return filePickerLauncher ?: throw IllegalStateException("FilePickerLauncher not initialized")
|
||||
}
|
||||
|
||||
/**
|
||||
* 应用程序的主活动
|
||||
* 负责初始化应用界面和必要的系统组件
|
||||
*/
|
||||
class MainActivity : ComponentActivity() {
|
||||
override fun onCreate(savedInstanceState: Bundle?) {
|
||||
super.onCreate(savedInstanceState)
|
||||
// 设置系统窗口装饰，确保内容能够扩展到系统栏区域
|
||||
WindowCompat.setDecorFitsSystemWindows(window, false)
|
||||
|
||||
// 预注册文件选择器
|
||||
// 预注册文件选择器，用于处理文件选择操作
|
||||
filePickerLauncher = registerForActivityResult(
|
||||
ActivityResultContracts.OpenDocument()
|
||||
) { uri: Uri? ->
|
||||
// 当用户选择文件后，调用工具类处理文件选择结果
|
||||
FilePickerUtil.handleFileSelection(this, uri)
|
||||
}
|
||||
|
||||
// 设置应用的主Compose内容
|
||||
setContent {
|
||||
BookkeepingApp()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 系统状态栏和导航栏颜色设置
|
||||
* 根据当前主题模式设置系统UI元素的颜色和外观
|
||||
*
|
||||
* @param isDarkTheme 是否为暗色主题
|
||||
*/
|
||||
@Composable
|
||||
private fun SystemBarColor(isDarkTheme: Boolean) {
|
||||
val view = LocalView.current
|
||||
if (!view.isInEditMode) {
|
||||
// 获取当前主题的表面颜色用于系统栏
|
||||
val surfaceColor = MaterialTheme.colorScheme.surface.toArgb()
|
||||
val currentWindow = (view.context as? Activity)?.window
|
||||
SideEffect {
|
||||
currentWindow?.let { window ->
|
||||
// 设置状态栏和导航栏颜色
|
||||
window.statusBarColor = surfaceColor
|
||||
window.navigationBarColor = surfaceColor
|
||||
// 设置系统栏图标的亮暗模式，以确保在不同背景下的可见性
|
||||
WindowCompat.getInsetsController(window, view).apply {
|
||||
isAppearanceLightStatusBars = !isDarkTheme
|
||||
isAppearanceLightNavigationBars = !isDarkTheme
|
||||
@ -67,27 +93,37 @@ private fun SystemBarColor(isDarkTheme: Boolean) {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 记账应用的主Compose函数
|
||||
* 处理主题设置并启动主导航组件
|
||||
*/
|
||||
@Composable
|
||||
fun BookkeepingApp() {
|
||||
// 跟踪当前应用的主题模式状态
|
||||
var themeMode by remember { mutableStateOf<ThemeMode>(ThemeMode.FOLLOW_SYSTEM) }
|
||||
|
||||
// 根据主题模式确定是否使用暗色主题
|
||||
val isDarkTheme = when (themeMode) {
|
||||
is ThemeMode.FOLLOW_SYSTEM -> isSystemInDarkTheme()
|
||||
is ThemeMode.LIGHT -> false
|
||||
is ThemeMode.DARK -> true
|
||||
is ThemeMode.CUSTOM -> isSystemInDarkTheme()
|
||||
is ThemeMode.FOLLOW_SYSTEM -> isSystemInDarkTheme() // 跟随系统设置
|
||||
is ThemeMode.LIGHT -> false // 强制使用亮色主题
|
||||
is ThemeMode.DARK -> true // 强制使用暗色主题
|
||||
is ThemeMode.CUSTOM -> isSystemInDarkTheme() // 自定义主题下的基础亮暗模式仍跟随系统
|
||||
}
|
||||
|
||||
// 处理自定义主题颜色方案
|
||||
val customColorScheme = when (themeMode) {
|
||||
is ThemeMode.CUSTOM -> {
|
||||
// 从主题模式中提取自定义主色
|
||||
val primaryColor = (themeMode as ThemeMode.CUSTOM).primaryColor
|
||||
if (isDarkTheme) {
|
||||
// 暗色模式下的自定义颜色方案
|
||||
MaterialTheme.colorScheme.copy(
|
||||
primary = primaryColor,
|
||||
secondary = primaryColor.copy(alpha = 0.7f),
|
||||
tertiary = primaryColor.copy(alpha = 0.5f)
|
||||
)
|
||||
} else {
|
||||
// 亮色模式下的自定义颜色方案
|
||||
MaterialTheme.colorScheme.copy(
|
||||
primary = primaryColor,
|
||||
secondary = primaryColor.copy(alpha = 0.7f),
|
||||
@ -95,27 +131,38 @@ fun BookkeepingApp() {
|
||||
)
|
||||
}
|
||||
}
|
||||
else -> null
|
||||
else -> null // 非自定义主题模式使用默认颜色方案
|
||||
}
|
||||
|
||||
// 应用主题到整个应用内容
|
||||
BookkeepingTheme(
|
||||
darkTheme = isDarkTheme,
|
||||
customColorScheme = customColorScheme
|
||||
) {
|
||||
// 设置系统状态栏和导航栏颜色
|
||||
SystemBarColor(isDarkTheme)
|
||||
|
||||
// 创建填充整个屏幕的基础Surface
|
||||
Surface(
|
||||
modifier = Modifier.fillMaxSize(),
|
||||
color = MaterialTheme.colorScheme.surface
|
||||
) {
|
||||
// 启动主导航组件，并传递主题相关参数
|
||||
MainNavigation(
|
||||
currentTheme = themeMode,
|
||||
onThemeChange = { themeMode = it }
|
||||
onThemeChange = { themeMode = it } // 允许导航组件中的屏幕更改主题
|
||||
)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 示例问候函数
|
||||
* 仅用于开发预览和测试目的
|
||||
*
|
||||
* @param name 要显示的名称
|
||||
* @param modifier 应用于Text组件的修饰符
|
||||
*/
|
||||
@Composable
|
||||
fun Greeting(name: String, modifier: Modifier = Modifier) {
|
||||
Text(
|
||||
@ -124,6 +171,9 @@ fun Greeting(name: String, modifier: Modifier = Modifier) {
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* Greeting组件的预览函数
|
||||
*/
|
||||
@Preview(showBackground = true)
|
||||
@Composable
|
||||
fun GreetingPreview() {
|
||||
@ -132,6 +182,9 @@ fun GreetingPreview() {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 整个应用的预览函数
|
||||
*/
|
||||
@Preview(showBackground = true)
|
||||
@Composable
|
||||
fun BookkeepingAppPreview() {
|
||||
|
||||
@ -1,7 +1,13 @@
|
||||
package com.yovinchen.bookkeeping.model
|
||||
|
||||
/**
|
||||
* 分析类型枚举
|
||||
* 定义记账应用中不同的数据分析视图类型
|
||||
*
|
||||
* 用于在数据分析模块中区分不同的分析维度和图表类型
|
||||
*/
|
||||
enum class AnalysisType {
|
||||
EXPENSE,
|
||||
INCOME,
|
||||
TREND
|
||||
EXPENSE, // 支出分析，用于分析用户的支出情况
|
||||
INCOME, // 收入分析，用于分析用户的收入情况
|
||||
TREND // 趋势分析，用于分析用户收支随时间的变化趋势
|
||||
}
|
||||
|
||||
@ -9,32 +9,71 @@ import androidx.room.TypeConverters
|
||||
import com.yovinchen.bookkeeping.model.Member
|
||||
import java.util.Date
|
||||
|
||||
/**
|
||||
* 交易类型枚举
|
||||
* 定义记账记录的交易类型
|
||||
*/
|
||||
enum class TransactionType {
|
||||
INCOME, EXPENSE
|
||||
INCOME, // 收入
|
||||
EXPENSE // 支出
|
||||
}
|
||||
|
||||
/**
|
||||
* Room数据库类型转换器
|
||||
* 用于在数据库中存储和检索复杂类型
|
||||
*/
|
||||
class Converters {
|
||||
/**
|
||||
* 将时间戳转换为Date对象
|
||||
*
|
||||
* @param value 时间戳（毫秒）
|
||||
* @return 对应的Date对象，如果输入为null则返回null
|
||||
*/
|
||||
@TypeConverter
|
||||
fun fromTimestamp(value: Long?): Date? {
|
||||
return value?.let { Date(it) }
|
||||
}
|
||||
|
||||
/**
|
||||
* 将Date对象转换为时间戳
|
||||
*
|
||||
* @param date Date对象
|
||||
* @return 对应的时间戳（毫秒），如果输入为null则返回null
|
||||
*/
|
||||
@TypeConverter
|
||||
fun dateToTimestamp(date: Date?): Long? {
|
||||
return date?.time
|
||||
}
|
||||
|
||||
/**
|
||||
* 将字符串转换为TransactionType枚举
|
||||
*
|
||||
* @param value 交易类型的字符串表示
|
||||
* @return 对应的TransactionType枚举值
|
||||
*/
|
||||
@TypeConverter
|
||||
fun fromTransactionType(value: String): TransactionType {
|
||||
return enumValueOf<TransactionType>(value)
|
||||
}
|
||||
|
||||
/**
|
||||
* 将TransactionType枚举转换为字符串
|
||||
*
|
||||
* @param type TransactionType枚举值
|
||||
* @return 对应的字符串表示
|
||||
*/
|
||||
@TypeConverter
|
||||
fun transactionTypeToString(type: TransactionType): String {
|
||||
return type.name
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 记账记录实体类
|
||||
* 用于在Room数据库中存储用户的收支记录
|
||||
*
|
||||
* 该实体与Member实体存在外键关系，表示每条记录可以关联到一个家庭成员
|
||||
*/
|
||||
@Entity(
|
||||
tableName = "bookkeeping_records",
|
||||
foreignKeys = [
|
||||
@ -42,21 +81,21 @@ class Converters {
|
||||
entity = Member::class,
|
||||
parentColumns = ["id"],
|
||||
childColumns = ["memberId"],
|
||||
onDelete = ForeignKey.SET_NULL
|
||||
onDelete = ForeignKey.SET_NULL // 当关联的成员被删除时，将此字段设为NULL
|
||||
)
|
||||
],
|
||||
indices = [
|
||||
Index(value = ["memberId"])
|
||||
Index(value = ["memberId"]) // 在memberId上创建索引以提高查询性能
|
||||
]
|
||||
)
|
||||
@TypeConverters(Converters::class)
|
||||
@TypeConverters(Converters::class) // 应用类型转换器
|
||||
data class BookkeepingRecord(
|
||||
@PrimaryKey(autoGenerate = true)
|
||||
val id: Long = 0,
|
||||
val amount: Double,
|
||||
val type: TransactionType,
|
||||
val category: String,
|
||||
val description: String,
|
||||
val date: Date,
|
||||
val memberId: Int? = null // 可为空，表示未指定成员
|
||||
val id: Long = 0, // 记录ID，自动生成
|
||||
val amount: Double, // 金额
|
||||
val type: TransactionType, // 交易类型（收入或支出）
|
||||
val category: String, // 分类
|
||||
val description: String, // 描述
|
||||
val date: Date, // 日期
|
||||
val memberId: Int? = null // 关联的成员ID，可为空表示未指定成员
|
||||
)
|
||||
|
||||
@ -3,11 +3,18 @@ package com.yovinchen.bookkeeping.model
|
||||
import androidx.room.Entity
|
||||
import androidx.room.PrimaryKey
|
||||
|
||||
/**
|
||||
* 交易分类实体类
|
||||
* 用于在Room数据库中存储收支分类信息
|
||||
*
|
||||
* 在记账应用中，每条记账记录都属于某个分类，
|
||||
* 如"餐饮"、"交通"、"工资"等，便于用户对支出和收入进行分类统计
|
||||
*/
|
||||
@Entity(tableName = "categories")
|
||||
data class Category(
|
||||
@PrimaryKey(autoGenerate = true)
|
||||
val id: Long = 0,
|
||||
val name: String,
|
||||
val type: TransactionType,
|
||||
val icon: Int? = null
|
||||
val id: Long = 0, // 分类ID，自动生成
|
||||
val name: String, // 分类名称
|
||||
val type: TransactionType, // 分类关联的交易类型（收入或支出）
|
||||
val icon: Int? = null // 分类图标资源ID，可选，默认为null
|
||||
)
|
||||
|
||||
@ -1,8 +1,14 @@
|
||||
package com.yovinchen.bookkeeping.model
|
||||
|
||||
/**
|
||||
* 分类统计数据类
|
||||
* 用于表示某个分类的统计信息，通常用于数据分析和图表展示
|
||||
*
|
||||
* 该类不是数据库实体，而是从数据库查询结果中聚合生成的统计数据
|
||||
*/
|
||||
data class CategoryStat(
|
||||
val category: String,
|
||||
val amount: Double,
|
||||
val count: Int = 0,
|
||||
val percentage: Double = 0.0
|
||||
val category: String, // 分类名称
|
||||
val amount: Double, // 该分类的总金额
|
||||
val count: Int = 0, // 该分类下的记录数量
|
||||
val percentage: Double = 0.0 // 该分类金额占总金额的百分比（0.0-100.0）
|
||||
)
|
||||
|
||||
@ -3,11 +3,18 @@ package com.yovinchen.bookkeeping.model
|
||||
import androidx.room.Entity
|
||||
import androidx.room.PrimaryKey
|
||||
|
||||
/**
|
||||
* 家庭成员实体类
|
||||
* 用于在Room数据库中存储家庭成员信息
|
||||
*
|
||||
* 在记账应用中，每条记账记录可以关联到特定的家庭成员，
|
||||
* 以便追踪不同成员的收支情况
|
||||
*/
|
||||
@Entity(tableName = "members")
|
||||
data class Member(
|
||||
@PrimaryKey(autoGenerate = true)
|
||||
val id: Int = 0,
|
||||
val name: String,
|
||||
val description: String = "", // 可选的描述信息
|
||||
val icon: Int? = null // 新增icon字段，可为空
|
||||
val id: Int = 0, // 成员ID，自动生成
|
||||
val name: String, // 成员姓名
|
||||
val description: String = "", // 成员描述信息，可选，默认为空字符串
|
||||
val icon: Int? = null // 成员图标资源ID，可选，默认为null
|
||||
)
|
||||
|
||||
@ -2,16 +2,39 @@ package com.yovinchen.bookkeeping.model
|
||||
|
||||
import androidx.room.ColumnInfo
|
||||
|
||||
/**
|
||||
* 家庭成员统计数据类
|
||||
* 用于表示某个成员的统计信息，通常用于数据分析和图表展示
|
||||
*
|
||||
* 该类不是数据库实体，而是通过数据库查询直接映射的结果类，
|
||||
* 表示按成员分组的聚合数据
|
||||
*/
|
||||
data class MemberStat(
|
||||
/**
|
||||
* 成员名称
|
||||
* 映射数据库查询结果中的member列
|
||||
*/
|
||||
@ColumnInfo(name = "member")
|
||||
val member: String,
|
||||
|
||||
/**
|
||||
* 该成员的总金额
|
||||
* 映射数据库查询结果中的amount列
|
||||
*/
|
||||
@ColumnInfo(name = "amount")
|
||||
val amount: Double,
|
||||
|
||||
/**
|
||||
* 该成员下的记录数量
|
||||
* 映射数据库查询结果中的count列
|
||||
*/
|
||||
@ColumnInfo(name = "count")
|
||||
val count: Int,
|
||||
|
||||
/**
|
||||
* 该成员金额占总金额的百分比（0.0-100.0）
|
||||
* 映射数据库查询结果中的percentage列
|
||||
*/
|
||||
@ColumnInfo(name = "percentage")
|
||||
val percentage: Double = 0.0
|
||||
)
|
||||
|
||||
@ -2,9 +2,35 @@ package com.yovinchen.bookkeeping.model
|
||||
|
||||
import androidx.compose.ui.graphics.Color
|
||||
|
||||
/**
|
||||
* 主题模式密封类
|
||||
* 用于表示应用程序的不同主题设置选项
|
||||
* 通过密封类实现，限制可能的主题模式类型
|
||||
*/
|
||||
sealed class ThemeMode {
|
||||
/**
|
||||
* 跟随系统主题模式
|
||||
* 应用将根据设备系统的暗色/亮色主题设置自动调整
|
||||
*/
|
||||
object FOLLOW_SYSTEM : ThemeMode()
|
||||
|
||||
/**
|
||||
* 固定亮色主题模式
|
||||
* 无论设备系统设置如何，应用将始终使用亮色主题
|
||||
*/
|
||||
object LIGHT : ThemeMode()
|
||||
|
||||
/**
|
||||
* 固定暗色主题模式
|
||||
* 无论设备系统设置如何，应用将始终使用暗色主题
|
||||
*/
|
||||
object DARK : ThemeMode()
|
||||
|
||||
/**
|
||||
* 自定义主题模式
|
||||
* 允许用户选择自定义的主题颜色
|
||||
*
|
||||
* @property primaryColor 用户选择的主要颜色，将影响应用的主色调
|
||||
*/
|
||||
data class CUSTOM(val primaryColor: Color) : ThemeMode()
|
||||
}
|
||||
|
||||
@ -20,7 +20,6 @@ import androidx.compose.material3.HorizontalDivider
|
||||
import androidx.compose.material3.Icon
|
||||
import androidx.compose.material3.MaterialTheme
|
||||
import androidx.compose.material3.Scaffold
|
||||
import androidx.compose.material3.Surface
|
||||
import androidx.compose.material3.Text
|
||||
import androidx.compose.runtime.Composable
|
||||
import androidx.compose.runtime.collectAsState
|
||||
|
||||
@ -10,40 +10,72 @@ import com.yovinchen.bookkeeping.getPreregisteredFilePickerLauncher
|
||||
import java.io.File
|
||||
import java.io.FileOutputStream
|
||||
|
||||
/**
|
||||
* 文件选择器工具类
|
||||
* 用于处理文件选择、权限获取和文件处理的工具类
|
||||
*
|
||||
* 主要功能：
|
||||
* 1. 启动系统文件选择器
|
||||
* 2. 处理选择结果
|
||||
* 3. 将选择的文件复制到应用缓存目录
|
||||
* 4. 文件类型验证
|
||||
*/
|
||||
object FilePickerUtil {
|
||||
/**
|
||||
* 当前活跃的文件选择回调
|
||||
* 用于在文件选择完成后调用
|
||||
*/
|
||||
private var currentCallback: ((File) -> Unit)? = null
|
||||
|
||||
/**
|
||||
* 启动文件选择器
|
||||
*
|
||||
* @param activity 当前活动，用于启动文件选择器
|
||||
* @param onFileSelected 文件选择完成后的回调函数，参数为选中的文件
|
||||
*/
|
||||
fun startFilePicker(activity: ComponentActivity, onFileSelected: (File) -> Unit) {
|
||||
currentCallback = onFileSelected
|
||||
|
||||
try {
|
||||
// 设置可选择的文件类型，限制为CSV和Excel文件
|
||||
val mimeTypes = arrayOf(
|
||||
"text/csv",
|
||||
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
|
||||
"application/vnd.ms-excel"
|
||||
)
|
||||
// 使用预注册的文件选择器启动文件选择流程
|
||||
activity.getPreregisteredFilePickerLauncher().launch(mimeTypes)
|
||||
} catch (e: Exception) {
|
||||
// 文件选择器启动失败时显示错误提示
|
||||
Toast.makeText(activity, "无法启动文件选择器：${e.message}", Toast.LENGTH_SHORT).show()
|
||||
currentCallback = null
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 处理文件选择结果
|
||||
*
|
||||
* @param context 上下文对象，用于访问ContentResolver
|
||||
* @param uri 选中文件的URI，如果用户取消选择则为null
|
||||
*/
|
||||
fun handleFileSelection(context: Context, uri: Uri?) {
|
||||
if (uri == null) {
|
||||
// 用户未选择文件时显示提示
|
||||
Toast.makeText(context, "未选择文件", Toast.LENGTH_SHORT).show()
|
||||
currentCallback = null
|
||||
return
|
||||
}
|
||||
|
||||
try {
|
||||
// 获取文件MIME类型
|
||||
val mimeType = context.contentResolver.getType(uri)
|
||||
// 验证文件类型是否合法
|
||||
if (!isValidFileType(uri.toString(), mimeType)) {
|
||||
Toast.makeText(context, "请选择CSV或Excel文件", Toast.LENGTH_SHORT).show()
|
||||
return
|
||||
}
|
||||
|
||||
// 获取持久性权限
|
||||
// 获取持久性权限，确保应用在重启后仍能访问该文件
|
||||
val takeFlags: Int = Intent.FLAG_GRANT_READ_URI_PERMISSION or
|
||||
Intent.FLAG_GRANT_WRITE_URI_PERMISSION
|
||||
context.contentResolver.takePersistableUriPermission(uri, takeFlags)
|
||||
@ -51,6 +83,7 @@ object FilePickerUtil {
|
||||
// 将选中的文件复制到应用私有目录
|
||||
val tempFile = copyUriToTempFile(context, uri)
|
||||
if (tempFile != null) {
|
||||
// 调用回调函数，传递临时文件
|
||||
currentCallback?.invoke(tempFile)
|
||||
} else {
|
||||
Toast.makeText(context, "文件处理失败，请重试", Toast.LENGTH_SHORT).show()
|
||||
@ -59,10 +92,18 @@ object FilePickerUtil {
|
||||
e.printStackTrace()
|
||||
Toast.makeText(context, "文件处理出错：${e.message}", Toast.LENGTH_SHORT).show()
|
||||
} finally {
|
||||
// 清除回调引用，避免内存泄漏
|
||||
currentCallback = null
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 验证文件类型是否合法
|
||||
*
|
||||
* @param fileName 文件名，用于检查文件扩展名
|
||||
* @param mimeType 文件MIME类型
|
||||
* @return 如果文件类型合法则返回true，否则返回false
|
||||
*/
|
||||
private fun isValidFileType(fileName: String, mimeType: String?): Boolean {
|
||||
val fileExtension = fileName.lowercase()
|
||||
return fileExtension.endsWith(".csv") ||
|
||||
@ -73,11 +114,20 @@ object FilePickerUtil {
|
||||
mimeType == "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
|
||||
}
|
||||
|
||||
/**
|
||||
* 将URI指向的文件复制到应用缓存目录
|
||||
*
|
||||
* @param context 上下文对象，用于访问ContentResolver和缓存目录
|
||||
* @param uri 要复制的文件URI
|
||||
* @return 复制后的临时文件，如果复制失败则返回null
|
||||
*/
|
||||
private fun copyUriToTempFile(context: Context, uri: Uri): File? {
|
||||
return try {
|
||||
// 获取文件名，如果无法获取则使用时间戳作为文件名
|
||||
val fileName = getFileName(context, uri) ?: "temp_backup_${System.currentTimeMillis()}"
|
||||
val tempFile = File(context.cacheDir, fileName)
|
||||
|
||||
// 从URI读取内容并写入临时文件
|
||||
context.contentResolver.openInputStream(uri)?.use { inputStream ->
|
||||
FileOutputStream(tempFile).use { outputStream ->
|
||||
inputStream.copyTo(outputStream)
|
||||
@ -90,6 +140,13 @@ object FilePickerUtil {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 从URI中获取文件名
|
||||
*
|
||||
* @param context 上下文对象，用于访问ContentResolver
|
||||
* @param uri 文件URI
|
||||
* @return 文件名，如果无法获取则返回null
|
||||
*/
|
||||
private fun getFileName(context: Context, uri: Uri): String? {
|
||||
var fileName: String? = null
|
||||
context.contentResolver.query(uri, null, null, null, null)?.use { cursor ->
|
||||
|
||||
@ -6,77 +6,126 @@ import androidx.compose.ui.graphics.vector.ImageVector
|
||||
import androidx.compose.ui.res.vectorResource
|
||||
import com.yovinchen.bookkeeping.R
|
||||
|
||||
/**
|
||||
* 图标管理器
|
||||
* 集中管理应用中使用的各类图标资源
|
||||
*
|
||||
* 主要功能：
|
||||
* 1. 管理分类图标和成员图标的映射关系
|
||||
* 2. 提供根据名称获取对应图标的方法
|
||||
* 3. 提供获取所有可用图标的方法
|
||||
*/
|
||||
object IconManager {
|
||||
// 类别图标映射
|
||||
/**
|
||||
* 类别图标映射
|
||||
* 将分类名称映射到对应的图标资源ID
|
||||
*/
|
||||
private val categoryIcons = mapOf(
|
||||
"餐饮" to R.drawable.ic_category_food_24dp,
|
||||
"交通" to R.drawable.ic_category_taxi_24dp,
|
||||
"购物" to R.drawable.ic_category_supermarket_24dp,
|
||||
"娱乐" to R.drawable.ic_category_bar_24dp,
|
||||
"居住" to R.drawable.ic_category_hotel_24dp,
|
||||
"医疗" to R.drawable.ic_category_medicine_24dp,
|
||||
"教育" to R.drawable.ic_category_training_24dp,
|
||||
"宠物" to R.drawable.ic_category_pet_24dp,
|
||||
"鲜花" to R.drawable.ic_category_flower_24dp,
|
||||
"外卖" to R.drawable.ic_category_delivery_24dp,
|
||||
"数码" to R.drawable.ic_category_digital_24dp,
|
||||
"化妆品" to R.drawable.ic_category_cosmetics_24dp,
|
||||
"水果" to R.drawable.ic_category_fruit_24dp,
|
||||
"零食" to R.drawable.ic_category_snack_24dp,
|
||||
"蔬菜" to R.drawable.ic_category_vegetable_24dp,
|
||||
"工资" to R.drawable.ic_category_membership_24dp,
|
||||
"礼物" to R.drawable.ic_category_gift_24dp,
|
||||
"其他" to R.drawable.ic_category_more_24dp,
|
||||
"工资" to R.drawable.ic_category_membership_24dp,
|
||||
"会员" to R.drawable.ic_category_membership_24dp,
|
||||
"奖金" to R.drawable.ic_category_gift_24dp,
|
||||
"投资" to R.drawable.ic_category_digital_24dp,
|
||||
"其他" to R.drawable.ic_category_more_24dp
|
||||
"餐饮" to R.drawable.ic_category_food_24dp, // 餐饮类别对应食物图标
|
||||
"交通" to R.drawable.ic_category_taxi_24dp, // 交通类别对应出租车图标
|
||||
"购物" to R.drawable.ic_category_supermarket_24dp, // 购物类别对应超市图标
|
||||
"娱乐" to R.drawable.ic_category_bar_24dp, // 娱乐类别对应酒吧图标
|
||||
"居住" to R.drawable.ic_category_hotel_24dp, // 居住类别对应酒店图标
|
||||
"医疗" to R.drawable.ic_category_medicine_24dp, // 医疗类别对应药品图标
|
||||
"教育" to R.drawable.ic_category_training_24dp, // 教育类别对应培训图标
|
||||
"宠物" to R.drawable.ic_category_pet_24dp, // 宠物类别对应宠物图标
|
||||
"鲜花" to R.drawable.ic_category_flower_24dp, // 鲜花类别对应花图标
|
||||
"外卖" to R.drawable.ic_category_delivery_24dp, // 外卖类别对应外卖图标
|
||||
"数码" to R.drawable.ic_category_digital_24dp, // 数码类别对应数码产品图标
|
||||
"化妆品" to R.drawable.ic_category_cosmetics_24dp, // 化妆品类别对应化妆品图标
|
||||
"水果" to R.drawable.ic_category_fruit_24dp, // 水果类别对应水果图标
|
||||
"零食" to R.drawable.ic_category_snack_24dp, // 零食类别对应零食图标
|
||||
"蔬菜" to R.drawable.ic_category_vegetable_24dp, // 蔬菜类别对应蔬菜图标
|
||||
"工资" to R.drawable.ic_category_membership_24dp, // 工资类别对应会员图标
|
||||
"礼物" to R.drawable.ic_category_gift_24dp, // 礼物类别对应礼物图标
|
||||
"其他" to R.drawable.ic_category_more_24dp, // 其他类别对应更多图标
|
||||
"会员" to R.drawable.ic_category_membership_24dp, // 会员类别对应会员图标
|
||||
"奖金" to R.drawable.ic_category_gift_24dp, // 奖金类别对应礼物图标
|
||||
"投资" to R.drawable.ic_category_digital_24dp // 投资类别对应数码图标
|
||||
)
|
||||
|
||||
// 成员图标映射
|
||||
/**
|
||||
* 成员图标映射
|
||||
* 将成员角色名称映射到对应的图标资源ID
|
||||
*/
|
||||
private val memberIcons = mapOf(
|
||||
"自己" to R.drawable.ic_member_boy_24dp,
|
||||
"老婆" to R.drawable.ic_member_bride_24dp,
|
||||
"老公" to R.drawable.ic_member_groom_24dp,
|
||||
"家庭" to R.drawable.ic_member_family_24dp,
|
||||
"儿子" to R.drawable.ic_member_baby_boy_24dp,
|
||||
"女儿" to R.drawable.ic_member_baby_girl_24dp,
|
||||
"爸爸" to R.drawable.ic_member_father_24dp,
|
||||
"妈妈" to R.drawable.ic_member_mother_24dp,
|
||||
"爷爷" to R.drawable.ic_member_grandfather_24dp,
|
||||
"奶奶" to R.drawable.ic_member_grandmother_24dp,
|
||||
"男生" to R.drawable.ic_member_boy_24dp,
|
||||
"女生" to R.drawable.ic_member_girl_24dp,
|
||||
"外公" to R.drawable.ic_member_grandfather_24dp,
|
||||
"外婆" to R.drawable.ic_member_grandmother_24dp,
|
||||
"其他" to R.drawable.ic_member_girl_24dp
|
||||
"自己" to R.drawable.ic_member_boy_24dp, // 自己对应男孩图标
|
||||
"老婆" to R.drawable.ic_member_bride_24dp, // 老婆对应新娘图标
|
||||
"老公" to R.drawable.ic_member_groom_24dp, // 老公对应新郎图标
|
||||
"家庭" to R.drawable.ic_member_family_24dp, // 家庭对应家庭图标
|
||||
"儿子" to R.drawable.ic_member_baby_boy_24dp, // 儿子对应男婴图标
|
||||
"女儿" to R.drawable.ic_member_baby_girl_24dp, // 女儿对应女婴图标
|
||||
"爸爸" to R.drawable.ic_member_father_24dp, // 爸爸对应父亲图标
|
||||
"妈妈" to R.drawable.ic_member_mother_24dp, // 妈妈对应母亲图标
|
||||
"爷爷" to R.drawable.ic_member_grandfather_24dp, // 爷爷对应祖父图标
|
||||
"奶奶" to R.drawable.ic_member_grandmother_24dp, // 奶奶对应祖母图标
|
||||
"男生" to R.drawable.ic_member_boy_24dp, // 男生对应男孩图标
|
||||
"女生" to R.drawable.ic_member_girl_24dp, // 女生对应女孩图标
|
||||
"外公" to R.drawable.ic_member_grandfather_24dp, // 外公对应祖父图标
|
||||
"外婆" to R.drawable.ic_member_grandmother_24dp, // 外婆对应祖母图标
|
||||
"其他" to R.drawable.ic_member_girl_24dp // 其他成员使用女孩图标作为默认值
|
||||
)
|
||||
|
||||
/**
|
||||
* 获取分类对应的图标向量
|
||||
* 用于在Compose UI中直接使用
|
||||
*
|
||||
* @param name 分类名称
|
||||
* @return 对应的图标向量，如果未找到则返回null
|
||||
*/
|
||||
@Composable
|
||||
fun getCategoryIconVector(name: String): ImageVector? {
|
||||
return categoryIcons[name]?.let { ImageVector.vectorResource(id = it) }
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取成员对应的图标向量
|
||||
* 用于在Compose UI中直接使用
|
||||
*
|
||||
* @param name 成员名称
|
||||
* @return 对应的图标向量，如果未找到则返回null
|
||||
*/
|
||||
@Composable
|
||||
fun getMemberIconVector(name: String): ImageVector? {
|
||||
return memberIcons[name]?.let { ImageVector.vectorResource(id = it) }
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取分类对应的图标资源ID
|
||||
*
|
||||
* @param name 分类名称
|
||||
* @return 对应的图标资源ID，如果未找到则返回null
|
||||
*/
|
||||
@DrawableRes
|
||||
fun getCategoryIcon(name: String): Int? {
|
||||
return categoryIcons[name]
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取成员对应的图标资源ID
|
||||
*
|
||||
* @param name 成员名称
|
||||
* @return 对应的图标资源ID，如果未找到则返回null
|
||||
*/
|
||||
@DrawableRes
|
||||
fun getMemberIcon(name: String): Int? {
|
||||
return memberIcons[name]
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取所有可用的分类图标资源ID列表
|
||||
*
|
||||
* @return 所有分类图标的资源ID列表
|
||||
*/
|
||||
fun getAllCategoryIcons(): List<Int> {
|
||||
return categoryIcons.values.toList()
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取所有可用的成员图标资源ID列表
|
||||
*
|
||||
* @return 所有成员图标的资源ID列表
|
||||
*/
|
||||
fun getAllMemberIcons(): List<Int> {
|
||||
return memberIcons.values.toList()
|
||||
}
|
||||
|
||||
Loading…
Reference in New Issue
Block a user