PakePlus完全指南：从安装到打包，打造你的专属桌面与移动应用

PakePlus是一款基于Rust的轻量级应用打包工具，能将任何网页或前端项目转换为仅5M大小的跨平台桌面和移动应用。本指南将带你完成从环境准备到应用发布的全流程，无需复杂开发经验，只需简单几步即可拥有专属应用。

认识PakePlus

PakePlus（简称PP）是基于Tauri2框架开发的多端应用打包工具，相比传统方案具有显著优势：

• 极致轻量化：打包后应用体积小于5M，远低于Electron的100M+量级
• 多端支持：同时支持桌面端（Windows/macOS/Linux）和移动端（Android/iOS）
• 零环境依赖：无需本地安装Rust或Node.js，通过云端或本地打包两种模式
• 功能丰富：支持窗口自定义、JS注入、静态文件打包等高级特性

核心特性一览：

• 基于Rust构建，性能优于传统JS框架
• 支持网页/本地静态文件（Vue/React等）打包
• 内置调试模式与API调用能力
• 提供图形化操作界面，无需命令行知识

安装PakePlus

下载安装包

PakePlus提供多平台安装包，根据你的操作系统选择对应版本：

操作系统	下载路径	架构支持
Windows	docs/bundle/redbook_0.0.1_x64-setup.exe	x64
macOS	docs/bundle/redbook_0.0.1_aarch64.dmg	arm64/x86_64
Linux	docs/bundle/redbook_0.0.1_amd64.deb	amd64

安装步骤

1. Windows系统：

   • 双击exe安装包，可能会触发系统安全提示
   • 如遇"Windows已保护你的电脑"，点击"更多信息"→"仍要运行"
   • 按向导完成安装，桌面将生成PakePlus快捷方式

2. macOS系统：

   • 打开dmg文件，将PakePlus拖入应用程序文件夹
   • 首次启动时可能提示"无法打开"，需在"系统设置→安全性与隐私"中允许运行
   • 如遇开发者验证问题，可执行终端命令：xattr -d com.apple.quarantine /Applications/PakePlus.app

3. Linux系统：
   • 执行命令安装deb包：sudo dpkg -i redbook_0.0.1_amd64.deb
   • 如遇依赖问题：sudo apt install -f
   • 从应用菜单启动或终端执行：pakeplus

快速开始：创建第一个项目

环境准备

PakePlus提供两种工作模式，根据需求选择：

模式	优势	适用场景	准备工作
云端打包	无需配置环境	简单项目/新手用户	GitHub账号+Token
本地打包	无文件大小限制	大型项目/开发者	Git+克隆仓库

获取GitHub Token（云端打包用户）

1. 访问GitHub个人设置→开发者设置→个人访问令牌
2. 创建Classic Token，勾选以下权限：
   • repo（仓库操作权限）
   • workflow（工作流执行权限）
   • user（用户信息访问）

3. 复制生成的Token，在PakePlus中点击右上角设置图标，粘贴并验证

注意：Token仅显示一次，请妥善保存。本地打包用户可跳过此步骤。

创建项目

1. 启动PakePlus，点击主界面"+"按钮
2. 填写项目基本信息：
   • 项目名称：字母数字组合，不可重复
   • 网站地址/本地路径：支持HTTP链接或本地HTML文件路径
   • APP标识：唯一ID，如"com.example.myapp"
   • 版本号：遵循语义化版本（如0.0.1）

3. 点击"确定"，系统自动创建项目并跳转至配置页面

应用配置详解

基础配置

项目创建后进入配置界面，主要包含以下设置项：

必填项：

• 应用名称：显示在桌面和开始菜单的名称，支持中文
• 目标地址：
  • 网络地址：如"https://example.com"
  • 本地文件：点击"浏览"选择index.html或dist文件夹
• 应用标识：唯一ID，建议使用反向域名格式
• 版本号：每次打包需要递增

推荐配置：

• 应用图标：上传1024x1024 PNG图片，支持圆角预览
• 窗口模式：预设桌面/iPhone/iPad/Android等尺寸
• 单例模式：启用后防止多开，适合工具类应用
• 状态保持：重启后恢复上次窗口位置和大小

高级功能

内容定制

