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

Se você quer criar um Mini Programa do WeChat, pode acabar esbarrando logo no começo em várias coisas: Ferramentas de Desenvolvedor do WeChat, 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 nem uma linha de código e já está tendo que lidar com esses detalhes técnicos.

Não importa. 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 este artigo, você vai saber como:

• Importar código nas Ferramentas de Desenvolvedor do WeChat (sem precisar registrar um AppID antes)
• Abrir 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 o produto final.

Ficou legal, né? Vamos começar.

I. Dez Minutos Antes de Começar

Abra o WorkBuddy, encontre o especialista "Desenvolvedor de Mini Programas do WeChat" na coluna de especialistas, habilidades ou conectores, e chame-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 próprio.
2Primeiro passo: o que eu preciso te passar? Ainda não escreva código; vamos discutir primeiro.

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

Ele vai te 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ábitos, 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 refletir sobre todas essas perguntas que você não tinha considerado e define o rumo.

Não busque a perfeição no início; deixe ele criar a versão 1.0 primeiro. Quando você tiver a estrutura básica, pode ir ajustando e modificando aos poucos. Assim que o rumo estiver definido, deixe ele começar a trabalhar.

Enquanto ele escreve o código, você pode instalar as Ferramentas de Desenvolvedor do WeChat.

Esta é a ferramenta oficial do WeChat, porque é nela que seu Mini Programa vai rodar, ser pré-visualizado e enviado. Procure por "Ferramentas de Desenvolvedor do WeChat" na página oficial de download, escolha a Versão Estável, siga as instruções para instalar e escaneie o QR code para entrar. Quando estiver dentro, vai ficar assim:

Alguns pontos importantes:

💡 Na primeira vez, mantenha apenas uma ou duas funções. Quanto mais funções, mais páginas para gerar e mais erros podem aparecer. Conserte o essencial primeiro.

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

⚠️ É normal que os nomes dos menus sejam diferentes do que eu digo. Esses softwares são atualizados com frequência. Se tiver algum problema, é só mandar um print para o WorkBuddy e ele vai te dizer 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. Normalmente, ele dá as instruções de importação; se não der, é só perguntar: "O código está pronto, como faço para importar nas Ferramentas de Desenvolvedor do WeChat?"

Agora você tem: um pacote completo de código do Mini Programa e as Ferramentas de Desenvolvedor do WeChat instaladas.

Está tudo pronto. Hora de pré-visualizar o produto semi-acabado.

II. Vendo o Produto Semi-Acabado

Abra as Ferramentas de Desenvolvedor do WeChat que você acabou de baixar, escaneie para entrar e clique no botão +.

Depois preencha estes três campos:

1. Nome do Projeto: O que você quiser, desde que você reconheça.
2. Diretório: Cole o endereço do passo anterior.
3. AppID: Pode aparecer em vermelho; tudo bem. Clique em "Conta de Teste" para continuar sem problemas.

Em Serviço de Backend, selecione "Não usar serviços em nuvem". Clique em Criar e depois em "Confiar e Executar". A ferramenta vai começar a compilar automaticamente.

⚠️ Quando você precisar mudar para um AppID formal: Se quiser usar o WeChat Cloud Development, fazer upload ou deixar outras pessoas testarem, registre um AppID gratuito com um e-mail. O Capítulo 6 explica isso em detalhes.

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

Se tudo correr bem, 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 talvez você veja uma tela cheia de texto de erro em vermelho. Não entre em pânico; é fácil de resolver.

III. Texto Vermelho em Todo Lugar? Deixe o Autor Corrigir

É normal ter erros na primeira compilação.

A solução é simples: Deixe quem escreveu o código consertar. 😂

Ou seja:

1. Encontre o painel Debugger nas Ferramentas de Desenvolvedor do WeChat; todos os erros vermelhos estão lá.
2. Copie a mensagem de erro inteira — não tire apenas um print parcial ou resuma.
3. Envie para o WorkBuddy. Você nem precisa escrever nada; ele vai corrigir 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 é realmente um erro: Mini Programas não suportam alguns códigos no estilo web (como certos seletores ou efeitos de hover). Se algo ficar estranho no computador, é porque o Mini Programa não suporta. Basta dizer à IA: "Esse efeito não é suportado em Mini Programas, usa outra forma."

