Como criar um Mini Programa do WeChat com o WorkBuddy: Guia para iniciantes

Se você quer criar um Mini Programa WeChat, provavelmente vai esbarrar primeiro em um monte de coisas: WeChat Developer Tools, diretórios de projeto, AppID, ambientes de desenvolvimento em nuvem, bancos de dados, upload e gerenciamento de versões no backend.

O que é tudo isso? Você ainda não escreveu uma linha de código e já está travado nessas burocracias.

Não tem problema. Mesmo que você nunca tenha escrito código, nunca tenha feito um Mini Programa ou nem saiba o que é um AppID, este artigo foi escrito para você.

Como é criar um em uma única tarde

Depois de ler isto, você vai saber:

• Importar código para o WeChat Developer Tools (sem precisar registrar um AppID antes)
• Abrir o programa no seu próprio celular
• Gerar um QR code para enviar aos amigos para testarem
• Enviar para revisão, publicar e ficar pesquisável

Primeiro, veja meu produto final.

Ficou bonito, né? Vamos começar.

I. Dez Minutos Antes de Começar

Abra o WorkBuddy, encontre o especialista "WeChat Mini Program Developer" na coluna de especialistas, habilidades ou conectores, e invoque-o.

Depois, não diga apenas "Me ajuda a fazer um Mini Programa".

1Quero criar um Mini Programa de acompanhamento de hábitos diários para uso pessoal.
2Primeiro passo: o que preciso te informar? Não escreva código ainda; vamos discutir antes.

Substitua "acompanhamento de hábitos diários" pela sua própria ideia.

Então ele vai perguntar como você quer armazenar os dados, o quão completa a primeira versão deve ser, qual método de desenvolvimento você pretende usar, se precisa de lembretes diários, quais são os tipos de hábito, a granularidade de tempo dos lembretes, preferências de estilo visual e, por fim, vai pedir para você ajustar as dimensões de classificação, arquivamento/exclusão e ciclos estatísticos.

Ele ajuda você a pensar em todas essas questões que você não tinha considerado e define o rumo.

Não busque a perfeição no começo; deixe ele construir a versão 1.0 primeiro. Quando você tiver a estrutura básica, pode ajustar e modificar aos poucos. Assim que o direcionamento estiver definido, deixe-o trabalhar.

Enquanto ele escreve o código, você pode instalar o WeChat Developer Tools.

Essa é a ferramenta oficial do WeChat, porque seu Mini Programa vai rodar, ser visualizado e enviado daqui. Procure por "WeChat Developer Tools" na página oficial de download, selecione a Versão Estável, siga as instruções para instalar e faça login com o código QR. Depois de entrar, fica assim:

Alguns pontos para observar:

💡 Na primeira vez, limite-se a uma ou duas funções. Quanto mais funções, mais páginas para gerar e mais erros podem aparecer. Corrija o essencial primeiro.

💡 Mude o modelo para HY3; não deixe no automático. Ele está gratuito por tempo limitado, com uso ilimitado. (Verifique no backend se a promoção ainda está ativa quando você ler isto.)

⚠️ É comum os nomes dos menus estarem diferentes do que eu falo. Essas ferramentas são atualizadas com frequência. Se tiver algum problema, é só mandar um print para o WorkBuddy que ele te diz onde clicar.

Quando o código estiver pronto, ele vai te dar o caminho da pasta do projeto. Guarde esse caminho; você vai precisar dele no próximo passo. Ele normalmente dá as instruções de importação; se não der, é só perguntar: "O código está pronto, como faço para importar no WeChat Developer Tools?"

Agora você tem: um conjunto completo de código do Mini Programa e o WeChat Developer Tools instalado.

Está tudo pronto. Hora de visualizar o produto semiacabado.

II. Visualizando o Produto Semiacabado

Abra o WeChat Developer Tools que você acabou de baixar, faça login com o QR code e clique no botão +.

Depois preencha estes três campos:

1. Project Name: Qualquer nome que você quiser, desde que reconheça.
2. Directory: Cole o endereço do passo anterior.
3. AppID: Pode aparecer em vermelho; tudo bem. Clique em "Test Account" para continuar sem problemas.

Em Backend Service, selecione "Do not use cloud services". Clique em Create e depois em "Trust and Run". A ferramenta vai começar a compilar sozinha.

