Structurer une bibliothèque publiable
Organiser lib, src et l’API publique
Structurer une bibliothèque publiable est une leçon Dart Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Dart Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Dart Academy comprend 4 leçons au total.
Un paquet n’est qu’un dossier
Un paquet Dart publiable est simplement un dossier contenant un fichier pubspec.yaml à sa racine. Ce seul fichier transforme du code ordinaire en quelque chose que pub.dev peut héberger. 📦
Le dossier lib est l’espace public
Tout ce que vous souhaitez rendre importable par les utilisateurs se trouve sous lib. Les fichiers placés directement dans lib font partie de l’interface publique de votre paquet : placez-les donc avec soin.
Masquer les éléments internes dans lib/src
Le code que vous ne souhaitez pas exposer va dans lib/src. Par convention, ces fichiers sont des détails d’implémentation privés et ne sont pas destinés à être importés directement par les utilisateurs.
lib/
my_package.dart
src/
helper.dartLe fichier point d’entrée
La plupart des paquets fournissent un fichier principal dans lib, nommé d’après le paquet. Ce point d’entrée est celui qu’importent les utilisateurs pour obtenir toute votre bibliothèque en une fois.
import 'package:my_package/my_package.dart';Réexporter avec le mot-clé export
Votre point d’entrée utilise export pour exposer les éléments de lib/src dont les utilisateurs ont réellement besoin. Vous composez ainsi une API publique claire et réfléchie.
export 'src/calculator.dart';
export 'src/parser.dart';Définir soigneusement votre API publique
L’ensemble des noms que vous exportez constitue votre API publique. Gardez-le réduit et stable, car chaque symbole exporté est une promesse faite à vos utilisateurs.
Les traits de soulignement indiquent le privé
En Dart, les noms commençant par un trait de soulignement sont privés à la bibliothèque. Même dans lib/src, préfixez d’un trait de soulignement les fonctions auxiliaires que vous ne voulez jamais exposer.
int _internalCount = 0;Le dossier example
Ajoutez un dossier example contenant un petit programme exécutable. Il montre aux utilisateurs comment fonctionne votre paquet et vous rapporte des points sur pub.dev. ✨
Les tests vont dans test
Les tests automatisés se trouvent dans le dossier test, en dehors de lib. Ils ne sont pas distribués aux utilisateurs, mais prouvent que votre paquet se comporte comme promis.
Les fichiers racine sont importants
La racine d’un bon paquet contient également un README, un CHANGELOG et une LICENSE. Ce sont les trois premiers fichiers que pub.dev présente aux visiteurs.
Une structure claire en un coup d’œil
Une fois l’ensemble réuni, la structure se lit comme une carte : lib pour l’API, src pour les éléments internes, ainsi que example, test et les fichiers de métadonnées.
my_package/
lib/
example/
test/
pubspec.yamlVérification rapide
Où placez-vous le code qui doit rester un détail d’implémentation interne ?
Récapitulatif : une bibliothèque bien organisée
Vous avez appris la structure : lib contient l’API publique, lib/src masque les éléments internes et export détermine ce que voient les utilisateurs. Commencez par la structure, puis publiez. 🚀
Questions Fréquemment Posées
La leçon « Structurer une bibliothèque publiable » est-elle gratuite ?
Oui — le texte complet de « Structurer une bibliothèque publiable » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Dart Academy, passe à CoddyKit PRO. Le cours Dart Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Structurer une bibliothèque publiable » ?
Organiser lib, src et l’API publique Tu pratiques Dart Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Dart Academy ?
Aucune expérience préalable n'est requise. Dart Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Structurer une bibliothèque publiable » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Dart Academy ?
Oui. Chaque leçon Dart Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Structurer une bibliothèque publiable
- Documenter avec les commentaires dartdoc
- Analyse statique, formatage et score pana
- dart pub publish vers pub.dev