O que store-pack faz?
Gera a pasta store/ na raiz do projeto: ícones, capturas de tela emolduradas, uma arte gráfica de destaque, texto da listagem, respostas de formulários do console e um README com bloqueadores. Nunca submeta, faça commit ou deploy; deixe isso para o usuário.
Requisitos: Python 3, o Flutter SDK (o compositor de imagens é um teste Flutter, nenhum aplicativo necessário) e macOS (para sips para verificação de imagens e tamanhos de ícones). As capturas de tela brutas vêm do próprio aplicativo.
Fluxo de Trabalho
- Inspecione o aplicativo para obter fatos (nunca invente): ID do pacote/bundle, versão, permissões (AndroidManifest, Info.plist), SDKs no pubspec, Cargo.toml ou package.json (anúncios, analytics, relatórios de falhas, faturamento, login), como funcionam contas e pagamentos, URLs de política de privacidade e suporte, configuração de assinatura, famílias de dispositivos. Leia a documentação de contribuição do próprio projeto para suas regras.
- Capturas de tela brutas. Capture do aplicativo real com dados inventados realistas. Nunca use dados de produção ou uma conta de produção.
- Flutter: um harness de teste widget com fontes reais (
debugDisableShadows = false, ou as sombras renderizam como contornos duros); telefone 440x956 em 3x = 1320x2868. - Web, desktop ou aplicativos híbridos: execute o próprio servidor do aplicativo em um banco de dados rascunho, alimente-o através da API e controle-o com uma ferramenta de automação de navegador. Use um contexto de navegador separado com
deviceScaleFactor3 (telefone, viewport 440x956) ou 2 (tablet, 1032x1376), e oculte as barras de rolagem com*::-webkit-scrollbar{display:none!important}*{scrollbar-width:none!important}antes de cada captura. - Mate apenas o processo ouvindo em sua própria porta rascunho (
lsof -ti tcp:PORT -sTCP:LISTEN), nunca pelo nome. - Verifique cada captura visualmente. Descarte telas que estejam quebradas na largura e informe o usuário.
- Flutter: um harness de teste widget com fontes reais (
store/app.json(vejadocs/config-reference.md), então executepython3 scripts/make_pack.py store/app.json. Ele emoldura as capturas de tela em um gradiente de marca com uma legenda, cria uma arte gráfica de destaque e ícones, e executascripts/check_pack.py.- Ícone: geralmente existe apenas arte com cantos arredondados embutidos ou texto; o trabalho
iconcorta a marca em um fundo sólido sem bordas. Informe ao usuário que ainda é necessário um vetor ou uma fonte limpa de 1024 px.
- Ícone: geralmente existe apenas arte com cantos arredondados embutidos ou texto; o trabalho
- Texto da listagem:
store/listings.json, depoispython3 scripts/write_listings.py store/listings.json(layout fastlane, limites aplicados). Descreva apenas o que a compilação realmente faz e o que a compilação da plataforma inclui. - Documentação:
store/README.md(tabela de bloqueadores primeiro),google-play/console-forms.md,app-store/connect-forms.md.
Especificações das lojas (confirme nos consoles; a página da Apple pode não carregar)
- Play: ícone 512 px (<= 1 MB); arte gráfica de destaque 1024x500, sem alfa; 2-8 capturas de telefone, cada lado entre 320-3840 px e lado longo <= 2x lado curto (use 1080x1920); opcional capturas de tablet 7"/10" (1200x1920, 1600x2560); título 30, curto 80, completo 4000.
- App Store: iPhone 6,9" 1320x2868 (obrigatório), 6,5" 1284x2778; iPad 13" 2064x2752 se iPad for suportado; até 10 cada; sem alfa; ícone 1024 px, sem alfa; nome 30, subtítulo 30, promo 170, palavras-chave 100.
- Ambas rejeitam capturas de tela com canal alfa; o compositor escreve PNG RGB.
Bloqueadores a serem verificados em todo aplicativo (aprendido)
- Pagamentos: vender desbloqueios digitais ou licenças por meio de um provedor de pagamento web dentro do aplicativo viola as regras do Play Billing / Apple IAP. Para iOS, envie sem interface de compra ou adicione StoreKit. Sem preços ou links de compra em compilações móveis.
- Exclusão de conta: qualquer aplicativo que crie contas precisa de um caminho de exclusão no aplicativo e (Play) uma URL web pública descrevendo-o.
- Entrar com Apple: exigido sempre que o login do Google ou outro terceiro for oferecido no iOS.
- IDs de anúncios de teste deixados em uma versão de lançamento; IDs reais ausentes.
- Play App Signing: adicione o SHA-1 de assinatura do Play aos clientes OAuth do Google Android, ou o login falhará em instalações do Play.
- Permissões restritas ou declaradas:
REQUEST_IGNORE_BATTERY_OPTIMIZATIONS, tipos de serviço em primeiro plano (precisa de declaração e vídeo), localização (mesmo commaxSdkVersion), BluetoothneverForLocation. - Acesso do revisor: aplicativos que precisam de um servidor ou licença precisam de um servidor de demonstração, PIN e etapas (acesso ao aplicativo Play, diretriz 2.1 da Apple).
- URL da política de privacidade deve existir; endereço de contato e telefone para status de comerciante (UE/UK).
- Assinatura de lançamento configurada; aumento de versão; AAB para Play; equipe Apple e ID do bundle;
ITSAppUsesNonExemptEncryption; manifesto de privacidade. - Novas contas pessoais Play: um teste fechado de 12 testadores por 14 dias é necessário antes da produção.
- Segurança de dados: "processado efemeramente" apenas para dados usados na memória e nunca armazenados (por exemplo, uma foto enviada a um serviço de IA); email ou IDs mantidos em um servidor não são efêmeros. ID de publicidade: responda "Não" apenas se nenhum SDK de anúncio ou conversão estiver presente e a permissão de ID de publicidade for removida.
- Público-alvo 18+ a menos que o aplicativo seja verdadeiramente para crianças.
- Um ofuscador de tamanho mínimo (R8) pode falhar em bibliotecas opcionais: se uma compilação de lançamento falhar com "Missing classes", adicione regras
-dontwarnpara os pacotes nomeados.
Arquivos
scripts/make_pack.pyexecuta tudo;scripts/compose/é o compositor Flutter (STORE_JOBS=jobs.json flutter test);scripts/build_icons.py;scripts/check_pack.py;scripts/write_listings.py.templates/app.example.json,templates/listings.example.json- configurações para copiar.examples/- um exemplo completo com um aplicativo fictício e sua saída.docs/- guia de início, referência de configuração, como funciona.