⚠️ Quando você precisar trocar para um AppID oficial: se quiser usar o WeChat Cloud Development, enviar o código ou deixar outras pessoas testarem, registre um gratuito usando um e-mail. O capítulo 6 explica isso em detalhes.

⚠️ Além disso, pense bem na categoria antes de registrar. Você precisa escolher entre Mini Games e outras opções, e isso não pode ser alterado depois.

Se tudo der certo, você vai ver seu Mini Programa na ferramenta: o simulador à esquerda e o código à direita.

Agora você tem: um Mini Programa rodando no seu computador.

Ou então, você pode ver uma tela cheia de erros em vermelho. Não entre em pânico; é fácil resolver.

III. Tela Cheia de Vermelho? Deixe o Autor Corrigir

É normal ter erros na primeira compilação.

A solução é simples: deixe quem escreveu o código corrigir. 😂

Especificamente:

1. Encontre o painel Debugger no WeChat Developer Tools; todos os erros vermelhos estão ali.
2. Copie a mensagem de erro inteira — não mande só um print parcial nem resuma com suas palavras.
3. Envie para o WorkBuddy. Você nem precisa escrever nada; ele corrige para você.

Depois de analisar, ele ou corrige o código diretamente ou te guia pelas configurações necessárias.

Duas coisas para observar:

⚠️ Um tipo de "erro" não é erro de verdade: Mini Programas não suportam alguns estilos de código web (como certos seletores ou efeitos de hover). Se ficou estranho no computador, é porque o Mini Programa não suporta esse recurso. Basta dizer para a IA: "Esse efeito não é suportado em Mini Programas, usa outro jeito."

⚠️ Outro é um "falso" erro: as alterações não fazem efeito. Não duvide da IA ainda; clique no botão de atualizar "Compile" ao lado de "Normal Compilation" no canto superior direito. Isso geralmente resolve.

Agora você tem: um Mini Programa rodando liso, sem tela branca nem problemas.

Fica ótimo no simulador do computador, mas pode não ser igual no celular real.

IV. Fica Bom no PC, mas Talvez Não no Celular

É comum que estilos fiquem desalinhados ou botões não respondam ao toque no celular real, mesmo funcionando no simulador. Os tamanhos de tela são diferentes, e toque é diferente de mouse.

Para colocar no seu celular, é só clicar em um botão: Preview.

A ferramenta gera um QR code. Escaneie com o WeChat e seu Mini Programa abre no celular.

Aqui é onde as pessoas se confundem: Preview, Real Machine Test e Remote Debugging geram QR codes. Qual é a diferença?

⚠️ Não use o Preview como teste final. Preview é só para uma olhada rápida; não significa que está tudo funcionando. Use o Real Machine Test para confirmar.

⚠️ Mais uma coisa: para facilitar o desenvolvimento, algumas verificações ficam desativadas na ferramenta, mas continuam ativas em dispositivos reais. Às vezes funciona no PC, mas falha no celular.

Agora você tem: um Mini Programa que abre no seu próprio celular.

Você provavelmente está ansioso para mandar o código para um amigo. Calma, rode essas cinco verificações antes, senão vai estar cheio de bugs! 😂

V. Não Deixe os Amigos Testarem Seus Bugs

Leva cinco minutos. Rode estes cinco itens você mesmo:

1. Adicionar: Adicione um novo registro; ele aparece na lista?
2. Status: Alterne entre concluído e não concluído; funciona?
3. Reentrada: Feche o Mini Programa e abra de novo; os dados que você adicionou continuam lá?
4. Excluir: Exclua um registro; ele continua excluído depois de atualizar?
5. Valores vazios: Clique em adicionar sem preencher nada; deve aparecer um aviso e não deve criar um registro vazio.

Os itens 3 e 5 costumam passar despercebidos se você não testar especificamente.

Depois de corrigir qualquer item, rode os cinco novamente. Corrigir A muitas vezes quebra B.

⚠️ Passar nos cinco significa apenas que não vai crashar de imediato. Esse é um processo de polimento em que você vai encontrar problemas estranhos ou ter novas ideias. No final, você terá uma versão com a qual está satisfeito.

Agora você tem: um Mini Programa polido e do seu agrado.

Agora só falta uma última coisa para enviar aos amigos: uma identidade formal.

VI. Envie um Código para os Amigos Escanearem

Para deixar outras pessoas escanearem, você precisa de um AppID oficial. Como registrar:

