CommunityImagemgithub.com

hmos-appgallery-poster

Criação de imagens promocionais para publicação na AppGallery do HarmonyOS (banners, capturas de tela da loja, páginas de detalhes do aplicativo).

O que é hmos-appgallery-poster?

Esta skill automatiza a geração de um conjunto completo de imagens promocionais para aplicativos HarmonyOS, prontas para upload no AppGallery Connect. O fluxo de trabalho começa com a análise do código-fonte do projeto para extrair informações como nome do app, ícone e recursos principais. Em seguida, utiliza ferramentas como `devecocli` e `hdc` para capturar screenshots no emulador ou dispositivo real. A etapa central envolve a geração de fundos artísticos via API Pollinations (ou outros conectores de IA), seguindo regras rígidas de estilo e sem texto na imagem. Por fim, usando Python + Pillow, as capturas e fundos são compostos em layouts profissionais (smartphone, tablet e PC), com textos localizados e formatação precisa. A skill também inclui uma etapa opcional de refinamento via conectores de design como Canva. Todo o processo respeita as especificações oficiais mais recentes da AppGallery, verificadas por consulta web, e evita violações de diretrizes da loja.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Huangzihengcmd/hmos-appgallery-poster/tree/HEAD

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Criação de Imagens Promocionais para AppGallery HarmonyOS

Gera um conjunto de imagens promocionais prontas para upload no AppGallery Connect (banners/capturas de tela para o carrossel do topo da página de detalhes do aplicativo) para o projeto HarmonyOS atual.

Princípios Gerais

  1. Ilustrações de fundo NÃO devem ser desenhadas com código. Como um designer humano: escreva prompts → utilize modelos gratuitos de geração de imagens → analise o resultado → se insatisfatório, troque o seed/ajuste o prompt e repita (veja Etapa 3). O código deve ser usado apenas para composição (montagem, cantos arredondados, layout de texto, exportação em escala).
  2. Verifique as especificações online antes de começar. As especificações básicas neste documento podem estar desatualizadas; sempre execute a Etapa 1 primeiro.
  3. Produção padrão: "Kit de imagens promocionais padrão" : 5 imagens verticais para smartphone (máx. 8) + 2-3 horizontais para tablet + 2 imagens 16:9 para PC. Siga solicitações específicas do usuário se houver.
  4. Todos os artefatos serão salvos em <raiz_do_projeto>/promotion/; não poluir o diretório de código-fonte do projeto.
  5. Arquivos temporários (downloads, imagens geradas) devem ficar no diretório do projeto, não no diretório Temp do sistema.

Fluxo de Trabalho

Etapa 0: Analisar o Aplicativo

Leia os seguintes arquivos para extrair informações (não pergunte ao usuário; leia o código):

  • AppScope/app.json5: bundleName, ícone, label
  • entry/src/main/module.json5: abilities, permissões, tipos de dispositivo (suporta tablet/pc?)
  • AppScope/resources/base/element/string.json e resources/zh/: nome do aplicativo
  • entry/src/main/resources/base/profile/main_pages.json + páginas em pages/: lista de funcionalidades
  • Ícone em resources/base/media/: determine a cor principal da marca (você pode julgar visualmente)

Gere promotion/plan.md contendo: nome do aplicativo, posicionamento em uma frase, 3-5 funcionalidades principais (cada imagem promocional corresponde a uma funcionalidade), público-alvo, cor principal da marca (hex), e seleção de estilo.

Etapa 1: Verificar Especificações Online (Obrigatório)

Use websearch / webfetch para pesquisar e confirmar os requisitos mais recentes. Exemplos de termos de pesquisa:

  • AppGallery 宣传图 尺寸 规格 应用信息
  • 华为应用市场 应用介绍图片 截图 要求
  • developer.huawei.com 主题设计指导及规范 (diretrizes de design HarmonyOS)
  • AppGallery Connect 图片规格 上架

