apkgo

分类: 工具与效率 | 上传者: KevinGong2013 | 下载: 0 | 版本: v1.0（最新）

将 APK 文件上传到 Android 应用商店（华为、小米、OPPO、vivo、荣耀、Google Play、三星、蒲公英、fir.im）并运行自定义脚本。专为具有结构化 JSON 输出、语义退出代码和零交互的 AI 代理而设计。

更新日志: Source: GitHub https://github.com/KevinGong2013/apkgo

目录结构

当前层级: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 pages.yml 537 B
  - 📄 release.yml 750 B
  - 📄 telemetry-server.yml 747 B
📁 cmd/
- 📁 telemetry-server/
  - 📄 docker-compose.yml 172 B
  - 📄 Dockerfile 380 B
  - 📄 main.go 6.5 KB
- 📄 config.go 4.4 KB
- 📄 history.go 1.7 KB
- 📄 init.go 2.1 KB
- 📄 root.go 2.6 KB
- 📄 serve.go 812 B
- 📄 stores.go 1.3 KB
- 📄 upgrade.go 4.9 KB
- 📄 upload.go 5.6 KB
- 📄 version.go 579 B
📁 docs/
- 📄 CNAME 13 B
- 📄 index.html 25.3 KB
📁 pkg/
- 📁 apk/
  - 📄 apk.go 958 B
- 📁 config/
  - 📄 config.go 4.7 KB
- 📁 history/
  - 📄 history.go 1.9 KB
- 📁 hooks/
  - 📄 hooks.go 1.8 KB
- 📁 server/
  - 📁 static/
    
    📄 index.html 17.7 KB
  - 📄 server.go 8.2 KB
- 📁 store/
  - 📁 fir/
    
    📄 fir.go 2.4 KB
  - 📁 googleplay/
    
    📄 googleplay.go 5.7 KB
  - 📁 honor/
    
    📄 honor.go 5.9 KB
  - 📁 huawei/
    
    📄 huawei.go 7.4 KB
  - 📁 oppo/
    
    📄 oppo.go 8.1 KB
  - 📁 pgyer/
    
    📄 pgyer.go 3.0 KB
  - 📁 samsung/
    
    📄 samsung.go 4.9 KB
  - 📁 script/
    
    📄 script.go 1.5 KB
  - 📁 tencent/
    
    📄 tencent.go 7.7 KB
  - 📁 vivo/
    
    📄 vivo.go 5.0 KB
  - 📁 xiaomi/
    
    📄 xiaomi.go 7.2 KB
  - 📄 registry.go 1.5 KB
  - 📄 store.go 1.8 KB
- 📁 telemetry/
  - 📄 telemetry.go 1.9 KB
- 📁 update/
  - 📄 check.go 3.0 KB
- 📁 uploader/
  - 📄 uploader.go 2.4 KB
📄 .gitignore 178 B
📄 .goreleaser.yaml 1.1 KB
📄 apkgo.example.yaml 1.2 KB
📄 article.md 4.9 KB
📄 CLAUDE.md 5.7 KB
📄 Dockerfile 199 B
📄 go.mod 412 B
📄 go.sum 2.1 KB
📄 LICENSE 11.1 KB
📄 main.go 111 B
📄 README.md 10.4 KB
📄 SKILL.md 6.8 KB

SKILL.md

---
name: apkgo
description: Upload APK files to Android app stores (Huawei, Xiaomi, OPPO, vivo, Honor, Google Play, Samsung, Pgyer, fir.im) and run custom scripts. Designed for AI agents with structured JSON output, semantic exit codes, and zero interaction.
---

# apkgo

Upload APK files to multiple Android app stores in one command.

## Install

Detect the platform and install accordingly:

```bash
# Linux (direct binary)
curl -fsSL https://github.com/KevinGong2013/apkgo/releases/latest/download/apkgo_Linux_x86_64.tar.gz | tar xz -C /usr/local/bin apkgo

# macOS Apple Silicon (direct binary)
curl -fsSL https://github.com/KevinGong2013/apkgo/releases/latest/download/apkgo_Darwin_arm64.tar.gz | tar xz -C /usr/local/bin apkgo

# macOS Intel (direct binary)
curl -fsSL https://github.com/KevinGong2013/apkgo/releases/latest/download/apkgo_Darwin_x86_64.tar.gz | tar xz -C /usr/local/bin apkgo

# Windows (PowerShell)
# Download from https://github.com/KevinGong2013/apkgo/releases/latest and add to PATH

# Go
go install github.com/KevinGong2013/apkgo@latest

# Docker
docker pull ghcr.io/kevingong2013/apkgo:latest
```

## When to use

Use this skill when the user wants to:
- Upload/publish/distribute an APK to Android app stores
- Release an Android app to Huawei, Xiaomi, OPPO, vivo, Honor, Tencent, Google Play, or Samsung stores
- Upload an APK to Pgyer or fir.im for beta distribution
- Automate APK distribution in CI/CD pipelines
- Run custom upload/notify scripts via the script store

## Supported stores

huawei, xiaomi, oppo, vivo, honor, tencent, googleplay, samsung, pgyer, fir, script

## Commands

```bash
apkgo stores                    # Discover config schema for each store (JSON)
apkgo init [--store names]      # Generate config file with comments
apkgo upload -f <apk> [flags]   # Upload APK to configured stores
apkgo serve [-p port]           # Start web GUI for uploading
apkgo version                   # Version info
```

## Upload flags

