桌面应用跨平台移动开发【免费下载链接】tauriBuild smaller, faster, and more secure desktop and mobile applications with a web frontend.项目地址https://gitcode.com/GitHub_Trending/ta/tauri点击查看免费下载Tauri 项目的应用分发离不开打包环节。本指南以仓库中的 crates/tauri-bundler/README.md 为骨架完整讲解tauri-bundler的全部配置项通用、Debian、macOS 专属设置、tauri.conf.json的bundle对象写法并结合源码剖析一次打包调用的完整执行流程、二进制打补丁、代码签名与自动更新产物生成机制。读完本文你将能够为 macOS.app/.dmg、Linux.deb/.rpm/.AppImage与 Windows.msi/NSIS.exe正确配置并产出可分发的安装包。1. tauri-bundler 是什么从 cargo-bundle 分支而来的打包库tauri-bundler的核心职责是把 Rust 编译出的可执行文件包装成各操作系统原生的应用包app bundle与安装器。它源于经典的 [cargo-bundle] 项目被改造为供 Tauri CLI 使用的库——也就是说不依赖 CLI 也能单独以库的形式调用。在 crates/tauri-bundler/src/lib.rs 的模块文档中明确列出了平台支持范围macOSDMG 与应用包.appLinuxAppImage、Debian.deb与 RPM.rpm包Windows基于 WiX 的 MSI 安装器以及 NSIS 安装器可在非 Windows 主机上通过cargo-xwin交叉构建。注意原 README 的平台清单只提到 MSI using WiX但从 src/bundle/settings.rs 的PackageType枚举可以看到当前实现还包含NsisNSIS.exe、IosBundleiOS 应用包与Updater更新器产物实际能力比文档描述更广。稳定性提示由于该库主要服务于tauri-cli其公开 API 并不严格遵循 SemVer——例如次要版本可能新增结构体字段、修改或删除Error枚举变体。如果你在第三方代码中直接依赖tauri-bundler需要对这类破坏性变更有所预期。从 Cargo.toml 可以看到当前版本为2.10.0采用 Apache-2.0 OR MIT 双许可。2. 配置入口bundle 对象与配置来源Tauri 会自动从tauri.conf.json的bundle对象加载打包配置。但tauri-bundler本身并不依赖这份 JSON——它是一个独立的库非 Tauri 应用同样可以使用配置将回退读取Cargo.toml的[package.metadata.bundle]。在 settings.rs 的SettingsBuilder::build()中有明确注释包设置Package settings从Cargo.toml读取bundle 设置优先读$TAURI_DIR/tauri.conf.json不存在则回退到 Cargo.toml 的[package.metadata.bundle]。配置整体可分为三组适用于所有或大多数系统的通用设置、仅用于 Debian 的专属设置、仅用于 macOS 的专属设置。下面逐一展开。2.1 通用设置General settings配置项必填说明name否应用构建名。缺省时使用Cargo.toml中的name字段。identifier是反向 DNS 形式的应用唯一标识如com.example.appname或io.github.username.project。macOS/iOS 用作 bundle 的CFBundleIdentifierWindows 上会被哈希生成应用 GUID。icon否图标文件路径或 glob 数组支持多种尺寸/格式。tauri-bundler会在不同平台间自动转换图片格式。支持 ICNS、ICO、PNG 以及任何能被imagecrate 解码的格式。面向高分辨率如 Retina的图标应在扩展名前加2x。version否应用版本号。缺省时使用Cargo.toml的version。resources否需要复制进 bundle 资源区的文件或目录列表支持 glob。copyright否应用版权字符串。category否应用分类。可以是人类可读字符串如Puzzle game、macOS 的LSApplicationCategoryType值如public.app-category.puzzle-games或 GNOME 桌面文件分类名如LogicGame打包器会按平台自动转换。short_description否一行短描述。缺省时使用Cargo.toml的description。long_description否更长的多行描述。关于category的“自动转换”在 src/bundle/category.rs 的实现中可见一斑输入字符串会被小写化、去空格与连字符然后在CATEGORY_STRINGS列表中精确匹配若无法精确匹配会使用 Jaro-Winkler 字符串相似度算法给出“你是不是想写……”did you mean的纠错建议并以serde反序列化错误的形式提示用户。AppCategory枚举同时提供freedesktop_categories()与macos_application_category_type()两个映射方法分别输出 GNOME 桌面文件分类如PuzzleGame→Game;LogicGame;和 macOS 的LSApplicationCategoryType值如PuzzleGame→public.app-category.puzzle-games其往返一致性由 category.rs 中的单元测试 保证。2.2 Debian 专属设置depends字符串列表指明安装本包所依赖的其他包如共享库。配置后会写入.deb包 control 文件的Depends:字段。从 settings.rs 的 DebianSettings 结构 可以看到实际实现还支持远超 README 描述的能力recommends、provides、conflicts、replaces、自定义files映射、desktop_templateHandlebars 模板可用变量categories/comment/exec/icon/name、section、priority默认optional、changelog以及pre_install_script/post_install_script/pre_remove_script/post_remove_script四个维护脚本路径。对应的打包实现位于 src/bundle/linux/debian.rs。2.3 macOS 专属设置frameworks需要随应用打包的 macOS 框架列表。每项可以是框架名不带.framework后缀如SDL2此时打包器会在标准安装位置~/Library/Frameworks/、/Library/Frameworks/、/Network/Library/Frameworks/搜索也可以是某个框架包的完整路径如./data/frameworks/SDL2.framework。该设置仅负责把框架复制进Foobar.app/Contents/Frameworks/你仍需自行(1) 让编译产物链接这些框架如在build.rs中输出cargo:rustc-link-libframeworkSDL2(2) 嵌入正确的 rpath如编译后运行install_name_tool -add_rpath executable_path/../Frameworks path/to/binary。minimum_system_version应用支持的最低 macOS 版本字符串如10.11。使用该字段时建议同时在build.rs输出cargo:rustc-envMACOSX_DEPLOYMENT_TARGET10.11保证编译产物与 bundle 声明的最低版本一致。licenseDMG bundle 使用的许可文件路径。exception_domainmacOS.appbundle 使用的例外域名允许应用与外部通信例如随应用分发的 Web 服务器。provider_short_name当你的 Apple ID 关联了多个团队时需要指定用于公证notarize应用的团队 provider short name可通过--list-providers查询获取。同样地源码中的MacOsSettingssettings.rs还提供更多配置signing_identity代码签名身份、skip_stapling跳过票证盖章且不等待公证完成适合首次公证耗时数小时的场景也便于离线环境、hardened_runtime保留 hardened runtime 标志ad-hoc 签名时可设为false放宽限制、entitlementsentitlements.plist 路径或原始 plist 值、info_plist与 bundle Info.plist 合并的 plist 文件或值等。2.4 完整配置示例以下tauri.conf.json示例来自原 README覆盖了上述三组配置的典型写法{ productName: Your Awesome App, version: 0.1.0, identifier: com.my.app, app: {}, bundle: { active: true, shortDescription: , longDescription: , copyright: Copyright (c) You 2021. All rights reserved., icon: [ icons/32x32.png, icons/128x128.png, icons/128x1282x.png, icons/icon.icns, icons/icon.ico ], resources: [./assets/**/*.png], deb: { depends: [debian-dependency1, debian-dependency2] }, macOS: { frameworks: [], minimumSystemVersion: 10.11, license: ./LICENSE }, externalBin: [./sidecar-app] } }仓库中一个更精简的真实案例是 examples/helloworld/tauri.conf.json它仅声明了active: true、targets: all与一套多尺寸图标列表配合productName、version、identifier即可完成一次完整打包。关于externalBin侧车二进制BundleSettings::external_bin要求每个外部二进制名附带目标平台的 target triple 后缀Windows 还需加.exe。例如名为sqlite3的 sidecar在 Linux 上应为sqlite3-x86_64-unknown-linux-gnu在 Windows 上应为sqlite3-x86_64-pc-windows-gnu.exe构建 macOS 通用二进制时则应命名为sqlite3-universal-apple-darwin。打包时打包器会去掉 triple 后缀并复制到 bundle 内见 settings.rs 的 copy_binaries。3. 一次打包调用的完整执行流程无论从 CLI 还是库代码入口最终都会汇聚到 src/bundle.rs 的bundle_project。对照源码整个流程按以下步骤推进解析目标类型调用settings.package_types()确定要构建的包类型。若 CLI 指定了列表则按目标平台过滤否则返回该平台的全部原生类型——macOS 为[MacOsBundle, Dmg]、iOS 为[IosBundle]、Linux 为[Deb, Rpm, AppImage]、Windows 为[WindowsMsi, Nsis]见 settings.rs。按依赖优先级排序PackageType::priority()保证有依赖关系的类型先构建——DMG 依赖.appDmg优先级 1MacOsBundle优先级 0Updater最后优先级 2。跨平台编译检查若目标平台与当前主机不一致会输出“Cross-platform compilation is experimental”的警告提示为获得完整兼容性请使用匹配的主机系统。Windows 预签名sign_binaries_if_needed先对非主二进制与 sidecar 进行签名可被--no-sign跳过。主二进制备份将未签名、未打补丁的主二进制复制到临时文件每个包类型步骤结束后恢复避免“重复签名导致多个签名”、“修改已签名二进制却未更新 PE 校验和破坏签名验证”两类问题。逐类型打补丁与签名对每个包类型调用patch_binary写入 bundle 类型信息见下节随后对主二进制重新签名再分派到具体实现macOS 的macos::app::bundle_project/macos::ios::bundle_project/macos::dmg::bundle_projectWindows 的windows::msi::bundle_project/windows::nsis::bundle_projectLinux 的linux::debian::bundle_project/linux::rpm::bundle_project/linux::appimage::bundle_project。更新器产物若配置了UpdaterSettings会根据目标类型生成 v1 兼容tar.gz/zip 包裹或 v2 插件可直接安装的更新包v1 兼容模式仅支持 app/appimage/msi/nsis且该模式已标记为废弃、将在 v3 移除源码会打印对应警告。清理与汇总macOS 上若仅构建 DMG 或 updater会清理临时生成的.app最后输出每个 bundle 的路径与体积目录会递归统计见 bundle.rs 的 bundle_size。3.1 二进制打补丁Binary Patching与更新器patch_binarybundle.rs在主二进制中查找占位符__TAURI_BUNDLE_TYPE_VAR_UNK将其替换为对应平台/类型的标记如 Linux 的__TAURI_BUNDLE_TYPE_VAR_DEB/_RPM/_APPWindows 的_NSS/_MSI。运行时更新器插件依赖这个标记判断当前安装包类型。若二进制中找不到该占位符会返回Error::MissingBundleTypeVar错误消息提示“Make sure tauri crate and tauri-cli are up to date”见 src/error.rs。这一步骤可通过 CLI 的--no-binary-patching关闭保留已有签名代价是每种包类型各自独立的更新器支持也可通过SettingsBuilder::binary_patching(false)在库代码中关闭。3.2 从 CLI 触发tauri build 与 tauri bundle在 crates/tauri-cli/src/bundle.rs 中定义了tauri bundle子命令tauri build在编译完成后也会走同一逻辑。常用参数包括--bundles list空格或逗号分隔的包类型列表deb/rpm/appimage/app/dmg/msi/nsis/ios/updaterPackageType::from_short_name映射见 settings.rs--target triple指定目标 tripleuniversal-apple-darwin可构建 macOS 通用二进制需同时安装aarch64-apple-darwin与x86_64-apple-darwin目标--config json|path合并额外的 JSON/JSON5/TOML 配置--ci跳过交互提示常与 CI 环境变量配合--no-sign跳过代码签名适合本地开发与 CI--skip-stapling跳过公证票证盖章且不等待公证完成首次公证可能耗时数小时之后建议恢复--no-binary-patching跳过主二进制打补丁。此外目标 triple 未指定时src/bundle/platform.rs 的target_triple()会通过执行rustc --print cfg解析出当前架构与操作系统环境失败时回退到编译期cfg!判断其解析逻辑由 platform.rs 中的单元测试 覆盖。4. 平台专属配置的进阶细节4.1 WindowsWiX 与 NSISWindowsSettingssettings.rs支持代码签名digest_algorithm、certificate_thumbprint、timestamp_url、tsp时间戳协议与自定义签名命令sign_command命令中必须包含%1占位符会被替换为待签名二进制路径默认使用signtool.exe非 Windows 平台交叉签名可用osslsigncode之类的工具。WiX 专属设置WixSettings中值得注意的点upgrade_codeGUID所有更新版本必须保持一致否则 Windows 会把新版当成不同应用导致重复安装。默认由productName.exe.app.x64字符串在 DNS 命名空间下生成 UUID v5可用tauri inspect wix-upgrade-code命令查看versionMSI 版本号格式major.minor.patch.buildbuild 可选major/minor 最大 255、后两段最大 65535language默认en-US可配合.wxl本地化文件enable_elevated_update_task在 Windows 任务计划程序中创建提权更新任务banner_path493×58 px与dialog_image_path493×312 px可定制安装界面位图。NSIS 设置NsisSettings提供header_image150×57 px、sidebar_image164×314 px、installer_icon/uninstaller_icon、install_modeNSISInstallerMode安装范围、languages与display_language_selector默认按 OS 语言选择不在列表则用第一个语言、compression压缩算法、start_menu_folder开始菜单分组以及installer_hooks通过NSIS_HOOK_PREINSTALL/POSTINSTALL/PREUNINSTALL/POSTUNINSTALL宏注入自定义 NSIS 脚本逻辑。NSIS 模板与语言文件位于 src/bundle/windows/nsis 目录。4.2 图标与资源处理打包器从BundleSettings::icon读取图标列表并在构建Settings时过滤掉以.icon结尾的条目settings.rs。不同平台所需格式ICNS/ICO/PNG会自动转换Retina 图标依赖2x命名约定。资源支持resources列表与resources_map映射到目标目录优先级更高两者不可同时使用glob 展开与目标路径计算由tauri-utils的ResourcePaths完成。5. 依赖、错误体系与许可从 Cargo.toml 可以看出其技术栈image图标转换、glob资源通配、handlebars模板渲染、zip/tar/flate2更新器压缩、rpmRPM 打包、tauri-macos-signmacOS 签名、windows-registry/windows-sysWindows 平台查询、ureq工具下载等。错误类型集中在 src/error.rs覆盖文件系统、子进程、图片解码、glob、URL 解析、签名SignToolNotFound、公证NotarizeAuthError提示设置APPLE_TEAM_ID或APPLE_API_KEY/APPLE_API_ISSUER/APPLE_API_KEY_PATH环境变量等场景并提供了带路径上下文的ErrorExt::fs_context辅助。许可方面tauri-bundler沿用 Tauri 生态的 Apache-2.0 OR MIT 双许可原 README 版权声明为 “(c) 2017 - present, George Burton, Tauri-Apps Organization”。需要特别说明的是DMG 打包引入了 BSD 3 条款许可的seticon二进制用于设置 DMG 图标其源码来自 osxiconutils 项目随仓库分发于 Windows/macOS 打包模板相关目录中。6. 实践要点小结identifier是唯一必填项务必采用反向 DNS 形式且不要在发布后随意变更——它决定 macOS 的CFBundleIdentifier与 Windows 的应用 GUIDWindows MSI 的upgrade_code是“一次设置、永久保留”的字段发布前请用tauri inspect wix-upgrade-code确认并固化到配置中多目标平台发布时sidecar 二进制必须按 target triple 命名否则打包器找不到对应文件跨平台打包属实验特性生产发布建议在目标平台原生环境执行避免 WiX/NSIS/签名等工具链差异带来的意外需要自动更新时确保目标类型在 app/appimage/deb/rpm/msi/nsis 之列并在 bundle 配置中开启更新器相关设置同时保持tauricrate 与tauri-cli版本一致以免__TAURI_BUNDLE_TYPE占位符缺失导致打补丁失败。深入阅读源码可继续查看 crates/tauri-bundler/src/bundle.rs总流程、crates/tauri-bundler/src/bundle/settings.rs全部配置结构、crates/tauri-bundler/src/bundle/category.rs分类映射以及 crates/tauri-cli/src/bundle.rsCLI 参数定义。赞分享桌面应用跨平台移动开发【免费下载链接】tauriBuild smaller, faster, and more secure desktop and mobile applications with a web frontend.项目地址https://gitcode.com/GitHub_Trending/ta/tauri点击查看免费下载相关推荐linux-tutorial 项目实战Linux 文件压缩与解压完全指南tar / gzip / zip / unziplinux tutorial 项目实战Linux 文件压缩与解压完全指南tar / gzip / zip / unzip 导读 本文是 linux tut桌面应用跨平台移动开发Silicon错误处理与调试10个常见问题解决方案大全Silicon错误处理与调试10个常见问题解决方案大全 Silicon是一款基于Rust开发的源代码美化图片生成工具能够将您的代码转换为精美的图片。作为Ca开发工具CLI图像处理跨平台应用自动化构建神器Tauri Action深度解析跨平台应用自动化构建神器Tauri Action深度解析 还在为多平台应用发布而烦恼吗每次都要手动为不同操作系统编译打包耗时又容易出错。现在Tauri上一篇Terratest测试文档最佳实践如何编写清晰的测试说明下一篇学习Go语言的终极宝库learning_tools项目完全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考