# MiniIME

**Repository Path**: chntamap/mini-ime

## Basic Information

- **Project Name**: MiniIME
- **Description**: MiniIME极简输入法：一个极简的输入法程序，包括输入法引擎库和终端交互程序
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-06
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 输入法库

## 项目介绍

【待编写】

## 功能特性

【待编写】

## 项目结构

```

【待编写】
```

## 构建和运行

### 环境要求

- CMake 3.16 或更高版本
- Ninja 构建工具

### CMake 预设配置说明
本项目提供 `CMakeUserPresets.json.example` 示例配置文件，使用前请按以下步骤操作：
1. 复制示例文件为本地配置文件：
```bash
# Linux / MacOS 终端
cp CMakeUserPresets.json.example CMakeUserPresets.json

# Windows PowerShell
Copy-Item CMakeUserPresets.json.example CMakeUserPresets.json
```
2. 编辑 `CMakeUserPresets.json`，根据你的开发环境修改路径配置：
   - **Windows MinGW 环境**：将所有 `/path/to/your/...` 占位符替换为你本地 MinGW、Ninja 等工具的实际安装路径
   - **Linux 环境**：若系统已安装 gcc、g++、ninja 工具链，可直接使用默认 `linux-gcc-x64` 预设，无需额外修改
   - （可选）配置词库自动复制：修改`base`公共预设中的`DICT_SOURCE_PATH`变量值为你本地词库目录的实际路径，构建时会自动将词库复制到构建目录的`data`文件夹
3. 选择对应平台的预设名称进行后续构建操作，可用预设包括：
   - `mingw810_32`：Windows MinGW 32位
   - `mingw810_64`：Windows MinGW 64位
   - `linux-gcc-x64`：Linux GCC 64位

### 构建步骤

1. 克隆项目到本地
2. 完成上述 CMake 预设配置
3. 执行以下命令（将 `<预设名称>` 替换为你选择的预设）：

```bash
# 使用 CMake 预设配置项目
cmake --preset <预设名称>

# 构建项目
cmake --build --preset <预设名称>
```

### 词库配置说明
程序运行时会按以下优先级查找词库：
1. 首先查找当前工作目录下的`data`目录
2. 如果`data`目录不存在，尝试读取`PINYIN_DICT_PATH`环境变量指定的词库路径

如果构建时配置了`DICT_SOURCE_PATH`CMake变量，构建过程会自动将词库复制到构建目录的`data`文件夹，无需额外运行时配置。


### 运行程序

#### Windows 平台
```powershell
# 替换为你本地 MinGW bin 目录路径，然后运行程序
$env:PATH += ";C:/path/to/your/mingw64/bin"
./build/bin/xxx.exe
```

#### Linux 平台
```bash
./build/bin/xxx
```

## 常见问题解决

### 1. libgcc_s_dw2-1.dll 等库文件找不到

**问题**：
```
由于找不到libgccs_dw2-1.dll，无法继续执行代码。
```

**解决方法**：
确保 MinGW 工具链的路径添加到系统 PATH 中：

```powershell
# 替换为你本地 MinGW bin 目录实际路径
$env:PATH += ";C:/path/to/your/mingw64/bin"


### 2. 词库加载失败
**问题**：
```
无法加载词库，请确保当前目录存在data目录，或设置PINYIN_DICT_PATH环境变量指向词库路径
```

**解决方法**：
方法1：在`CMakeUserPresets.json`中配置`DICT_SOURCE_PATH`变量指向词库目录，重新构建项目，会自动复制词库到构建目录
方法2：手动将词库目录复制到程序运行目录下，命名为`data`
方法3：设置`PINYIN_DICT_PATH`环境变量指向你的词库目录路径


## 开发说明

【待编写】

## 许可证

本项目遵循 MIT 许可证。