• 过滤元素：输入CSS选择器隐藏页面元素（如广告）

  .ad-banner, .popup-modal  /* 隐藏广告和弹窗 */
  

• 注入脚本：添加自定义JS增强功能，例如：

  // 自动登录脚本示例
  document.getElementById('username').value = 'myaccount';
  document.getElementById('password').value = 'mypassword';
  

窗口定制

在"更多配置"中可调整高级窗口属性：

{
  "tauri": {
    "windows": [
      {
        "decorations": false,  // 无边框窗口
        "transparent": true,   // 背景透明
        "alwaysOnTop": true    // 窗口置顶
      }
    ]
  }
}

完整配置项参考Tauri文档

打包与发布

预览应用

配置完成后点击"预览"按钮，PakePlus会启动一个临时窗口展示效果：

预览模式支持：

• 实时调整窗口大小
• 右键菜单调出开发者工具
• 测试JS注入效果

本地打包流程

1. 克隆项目仓库（开发者模式）：

   git clone https://gitcode.com/GitHub_Trending/pa/PakePlus.git
   cd PakePlus
   

2. 进入项目目录，修改配置文件： scripts/ppconfig.json

3. 执行打包命令：

   # 桌面端打包
   npm run build:desktop
   
   # 移动端打包
   npm run build:android  # 或 build:ios
   

4. 打包产物位于：

   • 桌面端：src-tauri/target/release/bundle/
   • 移动端：src-tauri/mobile/target/

云端打包流程

1. 配置完成后点击"发布"按钮
2. 选择打包平台（可多选）：
   • 桌面端：Windows/macOS/Linux
   • 移动端：Android APK/iOS IPA
3. 填写更新日志，点击"确认发布"
4. 等待云端编译（约5-10分钟），可在"发布记录"中查看进度

云端打包限制：每小时1次，每次最多3个平台。

高级技巧：自定义开发

静态资源打包

对于Vue/React等前端项目：

1. 先执行npm run build生成dist目录
2. 在PakePlus中选择"本地文件"→"浏览"→选择dist文件夹
3. 勾选"静态文件模式"，自动处理相对路径

API调用示例

PakePlus允许前端JS调用系统功能，例如文件下载：

// 保存文本到本地文件
window.__TAURI__.fs.writeTextFile({
  path: 'document.txt',
  contents: 'Hello from PakePlus!'
}).then(() => {
  alert('文件保存成功');
});

常用API列表：

• 文件操作：window.__TAURI__.fs
• 系统对话框：window.__TAURI__.dialog
• 进程执行：window.__TAURI__.shell
• 窗口控制：window.__TAURI__.window

完整API文档：docs/zh/guide/desktopapi.md

调试技巧

1. 启用调试模式：配置页面勾选"开发调试"
2. 查看日志：菜单→帮助→查看日志
3. 远程调试：
   • 预览窗口右键→"检查元素"
   • 使用Chrome浏览器访问devtools://devtools/bundled/inspector.html?ws=localhost:9222/devtools/browser

常见问题解决

打包失败排查

1. 网络问题：云端打包需要稳定网络，建议使用有线连接
2. 文件大小超限：本地打包无限制，云端单个文件不超过10M
3. 配置错误：检查APP标识格式和版本号是否正确
4. 依赖缺失：本地打包需安装Git和基础编译工具

应用运行问题

问题	解决方案
窗口空白	检查目标URL是否可访问，本地文件路径是否正确
图标不显示	使用1024x1024 PNG图片，确保路径无中文
无法安装	Windows关闭Defender，macOS允许未知来源
功能异常	开启调试模式查看控制台错误

更多问题参考常见问题文档

总结与进阶

通过本指南，你已掌握PakePlus从安装到打包的完整流程。以下是进阶学习路径：

1. 脚本注入：编写复杂JS实现自动化操作
2. 自定义主题：修改CSS实现应用界面个性化
3. 插件开发：扩展PakePlus功能，贡献社区
4. 批量打包：使用CLI模式批量处理多个项目

PakePlus源码托管于GitCode仓库，欢迎提交Issue和PR参与项目共建。如需技术支持，可加入官方交流群获取帮助。

现在就动手将你的常用网页或前端项目打包成专属应用，体验轻量化跨平台开发的乐趣吧！