AngChow/android-publish

Skill do Codex para automação completa do ciclo de publicação de apps Android: pré-verificação → empacotamento → upload de tabela de símbolos Bugly → submissão multicanal (Tencent MyApp/小米/华为/OPPO/vivo) → Git tag.

O que é android-publish?

Este skill do Codex automatiza todo o fluxo de publicação de aplicativos Android, desde a pré-verificação até a submissão para revisão em cinco grandes marketplaces chineses: Tencent MyApp (应用宝), Xiaomi (小米), Huawei (华为), OPPO e vivo. Ele executa uma série de etapas: verifica a configuração de assinatura de release e a versão do código, compila o APK de 64 bits, faz upload da tabela de símbolos para o Bugly (não bloqueante), envia para cada loja configurada (com suporte a dry-run apenas para MyApp), e, após sucesso em todos os canais, faz merge no branch master, cria uma tag Git e faz push. O usuário pode ativar o fluxo completo com um único comando ou selecionar canais específicos e pular etapas. O skill oferece proteções de segurança: exige a flag `--i-know-this-submits-to-production` e a variável de ambiente `PUBLISH_CONFIRM_SUBMIT=YES` para evitar submissões acidentais para produção. Cada loja tem suas particularidades de API e limites de taxa, que são respeitados automaticamente.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add AngChow/android-publish

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Skill de Publicação de Aplicativos Android

Empacota a versão release e submete para revisão nos cinco principais marketplaces de aplicativos: Tencent MyApp (应用宝), Xiaomi (小米), Huawei (华为), OPPO e vivo — automação de ponta a ponta.

Instruções de Execução

Quando o usuário solicitar "empacotar e submeter" (ou "gerar pacote"/"publicar"/"lançar aplicativo"/"submissão multicanal", etc.):

  1. Confirmar descrição da atualização: se o usuário não especificar, usar o padrão "Correções de bugs conhecidos e otimização da experiência do usuário", ou perguntar ao usuário
  2. Executar comando completo:
    PUBLISH_CONFIRM_SUBMIT=YES python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \
        --i-know-this-submits-to-production \
        --update-desc "<descrição da atualização>" \
        <diretório raiz do projeto>
    
  3. Monitorar saída: o script conclui automaticamente todas as etapas (pré-verificação -> empacotamento -> Bugly -> submissão multicanal -> Git tag), sem intervenção manual
  4. Relatar resultados: resumir o status de sucesso/falha de cada canal para o usuário
  5. Tratamento de exceções: se a pré-verificação falhar (assinatura/versão do código), parar e informar o motivo específico; falha em um canal não afeta os outros

Somente empacotar sem submeter (dry-run)

Apenas o Tencent MyApp suporta dry-run (upload sem submeter). Xiaomi, Huawei, OPPO e vivo fazem upload e submetem imediatamente; no dry-run, esses canais são ignorados automaticamente:

python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \
    --dry-run --store yyb \
    <diretório raiz do projeto>

Especificar canal único

PUBLISH_CONFIRM_SUBMIT=YES python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \
    --store yyb|xiaomi|huawei|oppo|vivo \
    --i-know-this-submits-to-production \
    --update-desc "<descrição da atualização>" \
    <diretório raiz do projeto>

Pular etapas

  • --skip-build: pular empacotamento, usar APK existente
  • --skip-bugly: pular upload da tabela de símbolos Bugly
  • --skip-git: pular Git tag
  • --skip-check: pular pré-verificação

Fluxo de Automação

EtapaScriptDescrição
Etapa 0 Pré-verificaçãopre_check.pyVerifica se a configuração de assinatura release está em signingConfigs.release e se o versionCode local > versionCode online
Etapa 1 Empacotamento./gradlew clean assembleReleaseLocaliza app-arm64-v8a-release.apk (envia apenas pacote 64 bits)
Etapa 1.5 Buglyupload_bugly_symbol.pyEnvia mapping.txt (não bloqueante; falha não impede submissão)
Etapa 2 Submissão multicanal*_submit.py para cada canalEnvia sequencialmente para canais com credenciais configuradas; trava de segurança independente
Etapa 3 Git taggit_tag.pyApós sucesso total, faz merge no master, cria tag de versão e faz push

Canais Suportados

CanalIdentificadorMétodo de Assinaturadry-runLimites de API
Tencent MyApp (应用宝)yybHmacSHA256Suportado100 uploads/dia, 50 atualizações/dia
Xiaomi App Store (小米)xiaomiRSA (certificado X.509)Não suportado (upload já é submissão)Nenhum
Huawei AppGallery (华为)huaweiOAuth2 (API Client)Não suportadoNenhum
OPPO App Market (OPPO)oppoHmacSHA256Não suportado50/dia/interface
vivo App Store (vivo)vivoHmacSHA256Não suportado50/dia/interface

Todos os canais aceitam descrições de atualização em chinês, passadas por --update-desc. Para Huawei, o campo newFeatures visível ao usuário é configurado adicionalmente.

Trava de Segurança

A submissão é uma operação de produção e exige que todas as condições sejam atendidas:

  • Linha de comando com --i-know-this-submits-to-production
  • Variável de ambiente PUBLISH_CONFIRM_SUBMIT=YES (para multicanal) ou variável específica do canal

build_and_submit.py define automaticamente as variáveis de ambiente correspondentes para cada subprocesso quando --confirm é usado, portanto basta definir PUBLISH_CONFIRM_SUBMIT=YES.

Particularidades de Cada Canal

  • Tencent MyApp: upload e submissão são separados; suporta dry-run. Limite de 100 uploads/dia, 50 atualizações/dia.
  • Xiaomi: upload já é submissão; a atualização requer apenas APK + updateDesc. Sem limite de API.
  • Huawei: Token -> upload para OBS -> atualizar informações do arquivo -> atualizar informações de idioma (descrição da atualização) -> aguardar 2 minutos -> submeter. Credenciais de equipe funcionam entre apps.
  • OPPO: a interface de publicação tem muitos campos, mas o script reutiliza automaticamente valores existentes a partir de consultas. Limite de 50/dia/interface.
  • vivo: upload do APK retorna número de lote + versionCode; a interface de atualização tem poucos campos obrigatórios. Limite de 50/dia/interface.

Pré-requisitos

  1. Os aplicativos já devem estar cadastrados e publicados em cada loja
  2. O diretório raiz do projeto deve conter .publish_env (incluído em .gitignore), com as credenciais de cada canal
  3. O arquivo de certificado de chave pública da Xiaomi deve estar no diretório raiz do projeto e incluído em .gitignore
  4. A máquina local deve ter Python 3.8+, requests, pycryptodome, cryptography
  5. O diretório raiz do projeto deve ter gradlew e Java / Android SDK configurados

Operação de Canal Único

Cada canal suporta consulta e submissão independentes; veja README.md para detalhes.

Tabela de Símbolos Bugly

Após o empacotamento, o mapping.txt é enviado automaticamente para o Bugly (não bloqueante), garantindo que stack traces de crashes em produção possam ser desofuscados. A ferramenta jar está incluída no diretório tools/ do skill; as credenciais são lidas de .publish_env (BUGLY_APP_ID / BUGLY_APP_KEY).

Habilidades Relacionadas