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

2026-02-05 04:19:59作者：史锋燃Gardner

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

安装步骤

Windows系统：
- 双击exe安装包，可能会触发系统安全提示
- 如遇"Windows已保护你的电脑"，点击"更多信息"→"仍要运行"
- 按向导完成安装，桌面将生成PakePlus快捷方式
macOS系统：
- 打开dmg文件，将PakePlus拖入应用程序文件夹
- 首次启动时可能提示"无法打开"，需在"系统设置→安全性与隐私"中允许运行
- 如遇开发者验证问题，可执行终端命令：xattr -d com.apple.quarantine /Applications/PakePlus.app

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

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

环境准备

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

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

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

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

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

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

创建项目

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

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

应用配置详解

基础配置

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

必填项：

应用名称：显示在桌面和开始菜单的名称，支持中文
目标地址：
- 网络地址：如"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注入效果

本地打包流程

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

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

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

执行打包命令：

# 桌面端打包
npm run build:desktop

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

打包产物位于：
- 桌面端：src-tauri/target/release/bundle/
- 移动端：src-tauri/mobile/target/

云端打包流程

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

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

高级技巧：自定义开发

静态资源打包

对于Vue/React等前端项目：

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

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

调试技巧

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

常见问题解决

打包失败排查

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

应用运行问题

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