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.):
- 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
- 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> - Monitorar saída: o script conclui automaticamente todas as etapas (pré-verificação -> empacotamento -> Bugly -> submissão multicanal -> Git tag), sem intervenção manual
- Relatar resultados: resumir o status de sucesso/falha de cada canal para o usuário
- 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
| Etapa | Script | Descrição |
|---|---|---|
| Etapa 0 Pré-verificação | pre_check.py | Verifica se a configuração de assinatura release está em signingConfigs.release e se o versionCode local > versionCode online |
| Etapa 1 Empacotamento | ./gradlew clean assembleRelease | Localiza app-arm64-v8a-release.apk (envia apenas pacote 64 bits) |
| Etapa 1.5 Bugly | upload_bugly_symbol.py | Envia mapping.txt (não bloqueante; falha não impede submissão) |
| Etapa 2 Submissão multicanal | *_submit.py para cada canal | Envia sequencialmente para canais com credenciais configuradas; trava de segurança independente |
| Etapa 3 Git tag | git_tag.py | Após sucesso total, faz merge no master, cria tag de versão e faz push |
Canais Suportados
| Canal | Identificador | Método de Assinatura | dry-run | Limites de API |
|---|---|---|---|---|
| Tencent MyApp (应用宝) | yyb | HmacSHA256 | Suportado | 100 uploads/dia, 50 atualizações/dia |
| Xiaomi App Store (小米) | xiaomi | RSA (certificado X.509) | Não suportado (upload já é submissão) | Nenhum |
| Huawei AppGallery (华为) | huawei | OAuth2 (API Client) | Não suportado | Nenhum |
| OPPO App Market (OPPO) | oppo | HmacSHA256 | Não suportado | 50/dia/interface |
| vivo App Store (vivo) | vivo | HmacSHA256 | Não suportado | 50/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
- Os aplicativos já devem estar cadastrados e publicados em cada loja
- O diretório raiz do projeto deve conter
.publish_env(incluído em.gitignore), com as credenciais de cada canal - O arquivo de certificado de chave pública da Xiaomi deve estar no diretório raiz do projeto e incluído em
.gitignore - A máquina local deve ter Python 3.8+,
requests,pycryptodome,cryptography - O diretório raiz do projeto deve ter
gradlewe 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).