Flint 客户端使用说明
Flint 是一款专业的图集打包工具,支持 GUI(桌面图形界面)工作流,适用于 Windows 与 macOS 平台。
安装
Windows
-
1
下载
Flint-Setup-x.x.x-x64.exe - 2 双击运行,一键静默安装
- 3 安装完成后桌面和开始菜单会出现 Flint 快捷方式
macOS
-
1
下载
Flint-x.x.x-arm64.dmg(Apple Silicon)或Flint-x.x.x-x64.dmg(Intel) -
2
打开
.dmg文件,将 Flint.app 拖入 Applications 文件夹
绕过 Gatekeeper(必须)
由于应用暂未进行 Apple 公证,macOS 默认会阻止启动。安装后在终端执行以下命令解除限制:
sudo xattr -rd com.apple.quarantine /Applications/Flint.app
执行后即可正常从 Launchpad 或 Applications 打开 Flint。
GUI 使用
启动 Flint 后会加载在线界面,在图形界面中您可以非常直观地进行以下操作:
-
拖入图片或目录进行图集打包
-
配置图集参数(格式、尺寸、间距等)
-
预览打包结果并下载
自动更新
Flint 支持自动检查更新。启动后若检测到新版本,会在界面中提示,确认后自动下载,退出时完成安装。
也可手动检查:菜单栏 → 帮助 → 检查更新。
日志位置
若遇到问题,可查看日志文件:
%APPDATA%\Flint\logs\
~/Library/Logs/Flint/
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 凭证不会自动过期,但授权到期或凭证被撤销后将无法继续打包。