apkgo

Category: Tools & Productivity | Uploader: KevinGong2013 | Downloads: 0 | Version: v1.0（Latest）

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.

Changelog: Source: GitHub https://github.com/KevinGong2013/apkgo

Directory Structure

Current level: 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: $?"
```

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

apkgo

Directory Structure

SKILL.md

Report

Notice