PakePlus 配置指南App 基础配置、脚本注入与 Tauri 窗口参数的完整解析【免费下载链接】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本文围绕 PakePlus 的基础配置文档展开覆盖创建项目后必须填写的四个必填项App 名称、网址、App ID、版本号以及图标、窗口保持、单例模式、调试、脚本注入等全部可选配置项。结合仓库中的配置模板 scripts/ppconfig.json 与 Tauri 端源码 src-tauri/src/command/cmds.rs、src-tauri/src/utils/init.rs你可以理解每个配置项最终如何映射到打包产物并掌握从 Preview 到 Publish 的完整配置生效链路。一、四个必填项名称、网址、App ID、版本号创建项目后PakePlus 要求先完成基础配置。其中前四项为必填其余按需求选填配置项说明约束App 名称应用名称将作为打包产物的名称支持中文、英文等但不允许包含空格网站地址要打包的网址必须是http://或https://开头的地址也支持本地 HTML 文件、Vue/React 构建后的dist文件夹单个文件最好不超过 10MBGitHub 云端打包的限制视频/图片建议使用外链或压缩到 10MB 以下App ID软件唯一标识全局唯一不能与其他项目重复版本号区分应用的不同版本用于版本管理与更新追踪中文文档 docs/zh/guide/config.md 中对 App ID 给出了更严格的格式规范值得在填写时注意仅允许小写字母、数字、下划线段以.分隔的部分不能以数字开头不允许连续点也不允许首尾出现点。例如com.xiaoshen.app这类反向域名风格的 ID 就是符合规范的写法。仓库自带的配置模板 scripts/ppconfig.json 中桌面端与移动端分别使用了com.xiaoshen.app、com.xiaoshen.PakePlus.ios、com.xiaoshen.PakePlus.android这样的示例值。版本号在配置结构中默认值为0.0.1每次发布新版本时递增便于用户区分新旧版本。二、完整配置结构从 16 个配置项到 JSON 字段文档列出的 16 个配置项与 PakePlus 实际使用的配置模板存在一一对应关系。查看 scripts/ppconfig.json 可以直接看到这些字段是如何组织的{ name: , url: , showName: , appid: , icon: , iconRound: true, state: true, single: true, injectJq: true, tauriApi: false, devbug: false, version: 0.0.1, preview: desktop, platform: [1-1, 1-2, 2-1, 2-2], width: 800, height: 600, desc: , jsFile: [], filterCss: , customJs: , isHtml: false, htmlPath: , htmlFiles: [] }各配置项与字段的映射如下文档中的配置项JSON 字段作用App 图标icon/iconRound支持上传本地图片iconRound控制 macOS 图标圆角切换不填时默认使用 PakePlus 图标窗口保持state二次启动时是否恢复上次的窗口大小与位置单例模式single多次点击桌面图标时只允许打开一个应用实例开发调试devbug启用后可以在预览窗口中打开调试工具Tauri APItauriApi启用后可以在注入脚本的 JS 中调用 Tauri 接口脚本文件jsFile/customJs任意 JS 脚本应用启动时执行注入进阶功能不懂代码不建议修改窗口模式preview支持 Desktop / iPhone / iPad / Android / 自定义布局过滤元素filterCss通过 CSS 选择器过滤不需要显示的元素例如广告App 描述desc说明应用是什么、有什么作用更多配置右上角more.windows自定义窗口配置详见 Tauri 2 文档进阶功能不确定不要修改JSON 配置more整体支持 JSON 格式的深度配置进阶功能不确定不要修改注入 jQueryinjectJq注入 jQuery 库供自定义脚本操作 DOM使用时需熟悉 jQuery本地 HTMLisHtml/htmlPath/htmlFiles打包本地 HTML 文件或dist目录移动端与平台相关配置在模板中单独成组phonesafeArea、header、siderMenu、tabBar、webview 等移动端界面项、ios、android、desktop各含name、version、id、webUrl、icon、debug等字段。桌面端更高级的窗口属性则集中在more.windows下包括userAgent、width/height、minWidth/minHeight、maxWidth/maxHeight、decorations、transparent、alwaysOnTop、center、skipTaskbar、dragDropEnabled、devtools等几十个可直接对照 Tauri 2WindowConfig文档的键值。三、Preview 与 Publish配置在源码中的生效链路文档指出完成基础配置后点击Preview可预览应用最终效果确认无误后点击Publish开始打包。这两个动作在 Tauri 端有明确的实现对应。本地静态服务器HTML/dist 打包的前置条件当网站地址不是http(s)地址而是本地dist文件夹时需要先把静态目录变成可访问的 URL。src-tauri/src/command/cmds.rs 中的start_server命令用 warp 框架在127.0.0.1上启动静态文件服务端口为 0 时调用find_port()通过TcpListener::bind(127.0.0.1:0)自动探测空闲端口路由上除了静态文件外还注册了callback路径用于接收 OAuth 参数并发射callback事件给前端所有响应都会加上Cache-Control: no-store、Pragma: no-cache、Expires: 0等头部确保预览时始终拿到最新内容。运行中的应用同理get_www_dir命令会读取打包产物内的config/www目录参考 scripts/config/www/index.html非空时自动起本地服务并返回http://127.0.0.1:端口作为窗口 URL。预览窗口按配置生成 WebviewWindow点击 Preview 时调用的是preview_from_config命令它接收 Tauri 的WindowConfig即上表中的窗口参数、注入脚本js_content、devbug开关和 base64 编码的图标以窗口标签PreView复用已存在的预览窗口尺寸变化时只set_size否则关闭重建通过WebviewWindowBuilder::from_config依据完整窗口配置建窗initialization_script_for_all_frames(js_content)把自定义脚本注入所有框架——这正是“脚本文件在启动时执行”的实现位置图标从data:image/png;base64,前缀剥离并解码后set_icon生效所以预览窗口能显示你上传的图标devbug为 true 时调用open_devtools()对应“开发调试启用后可以在预览窗口中调试页面”。发布打包配置写入产物的三件套点击 Publish 走build_local命令其核心动作是读取模板 src-tauri/data/man.json结构含name、version、description、window、debug、icon等字段把你配置的WindowConfig覆盖到window字段同时写入debug、name、visibleWindows 平台还写入 base64 图标整体 Base64 编码后由windows_build/macos_build写入产物目录的config/man文件自定义 JS 写入config/inject/custom.js参考 scripts/config/inject/custom.js 的示例内容HTML 源目录复制到config/wwwmacOS 分支还会调用png_to_icns用系统sipsiconutil把你上传的 PNG 转成.icns放进Contents/Resources。也就是说你在界面上的所有配置最终都固化成了产物中的三份文件config/man窗口与应用元信息、config/inject/custom.js启动注入脚本、config/www/本地站点。四、关键配置项的源码级细节窗口保持store 持久化窗口状态state开启后应用二次启动会恢复窗口大小与位置。src-tauri/src/utils/init.rs 的resolve_setup展示了完整机制启动时从tauri-plugin-store打开以应用名命名的{name}.json存储见 package.json 中的tauri-apps/plugin-store依赖依次读取window_size、window_position、fullscreen、maximized并恢复config.center为 true 或坐标无效时回退到屏幕居中注册WindowEvent监听Resized时写入window_size与maximized/fullscreen标记Moved时写入window_position最小化/最大化状态下不写避免记录无效坐标。cmds.rs中的update_init_rs命令则负责生成代码层面的开关把模板init.rs中的WINDOWCONFIG占位符替换为实际配置并在关闭窗口保持时将if true {替换为if false {——从源码结构看这就是state配置被编译进产物的方式。单例模式single: true保证多次点击桌面图标只打开一个实例。该能力依赖 Tauri 的单实例插件package.json 中引入了tauri-apps/api及多个tauri-apps/plugin-*包均基于 Tauri 2 体系。开发调试DevTools 与 vConsole 两条路径调试配置在两个阶段分别生效预览阶段preview_from_config中devbug为 true 直接open_devtools()产物运行阶段resolve_setup读取man中的debug字段为 true 时向注入脚本追加var vConsole new window.VConsole();对应产物内随附的 src-tauri/data/vconsole.min.js在页面内提供移动端风格的调试控制台。Tauri API 与脚本注入tauriApi开启后注入脚本可直接调用 Tauri 的 JS 接口前端依赖tauri-apps/api。customJs/jsFile内容通过两条通道进入应用预览时经initialization_script_for_all_frames运行时由get_config_js读取产物中的config/inject/custom.js再交给initialization_script执行见 src-tauri/src/command/cmds.rs 的get_config_js与 src-tauri/src/utils/init.rs 的resolve_setup。文档对此明确标注了警告这是面向有编码经验用户的高级功能不熟悉代码不要修改。元素过滤与 jQuery 注入filterCss填写 CSS 选择器即可隐藏窗口中的指定元素如广告位适合把带营销组件的网页打包成干净的应用injectJq开启后先注入 jQuery再配合自定义脚本用$语法操作 DOM。两者都属于“增强注入脚本能力”的配套选项单独使用意义有限通常与脚本文件搭配。窗口模式与高级 JSON 配置preview字段控制窗口呈现形态Desktop / iPhone / iPad / Android / 自定义对应模板中platform数组的多端选择。右上角“更多配置”与 JSON 配置入口最终都落到more.windows结构其键值与 Tauri 2 的WindowConfig对齐——例如userAgent可模拟特定浏览器、decorations: false可去标题栏、transparent可做透明窗口、skipTaskbar可隐藏任务栏图标。文档对这两处同样给出“核弹级”警告修改前建议先阅读 Tauri 2 官方文档不确定就不要碰。五、注意事项与适用前提文件大小限制走 GitHub 云端打包时单个文件最好不要超过 10MB视频/图片建议全部外链或压缩否则可能失败。App ID 唯一且合规重复的 ID 会与其他项目冲突填写时遵循“小写字母/数字/下划线、段不以数字开头、无连续点与首尾点”的规则。进阶配置慎改脚本文件、更多配置右上角、JSON 配置、注入 jQuery 均被原文档标注为高级功能改动前确认自己理解其行为。图标缺省行为不上传图标时默认使用 PakePlus 图标macOS 构建会把上传的 PNG 转成.icnspng_to_icns支持 16–512 五档尺寸及 2x 变体。平台适用性仓库当前版本package.json 中version: 2.2.8Tauri CLI 2.5 体系的本地打包路径中linux_build从源码看目前只打印日志即 Linux 本地产物尚在完善中配置项的实际生效以 Windows/macOS 构建和云端打包为准本文所有窗口参数说明均基于 Tauri 2 的WindowConfig语义。配置模板可参考完整的字段结构可对照 scripts/ppconfig.jsonman元信息模板见 src-tauri/data/man.json 与 scripts/config/man.json注入脚本示例见 scripts/config/inject/custom.js。完成基础配置后按文档建议的操作顺序执行先Preview验证应用外观含注入脚本、过滤效果、图标再Publish开始打包。涉及more.windows或 JSON 配置的深度定制时以 Tauri 2 官方文档为准。【免费下载链接】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），仅供参考