Considere a documentação oficial da Huawei (developer.huawei.com / Central de Ajuda do AppGallery Connect) como autoridade. Se as páginas oficiais não puderem ser acessadas devido a renderização JS, use as palavras-chave acima para buscar fontes secundárias confiáveis para validação cruzada.

Tabela de Especificações Base (verificada em nov/2026, ainda requer verificação online):

MaterialDimensões/ProporçãoFormato e Limitações
Imagem promocional smartphone (retrato)1080×1920 / 1080×2340 / 1080×2400 (9:16 ~ 9:19.5)JPG/PNG, ≤2MB cada, 3-8 imagens
Imagem promocional tablet (paisagem)2560×1440 (16:9) ou 3:2Mesmo que acima
Imagem promocional PC1920×1080 (16:9)Mesmo que acima
Ícone da loja216×216 (backend AGC) / 512×512PNG, cantos arredondados cortados pelo backend
Fundo/ícone da tela inicial HarmonyOS1024×1024PNG, transparente, proibido adicionar cantos arredondados, bordas ou sombras

Linhas Vermelhas de Revisão: A imagem não deve conter texto iOS / iPhone / Apple Store / logotipos de lojas concorrentes ou aparência de dispositivo; não deve conter propaganda enganosa inconsistente com as funções reais; não deve conter bandeiras nacionais ou elementos politicamente sensíveis; capturas de tela não devem expor informações privadas.

Registre os resultados da verificação em promotion/plan.md.

Etapa 2: Capturas de Tela do Emulador (Material para Imagens de Apresentação do Produto)

  1. devecocli devices verifica dispositivos; se nenhum, inicie o emulador.
  2. Se o projeto não foi construído: devecocli build; em seguida, devecocli run --skip-build para instalar e iniciar.
  3. Capture screenshots página por página (padrão: use hdc para captura de tela, não verify_ui; a ferramenta de verificação de UI deve ser usada apenas quando o usuário solicitar explicitamente):
hdc shell "snapshot_display -f /data/local/tmp/shot_1.jpeg"
hdc file recv /data/local/tmp/shot_1.jpeg .\promotion\shots\shot_1.jpeg
  1. Planeje as capturas de tela com base nos pontos de venda: pelo menos uma captura para cada página de funcionalidade principal; navegue até a página correspondente antes de capturar a próxima.
  2. Se a captura de tela não tiver 1080 px de largura, registre a resolução real em plan.md e redimensione proporcionalmente durante a composição.

Etapa 3: Geração de Imagens por IA — Simulando Desenho Humano (Fundos Multiestilo)

Método A (Padrão, gratuito, sem chave): Conexão Direta Pollinations

Formato da URL (prompt deve ser URL-encoded, em inglês):

https://image.pollinations.ai/prompt/{encoded_prompt}?width=1024&height=2048&seed={n}

Notas práticas (nov/2026):

  • Não inclua nologo=true; este parâmetro agora é pago (retorna 402 Payment Required); também não inclua model=flux; use o modelo padrão.
  • O canal gratuito tem limite de taxa; a primeira solicitação frequentemente resulta em 503 (sugere "Retry after 10s"). Aguarde 12 segundos e tente novamente; no máximo 5 tentativas geralmente funcionam.
$prompt = [uri]::EscapeDataString("soft gradient fluid abstract background, deep blue and cyan, smooth flowing shapes, no text, no watermark")
foreach ($i in 1..5) {
  Start-Sleep -Seconds 12
  try {
    Invoke-WebRequest -Uri "https://image.pollinations.ai/prompt/$prompt`?width=1024&height=2048&seed=42" -OutFile .\promotion\bg\style1_s42.png -TimeoutSec 120
    break
  } catch { }
}

Iteração ao estilo humano: gere 2-3 seeds para cada estilo, visualize cada imagem (julgue a qualidade visualmente) e, se insatisfatório, modifique o prompt ou troque o seed e recomece. Não gere dezenas de imagens de uma vez.

Método B (Degradado, quando o usuário solicita "operar a página web como um humano"): Automação de Navegador

