Comment créer un mini-programme WeChat avec WorkBuddy : Guide pour débutants

Si tu veux créer un mini-programme WeChat, tu risques de te heurter d’abord à tout un tas de choses : les outils de développement WeChat, les dossiers de projet, l’AppID, les environnements de développement cloud, les bases de données, le téléversement et la gestion des versions du backend.

Qu’est-ce que tout ça ? Tu n’as pas encore écrit une seule ligne de code et tu es déjà bloqué sur ces détails techniques.

Peu importe. Même si tu n’as jamais écrit de code, jamais créé de mini-programme ou si tu ne sais même pas ce qu’est un AppID, cet article est écrit pour toi.

À quoi ressemble la création d’un mini-programme en un après-midi

Après avoir lu ce guide, tu sauras comment :

• Importer du code dans les outils de développement WeChat (sans avoir besoin d’enregistrer un AppID au préalable)
• L’ouvrir sur ton propre téléphone
• Générer un code QR à envoyer à des amis pour tester
• Le soumettre à la validation, le mettre en ligne et le rendre accessible dans les recherches

D’abord, regarde mon produit terminé.

Pas mal, non ? Alors, c’est parti.

I. Dix minutes avant de commencer

Ouvre WorkBuddy, trouve l’expert « Développeur de mini-programmes WeChat » dans la colonne experts, compétences ou connecteurs, et invoque-le.

Ensuite, ne te contente pas de dire « Aide-moi à créer un mini-programme ».

1Je veux créer un mini-programme de suivi d'habitudes quotidiennes pour mon usage personnel.
2Première étape : quelles informations dois-je te fournir ? N'écris pas encore de code, discutons d'abord.

Remplace « suivi d’habitudes quotidiennes » par ton propre concept.

Ensuite, il te demandera comment tu veux stocker les données, à quel point la première version doit être complète, quelle méthode de développement tu comptes utiliser, si tu as besoin de rappels quotidiens, quels sont les types d’habitudes, la granularité temporelle des rappels, tes préférences en matière de style visuel. Enfin, il te demandera d’affiner les dimensions de classification, l’archivage/suppression et les cycles de statistiques.

Il t’aide à réfléchir à toutes ces questions auxquelles tu n’avais pas pensé et fixe le cap.

Ne vise pas la perfection au début ; laisse-le d’abord construire une version 1.0. Une fois que tu as le cadre de base, tu peux ajuster et modifier les choses tranquillement. Dès que la direction est définie, laisse-le se mettre au travail.

Pendant qu’il écrit le code, tu peux installer les outils de développement WeChat.

Ce sont les outils officiels de WeChat, car ton mini-programme sera exécuté, prévisualisé et téléversé à partir de là. Cherche « WeChat Developer Tools » sur la page de téléchargement officielle, sélectionne la version stable, suis les instructions d’installation, puis scanne le code QR pour te connecter. Une fois à l’intérieur, l’interface ressemble à ceci :

Quelques points à noter :

💡 Pour une première fois, limite-toi à une ou deux fonctionnalités. Plus il y a de fonctionnalités, plus il y a de pages à générer et plus le risque d’erreurs augmente. Corrige d’abord l’essentiel.

💡 Passe le modèle sur HY3, ne le laisse pas en auto. C’est gratuit pour une durée limitée, avec une utilisation illimitée. (Vérifie dans le backend si la promotion est toujours active lorsque tu liras ceci.)

⚠️ Il est courant que les noms de menus diffèrent de ce que je dis. Ces outils logiciels sont mis à jour fréquemment. Si tu as un problème, envoie une capture d’écran à WorkBuddy, et il te dira où cliquer.

Quand le code est terminé, il te donnera le chemin du dossier du projet. Garde ce chemin en tête ; tu en auras besoin pour l’étape suivante. Il fournit normalement des instructions d’importation ; sinon, demande-lui simplement : « Le code est prêt, comment l’importer dans les outils de développement WeChat ? »

