xby-hitoshura25-android-playstore-deploy

Readme

# xby-hitoshura25-android-playstore-deploy

DeepSeek Harness (DSH) 的插件：Android应用商店部署工具

一个帮助开发者设置自动化Google Play商店部署流程的工具，支持项目分析、密钥生成、服务账户配置和GitHub Actions工作流生成。

## 功能

- **set_xby_apikey** — 在聊天中设置 API 密钥（自动持久化，重启有效）
- **analyze_android_project** — Analyze an Android project to understand its configuration and identify requirements for Play Store deployment


Args:

    project_path: Absolute path to the Android project root directory



Returns:
    Result from analyze_android_project

- **generate_keystore** — Generate a new Android keystore file for app signing with secure parameters


Args:

    output_path: Absolute path where the keystore will be saved

    alias: Key alias for the signing key

    key_password: Password for the signing key

    store_password: Password for the keystore

    validity_days: How many days the key should be valid

    key_size: Key size in bits

    dname: Distinguished name for the certificate



Returns:
    Result from generate_keystore

- **generate_signing_config** — Generate Gradle signing configuration with dual-source support

Generates signing configuration that works seamlessly for both local development and CI/CD:
- Environment variables (prioritized for CI/CD)
- gradle.properties fallback (for local development)
- Task-based validation (debug builds always work)

Automatically generates gradle.properties.template for easy local setup.

Args:

    project_path: Path to Android project

    env_var_prefix: Prefix for environment variables (default: "APP_")
                   Example: "APP_" creates APP_SIGNING_KEY_STORE_PATH
                   Use "" for no prefix


Returns:
    Result including gradle_config_kotlin, gradle_properties_template, and setup instructions

- **setup_service_account_guide** — Provide interactive step-by-step guide for setting up Google Play Service Account


Returns:
    Result from setup_service_account_guide

- **generate_github_workflow** — Generate a complete GitHub Actions workflow file for Play Store deployment


Args:

    project_path: Path to Android project

    package_name: Android app package name

    track: Play Store release track (internal, alpha, beta, production)

    trigger_strategy: How to trigger the workflow (manual, branch, tag)

    branch_name: Branch name to trigger on if trigger_strategy is branch

    app_module_path: Path to app module relative to project root

    java_version: Java/JDK version to use for builds

    enforce_proguard: If True, ensure isMinifyEnabled=true in build.gradle.kts (default: True)

    mapping_file_path: Override default ProGuard mapping file path

    include_release_notes: Include release notes directory (default: True)

    release_notes_directory: Path to release notes directory (default: distribution/whatsnew)

    env_var_prefix: Prefix for environment variables (default: "APP_")
                   Example: "APP_" creates APP_SIGNING_KEY_STORE_PATH
                   Use "" for no prefix



Returns:
    Result from generate_github_workflow

- **validate_github_secrets** — Validate that required GitHub Secrets are configured (checks existence only)


Args:

    repo_owner: GitHub repository owner username or organization

    repo_name: GitHub repository name

    github_token: GitHub Personal Access Token with repo scope

    required_secrets: List of secret names to check for



Returns:
    Result from validate_github_secrets

- **create_github_secrets_guide** — Generate a comprehensive guide for creating all required GitHub Secrets


Args:

    repo_url: GitHub repository URL

    keystore_path: Optional path to keystore for encoding instructions



Returns:
    Result from create_github_secrets_guide

- **validate_play_store_setup** — Validate that Play Store app and API access are properly configured using service account


Args:

    service_account_json_path: Path to service account JSON file

    package_name: Android app package name to validate



Returns:
    Result from validate_play_store_setup

- **test_deployment_workflow** — Test the deployment workflow locally without uploading to Play Store


Args:

    project_path: Path to Android project

    keystore_path: Path to keystore file

    store_password: Keystore password

    key_alias: Key alias

    key_password: Key password

    dry_run: If true, skip actual Play Store upload



Returns:
    Result from test_deployment_workflow


## 安装

### 方式一：从 GitHub 直接安装（推荐）

```bash
# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-hitoshura25-android-playstore-deploy
```

### 方式二：从本地目录安装（开发模式）

```bash
# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-hitoshura25-android-playstore-deploy
```

### 方式三：通过 cordis.patch.yml 开发调试

```bash
dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml
```



## 配置

### 获取 API 密钥

前往 [小笨羊官网](https://xiaobenyang.com) 注册并获取 API 密钥。