# CombatCalculator-战斗计算器

**Repository Path**: rainbowno6/CombatCalculator

## Basic Information

- **Project Name**: CombatCalculator-战斗计算器
- **Description**: 一款基于kotlin_jetpack compose开发的可自定义公式计算器
- **Primary Language**: Kotlin
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-24
- **Last Updated**: 2025-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CombatCalculator - 战斗计算器

## 简介

CombatCalculator 是一款专为游戏玩家和数学爱好者设计的公式计算应用。它允许用户创建、保存和管理自定义数学公式，特别适合用于可总结出公式的问题进行计算等场景，可根据公式中任意已知值求唯一未知量。

## 主要功能

- **公式编辑器**：创建和编辑自定义公式
- **变量管理**：为公式定义变量并设置默认值
- **公式计算**：输入变量值并计算结果
- **批量操作**：支持批量导出/导入公式
- **主题切换**：支持日间/夜间模式切换
- **震动反馈**：关键操作提供触觉反馈

## 技术特点

- 采用 Jetpack Compose 构建现代化 UI
- 使用 Kotlin 协程处理异步操作
- 实现公式解析和方程求解功能
- 支持 JSON 格式的公式导入导出
- 适配 Android 10+ 的文件存储权限系统

## 安装与使用

### 系统要求
- Android 10 或更高版本

### 安装方法
1. 下载最新 APK 文件
2. 在 Android 设备上安装
3. 授予必要的存储权限

### 基本使用指南
1. **创建公式**：
   - 点击"公式编辑器"
   - 输入公式名称
   - 添加变量
   - 构建公式表达式
   - 保存公式

2. **使用公式**：
   - 在"查看公式"中选择公式
   - 输入变量值
   - 点击计算获取结果

3. **导入/导出**：
   - 在"查看公式"界面使用导入/导出功能
   - 导出支持选择特定公式或全部导出
   - 导出文件通常位于Download文件夹下

## 开发环境

- Android Studio Flamingo 或更高版本
- Kotlin 1.8.0
- Android SDK 33+
- Gradle 7.4+

## 项目结构

```
app/
├── src/
│   ├── main/
│   │   ├── java/com/rainbowno6/combatcalculator/
│   │   │   ├── MainActivity.kt        # 主入口
│   │   │   ├── FileManager.kt         # 文件管理
│   │   │   ├── VibrationUtils.kt      # 震动工具
│   │   │   └── ...                    # 其他组件
│   │   └── res/                       # 资源文件
│   └── test/                          # 测试代码
build.gradle                           # 项目构建配置
```

## 开源许可

本项目采用 [MIT License](LICENSE)

## 贡献指南

欢迎提交 Pull Request 或 Issue。主要开发方向：
- 增强公式解析能力
- 添加更多数学函数支持
- 改进用户界面
- 增加云同步功能

## 联系方式

开发者: 忍冬(Mr.R)
Email: xuanyuluo666@163.com
Gitee: https://gitee.com/rainbowno6/CombatCalculator.git

---
*项目开始时间：2025.05。18
*最后更新: 2025.05.24*