Maintenant, tu disposes : d’un jeu complet de code pour ton mini-programme et des outils de développement WeChat installés.

Tout est prêt. Il est temps de prévisualiser le produit semi-fini.

II. Voir le produit semi-fini

Ouvre les outils de développement WeChat que tu viens de télécharger, scanne pour te connecter, puis clique sur le bouton +.

Renseigne ensuite ces trois champs :

1. Nom du projet : celui que tu veux, tant que tu le reconnais.
2. Répertoire : colle l’adresse indiquée à l’étape précédente.
3. AppID : il peut apparaître en rouge ; pas de problème. Clique sur « Compte de test » pour continuer en toute simplicité.

Pour le service backend, sélectionne « Ne pas utiliser les services cloud ». Clique sur Créer, puis sur « Approuver et exécuter ». L’outil commencera à compiler automatiquement.

⚠️ Quand tu devras passer à un AppID officiel : si tu veux utiliser le développement cloud WeChat, téléverser le mini-programme ou le faire essayer par d’autres, il faut en créer un gratuitement avec une adresse e-mail. Le chapitre 6 explique cela en détail.

⚠️ Par ailleurs, réfléchis bien à la catégorie avant de t’inscrire. Tu dois choisir entre les mini-jeux et les autres catégories, et ce choix ne peut pas être modifié par la suite.

Si tout se passe bien, tu verras ton mini-programme dans l’outil : le simulateur à gauche et le code à droite.

Maintenant, tu as : un mini-programme qui tourne sur ton ordinateur.

Ou bien, tu verras peut-être un écran plein de texte d’erreur en rouge. Pas de panique, c’est facile à corriger.

III. Du texte rouge partout ? Laisse l’auteur le corriger

Il est normal d’avoir des erreurs lors de la première compilation.

La solution est simple : laisse celui qui a écrit le code le corriger. 😂

Concrètement :

1. Repère le panneau Débogueur dans les outils de développement WeChat ; toutes les erreurs rouges s’y trouvent.
2. Copie l’intégralité du message d’erreur — ne te contente pas d’une capture partielle ou d’une reformulation.
3. Envoie-le à WorkBuddy. Pas besoin d’ajouter quoi que ce soit, il corrigera pour toi.

Après analyse, il corrigera le code directement ou te guidera à travers les réglages nécessaires.

Deux choses à noter :

⚠️ Un type d’« erreur » n’en est pas vraiment une : les mini-programmes ne prennent pas en charge certains styles de codage web (comme certains sélecteurs ou effets de survol). Si ça semble bizarre sur l’ordinateur, c’est que le mini-programme ne le supporte pas. Il suffit de dire à l’IA : « Cet effet n’est pas pris en charge dans les mini-programmes, utilise une autre méthode. »

⚠️ Une autre est une « fausse » erreur : les modifications ne prennent pas effet. Ne doute pas encore de l’IA ; clique sur le bouton « Compiler » à côté de « Compilation normale » en haut à droite. Cela règle généralement le problème.

Maintenant, tu as : un mini-programme fluide, sans écrans blancs ni problèmes.

Il rend très bien sur le simulateur de l’ordinateur, mais ce n’est peut-être pas pareil sur un vrai téléphone.

IV. Ça rend bien sur PC, mais peut-être pas sur mobile

Il est courant que des styles soient décalés ou que des boutons ne soient pas cliquables sur un vrai téléphone, même s’ils fonctionnent dans le simulateur. Les tailles d’écran et l’interaction tactile (par opposition à la souris) sont différentes.

Pour l’avoir sur ton téléphone, clique sur un seul bouton : Aperçu.

L’outil génère un code QR. Scanne-le avec WeChat et ton mini-programme s’ouvre sur ton téléphone.

C’est là que les gens s’embrouillent : Aperçu, Test sur appareil réel et Débogage à distance génèrent tous des codes QR. Quelle est la différence ?

