202 lines
4.9 KiB
Markdown
202 lines
4.9 KiB
Markdown
# Linux 存储管理器 - 跨平台兼容性实现总结
|
||
|
||
## 目标
|
||
|
||
实现一个打包后的软件，可以在 **Arch Linux** 和 **CentOS 8** 两个系统上运行，统一使用 **Tkinter** 作为 GUI 后端。
|
||
|
||
## 解决方案概述
|
||
|
||
### 核心设计
|
||
|
||
1. **统一入口点** (`main.py`)
|
||
- 直接使用 Tkinter，无需检测 GUI 后端
|
||
- 简化启动逻辑
|
||
|
||
2. **平台检测模块** (`platform_compat.py`)
|
||
- 检测操作系统类型 (Arch/CentOS/RHEL/Ubuntu/Debian)
|
||
- 检查系统前提条件
|
||
- 提供安装指南
|
||
|
||
3. **系统命令兼容模块** (`system_compat.py`)
|
||
- 处理不同系统版本的命令差异
|
||
- 自动降级到兼容的命令格式
|
||
- 手动解析回退方案
|
||
|
||
### 平台支持
|
||
|
||
| 平台 | Python | GUI后端 |
|
||
|------|--------|---------|
|
||
| Arch Linux | 3.7+ | Tkinter |
|
||
| CentOS 8 | 3.6 | Tkinter |
|
||
| CentOS 8 Stream | 3.9+ | Tkinter |
|
||
| RHEL 8 | 3.6 | Tkinter |
|
||
| Ubuntu/Debian | 3.x | Tkinter |
|
||
|
||
### 为什么选择 Tkinter?
|
||
|
||
1. **Python 内置** - 无需额外安装
|
||
2. **跨版本兼容** - 支持 Python 3.6+ (包括 CentOS 8)
|
||
3. **跨发行版** - 所有 Linux 发行版都原生支持
|
||
4. **打包简单** - PyInstaller 处理更稳定
|
||
|
||
## 兼容性修改详情
|
||
|
||
### 1. Python 3.6 兼容性修复
|
||
|
||
#### system_info.py
|
||
```python
|
||
# 修改前 (Python 3.7+)
|
||
result = subprocess.run(
|
||
command_list,
|
||
capture_output=check_output, # 3.7+
|
||
text=True, # 3.7+
|
||
...
|
||
)
|
||
|
||
# 修改后 (兼容 Python 3.6)
|
||
result = subprocess.run(
|
||
command_list,
|
||
stdout=subprocess.PIPE if check_output else None,
|
||
stderr=subprocess.PIPE if check_output else None,
|
||
encoding='utf-8' if check_output else None,
|
||
...
|
||
)
|
||
```
|
||
|
||
#### platform_compat.py
|
||
- `_command_exists()`: 使用 `stdout=subprocess.PIPE` 代替 `capture_output=True`
|
||
|
||
#### system_compat.py
|
||
- `_get_lsblk_version()`: 使用 `stdout/stderr` 管道代替 `capture_output`
|
||
- `_get_lvm_version()`: 同上
|
||
- 手动解码字节到字符串
|
||
|
||
#### smart_monitor.py
|
||
- 为 `dataclasses` 模块提供回退实现
|
||
```python
|
||
if sys.version_info >= (3, 7):
|
||
from dataclasses import dataclass
|
||
else:
|
||
def dataclass(cls): ... # 简化实现
|
||
```
|
||
|
||
#### disk_operations_tkinter.py
|
||
- 修复 f-string 中的中文引号问题 (Python 3.6 f-string 限制)
|
||
|
||
### 2. 系统命令差异处理
|
||
|
||
#### lsblk PATH 列
|
||
- **问题**: CentOS 8 的 lsblk (2.32) 不支持 PATH 列
|
||
- **解决**: 使用 KNAME 列代替，在解析时构建路径
|
||
|
||
```python
|
||
# 命令修改
|
||
"NAME,FSTYPE,...,PATH" → "NAME,KNAME,FSTYPE,...,PKNAME"
|
||
|
||
# 解析时处理
|
||
dev['path'] = f"/dev/{dev['kname']}"
|
||
```
|
||
|
||
#### JSON 格式支持
|
||
- **lsblk JSON**: util-linux 2.23+ (CentOS 8 ✓)
|
||
- **LVM JSON**: LVM 2.02.166+ (CentOS 8 ✓)
|
||
- **回退**: 普通格式 + 手动解析
|
||
|
||
## 文件列表
|
||
|
||
### 新增文件
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `main.py` | 统一入口点 (Tkinter) |
|
||
| `platform_compat.py` | 平台检测模块 |
|
||
| `system_compat.py` | 命令兼容性模块 |
|
||
| `build-compat.sh` | 跨平台构建脚本 |
|
||
| `run.sh` | 启动脚本 |
|
||
| `disk-manager-compat.spec` | PyInstaller配置 |
|
||
| `README_COMPAT.md` | 使用文档 |
|
||
| `COMPAT_SUMMARY.md` | 本文档 |
|
||
|
||
### 修改的文件
|
||
| 文件 | 修改内容 |
|
||
|------|----------|
|
||
| `system_info.py` | 使用兼容性模块；修复 subprocess 调用 |
|
||
| `smart_monitor.py` | 添加 dataclass 回退 |
|
||
| `disk_operations_tkinter.py` | 修复 f-string 引号 |
|
||
| `AGENTS.md` | 添加兼容性文档 |
|
||
|
||
### 保留的原文件
|
||
- `mainwindow_tkinter.py` - Tkinter 主窗口
|
||
- `disk_operations_tkinter.py` - 磁盘操作
|
||
- `lvm_operations_tkinter.py` - LVM 操作
|
||
- `raid_operations_tkinter.py` - RAID 操作
|
||
- 其他所有原始文件
|
||
|
||
## 使用方式
|
||
|
||
### 源码运行
|
||
|
||
```bash
|
||
# 统一入口
|
||
python3 main.py
|
||
|
||
# 或使用启动脚本
|
||
./run.sh
|
||
|
||
# 直接运行主模块
|
||
python3 mainwindow_tkinter.py
|
||
```
|
||
|
||
### 构建打包
|
||
|
||
```bash
|
||
# 使用新的构建脚本
|
||
./build-compat.sh
|
||
|
||
# 或手动打包
|
||
pyinstaller -F disk-manager-compat.spec
|
||
|
||
# 输出
|
||
# dist/disk-manager
|
||
```
|
||
|
||
### 安装依赖
|
||
|
||
#### Arch Linux
|
||
```bash
|
||
sudo pacman -S python tk parted mdadm lvm2
|
||
sudo pacman -S dosfstools e2fsprogs xfsprogs ntfs-3g
|
||
pip3 install pexpect
|
||
```
|
||
|
||
#### CentOS 8
|
||
```bash
|
||
sudo yum install -y python3 python3-tkinter parted mdadm lvm2
|
||
sudo yum install -y dosfstools e2fsprogs xfsprogs ntfs-3g
|
||
pip3 install pexpect
|
||
```
|
||
|
||
## 测试验证
|
||
|
||
在 CentOS 8 环境测试通过：
|
||
|
||
```
|
||
Python 3.6.8
|
||
平台: Linux-4.18.0-348.el8.x86_64
|
||
GUI后端: tkinter
|
||
lsblk: 正常获取块设备
|
||
系统命令: 自动适配
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **权限要求**: 磁盘管理操作需要 root/sudo 权限
|
||
2. **Tkinter 安装**: 确保系统已安装 python3-tkinter/tk
|
||
3. **可选依赖**: mkfs.ntfs 等命令为可选，缺失时相应功能不可用
|
||
4. **打包文件**: 单个可执行文件可在两个系统运行
|
||
|
||
## 后续建议
|
||
|
||
1. 考虑添加更多发行版支持 (Ubuntu/Debian/SUSE)
|
||
2. 可以添加容器化部署选项
|
||
3. 考虑添加主题支持改进 Tkinter 外观
|