Flint 客户端使用说明

Flint 是一款专业的图集打包工具,支持 GUI(桌面图形界面)工作流,适用于 Windows 与 macOS 平台。

安装

Windows

  1. 1 下载 Flint-Setup-x.x.x-x64.exe
  2. 2 双击运行,一键静默安装
  3. 3 安装完成后桌面和开始菜单会出现 Flint 快捷方式

macOS

  1. 1 下载 Flint-x.x.x-arm64.dmg (Apple Silicon)或 Flint-x.x.x-x64.dmg (Intel)
  2. 2 打开 .dmg 文件,将 Flint.app 拖入 Applications 文件夹

绕过 Gatekeeper(必须)

由于应用暂未进行 Apple 公证,macOS 默认会阻止启动。安装后在终端执行以下命令解除限制:

sudo xattr -rd com.apple.quarantine /Applications/Flint.app

执行后即可正常从 Launchpad 或 Applications 打开 Flint。

GUI 使用

启动 Flint 后会加载在线界面,在图形界面中您可以非常直观地进行以下操作:

  • 拖入图片或目录进行图集打包
  • 配置图集参数(格式、尺寸、间距等)
  • 预览打包结果并下载

自动更新

Flint 支持自动检查更新。启动后若检测到新版本,会在界面中提示,确认后自动下载,退出时完成安装。

也可手动检查:菜单栏 → 帮助 → 检查更新。

日志位置

若遇到问题,可查看日志文件:

Windows %APPDATA%\Flint\logs\
macOS ~/Library/Logs/Flint/
Flint CLI

Flint CLI

使用 Windows x64 版 Flint CLI,将图集打包接入本地脚本与 CI 自动化流程。

1. 购买 Flint CLI 年度授权

在 Flint 首页下载区购买 Flint CLI 年度授权,价格为 79 元/年,不自动续费。有效期内暂不支持提前购买,到期后可通过原入口重新购买。

2. 运行 Flint CLI

下载并解压 Windows x64 压缩包,在解压目录中打开终端,直接运行 flint.exe。当前暂不支持 macOS 和 Linux。

3. 登录授权

安装完成后,在终端执行以下命令。浏览器会打开 Flint 授权页;完成登录后,终端会自动继续。

./flint.exe login

4. 第一次图集打包

指定素材目录和输出目录,即可生成图集图片及对应的引擎配置文件。

./flint.exe pack ./assets -o ./output --format cocos

输入支持 PNG 和 JPG,并递归扫描子目录。配置格式支持 PixiJS、Cocos、Unity、Godot、LayaAir、Unreal 和 Phaser;不指定 -o 时默认输出到当前目录。

原始图片在本机读取,图集在本机合成;服务端只接收图片尺寸和排版参数。登录和每次打包都需要联网,每次打包都会实时检查 Flint CLI 授权。

5. 退出授权

执行 logout 可撤销服务端凭证,并删除本机保存的凭证文件。

./flint.exe logout

6. Windows CI 运行

使用 --credentials-file 将凭证保存到指定文件,把该文件作为受保护的 CI 凭证保存并在构建时恢复。不要输出文件内容;构建环境需联网完成权益校验与排版。

./flint.exe login --credentials-file ./cli-credentials.json
./flint.exe pack ./assets --credentials-file ./cli-credentials.json

7. 授权与功能边界

Flint CLI 年度授权只包含 Windows x64 版 CLI 图集打包,不包含 AI 积分、AI 素材处理、图集分割或 flint.config.json。

浏览器登录请求有效 10 分钟。若请求失效,请返回终端重新执行 ./flint.exe login。

CLI 凭证不会自动过期,但授权到期或凭证被撤销后将无法继续打包。