# cmake-spark-tools

**Repository Path**: zinface/cmake-spark-tools

## Basic Information

- **Project Name**: cmake-spark-tools
- **Description**: 一套轻量、纯脚本化的 cmake/_spark 管理工具集
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-08
- **Last Updated**: 2026-04-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cmake-spark-tools

cmake/_spark 目录 Git 变更检查与无变更自动更新工具集，支持自动替换旧包 `check-cmake-spark`，纯脚本构建、可分发、全局可用。

## 🌟 功能介绍
- `check_cmake_spark`：遍历 cmake/_spark 下所有子目录，检查 Git 文件变更并提示
- `update_cmake_spark`：遍历 cmake/_spark 下所有子目录，**无变更时自动执行 git pull 更新**，有变更则跳过
- 自动兼容旧版本：安装新包时，自动卸载旧包 `check-cmake-spark`，无需手动操作
- 纯脚本构建：单文件一键生成 DEB 安装包，无依赖、开箱即用

## 📦 快速使用

### 1. 构建 DEB 安装包
下载项目中的 `build-cmake-spark-tools.sh`，执行以下命令构建安装包：
```bash
# 赋予执行权限
chmod +x build-cmake-spark-tools.sh

# 一键构建（无警告，自动生成 DEB 包）
./build-cmake-spark-tools.sh
```
构建完成后，会生成 `cmake-spark-tools_1.0_all.deb` 文件。

### 2. 安装工具集
无需卸载旧包，直接安装新包即可（自动替换旧包 `check-cmake-spark`）：
```bash
sudo dpkg -i cmake-spark-tools_1.0_all.deb
```

### 3. 核心命令使用
#### 检查 Git 变更
```bash
check_cmake_spark
```
输出示例：
```
✅ 正在检查：cmake/_spark  
========================================
⚠️  moduleA 中有文件变更
✅ 检查完成！
```

#### 无变更自动更新
```bash
update_cmake_spark
```

输出示例：
```
🔄 正在检查并更新：cmake/_spark
========================================
✅ moduleA 无变更，执行更新...
✅ moduleA 更新完成
⚠️  moduleB 有变更，跳过更新
✅ 所有模块处理完成！
```

## 🗑️ 卸载工具
```bash
sudo dpkg -r cmake-spark-tools
```

## 📋 项目说明
- 包名：`cmake-spark-tools`（兼容并替换旧包 `check-cmake-spark`）
- 依赖：`bash`、`git`（系统默认自带，无需额外安装）
- 架构：支持所有 Linux 系统（amd64、arm64 等， Architecture: all）
- 特点：无冗余文件、无配置、静默执行、界面简洁

## ✅ 注意事项
1. 运行命令时，需确保当前目录下存在 `cmake/_spark` 目录，否则会提示错误并退出
2. 构建脚本需使用 `sudo` 权限（用于设置 DEB 包文件属主为 root，消除打包警告）
3. 旧包 `check-cmake-spark` 会被自动替换，无需手动卸载，不影响原有使用习惯