⚠️ N’utilise pas l’Aperçu comme test final. L’Aperçu est juste un coup d’œil rapide ; cela ne garantit pas que tout fonctionne. Utilise le Test sur appareil réel pour confirmer.

⚠️ Encore un point : pour faciliter le développement, certaines vérifications sont désactivées dans l’outil, mais elles restent actives sur les vrais appareils. Parfois, cela fonctionne sur PC mais échoue sur mobile.

Maintenant, tu as : un mini-programme qui s’ouvre sur ton propre téléphone.

Tu as probablement très envie d’envoyer le code à un ami. Attends, fais d’abord ces cinq vérifications, sinon il sera plein de bugs ! 😂

V. Ne laisse pas tes amis tester tes bugs

Ça prend cinq minutes. Fais ces cinq points toi-même :

1. Ajout : ajoute une nouvelle entrée ; apparaît-elle dans la liste ?
2. Statut : bascule entre terminé et non terminé ; est-ce que ça fonctionne ?
3. Réouverture : ferme le mini-programme puis rouvre-le ; les données que tu viens d’ajouter sont-elles toujours là ?
4. Suppression : supprime une entrée ; disparaît-elle définitivement après un rafraîchissement ?
5. Valeurs vides : clique sur ajouter sans rien remplir ; un message doit s’afficher et aucune fiche vide ne doit être créée.

Les points 3 et 5 sont souvent oubliés si on ne les teste pas spécifiquement.

Après avoir corrigé un point, refais les cinq tests. Corriger A casse souvent B.

⚠️ Réussir ces cinq tests signifie seulement que le mini-programme ne plantera pas tout de suite. C’est un processus de polissage où tu découvriras des problèmes bizarres ou de nouvelles idées. Au final, tu obtiendras une version qui te convient.

Maintenant, tu as : un mini-programme soigné, dont tu es satisfait.

Il ne te reste plus qu’une chose pour l’envoyer à des amis : une identité officielle.

VI. Envoie un code à scanner par tes amis

Pour que d’autres puissent le scanner, tu as besoin d’un AppID officiel. Voici comment l’obtenir :

1. Ouvre la plateforme des comptes officiels WeChat et suis la procédure d’inscription. Il existe plusieurs types : comptes officiels, mini-programmes, mini-jeux. Choisis Mini-programme. ⚠️ Si tu fais le mauvais choix, tu ne pourras pas le modifier ; tu devras tout supprimer et recommencer.
2. Utilise une adresse e-mail dédiée. Saisis l’e-mail, clique sur activer, entre le code de vérification reçu dans ta boîte de réception, puis définis un mot de passe.

1. Choisis le type d’entité. Pour un usage personnel, choisis « Individuel ». Cela nécessite une vérification d’identité et un scan WeChat ; c’est gratuit.
2. Connecte-toi au backend, puis trouve l’AppID dans Gestion du développement. Il commence par « wx » ; copie-le.

Une fois que tu as l’AppID, envoie ce message à ton WorkBuddy :

1Remplace l'AppID du projet par le mien : [ta chaîne wx...]

Retourne ensuite dans les outils de développement WeChat et clique sur « Téléverser » en haut à droite.

Il te demandera un numéro de version et des notes. Utilise 0.0.1 pour la première fois. Après le téléversement, va sur la page Gestion des versions dans le backend WeChat. Tu verras la version ; clique sur la flèche vers le bas pour trouver la « Version d’essai ». Une fois définie, tu obtiens un code QR d’essai.

Maintenant, tu peux montrer ton mini-programme à tes amis ! Ils peuvent l’utiliser en le scannant, sans que tu aies besoin de le publier ni de passer une validation officielle.

Deux choses à noter :

Premièrement, téléverser n’est pas publier. Le téléversement place simplement la version de développement dans le backend. Elle n’est pas encore visible dans les recherches ; seules les personnes qui ont le code peuvent y accéder.