⚠️ Outro é um "erro falso": as mudanças não são aplicadas. Não desconfie da IA ainda; clique no botão de atualizar "Compilar" ao lado de "Compilação Normal" no canto superior direito. Isso geralmente resolve.

Agora você tem: um Mini Programa funcionando liso, sem telas brancas ou problemas.

Ele fica ótimo no simulador do computador, mas pode não ser igual em um celular de verdade.

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

É comum os estilos ficarem desalinhados ou os botões não responderem ao toque em um celular real, mesmo funcionando no simulador. O tamanho da tela e o toque versus o mouse são diferentes.

Para colocar no seu celular, clique em um botão: Pré-visualizar.

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

É aqui que as pessoas se confundem: Pré-visualizar, Teste em Dispositivo Real e Depuração Remota geram QR codes. Qual é a diferença?

⚠️ Não use a Pré-visualização como teste final. A pré-visualização é só para uma olhada rápida; não significa que tudo funciona. Use o Teste em Dispositivo Real para confirmar.

⚠️ Mais uma coisa: para facilitar o desenvolvimento, algumas verificações ficam desativadas na ferramenta, mas continuam ativas nos 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á morrendo de vontade de mandar o código para um amigo. Espere, faça estas cinco verificações primeiro, senão pode estar cheio de bugs! 😂

V. Não Deixe os Amigos Testarem Seus Bugs

Leva cinco minutos. Faça você mesmo estas cinco verificações:

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ê acabou de adicionar 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 criar um registro vazio.

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

Depois de corrigir qualquer item, refaça os cinco. Corrigir A muitas vezes quebra B.

⚠️ Passar nos cinco só significa que ele não vai travar na hora. Isso é um processo de polimento em que você vai encontrar problemas estranhos ou ter novas ideias. Eventualmente, você vai ter uma versão com a qual vai ficar 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 que outras pessoas possam escanear, você precisa de um AppID formal. Como registrar:

1. Abra a Plataforma de Contas Oficiais do WeChat e siga o processo de registro. Existem vários tipos: Contas Oficiais, Mini Programas, Mini Games. Escolha Mini Programa. ⚠️ Se escolher o errado, não dá para mudar; você teria que excluir e recomeçar.

1. Use um e-mail que não esteja cadastrado. Digite o e-mail, clique em ativar, insira o código de verificação enviado para a 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 escaneamento pelo WeChat; é gratuito.

1. Entre no backend e encontre o AppID em Gerenciamento de Desenvolvimento. Ele começa com "wx"; copie-o.

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 para as Ferramentas de Desenvolvedor do WeChat e clique em "Upload" no canto superior direito.

Ele vai pedir um número de versão e observações. Use 0.0.1 na primeira vez. Depois do upload, vá para a página de Gerenciamento de Versões no backend do WeChat. Você vai ver a versão; clique na seta para baixo para encontrar a "Versão de Teste". Depois de definir, ele gera um QR code de Teste.

Agora você pode exibir seu Mini Programa para os amigos! Eles conseguem usar escaneando, sem você precisar publicar ou passar por uma revisão formal.

Duas coisas para observar:

Primeiro, subir não é publicar. O upload apenas coloca a versão de desenvolvimento no backend. Ela ainda não é pesquisável; só quem tem o código consegue acessar.

Segundo, Versões de Teste têm validade. Normalmente sete dias. É só fazer o upload novamente para conseguir um novo código. É perfeito para demonstrações ou para compartilhar com alguns amigos.

⚠️ Para muitos, isso já é suficiente. Se for apenas para uso pessoal ou para amigos, a Versão de Teste funciona muito bem. Vou explicar certificação e registro (ICP) 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, tudo desaparece. Como salvar os dados?

