使用指南

了解如何填写表单、设置图标和配置打包参数，让打出的 APK 更符合你的需求。

基本使用流程

功能卡片说明

配置签名 Keystore

Keystore 正确配置后，每次打包签名一致，可以升级覆盖安装。

生成 Keystore

进入你 Fork 的仓库 → Actions → 左侧 gen-keystore → 点击 Run workflow，填写密码，等待约 30 秒完成。

获取 Base64 字符串

运行完成后，点击该次运行 → 展开 Generate Keystore 步骤 → 找到 KEYSTORE_BASE64: 行，复制后面的完整字符串。

Keystore 参数说明

配置 GitHub Secrets

Secrets 向 Actions 传递敏感信息，不会出现在代码或日志中。

创建 Personal Access Token

前往 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)，点击 Generate new token。

勾选以下权限：

• repo — 访问私有仓库
• workflow — 触发和管理 Actions

生成后立即复制 Token（离开页面后不再显示）。

添加 Secrets

仓库 → Settings → Secrets and variables → Actions → New repository secret：

部署到 Cloudflare Pages

Pakr 是纯静态项目，托管在 Cloudflare Pages，全球 CDN 加速，免费无限流量。

自动更新

CF Pages 默认开启 Auto Deployment，每次向主分支 push 代码后自动重新部署，无需手动操作。

架构说明

Pakr 采用三层无服务器架构，所有计算资源均来自免费托管平台，零成本运行。

整体架构

各层说明

Cloudflare Pages（前端层）

承载所有静态资源（HTML/CSS/JS），全球 CDN 分发，访问速度极快。同时挂载 Cloudflare Worker 作为 API 网关，处理前端与 GitHub API 之间的请求转发和鉴权。

Cloudflare Worker（网关层）

Worker 运行在 CF 边缘节点，主要职责：

• 接收前端提交的打包参数
• 将 GH_TOKEN 注入请求头，安全调用 GitHub API
• 轮询 Actions 运行状态并返回实时进度
• 构建完成后获取 Release 下载链接

GitHub Actions（构建层）

接收到触发后，按以下顺序执行构建流程：

技术栈

API 文档

Worker 提供以下 HTTP 接口，可用于二次开发或自动化脚本集成。

Base URL

https://<你的域名>/api

所有接口均为 JSON 格式，响应头包含 Content-Type: application/json。

接口列表

{
  "success": true,
  "runId": "12345678",
  "message": "构建任务已触发"
}

{
  "status": "in_progress",
  "progress": 65,
  "step": "Gradle 构建中",
  "conclusion": null
}

{
  "success": true,
  "downloadUrl": "https://github.com/.../releases/download/v1.0/app.apk",
  "fileName": "Pakr_MyApp_v1.0.apk",
  "size": 4194304
}

错误码

更新日志

记录每个版本的主要改动。

常见问题