# apkgo-desktop

**Repository Path**: kml/apkgo-desktop

## Basic Information

- **Project Name**: apkgo-desktop
- **Description**: APK multi-store distribution desktop tool: push, material management, history audit, license control (Wails + Vue3 + Go)
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# apkgo-desktop — Windows 桌面端 APK 多商店分发工具

基于 Wails v2（Go + Vue3）的单 EXE 便携工具，封装 [apkgo](https://github.com/KevinGong2013/apkgo) 命令行引擎，提供图形化界面完成 APK 多商店发布；同时内置六大商店开放平台 API 直连能力，实现物料管理、审核状态查询等全流程闭环。

## 仓库结构

| 目录 | 说明 |
| --- | --- |
| [apkgo-desktop](apkgo-desktop/) | 主程序：多商店推送、物料管理、审核查询、密钥库、历史记录 |
| [apkgo-license-gen](apkgo-license-gen/) | 配套授权密钥生成工具（RSA 密钥对 + 授权签发桌面应用） |

## 功能特性

- **推送**：单个/批量选择 APK，自动解析包名与版本；按路由规则自动选择目标商店，也可手动多选商店覆盖；支持更新日志、试跑预览；实时显示每商店推送进度（认证→上传→提交→完成/失败）
- **路由规则**：文件名关键词规则（如文件名含 `vivo` → 只推 vivo）+ 包名规则（指定包名推指定商店），无规则时默认推全部已配密钥商店
- **物料管理**：直连华为 AGC / 荣耀 / OPPO / vivo / 小米 / 腾讯应用宝开放平台 API，拉取、编辑、上传、提交应用物料与版本信息，免浏览器操作
- **审核状态**：自动查询各商店审核进度，华为（AGC 服务账号 JWT 签名）完整实现
- **历史记录**：SQLite 持久化推送历史，失败商店一键重试；支持多条件查询与排序
- **密钥库**：按「全局 / 包名+商店」维度配置各商店凭证，Windows DPAPI 加密存储于本地
- **授权体系**：RSA 公私钥签名授权 + 公共时间源防篡改，到期前可更换密钥续期
- **引擎自更新**：内置 apkgo 兜底引擎，启动时自动检查 GitHub 最新版，支持一键更新（SHA-256 校验 + 原子替换）
- **代理**：系统代理 / 自定义 HTTP(S)、SOCKS5 / 直连 三模式

## 使用

1. 将 `apkgo-desktop.exe` 放入任意目录（建议独立文件夹），双击运行
2. 数据（引擎、密钥、历史、规则）自动保存在 EXE 同目录 `data/` 下，拷贝整个目录即可迁移
3. 首次使用：设置页确认代理模式 → 密钥页配置商店凭证 → 规则页配置路由 → 推送页选择 APK 开始分发

## 环境要求

- Windows 10/11 x64（依赖系统自带 WebView2 Runtime）
- 无需安装 Go / Node / apkgo 环境

## 构建

```bash
cd apkgo-desktop
wails build -platform windows/amd64 -clean -nsis
```

产物：`build/bin/apkgo-desktop.exe`（便携单文件）、`build/bin/apkgo-desktop-amd64-installer.exe`（NSIS 安装包）

> 注：`build/webview2-runtime/`（固定版本 WebView2 自包含运行时，约 45MB）不随仓库分发，构建自包含安装包前需自行放置该目录。

## 开发

```bash
cd apkgo-desktop
wails dev        # 前端热重载开发
go test ./internal/...   # 后端单元测试
```

## 说明与限制

- apkgo 引擎为 [PolyForm Noncommercial](https://polyformproject.org/licenses/noncommercial/1.0.0/) 许可，本工具非商业用途不受限；商用需联系 [apkgo 作者](https://github.com/KevinGong2013/apkgo) 授权，详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)
- 审核状态/物料接口因各开放平台文档变动频繁，需按最新官方文档适配
- GitHub 更新下载在国内需代理；无网络时自动使用内置兜底引擎，不影响推送

## 赞助支持

如果这个工具对你有帮助，欢迎扫码支持一下，感谢！

<p align="center">
  <img src="assets/sponsor/alipay.jpg" width="240" alt="支付宝赞助" />
  <img src="assets/sponsor/wechat.jpg" width="240" alt="微信赞助" />
</p>