itools-gui 0.0.0

iTools GUI module
Documentation

iTools GUI

概述

iTools GUI 是 iTools 项目的图形用户界面模块，提供了直观的用户交互界面。

功能特性

  • 现代化的图形界面
  • 响应式设计
  • 国际化支持
  • 与 iTools 核心功能集成

安装

# 从源码构建
cargo build --package itools-gui

# 运行
cargo run --package itools-gui

使用方法

基本使用

  1. 启动 GUI

    cargo run --package itools-gui

  2. 创建新项目

    • 在主界面点击 "New Project" 按钮
    • 输入项目名称和路径
    • 选择项目类型
    • 点击 "Create" 按钮

  3. 打开现有项目

    • 在主界面点击 "Open Project" 按钮
    • 浏览并选择项目目录
    • 点击 "Open" 按钮

项目管理

  • 构建项目：点击工具栏中的 "Build" 按钮
  • 运行项目：点击工具栏中的 "Run" 按钮
  • 检查项目：点击工具栏中的 "Check" 按钮

配置

GUI 配置存储在项目根目录的 .itools/config.toml 文件中。

开发指南

项目结构

itools-gui/
├── src/
│   ├── app.rs         # 应用主逻辑
│   ├── components.rs  # UI 组件
│   ├── event.rs       # 事件处理
│   ├── lib.rs         # 库入口
│   ├── render.rs      # 渲染逻辑
│   ├── style.rs       # 样式定义
│   ├── utils.rs       # 工具函数
│   └── window.rs      # 窗口管理
├── Cargo.toml         # 项目配置
└── readme.md          # 项目文档

扩展 GUI

  1. 添加新组件

    • 在 src/components.rs 中定义新组件
    • 在 src/render.rs 中实现渲染逻辑
    • 在 src/event.rs 中处理组件事件

  2. 添加新功能

    • 在 src/app.rs 中添加新的应用逻辑
    • 更新 UI 组件以支持新功能
    • 添加相应的事件处理

国际化

GUI 支持多语言，翻译资源与 iTools 核心共享。

支持的语言

  • 英文 (en)
  • 中文 (zh-CN)

语言切换

通过系统语言设置自动切换，或在设置菜单中手动选择。

故障排除

  • GUI 启动失败：检查依赖是否正确安装
  • 界面显示异常：检查系统分辨率和显示设置
  • 功能无响应：检查后台服务是否正常运行

贡献

欢迎提交 Issue 和 Pull Request 来改进 iTools GUI。

许可证

AGPL-3.0