Tiny RDM 构建目录全解析基于 Wails 的 macOS / Windows / Linux 打包资源与安装包定制指南【免费下载链接】tiny-rdmTiny RDM (Tiny Redis Desktop Manager) - A modern, colorful, super lightweight Redis GUI client for Mac, Windows, and Linux. It also provides a web version that can be deployed via Docker.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny-rdmTiny RDMTiny Redis Desktop Manager是一款基于 Wails 框架的跨平台 Redis 图形化客户端其桌面端同时面向 macOS、Windows 与 Linux 三套系统分发。而这一切跨平台构建能力的落点正是仓库根目录下的build/目录——它集中存放了三平台的构建资源、安装包脚本与应用图标并在wails build/wails dev时被模板化渲染进最终产物。本文以 build/README.md 为主体脉络逐文件拆解 build 目录的职责分工、模板变量机制与各平台打包细节并结合仓库内真实配置文件给出可直接复用的定制与回退方案。一、build 目录的定位与整体结构根据 build/README.md 的说明build 目录的唯一职责是存放应用的全部构建文件与资源build files and assets。它本身不参与运行时逻辑只在打包阶段被读取、渲染并写入产物。文档约定的基础结构为目录 / 文件用途bin/构建输出目录wails build的产物落点darwin/macOS 专用构建文件windows/Windows 专用构建文件不过对照当前仓库的实际目录树Tiny RDM 的 build 目录在文档所述基础之上还扩展了更多平台资源build/darwin/Info.plist正式构建用与Info.dev.plist开发模式用build/windows/icon.ico、info.json、wails.exe.manifest以及 build/windows/installer/ 下的 NSIS 安装脚本build/linux/Debian 系.deb打包所需的DEBIAN/control、.desktop启动器与 hicolor 图标目录名为tiny-rdm_0.0.0_amd64其中0.0.0是模板渲染前的占位版本号build/dmg/macOS DMG 镜像制作资源背景图与辅助脚本build/appicon.png1024×1024 的应用图标源文件是各平台图标的母版。可以看到build 目录事实上是一源appicon.png 模板配置多端三平台资源的打包资源中心。bin/属于构建产物输出位置通常由本地wails build生成不随源码入库因此当前仓库树中并未包含它。二、构建元数据的源头wails.json 与模板变量机制理解 build 目录内各文件前必须先认识它们的数据源——仓库根目录的 wails.json。build 目录中几乎所有配置文件都包含{{.Name}}、{{.Info.ProductName}}这类 Go 模板变量wails build时由 Wails CLI 从 wails.json 取值统一渲染。当前项目的 wails.json 关键配置如下{ $schema: https://wails.io/schemas/config.v2.json, name: tinyrdm, outputfilename: Tiny RDM, frontend:install: npm install, frontend:build: npm run build, frontend:dev:watcher: npm run dev, frontend:dev:serverUrl: auto, author: { name: tiny-craft, email: lykinhuangoutlook.com }, info: { companyName: Tiny Craft, productName: Tiny RDM, productVersion: 1.0.0, copyright: Copyright © 2026, comments: Tiny Redis Desktop Manager } }各字段对 build 目录的影响如下nametinyrdm填充模板变量{{.Name}}被用于 macOS 的 Bundle Identifiercom.tinycraft.{{.Name}}、Windows 程序集标识com.wails.{{.Name}}、Linux 包名与.desktop的StartupWMClassoutputfilenameTiny RDM决定最终可执行文件/应用包的名称也是 Windows 安装器输出路径中的${INFO_PROJECTNAME}取值来源info块向{{.Info.ProductName}}、{{.Info.ProductVersion}}、{{.Info.CompanyName}}、{{.Info.Copyright}}、{{.Info.Comments}}等模板变量提供数据会同时影响三平台的版本号、版权信息与描述文案frontend:*三项定义前端安装、构建与开发监听命令是wails build/wails dev的流水线入口本仓库前端实际构建命令由 frontend/package.json 的 scripts 承载。实践结论当需要统一修改应用名称、版本号、公司名或版权信息时只需改动 wails.json 的info块并重新执行wails build所有平台产物会同步更新无需逐个修改 build 目录下的文件。三、macOS 构建资源darwin 目录3.1 两个 plist 的分工darwin目录持有两份内容几乎一致的 plist 文件分别服务于两种构建模式见 build/README.mdbuild/darwin/Info.plist主 plistwails build打包正式版时使用build/darwin/Info.dev.plist与主 plist 相同但用于wails dev开发调试构建。两份文件均基于 Apple 的 PropertyList 1.0 格式且通过{{.Info.*}}模板变量与 wails.json 打通。其中值得关注的键值以 Info.plist 为例键值说明CFBundlePackageTypeAPPL声明为应用程序包CFBundleName/CFBundleExecutable{{.Info.ProductName}}应用显示名与可执行文件名CFBundleIdentifiercom.tinycraft.{{.Name}}反向域名风格的 Bundle ID由name拼接生成CFBundleVersion/CFBundleShortVersionString{{.Info.ProductVersion}}构建版本号与短版本号CFBundleIconFileiconfile应用图标文件名LSMinimumSystemVersion11.7.0最低支持 macOS 系统版本NSHighResolutionCapabletrue声明支持高分屏Retina渲染NSHumanReadableCopyright{{.Info.Copyright}}人类可读的版权声明3.2 dev 版 plist 的独有差异对比两份文件可以发现Info.dev.plist 额外声明了NSAppTransportSecurity下的NSAllowsLocalNetworking true。这是开发模式下独有的网络豁免允许应用访问本地网络资源如连接本机/局域网内的 Redis 服务、调试用的本地 WebSocket 或后端接口而正式版不携带该豁免避免引入不必要的安全面。从源码结构看这一差异正是开发与生产环境网络策略区分的实现点。3.3 恢复默认状态文档明确说明darwin下的文件可自定义并参与构建如需恢复默认直接删除它们然后执行wails buildWails 会按默认模板重新生成。因此对 macOS 构建文件的定制是无损、可回滚的。四、Windows 构建资源windows 目录windows目录负责三件事应用图标、应用元数据右键属性详情、以及安装器与清单文件见 build/README.md。4.1 icon.ico应用图标及其自动生成机制build/windows/icon.ico 是 Windows 应用图标256×256在wails build时被打入可执行文件。文档特别指出两条规则想更换图标直接用自己的.ico替换该文件即可若该文件缺失Wails 会自动使用 build 目录下的 build/appicon.png1024×1024 源图生成新的icon.ico。这解释了appicon.png作为图标母版的定位它既是 Linux 图标的来源也是 Windows 图标缺失时的兜底生成源。替换图标的最稳妥做法是更新appicon.png→ 删除旧的icon.ico→ 重新wails build让 Wails 重新派生各尺寸图标。4.2 info.jsonWindows 文件属性详情build/windows/info.json 以模板形式承载 Windows 版本资源其数据会被 Windows 安装器以及应用本身使用右键 exe → 属性 → 详细信息。结构分两部分{ fixed: { file_version: {{.Info.ProductVersion}} }, info: { 0000: { ProductVersion: {{.Info.ProductVersion}}, CompanyName: {{.Info.CompanyName}}, FileDescription: {{.Info.ProductName}}, LegalCopyright: {{.Info.Copyright}}, ProductName: {{.Info.ProductName}}, Comments: {{.Info.Comments}} } } }fixed.file_version固定文件版本号info.0000映射到资源查看器中的文件版本 / 公司名称 / 文件说明 / 版权 / 产品名称 / 备注等详情条目。所有值均来自 wails.json 的info块改一处即全局生效。4.3 wails.exe.manifestDPI 与系统控件清单build/windows/wails.exe.manifest 是主应用程序清单文件其关键声明包括程序集标识com.wails.{{.Name}}版本跟随{{.Info.ProductVersion}}依赖Microsoft.Windows.Common-Controls6.0启用现代通用控件视觉样式显式声明高 DPI 支持dpiAware设为true/pm兼容 Windows 7/8dpiAwareness设为permonitorv2,permonitor优先每显示器 V2 感知不支持时回退到每显示器感知。这一配置对 Tiny RDM 这类需要渲染大量列表、树形控件与文本的 GUI 工具至关重要能避免高分屏下的模糊与错位。4.4 installer/NSIS 安装器工程installer/*是用于创建 Windows 安装程序的文件build/README.md包含两份脚本project.nsibuild/windows/installer/project.nsiNSIS 安装脚本本体。其头部注释给出了非常有用的调试方法——wails_tools.nsh 未生成时可先执行wails build --target windows/amd64 --nsis生成它再直接用makensis手动构建安装器例如makensis -DARG_WAILS_AMD64_BINARY..\..\bin\app.exe。脚本关键逻辑页面流程使用 MUIModern UI 2Welcome → Directory → InstFiles → Finish外加卸载页并定义了MUI_ABORTWARNING退出时警告与MUI_FINISHPAGE_NOAUTOCLOSE安装完成后停留让用户查看细节安装段依次执行wails.checkArchitecture架构校验、wails.setShellContext、wails.webview2runtime确保目标机器具备 WebView2 运行时、wails.files拷贝应用文件随后在开始菜单与桌面创建快捷方式并写入卸载器卸载段除删除安装目录与快捷方式外还会清理$AppData\${PRODUCT_EXECUTABLE}即 WebView2 的应用数据目录实现较彻底的卸载默认安装路径为$PROGRAMFILES64\${INFO_COMPANYNAME}\${INFO_PRODUCTNAME}安装器输出到..\..\bin\${INFO_PROJECTNAME}-${ARCH}-installer.exe文件头部以注释形式保留了代码签名钩子signtool与 EULA 页面、欢迎页位图等可选项的接入位置需要签名或自定义界面时在此处取消注释即可重要约定该文件内的模板替换不生效所有INFO_*值由 wails_tools.nsh 从 wails.json 的 ProjectInfo 填充若在此手动!define覆盖wails_tools.nsh 将不再覆盖它们见文件头注释。wails_tools.nshbuild/windows/installer/wails_tools.nsh文件首行即注明DO NOT EDIT—— 由wails build自动生成它引入x64.nsh、WinVer.nsh、FileFunc.nsh等 NSIS 标准库为未手动定义的INFO_PROJECTNAME、INFO_COMPANYNAME、INFO_PRODUCTVERSION、INFO_COPYRIGHT、PRODUCT_EXECUTABLE等提供默认值默认值即 wails.json 的模板渲染结果定义卸载注册表键Software\Microsoft\Windows\CurrentVersion\Uninstall\...默认请求管理员权限执行REQUEST_EXECUTION_LEVEL默认admin可在 project.nsi 中覆盖根据传入的ARG_WAILS_AMD64_BINARY/ARG_WAILS_ARM64_BINARY自动判定架构amd64/arm64/amd64_arm64并包含wails.checkArchitecture、wails.webview2runtime、wails.files、wails.writeUninstaller等宏的实现以及 Windows 10Server 2016及以上的系统版本校验。五、Linux 打包资源linux 目录虽然 build/README.md 正文仅提及 darwin 与 windows但仓库实际的 build/linux/ 目录承担了 Debian/Ubuntu 系 .deb 包的资源组织其布局为一个标准的 Debian 包目录树tiny-rdm_0.0.0_amd64/DEBIAN/control包控制元数据同样全部模板化Package: {{.Name}}、Version: {{.Info.ProductVersion}}、Architecture: amd64Depends: {{.libwebkit2gtk.PackageName}}声明对 WebKit2GTK 运行库的依赖——这是 Wails/Linux 桌面应用渲染前端所必需的底层组件安装 .deb 时包管理器会自动处理该依赖Maintainer: {{.Author.Name}} {{.Author.Email}}维护者信息来自 wails.json 的author块Description: {{.Info.Comments}}包描述复用info.comments。usr/share/applications/tiny-rdm.desktop桌面启动器条目Exec/usr/local/bin/tiny-rdm %U可执行文件安装路径与参数透传Icontiny-rdm引用系统图标主题中的tiny-rdmStartupWMClasstinyrdm与 wails.json 的name对应用于窗口管理器的窗口匹配任务栏分组、图标关联MimeTypex-scheme-handler/tinyrdm;注册自定义 URL Scheme允许通过tinyrdm://协议唤起应用——这是 Tiny RDM 支持深链Deep Link能力的打包侧依据CategoriesOffice;等字段用于桌面环境菜单归类。usr/share/icons/hicolor/512x512/apps/tiny-rdm.png512×512 的 hicolor 规范图标供桌面环境各尺寸缩放使用。目录名中的0.0.0为未渲染前的占位版本号实际打包时由 Wails 依据 wails.json 的productVersion替换因此无需手工修改目录名。六、DMG 镜像资源dmg 目录build/dmg/ 存放 macOS 磁盘镜像DMG制作的辅助资源background.tiffDMG 窗口的背景图660×400安装包打开时呈现品牌化视觉fix-app 与 fix-app_zh从文件命名可以推断这是对 .app 包进行后处理/修补的辅助脚本提供英文与中文版本用于在生成 DMG 前修正或优化应用包的某些状态。该目录属于文档未展开、但实际参与 macOS 分发链的扩展资源。七、与构建流程的配合从 build 目录到最终产物build 目录并非孤立存在它嵌在 Wails 的完整构建流水线中。综合 wails.json 与 Dockerfile可梳理出两条构建路径桌面版wails buildCLI 依次执行frontend:installnpm install→frontend:buildnpm run build产出前端静态资源→ 读取 build 目录资源并以 wails.json 渲染{{.*}}模板 → 编译 Go 后端入口为根目录的 main.go→ 将前端资源嵌入可执行文件 → 按目标平台组装 .app / .exe / .deb 并输出到bin/。开发模式wails dev则改用frontend:dev:watchernpm run dev启动前端热更新服务并使用Info.dev.plist构建 macOS 调试包。Web 版DockerTiny RDM 同时提供 Web 形态。仓库根目录的 Dockerfile 采用三阶段构建详见 Dockerfilefrontend-builder阶段以 Node 22 执行npm run build并设置VITE_WEBtrue环境变量backend-builder阶段以 Go 1.25 编译main_web.go命令为go build -tags web即通过 build tag 区分 Web 入口与桌面入口产物输出为tinyrdm-server最终runtime阶段以 Alpine Nginx 承载前端静态资源并反向代理 Go 服务对外暴露 8086 端口。这一路径与 build 目录无关但可作为理解同一仓库、多形态分发的对照桌面三平台走 build 目录资源Web 形态走 Docker 镜像。八、定制与回退实践建议汇总综合原文档与仓库源码对 build 目录的常见定制操作可归纳如下目标操作依据修改应用名/版本/版权改 wails.json 的info块重新wails build模板变量贯穿三平台更换 Windows 图标替换 icon.ico或更新 appicon.png 后删除 icon.ico 让其自动生成build/README.md 的 icon.ico 说明定制 Windows 安装行为编辑 project.nsi覆盖INFO_*或调整页面/快捷方式/安装路径project.nsi 头注释调整 macOS 最低系统版本或网络策略编辑 Info.plist / Info.dev.plistplist 键值即构建期生效调整 Linux 包依赖与启动器编辑 control 与 tiny-rdm.desktopDebian 包布局恢复某平台默认构建资源删除对应目录如darwin/、windows/下的文件重新wails buildbuild/README.md 明示几点注意wails_tools.nsh由wails build自动生成、禁止手工编辑project.nsi内的模板替换不生效版本等元数据依赖 wails_tools.nsh 从 wails.json 填充所有 build 资源均为模板驱动单一信息源wails.json是保持三平台配置一致性的关键。整体而言Tiny RDM 的 build 目录是一套设计清晰的 Wails 标准构建资源中心——理解了它的文件职责与模板机制就能在不触碰业务代码的前提下独立完成跨平台打包、品牌定制与安装器裁剪。【免费下载链接】tiny-rdmTiny RDM (Tiny Redis Desktop Manager) - A modern, colorful, super lightweight Redis GUI client for Mac, Windows, and Linux. It also provides a web version that can be deployed via Docker.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny-rdm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考