Deuxièmement, les versions d’essai expirent. En général, après sept jours. Il suffit de téléverser de nouveau pour obtenir un nouveau code. C’est idéal pour des démos ou pour partager avec quelques amis.

⚠️ Pour beaucoup, cela suffit. Si c’est juste pour un usage personnel ou entre amis, la version d’essai fait parfaitement l’affaire. J’expliquerai la certification et l’enregistrement dans les chapitres suivants.

Maintenant, tu as : un code QR d’essai à envoyer à tes amis.

Tu as créé un vrai mini-programme. Mais si un ami ajoute des données et ferme l’application, tout disparaît. Comment sauvegarder les données ?

VII. Ne perds pas de données en fermant

Nous n’avons pas encore réglé la question de l’endroit où tes données sont stockées.

Si les données n’existent qu’en local sur le téléphone, elles sont perdues si tu changes de téléphone ou si tu veux les partager. Tu as besoin d’un backend. Mettre en place ton propre backend implique des serveurs, des bases de données, des domaines, HTTPS et un enregistrement. Évitons ces tracas et utilisons Cloud Development. La base de données et la logique sont dans le cloud ; le mini-programme les appelle directement.

1. Clique sur « Cloud Development » en haut de l’outil → Active → Note l’ID d’environnement.

Quand tu cliques sur Activer, il se peut qu’un tarif de 19,9 RMB/mois s’affiche, mais attends : il devrait te guider automatiquement vers un environnement de développement gratuit.

1. Copie l’ID d’environnement et envoie-le à WorkBuddy pour définir l’ID globalData.env.

1. Console Cloud Development → Base de données → Crée des collections comme categories / habits / checkins. Définis les autorisations sur « Seul le créateur peut lire/écrire ». WorkBuddy t’indiquera quelles collections créer.

1. Fais un clic droit sur cloudfunctions/login → Téléverser et déployer : installer les dépendances cloud. Cela garantit que la fonction cloud trouve les packages dont elle a besoin.

Astuce : si tu ne trouves pas cloudfunctions dans ton projet, c’est peut-être que ton dossier d’importation est erroné. Remplace-le par le dossier parent.

Maintenant que le stockage des données est prêt, recharge le projet. Il te demandera l’AppID et l’ID d’environnement cloud.

⚠️ Tu ne peux pas utiliser un compte de test pour cela ; tu as besoin d’un AppID officiel.

⚠️ Le développement cloud a parfois des promotions pour les nouveaux utilisateurs, mais elles sont limitées dans le temps.

Réimporte la version qui sauvegarde les données, colle ton AppID et sélectionne « WeChat Cloud Development » comme service backend. Les données sont maintenant connectées.

Le stockage des données est terminé. Si tu veux que des inconnus te trouvent ou utiliser le mini-programme à des fins commerciales, le vrai défi commence.

VIII. Laisser des inconnus te trouver

Obtenir une version d’essai est différent de passer une validation officielle.

Fais d’abord ces six auto-vérifications :

1. L’AppID est-il officiel ? Les comptes de test ne peuvent pas être mis en ligne.
2. Clique sur chaque page. Pas d’écran blanc ni de plantage.
3. Configure les domaines des serveurs. Si ton application récupère des données externes, ces domaines doivent être configurés dans le backend (Développement → Paramètres de développement). Seuls HTTPS et WSS sont autorisés, et le domaine doit être enregistré (ICP). Les adresses IP ne sont pas autorisées.
4. Décoche « Ne pas vérifier les domaines de requête... » dans les outils de développement. Cela ne fonctionne que dans l’outil ; les vrais appareils vérifient toujours. Décoche-le et reteste.
5. Remplis le Guide de protection de la vie privée des utilisateurs. Si ton application lit les avatars, la localisation ou les contacts, tu dois le déclarer. Sinon, ces API seront désactivées. Ignore cette étape si tu n’accèdes pas aux informations des utilisateurs.
6. Renseigne le nom, l’avatar, la description et la catégorie dans le backend. Choisir la mauvaise catégorie est une raison fréquente de rejet.