Se o deveco.json estiver configurado com um MCP de navegador (ex.: @playwright/mcp), abra um site gratuito de geração de imagens (pollinations.ai, etc.), simulando um humano: insira o prompt → aguarde a geração → baixe para promotion/bg/. Se esse MCP não existir, use o Método A.

Método C: MCP/Conector de Geração de Imagens já configurado no ambiente (ex.: conector Canva com IA de geração de imagens). Se existir, deve ser prioritário em relação ao Método A.

Biblioteca de Estilos (selecione 3-5 estilos em plan.md com base no tipo de aplicativo, cada um para 1-2 imagens promocionais):

EstiloAdequado paraPalavras-chave do Prompt
Gradiente FluidoFerramentas/Tecnologia/IAsoft gradient fluid abstract, smooth flowing shapes
Geométrico MinimalistaProdutividade/Negóciosminimalist flat design, geometric shapes, clean, pastel
Render 3D CartoonInfantil/Educação/Lazercute 3d cartoon render, soft lighting, playful
Fotografia de Paisagem NaturalEstilo de Vida/Saúde/Viagemnatural landscape photography, golden hour, bokeh
Ilustração Chinesa ModernaConteúdo/Culturachinese traditional illustration, modern guochao style
Neon EscuroJogos/eSportsdark neon glow, cyberpunk, dramatic lighting
Luz Difusa SuaveSocial/Emocionalsoft diffuse light, dreamy pastel, warm

Regra de Ouro para Prompts: Deve incluir no text, no watermark — o texto na imagem será adicionado na Etapa 4 (layout); modelos de geração de imagem produzem texto distorcido. A paleta de cores deve girar em torno da cor principal da marca.

Etapa 4: Composição das Imagens de Apresentação do Produto (Contorno do Smartphone HarmonyOS + Texto)

Use Python + Pillow para composição (instale com pip install pillow se necessário). Estrutura de cada imagem vertical:

┌─────────────────┐  1080×2400
│  Nome do App (Título)│  ← Área do título: nome do app + ponto de venda em uma frase, cor principal/texto branco
│  Ponto de venda      │
│ ╭─────────────╮ │
│ │ Contorno do   │ │  ← Corpo: retângulo arredondado gradiente com cor principal (r≈140px),
│ │ Smartphone    │ │     borda com brilho, contém captura de tela da Etapa 2 (também cortada com cantos arredondados)
│ │ ┌─────────┐ │ │
│ │ │ Captura  │ │ │
│ │ │ de Tela  │ │ │
│ │ └─────────┘ │ │
│ ╰─────────────╯ │
│  Ícone + Nome App  │  ← Área da marca inferior
└─────────────────┘

Esqueleto funcional mínimo (ajuste parâmetros conforme necessário, não copie cegamente):

from PIL import Image, ImageDraw, ImageFilter, ImageFont

W, H = 1080, 2400
bg = Image.open("bg/style1_s42.png").convert("RGB")
bg = bg.resize((W, H))  # Preencher fundo; corte primeiro se necessário para manter proporção

img = bg.copy()
draw = ImageDraw.Draw(img)

# Contorno do smartphone HarmonyOS
frame_w, frame_h = 760, 1560
fx, fy = (W - frame_w) // 2, 560
body = Image.new("RGB", (frame_w, frame_h), (20, 20, 25))
mask = Image.new("L", (frame_w, frame_h), 0)
ImageDraw.Draw(mask).rounded_rectangle([0, 0, frame_w, frame_h], radius=110, fill=255)
img.paste(body, (fx, fy), mask)

shot = Image.open("shots/shot_1.jpeg").convert("RGB")
shot = shot.resize((frame_w - 24, int((frame_w - 24) * shot.height / shot.width)))
if shot.height > frame_h - 24:
    shot = shot.crop((0, 0, shot.width, frame_h - 24))
smask = Image.new("L", shot.size, 0)
ImageDraw.Draw(smask).rounded_rectangle([0, 0, shot.width, shot.height], radius=98, fill=255)
img.paste(shot, (fx + 12, fy + 12), smask)
draw.rounded_rectangle([fx, fy, fx + frame_w, fy + frame_h], radius=110, outline=(255, 255, 255), width=4)