1. Acesse a Plataforma Oficial do WeChat e siga o processo de registro. Existem vários tipos: Official Accounts, Mini Programas, Mini Games. Escolha Mini Program. ⚠️ Se escolher errado, não tem como mudar; você teria que excluir e recomeçar.
2. Use um e-mail limpo. Digite o e-mail, clique em ativar, insira o código de verificação enviado para sua caixa de entrada e defina uma senha.

1. Selecione o Tipo de Conta. Para uso pessoal, escolha "Individual". Exige verificação de identidade e um scan do WeChat; é gratuito.
2. Entre no backend e encontre o AppID em Development Management. Ele começa com "wx"; copie.

Assim que tiver o AppID, envie isto para o seu WorkBuddy:

1Altere o AppID no projeto para o meu AppID: [sua string wx...]

Depois volte ao WeChat Developer Tools e clique em "Upload" no canto superior direito.

Ele vai pedir um número de versão e notas. Use 0.0.1 na primeira vez. Depois do upload, vá para a página de Version Management no backend do WeChat. Você verá a versão; clique na seta para baixo e encontre a "Trial Version". Depois de configurada, ela gera um QR code de teste.

Agora você pode exibir seu Mini Programa para os amigos! Eles podem usar escaneando o código, sem precisar publicar ou passar por uma revisão oficial.

Duas coisas para observar:

Primeiro, enviar (upload) não é publicar. Enviar apenas coloca a versão de desenvolvimento no backend. Ela ainda não é pesquisável; só quem tem o código consegue entrar.

Segundo, a Trial Version tem validade. Geralmente sete dias. É só reenviar o código para gerar um novo. É perfeito para demonstrações ou para compartilhar com alguns amigos.

⚠️ Para muita gente, isso já é suficiente. Se for só para uso pessoal ou para amigos, a Trial Version funciona bem. Vou explicar certificação e ICP filing nos próximos capítulos.

Agora você tem: um QR code de teste para enviar aos amigos.

Você criou um Mini Programa de verdade. Mas se um amigo adicionar dados e fechar o aplicativo, eles desaparecem. Como salvar os dados?

VII. Não Perca Dados ao Fechar

Ainda não resolvemos onde seus dados são armazenados.

Se os dados existem apenas localmente no celular, eles se perdem se você trocar de aparelho ou quiser compartilhá-los. Você precisa de um backend. Montar seu próprio backend envolve servidores, bancos de dados, domínios, HTTPS e ICP filing. Vamos pular essa dor de cabeça e usar o Cloud Development. O banco de dados e a lógica ficam na nuvem; o Mini Programa chama tudo diretamente.

1. Clique em "Cloud Development" no topo da ferramenta → Activate → Anote o Environment ID.

Quando você clicar em ativar, pode aparecer uma taxa de 19,9 RMB/mês, mas calma — ele deve guiar você automaticamente para um ambiente de desenvolvimento gratuito.

1. Copie o Environment ID e envie para o WorkBuddy configurar o ID de globalData.env.

1. Console do Cloud Development → Database → Crie coleções como categories / habits / checkins. Defina as permissões como "Creator only can read/write" (somente o criador pode ler/escrever). O WorkBuddy vai te dizer quais coleções criar.

1. Clique com o botão direito em cloudfunctions/login → Upload and Deploy: Install cloud dependencies (enviar e implantar: instalar dependências da nuvem). Isso garante que a cloud function encontre os pacotes de que precisa.

Uma dica: se você não encontrar cloudfunctions no seu projeto, a pasta de importação pode estar errada. Mude para a pasta pai.

Agora que o armazenamento de dados está pronto, recarregue o projeto. Ele vai pedir o AppID e o Cloud Environment ID.

⚠️ Você não pode usar uma conta de teste para isso; precisa de um AppID oficial.

⚠️ O Cloud Development às vezes tem promoções para novos usuários, mas são por tempo limitado.

Reimporte a versão que salva dados, cole seu AppID e selecione "WeChat Cloud Development" como backend. Agora, os dados estão conectados.

Armazenamento de dados resolvido. Se você quiser que desconhecidos te encontrem ou usar o Mini Programa comercialmente, o desafio de verdade começa agora.

VIII. Deixando Desconhecidos Te Encontrarem

Passar na Trial Version é diferente de passar na revisão oficial.

Rode estas seis verificações primeiro:

1. O AppID é oficial? Contas de teste não podem publicar.
2. Clique em todas as páginas. Sem telas brancas ou crashes.
3. Configure os domínios do servidor. Se o seu aplicativo busca dados externos, esses domínios precisam ser configurados no backend (Development → Development Settings). Apenas HTTPS e WSS são permitidos, e o domínio precisa ter ICP filing. IPs não são permitidos.
4. Desmarque "Do not verify request domain..." nas ferramentas de desenvolvimento. Isso só funciona na ferramenta; em dispositivos reais a verificação continua ativa. Desative e teste novamente.
5. Preencha o Guia de Proteção de Privacidade do Usuário. Se o seu aplicativo lê avatar, localização ou contatos, você precisa declarar. Caso contrário, essas APIs serão desativadas. Pule isto se você não mexe em informações do usuário.
6. Preencha nome, avatar, introdução e categoria no backend. Escolher a categoria errada é um motivo comum de rejeição.

💡 Se você usa Cloud Development ou não usa internet, pule os passos 3 e 4.

🔴 Preparei isto para você; é só enviar para o WorkBuddy:

1Vou enviar um Mini Programa WeChat para revisão. Me ajude a verificar este projeto de acordo com estes pontos.
2Corrija o que puder e me diga o que preciso preencher manualmente.
3Verifique se o appid em project.config.json é uma conta de teste.
4Liste todos os caminhos de páginas em app.json para eu verificar se há telas brancas.
5Pesquise no projeto por wx.request, wx.uploadFile, wx.downloadFile e wx.connectSocket.
6Extraia todos os domínios e agrupe-os nessas quatro categorias.
7Marque os que não começam com https/wss ou usam IPs para eu configurá-los no backend.
8Altere urlCheck em project.config.json para true se estiver false.
9Pesquise por APIs de informações do usuário (avatar, localização, contatos etc.) e liste quais arquivos/linhas as usam.
10Vou usar isso para o Guia de Proteção de Privacidade.
11Verifique se sobrou algum código de debug com console.log.
12Por fim, me dê uma tabela resumo com: Item de Verificação, Status Atual e Próximo Passo.

⚠️ Não pule o passo 2. A revisão oficial exige um produto completo. A rejeição por "funcionalidade incompleta" é comum.

Depois, existem 4 barreiras antes da submissão:

1️⃣ Informações do Mini Programa

• Nome: Algo reconhecível (ex.: "Habit Tracker" — Controlador de Hábitos). Contas pessoais não podem usar "Oficial" ou "WeChat".
• Ícone: PNG 1024x1024.
• Introdução: Uma frase explicando a função.
• Escopo do Serviço: Escolha "Tools > Efficiency" (Ferramentas > Eficiência) ou "Life Services" (Serviços de Vida).

2️⃣ Categoria

Contas pessoais têm limitações. Recomendado: Tools > Efficiency ou Notepad (Ferramentas > Eficiência ou Bloco de Notas). A categoria determina quais APIs você pode usar.

3️⃣ ICP Filing

A partir de 2024, todos os Mini Programas precisam de ICP filing. Você vai precisar de uma foto do documento e verificação facial. Leva de 1 a 3 dias úteis.

4️⃣ Certificação WeChat (Opcional, mas recomendado)

Contas pessoais podem ser certificadas por 300 RMB/ano. Se você não quiser pagar, pode pular — isso não impede a publicação, mas você não ficará pesquisável.

Motivos comuns de rejeição: falta de qualificações médicas/financeiras, falta de permissões de transmissão ao vivo ou funcionalidade incompleta. A revisão geralmente leva de 1 a 7 dias.

Viu? Você Conseguiu

Você falou com a IA, e o código apareceu.

Você preencheu um caminho, e a página apareceu.

Você mandou de volta o texto vermelho, e ele se corrigiu.

Você escaneou um código, e ele rodou no seu celular.

Você clicou em enviar, e os amigos puderam escanear.

Do início ao fim, nenhum conhecimento de código foi necessário.

Só faça uma coisa hoje à noite: instale o WeChat Developer Tools. Leva dez minutos.

Depois de instalado, você vai ficar com vontade de jogar alguma coisa para rodar. Nesse momento, você já começou.

Se alguém que você conhece quer fazer um Mini Programa, mas ainda não começou, mande este artigo. Vai economizar um fim de semana inteiro.

Eu sou o Song Song. Vou continuar compartilhando conteúdo útil.