VII. Não Perca Dados ao Fechar

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

Se os dados existirem somente localmente no celular, eles se perdem quando você troca de telefone ou quer compartilhar. Você precisa de um backend. Montar seu próprio backend envolve servidores, bancos de dados, domínios, HTTPS e registro (ICP). Vamos pular essa parte trabalhosa e usar o Cloud Development. O banco de dados e a lógica ficam na nuvem; o Mini Programa os acessa diretamente.

1. Clique em "Cloud Development" no topo da ferramenta → Ativar → Anote o ID do Ambiente.

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

1. Copie o ID do Ambiente e envie para o WorkBuddy para definir o ID do globalData.env.

1. Console do Cloud Development → Banco de Dados → Crie coleções como categories / habits / checkins. Defina as permissões como "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 e Deploy: Instalar dependências na nuvem. Isso garante que a função de nuvem 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 ID do Ambiente de Nuvem.

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

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

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

O armazenamento de dados está pronto. Se você quiser que estranhos te encontrem ou usar comercialmente, o verdadeiro desafio começa.

VIII. Deixando Estranhos Te Encontrarem

Passar na Versão de Teste é diferente de passar na revisão oficial.

Faça antes estas seis verificações:

1. O AppID é formal? Contas de teste não podem ir ao ar.
2. Clique em todas as páginas. Sem telas brancas ou travamentos.
3. Configure os domínios do servidor. Se o seu aplicativo busca dados externos, esses domínios precisam ser configurados no backend (Desenvolvimento → Configurações de Desenvolvimento). Apenas HTTPS e WSS são permitidos, e o domínio precisa ter registro (ICP). IPs não são permitidos.
4. Desmarque "Não verificar o domínio da requisição..." nas ferramentas de desenvolvimento. Isso só funciona na ferramenta; dispositivos reais ainda fazem a verificação. Desative e teste novamente.
5. Preencha o Guia de Proteção de Privacidade do Usuário. Se o seu aplicativo lê avatares, localização ou contatos, você precisa declarar. Caso contrário, essas APIs serão desativadas. Pule isso se você não lida com informações de 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 as etapas 3 e 4.

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

1Estou enviando um Mini Programa do WeChat para revisão. Me ajude a verificar este projeto em relação a 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ágina em app.json para eu verificar se há telas brancas.
5Procure no projeto por wx.request, wx.uploadFile, wx.downloadFile e wx.connectSocket. 
6Extraia todos os domínios e agrupe-os nessas quatro categorias. 
7Marque qualquer um que não comece com https/wss ou que use IPs para eu configurar no backend.
8Mude urlCheck em project.config.json para true, se estiver como false.
9Procure 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 depuração console.log.
12Por fim, me dê uma tabela-resumo com: Item de Verificação, Status Atual e Próximo Passo.

⚠️ Não pule a etapa 2. Revisões oficiais exigem um produto completo. A rejeição por "funcionalidade incompleta" é comum.

Depois, existem 4 obstáculos antes do envio:

1️⃣ Informações do Mini Programa

• Nome: Algo reconhecível (ex.: "Controle 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 "Ferramentas > Eficiência" ou "Serviços de Vida".

2️⃣ Categoria

Contas pessoais são limitadas. Recomendado: Ferramentas > Eficiência ou Bloco de Notas. A categoria determina quais APIs você pode usar.

3️⃣ Registro (ICP)

Desde 2024, todos os Mini Programas precisam ter registro ICP. Você precisa de uma foto do documento e verificação facial. Leva de 1 a 3 dias úteis.

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

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 para transmissão ao vivo ou funcionalidade incompleta. A revisão normalmente 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ê devolveu o texto vermelho, e ele se corrigiu sozinho.

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

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

Do começo ao fim, sem precisar saber programar.

Faça só uma coisa hoje à noite: instale as Ferramentas de Desenvolvedor do WeChat. Leva dez minutos.

Depois de instalado, você vai ficar morrendo de vontade de colocar algo para rodar. Quando perceber, já começou.

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

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