💡 Si tu utilises Cloud Development ou si tu n’utilises pas Internet, ignore les étapes 3 et 4.

🔴 J’ai préparé ceci pour toi ; envoie-le simplement à WorkBuddy :

1Je soumets un mini-programme WeChat pour validation. Aide-moi à vérifier ce projet sur ces points.
2Corrige ce que tu peux, et dis-moi ce que je dois remplir manuellement.
3Vérifie si l'appid dans project.config.json est un compte de test.
4Liste tous les chemins de pages dans app.json pour que je puisse vérifier les écrans blancs.
5Recherche dans le projet les occurrences de wx.request, wx.uploadFile, wx.downloadFile et wx.connectSocket.
6Extrais tous les domaines et regroupe-les dans ces quatre catégories.
7Marque ceux qui ne commencent pas par https/wss ou qui utilisent des adresses IP afin que je puisse les configurer dans le backend.
8Définis urlCheck dans project.config.json sur true s'il est à false.
9Recherche les API d'informations utilisateur (avatar, localisation, contacts, etc.) et liste les fichiers/lignes qui les utilisent.
10Je m'en servirai pour le Guide de protection de la vie privée.
11Vérifie s'il reste du code de débogage console.log.
12Enfin, donne-moi un tableau récapitulatif avec : Élément vérifié, Statut actuel, Prochaine étape.

⚠️ Ne saute pas l’étape 2. Les validations officielles exigent un produit complet. Le rejet pour « fonctionnalité incomplète » est courant.

Ensuite, il y a 4 obstacles avant de soumettre :

1️⃣ Informations sur le mini-programme

• Nom : quelque chose de reconnaissable (par exemple « Habit Tracker »). Les comptes personnels ne peuvent pas utiliser « Officiel » ou « WeChat ».
• Icône : PNG de 1024x1024.
• Description : une phrase qui explique la fonctionnalité.
• Domaine de service : choisis « Outils > Efficacité » ou « Services de la vie quotidienne ».

2️⃣ Catégorie

Les comptes personnels sont limités. Recommandation : Outils > Efficacité ou Bloc-notes. La catégorie détermine les API que tu peux utiliser.

3️⃣ Enregistrement (ICP)

Depuis 2024, tous les mini-programmes doivent avoir un enregistrement ICP. Tu as besoin d’une photo d’identité et d’une vérification faciale. Cela prend 1 à 3 jours ouvrés.

4️⃣ Certification WeChat (facultative mais recommandée)

Les comptes personnels peuvent être certifiés pour 300 RMB/an. Si tu ne veux pas payer, tu peux t’en passer : cela ne t’empêchera pas de publier, mais ton mini-programme ne sera pas trouvable dans les recherches.

Raisons de rejet courantes : absence d’agréments médicaux/financiers, absence d’autorisations de diffusion en direct, ou fonctionnalité incomplète. La validation prend généralement 1 à 7 jours.

Tu vois ? Tu as réussi

Tu as parlé à l’IA, et le code est apparu.

Tu as renseigné un chemin, et la page s’est affichée.

Tu as renvoyé le texte rouge, et il s’est corrigé tout seul.

Tu as scanné un code, et il a tourné sur ton téléphone.

Tu as cliqué sur téléverser, et tes amis ont pu le scanner.

Du début à la fin, aucune connaissance en programmation n’est requise.

Fais juste une chose ce soir : installe les outils de développement WeChat. Ça prend dix minutes.

Une fois installés, tu auras très envie d’y jeter quelque chose et de le lancer. À ce moment-là, tu auras déjà commencé.

Si quelqu’un que tu connais veut créer un mini-programme mais n’a pas encore commencé, envoie-lui cet article. Ça lui fera gagner un week-end.

Je suis Song Song. Je continuerai à partager du contenu utile.