```
-f, --file         APK file path (required)
    --file64       64-bit APK for split-arch uploads
-s, --store        Comma-separated store names (default: all configured)
-n, --notes        Release notes text
    --notes-file   Read release notes from file
    --dry-run      Validate without uploading
-t, --timeout      Timeout duration (default: 10m)
-c, --config       Config file path (default: apkgo.yaml)
```

## Configuration

Create `apkgo.yaml` or use environment variables `APKGO_<STORE>_<KEY>`:

```yaml
# Hooks (optional): shell commands executed before/after uploads.
# hooks:
#   before: "./scripts/validate.sh"
#   after: "./scripts/notify.sh"

stores:
  huawei:
    client_id: ""       # required - from AppGallery Connect > API key
    client_secret: ""   # required
    # Per-store hooks (optional):
    # before: "./scripts/before-huawei.sh"
    # after: "./scripts/after-huawei.sh"
  xiaomi:
    email: ""           # required - developer account email
    private_key: ""     # required - from dev.mi.com API management
  oppo:
    client_id: ""       # required - from open.oppomobile.com
    client_secret: ""   # required
  vivo:
    access_key: ""      # required - from dev.vivo.com.cn
    access_secret: ""   # required
  honor:
    client_id: ""       # required - from developer.honor.com
    client_secret: ""   # required
    app_id: ""          # required
  tencent:
    user_id: ""         # required - from app.open.qq.com
    access_secret: ""   # required - API access secret
    app_id: ""          # required
    package_name: ""    # required
  googleplay:
    json_key_path: ""   # required - service account JSON key file
    track: "internal"   # release track (default: internal)
  samsung:
    service_account_id: ""  # required
    private_key_path: ""    # required

  # Script store: run any shell command or script.
  # Receives APK metadata as JSON on stdin; exit 0 = success.
  # script:
  #   command: "./deploy.sh"

  # Multiple script instances via "script.<name>" prefix:
  # script.cdn-upload:
  #   command: "./upload-cdn.sh"
  # script.dingtalk:
  #   command: "./notify-dingtalk.sh"
```

Environment variable example:
```bash
APKGO_HUAWEI_CLIENT_ID=xxx APKGO_HUAWEI_CLIENT_SECRET=yyy apkgo upload -f app.apk --store huawei
```

## Hooks

Hooks are optional shell commands executed before/after uploads. They receive JSON context on stdin and environment variables `APKGO_STORE`, `APKGO_PACKAGE`, `APKGO_VERSION`.

- `before` hook exit non-zero → abort upload
- `after` hook exit non-zero → warning only

**Global before** (`hooks.before`) stdin:
```json
{
  "file_path": "/path/to/app.apk",
  "apk": {"package": "com.example.app", "version_name": "1.0.0", "version_code": 1, "app_name": "MyApp"},
  "stores": ["huawei", "xiaomi"]
}
```

**Global after** (`hooks.after`) stdin:
```json
{
  "file_path": "/path/to/app.apk",
  "apk": {"package": "com.example.app", "version_name": "1.0.0", "version_code": 1, "app_name": "MyApp"},
  "results": [
    {"store": "huawei", "success": true, "duration_ms": 12300},
    {"store": "xiaomi", "success": false, "error": "auth failed", "duration_ms": 400}
  ]
}
```

**Per-store before** (`stores.<name>.before`) stdin:
```json
{
  "file_path": "/path/to/app.apk",
  "apk": {"package": "com.example.app", "version_name": "1.0.0", "version_code": 1, "app_name": "MyApp"},
  "store": "huawei"
}
```

**Per-store after** (`stores.<name>.after`) stdin:
```json
{
  "file_path": "/path/to/app.apk",
  "apk": {"package": "com.example.app", "version_name": "1.0.0", "version_code": 1, "app_name": "MyApp"},
  "store": "huawei",
  "result": {"store": "huawei", "success": true, "duration_ms": 12300}
}
```

## Script store stdin

The script store (`command` field) receives the same JSON on stdin:
```json
{
  "file_path": "/path/to/app.apk",
  "file_64_path": "",
  "app_name": "MyApp",
  "package_name": "com.example.app",
  "version_code": 42,
  "version_name": "1.2.0",
  "release_notes": "Bug fixes"
}
```

Exit 0 = success, non-zero = failure (stderr as error message).

## Output format

All output is structured JSON on stdout (logs go to stderr):

```json
{
  "apk": {"package": "com.example.app", "version_name": "1.0.0", "version_code": 1},
  "results": [
    {"store": "huawei", "success": true, "duration_ms": 12300},
    {"store": "xiaomi", "success": false, "error": "invalid private key", "duration_ms": 400}
  ]
}
```

## Exit codes

- 0: All succeeded
- 1: Partial failure
- 2: All failed
- 3: Input/config error

## Workflow

```bash
# 1. Install (if needed)
which apkgo || curl -fsSL https://github.com/KevinGong2013/apkgo/releases/latest/download/apkgo_Linux_x86_64.tar.gz | tar xz -C /usr/local/bin apkgo

# 2. Discover required fields
apkgo stores

# 3. Generate config
apkgo init --store huawei,xiaomi

# 4. Fill in credentials (or use env vars)

# 5. Validate
apkgo upload -f app.apk --dry-run

# 6. Upload and parse result
apkgo upload -f app.apk --notes "v1.0.0" --timeout 15m
echo "Exit code: $?"
```

登录后下载/点赞/收藏 ❤ 38 | ★ 0

apkgo

目录结构

SKILL.md

举报内容

提示