Skip to content

快速开始

本指南将帮助您快速上手 QT Tool。

系统要求

  • Rust 1.70 或更高版本
  • 操作系统:Linux、macOS、Windows

安装

预编译二进制(推荐)

点击此处下载最新版本

从源码编译

bash
# 克隆仓库
git clone https://gitee.com/su_xii/qt-tool.git
cd qt-tool

# 编译
cargo build --release

# 可选:将可执行文件添加到 PATH
cp target/release/qt /usr/local/bin/

使用 Cargo 安装(即将推出)

bash
cargo install qt-tool

快速体验

1. 命令行模式

最简单的方式是直接处理 ZIP 文件:

bash
# 压缩包路径 输出文件名 -p 输出路径  -o [输出的文件目录(对应压缩包的文件,按照文件大小从小到大顺序排列)]
qt ./input.zip ok.png -p ./test -o "[v1,v2,v3]"

这将:

  1. 读取 input.zip 文件
  2. 输出名为 ./test/v1/ok.png ./test/v2/ok.png ./test/v3/ok.png 的文件

2. 服务器模式

启动 HTTP 服务:

bash
# 使用当前项目目录下的config.toml启动服务
qt --run

默认情况下,服务会在 http://127.0.0.1:9999 启动。

3. 指定配置文件

使用自定义配置文件:

bash
qt --run --config config.toml

第一个配置

创建一个简单的 config.toml 文件:

toml
[server]
addr = "127.0.0.1:9999"

[[output]]
name = "Android 图标"
description = "Android 应用图标"
base_path = "./android"
format = ["mdpi", "hdpi", "xhdpi"]
zip_format = ["mipmap-mdpi/", "mipmap-hdpi/", "mipmap-xhdpi/"]
format_limit = [".png", ".svg"]

这个配置定义了一个 Android 图标的输出规则:

  • 输出到 ./android 目录
  • 分发到 mdpihdpixhdpi 三个子目录
  • 从 ZIP 的对应目录中读取文件
  • 只允许 .png.svg 文件

下一步

Released under the MIT License.