PakePlus 使用指南把网站、HTML、Vue/React 项目快速打包为小于 5M 的多端应用【免费下载链接】PakePlusTurn any webpage/HTML/Vue/React and so on into desktop and mobile app under 5M with easy in few minutes. 轻松将任意网站/HTML/Vue/React等项目构建为轻量级(小于5M)多端桌面应用和手机应用仅需几分钟. https://ppofficial.netlify.app项目地址: https://gitcode.com/GitHub_Trending/pa/PakePlusPakePlus也被开发者称为 PP 或 2P是一个基于 Tauri 2 与 GitHub 的开源打包工具可将任意网站 / HTML / Vue / React 等项目的 dist 静态文件打包为跨平台桌面软件和手机软件打包产物体积小于 5M。本文基于官方使用教程的入门篇 docs/zh/guide/index.md 展开完整梳理它的定位、特性与典型使用场景并进一步结合仓库源码验证“免本地依赖、JS 注入、本地 30 秒打包”等关键能力的实现方式读完即可判断它是否适合你的项目并知道从何入手。一、PakePlus 是什么PakePlus 是一个基于Tauri2 和 GitHub的打包工具核心能力是把“已经能运行的前端产物”变成“像原生应用一样分发的软件”支持将任意网站 / HTML / Vue / React 等项目的 dist 静态文件打包为跨平台桌面软件和手机软件打包产物体积小巧小于 5M且性能好PakePlus 工具本身体积约10M 左右无需在本地安装 Node、Rust 等开发环境即可使用当前仓库版本为2.2.8见 package.json 与 src-tauri/Cargo.toml覆盖 Mac、Windows、Linux 桌面端以及 Android、iOS 移动端仓库内 fastlane/ios 与 fastlane/screenshots 目录即为移动端上架素材与本地化配置的载体。注意官方红线PakePlus 仅作为打包工具使用不支持软件签名打包后的软件仅限自己使用请勿传播或用于商业用途否则后果自负。从仓库的实际产出可以直观看到它的成果形态docs/bundle 目录保留了若干真实打包示例如 Yandex、redbook 的aarch64.dmg、amd64.deb、x64-setup.exe分别对应 macOS Apple 芯片、Linux x64 和 Windows x64 平台。二、核心特性入门文档列出了 PakePlus 的完整特性清单这里按主题归类并完整保留每一项轻量与性能体积比 Electron 包小约 20 倍小于 5M性能快 10 倍官方数据基于 Rust Tauri 构建比基于 JS 的框架更轻量、更快PakePlus 本身只是一个极简的软件用 Tauri 替代旧的打包方式支持跨平台桌面。打包形态内置丰富功能包——支持快捷方式、沉浸式窗口、极简自定义使用原生框架打包 Android 和 iOS APP比 Tauri2 体积更小更快支持静态文件打包将 Vue/React 等项目编译后的 dist 目录甚至单个 index.html丢进来即可成为跨平台客户端支持中文名称打包UI 操作简单美观对新手友好。工作流不需要在本地安装任何复杂的依赖环境使用GitHub Action 云端自动打包省时省心省硬盘空间支持本地打包且同样不需要安装任何依赖环境本地打包仅需约 30 秒不限制文件数量和大小没有 GitHub Token 也没关系本地打包简单方便、不需要 Token而且速度快支持网页端直接使用PakePlus Web但客户端功能更强大更推荐客户端支持 debug 调试模式无论是预览阶段还是发布阶段都可以找到 bug 并消灭 bug。扩展与安全支持自定义 js 注入你可以编写自己的 js 代码注入到页面中支持在 JS 脚本中调用系统级 API例如下载文件 / 执行命令 / 打开新窗口等实现“前端变全端”数据安全你的 Token 仅保存在本地不会上传服务器你的项目也都在你自己的 Git 中安全存储支持国际化对全球用户友好并且会自动跟随你的电脑系统语言遇到问题可随时加入官方技术交流群咨询。三、典型使用场景文档归纳了九类典型场景基本覆盖了“把前端产物应用化”的常见诉求你有一个网站想把它立刻变成桌面应用你有一个 Vue/React 等项目不想购买服务器想把它打包成桌面应用你的 Cocos 游戏想要跨平台客户端运行你的 Unity 项目想要跨平台打包为客户端Web 端产物同样适用隐藏你的网站地址不被随意传播和使用防止爬虫程序获取你的网站内容公司内网平台不想让别人知道网站地址只允许通过你的客户端访问想把某个网站变成自己的客户端实现自定义功能比如注入 JS 实现自动化操作网站广告太多想把它隐藏起来用 JS 来屏蔽它们需要使用 Tauri2 打包但依赖环境太复杂、本地硬盘不够用——就用 PakePlus。四、快速上手流程结合 README 的 Getting Started 与 FAQ标准流程如下以客户端为例下载并运行从 Release 页下载 PakePlus 安装包支持 Mac / Windows / Linux双击安装后直接运行也可以直接使用网页版。配置凭证或选择本地打包配置 GitHub Token或者直接使用免 Token 的本地打包然后创建新项目并配置参数。使用 GitHub Token 时需要相应权限beta 版 Token 权限repoFork 模板仓库、actions管理 Actions、adminFork 及管理仓库文件、contents增删改查仓库内容、issues向 PacBao 提交 issueclassic 版 Token 权限repoFork 并管理模板代码、workflow编译并发布你的软件。使用 GitHub Token 时工具会自动 star 项目、把编译结果计入成功/失败统计打包产物会存放在你自己的开源仓库中任何人都可查看请严格遵循 GitHub 使用规范。预览与发布在新窗口中预览应用效果确认无误后点击发布按钮进行打包。获取产物从 Release 页下载打包好的应用。Mac 用户必读由于 PakePlus 不做官方签名官方签名需 99 美元/年安装后若弹出“App 已损坏”提示点击取消并执行以下命令后重新打开即可# 安装 PakePlus 本身后的处理 sudo xattr -r -d com.apple.quarantine /Applications/PacBao.app # 安装你用 PakePlus 打包的应用时的处理YourAppName 替换为你的应用名 sudo xattr -r -d com.apple.quarantine /Applications/YourAppName.app另外两点 FAQ 值得注意2025 年之前开发的版本基于 Tauri v1.02025 年起升级为 v2.0遇到问题请先升级到最新版添加 GitHub Token 后PakePlus 会 Fork 一个模板仓库到你自己的账号下后续所有项目都依赖该仓库进行创建和编译请勿删除它。五、源码级剖析这些特性是如何实现的文档宣称的每一项能力都能在仓库源码中找到对应实现以下选取与“打包、预览、注入、本地构建”直接相关的部分逐一印证。5.1 为什么产物能小于 5MTauri 2 而非 Electron从 src-tauri/Cargo.toml 可以看到桌面端核心依赖是tauri 2辅以warp本地静态服务、zip产物压缩、machine-uid、notify-rust等 Rust crate完全没有引入任何 JS 运行时或 Chromium 依赖——这正是产物体积小、启动轻的根源。主配置 src-tauri/tauri.conf.json 中frontendDist: ../dist前端产物直接嵌入打包运行时不再依赖开发服务器assetProtocol启用且 scope 为**/*允许应用加载本地资源文件withGlobalTauri: true与create_webview_window: true为“JS 注入 / 打开新窗口”等能力提供全局 API 与多 WebView 支持plugins.updater配置了多个镜像端点与公钥实现客户端的增量更新Windows 下installMode: passive静默安装。5.2 “JS 注入”原理初始化脚本注入到所有 frame特性清单中“支持自定义 js 注入”与“前端变全端”对应源码中的命令注册表 src-tauri/src/lib.rs其中preview_from_config、start_server、windows_build/macos_build/linux_build、build_local、download_file、run_command、open_url等指令暴露给了前端。预览阶段的注入实现在 src-tauri/src/command/cmds.rs 的preview_from_config中先调用start_server在127.0.0.1上用warp起一个本地静态文件服务见 cmds.rs支持自动寻找空闲端口并统一加上no-cache响应头保证预览新鲜度再用WebviewWindowBuilder::from_config按用户配置的窗口参数标题、尺寸、图标创建预览窗口并通过initialization_script_for_all_frames(contents)把用户编写的自定义 JS 注入到所有 frame——这就是“自定义 js 注入页面”的落地方式窗口图标由前端传入的 Base64 PNG 解码后set_icon设置devbug为 true 时自动open_devtools()对应特性中的“debug 调试模式”。而run_command、download_file、open_url、get_env_var等 Rust 命令则支撑了“在 JS 中调用系统级 API执行命令 / 下载文件 / 打开新窗口”的卖点形成“前端变全端”的闭环。5.3 本地打包一次调用完成配置注入 平台适配“本地打包仅需 30 秒、不装任何依赖”对应 cmds.rs 中的build_local命令其流程为读取随应用捆绑的模板配置 src-tauri/data/man.json把本次构建的window配置、debug开关、name、visible: false等字段写入并按平台写入 Base64 图标再整体 Base64 编码通过handle.emit(local-progress, ...)向前端推送 10%→100% 的构建进度分平台执行Windowswindows_build借助捆绑的data/rh.exe脚本工具 PowerShell 完成产物组装捆绑清单见 src-tauri/tauri.windows.conf.jsonman.json、vconsole.min.js、rh.exe均作为 resources 打进安装包因此本机无需任何环境macOSmacos_buildcmds.rs直接拼装标准.app目录结构Contents/MacOS、Contents/Resources拷贝Info.plist与 PakePlus 可执行体写入config/inject/custom.js用户注入脚本与config/www静态产物并用sipsiconutil把 PNG 图标转成.icnspng_to_icnscmds.rsLinuxlinux_build提供对应入口当前源码中该分支为占位实现Linux 本地打包能力以实际发行版为准。云端打包则走 GitHub Actions工具通过用户 Token Fork 官方模板仓库、写入配置后触发 Action 编译产物回到用户自己的仓库 Release 中——这也是“项目存放在你自己的 Git 中”含义的来源。5.4 移动端原生框架 fastlane 素材特性中“使用原生框架打包 Android 和 iOS APP”在仓库中对应 fastlane/ 目录fastlane/ios下含 9 个语言zh-Hans、zh-Hant、en-US、ja、ko、de-DE、es-ES、fr-FR、pt-PT的应用商店元数据description、keywords、subtitle 等与截图本地化脚本localized.sh/localized.yamlfastlane/screenshots 则存放各端e/f/h/pp/r系列上架截图说明移动端走的是原生框架 fastlane 的发布链路。六、安全边界与注意事项结合文档与配置使用 PakePlus 需要清楚以下边界不做签名无代码签名是体积与流程极简的代价Mac 端需手动去除 quarantine 属性见第四节命令也意味着产物只能自用产物可被公网看到走 GitHub Actions 的云端打包会把产物存进你自己的开源仓库请勿打包涉密或敏感内容CSP 约束src-tauri/tauri.conf.json 中定义了明确的 Content-Security-Policy允许asset:、ipc:、本地端口等来源这既约束了 PakePlus 自身也提示使用者注入的 JS 与加载的远程资源需符合该策略版本前提仓库当前基于 Tauri 2tauri 2若你持有 2025 年前的旧版本请升级到最新版以获得 v2 能力。七、延伸阅读仓库内文档与关键文件围绕本入门篇仓库文档站VitePress构建脚本见 package.json 中docs:dev/docs:build提供了完整的进阶教程均位于 docs/zh/guide 下创建项目与打包流程creat.md、down.md应用配置详解config.md、appconfig.mdToken 申请token.md自定义打包custompack.mdJS 脚本与桌面 APIscript.md、desktopapi.md手机应用phone.md、phoneapi.mdTauri 相关tauri.md示例配置与注入脚本scripts/config/man.json、scripts/config/inject/custom.js桌面端核心实现src-tauri/src/lib.rs、src-tauri/src/command/cmds.rs一句话总结PakePlus 的价值在于把“Tauri 打包”这件需要 Rust 工具链和大量配置的事压缩成“填表单 等结果”——桌面端走 Tauri 2 内核保证产物小于 5M移动端走原生框架云端与本地双通道打包再叠加 JS 注入与系统 API 调用能力让任意静态站点都能以最小代价获得跨平台客户端形态。【免费下载链接】PakePlusTurn any webpage/HTML/Vue/React and so on into desktop and mobile app under 5M with easy in few minutes. 轻松将任意网站/HTML/Vue/React等项目构建为轻量级(小于5M)多端桌面应用和手机应用仅需几分钟. https://ppofficial.netlify.app项目地址: https://gitcode.com/GitHub_Trending/pa/PakePlus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