# Texto (fonte chinesa: Windows use msyh.ttc; se HarmonyOS Sans estiver instalado, priorize)
font_big = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", 88)
font_sub = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", 46)
draw.text((W // 2, 300), "Nome do Aplicativo", font=font_big, fill=(255, 255, 255), anchor="mm")
draw.text((W // 2, 410), "Ponto de venda em uma frase", font=font_sub, fill=(230, 230, 230), anchor="mm")

img.save("final/phone/poster_1.png", optimize=True)

Requisitos:

  • Versões para tablet/PC: layout horizontal, captura à esquerda ou direita, texto no lado oposto, resolução conforme verificado na Etapa 1.
  • Verifique cada imagem após exportação: cada uma ≤2MB (se exceder, converta para JPG quality=88 ou reduza a resolução), texto não sobreponha o assunto principal, cantos arredondados naturais.
  • Texto extraído dos pontos de venda em plan.md, frases curtas (≤12 caracteres/linha). Proibido descrições de funcionalidades falsas.

Etapa 5: Aprimoramento Opcional — Ferramentas de Design Web (Conector Canva, etc.)

O Canva possui uma grande biblioteca de ativos gráficos integrados: modelos prontos (promoção de aplicativos/pôsteres para smartphone), formas, adesivos de ilustração, ícones e fontes. Com o conector Canva, a IA pode usar diretamente esses ativos integrados para refinamento, sem precisar desenhar do zero.

  1. Verifique na seção mcp do deveco.json / configuração global se existem conectores de design como canva, Figma, MasterGo, Pixso, etc.
  2. Se o Canva estiver disponível: Pesquise por modelos integrados (palavras-chave "app promotion" / "poster celular") → Substitua o fundo gerado na Etapa 3 e as capturas da Etapa 2 nos espaços reservados do modelo → Use ativos integrados para ajustar layout e texto → Exporte para promotion/final/. Aproveita os ativos de design prontos do Canva, resultando em rapidez e profissionalismo.
  3. Se não estiver disponível: Pule esta etapa; o fluxo principal (geração gratuita de imagens + composição) já é suficiente; informe ao usuário que ele pode configurar um conector Canva para obter capacidade de refinamento com modelos.

Posicionamento: Esta etapa é um aprimoramento opcional ("cereja do bolo"). A produção principal de imagens promocionais sempre se baseia na geração gratuita de imagens (Pollinations) da Etapa 3 + composição por código da Etapa 4. O Canva é usado apenas quando o conector existe e o usuário deseja um layout de modelo mais sofisticado.

Etapa 6: Autoverificação e Entrega

Verifique cada imagem em promotion/final/:

  • Resolução = especificações verificadas na Etapa 1 (dimensões, proporção)
  • Formato JPG/PNG, cada uma ≤2MB
  • 3-8 imagens para smartphone, cada uma correspondendo a um ponto de venda
  • Sem texto iOS/Apple/loja concorrente, sem marcas d'água, sem texto ilegível
  • Texto em chinês sem erros de digitação, consistente com a funcionalidade real do aplicativo

Estrutura do diretório:

promotion/
  plan.md          # Pontos de venda, registro de verificação de especificações, seleção de estilo
  shots/           # Capturas de tela originais do emulador
  bg/              # Fundos gerados por IA (multi-estilo, multi-seed)
  final/phone/     # Produto final para smartphone
  final/tablet/    # Produto final para tablet (se aplicável)
  final/pc/        # Produto final para PC (se aplicável)
  manifest.md      # Lista de entrega: nome do arquivo, dimensões, tamanho, ponto de venda correspondente

Relate ao usuário no momento da entrega: caminhos dos arquivos finais, dimensões e pontos de venda de cada imagem, e onde fazer upload no AppGallery Connect (Informações do Aplicativo → Imagens de Apresentação / Imagens Promocionais).

Habilidades Relacionadas