Vue d'ensemble
Chaque fichier PicoPixel possède sa propre bibliothèque. Le panneau Assets regroupe ses couleurs, polices, images, images animées et composants. Ces ressources appartiennent d’abord à ce fichier. En le publiant, vous permettez aux membres de votre équipe de lier sa bibliothèque à leurs propres fichiers et d’y réutiliser les ressources.
Ce guide présente le contenu des bibliothèques, leur publication, leur liaison à d’autres fichiers et les endroits où les retrouver. Voici le point essentiel :
Publier ne rend pas votre travail public. La bibliothèque devient accessible uniquement aux membres de votre équipe dans PicoPixel. Elle n’apparaît dans aucun catalogue public et personne en dehors de l’équipe ne peut la consulter. Pour partager du contenu à l’extérieur, vous devez effectuer l’une des actions décrites à la fin de ce guide.
Ce qu'est une bibliothèque
Une bibliothèque regroupe les ressources réutilisables d’un fichier. Dans Assets, la section local library, ouverte par défaut, contient les ressources du fichier en cours.
Lorsque vous liez une bibliothèque d’équipe, une section distincte apparaît sous la bibliothèque locale. Elle porte le nom du fichier source, par exemple Animation Examples. Vous avez ainsi accès aux ressources de votre fichier et de la bibliothèque liée, prêtes à être déposées dans votre interface.
Imaginez deux étagères dans le même placard : la bibliothèque locale est ce que ce fichier a créé, et chaque bibliothèque liée est une étagère empruntée à un autre fichier de votre équipe. Vous pouvez puiser dans l'une ou l'autre sans quitter votre design.
Ce que peut contenir une bibliothèque
La publication partage toutes les ressources du panneau Assets. Elles sont regroupées dans les catégories suivantes :
- Images, graphiques statiques que vous avez ajoutés au fichier.
- Animated images, graphiques animés à plusieurs images.
- Components, widgets LVGL réutilisables (voir ci-dessous).
- Colors, nuanciers de couleurs sauvegardés.
- Fonts, polices que vous avez ajoutées et converties pour une utilisation sur l'appareil.
Publiez le fichier et chacune de ces ressources devient réutilisable par votre équipe, sans copier-coller entre fichiers.
Ce qu'est un « composant »
Un composant est un ensemble réutilisable d’un ou plusieurs widgets. Un bouton ou un libellé constitue un widget ; un composant peut réunir plusieurs widgets et calques, par exemple une carte avec un titre, une icône et une valeur. Vous pouvez ensuite déposer cet ensemble sur n’importe quel écran.
Chaque composant possède une instance principale. Ses modifications peuvent être répercutées sur les copies du composant, y compris dans les fichiers liés à la bibliothèque. Vous conservez ainsi une interface cohérente en modifiant le composant à un seul endroit. Les fichiers liés appliquent ces changements via les mises à jour de bibliothèque décrites plus bas.
Si vous recréez souvent le même groupe de widgets, faites-en un composant : un en-tête, une carte de mesure ou un interrupteur avec son libellé. Vous pourrez le réutiliser et le mettre à jour plus facilement.
Publier un fichier comme bibliothèque
Publier un fichier désigne sa bibliothèque comme une bibliothèque partagée au sein de l’équipe.
- Ouvrez la boîte de dialogue Libraries. Depuis le panneau Assets, utilisez le bouton Add library (il affiche Manage library une fois que le fichier a déjà des bibliothèques liées ou des composants).
- Dans l'onglet LIBRARIES, regardez sous LIBRARIES IN THIS FILE. Vous verrez File library — c'est la bibliothèque du fichier actuel — avec un bouton Publish à côté.
- Cliquez sur Publish.
Le bouton passe à Unpublish, confirmant que le fichier est maintenant une bibliothèque partagée que votre équipe peut lier. PicoPixel ajoute également un petit badge de bibliothèque au fichier : vous le verrez dans le coin supérieur droit de l'en-tête de l'espace de travail, et sur la carte du fichier dans le Dashboard, pour repérer facilement quels fichiers sont publiés.
Pour retirer la publication, cliquez sur Unpublish et confirmez. Avant de dissocier la bibliothèque, PicoPixel copie ses ressources dans les fichiers qui les utilisent. Ces fichiers conservent ainsi tout ce dont ils ont besoin.
Trouver les bibliothèques de votre équipe
Les bibliothèques publiées sont rassemblées en un seul endroit pour toute l'équipe.
- Ouvrez le Dashboard.
- Dans la barre latérale gauche, sous Sources, cliquez sur Libraries.
La page affiche les bibliothèques publiées dans l’équipe active. Si vous changez d’équipe, vous accédez à son propre catalogue. Vos collègues peuvent y repérer les ressources à réutiliser.
Réutiliser une bibliothèque dans un autre fichier
Une fois une bibliothèque publiée, n'importe quel fichier de l'équipe peut l'intégrer.
- Ouvrez le fichier dans lequel vous souhaitez travailler.
- Dans le panneau Assets, cliquez sur Add library (ou Manage library) pour ouvrir la boîte de dialogue Libraries.
- Dans la section SHARED LIBRARIES, trouvez la bibliothèque souhaitée — le champ Search shared libraries aide quand la liste est longue — et cliquez sur le + à côté pour la lier.
La bibliothèque liée apparaît dans une section à son nom, sous la bibliothèque locale du panneau Assets. Faites glisser ses composants, images, couleurs et polices dans votre interface.
Maintenir une bibliothèque liée à jour
Lorsqu'une bibliothèque que vous avez liée change — son propriétaire modifie un composant ou ajuste une couleur — ces mises à jour ne s'imposent pas à vous. L'onglet UPDATES du dialogue Libraries liste les bibliothèques liées ayant des changements plus récents, et un bouton Update les applique à votre fichier quand vous êtes prêt. Si rien n'a changé, l'onglet vous indique simplement qu'il n'y a rien à mettre à jour.
Confidentialité : rien n'est jamais rendu public
Le terme Publier peut prêter à confusion. Dans PicoPixel, la publication d’une bibliothèque reste interne à l’équipe.
Une bibliothèque publiée est partagée avec votre équipe, et personne d’autre. L’accès nécessite une authentification et reste limité à ses membres. Il n’existe ni lien public ni catalogue public permettant de consulter cette bibliothèque.
Pour partager votre contenu en dehors de l’équipe, vous devez choisir l’une de ces deux actions :
- Vous exportez et envoyez vous-même un fichier
.picopixel. Depuis le menu de l'espace de travail, vous pouvez faire Export.picopixel, ce qui télécharge un fichier sur votre ordinateur. Ce que vous faites avec ce fichier — l'envoyer par e-mail, le partager, le remettre à quelqu'un — vous appartient entièrement et se passe en dehors de PicoPixel. - Vous faites une soumission officielle à l'équipe PicoPixel. Si vous souhaitez partager votre design avec la communauté PicoPixel au sens large, proposez-le à l’équipe à
app.picopixel.io/#/settings/submit-template. L'équipe examine chaque soumission avant que quoi que ce soit soit publié dans la galerie communautaire. Consultez Comment soumettre un modèle pour connaître les informations demandées dans le formulaire et les droits que vous accordez.
En dehors de ces deux étapes délibérées, vos fichiers et bibliothèques restent au sein de votre équipe.
Modèles communautaires et bibliothèques toutes faites
Vous n'avez pas à partir de zéro. La galerie de modèles PicoPixel dispose d'une collection grandissante de modèles, kits d'interface, exemples, sprites, images animées et fichiers d'applications complètes créés par l'équipe PicoPixel et la communauté au sens large. Chacun est un fichier .picopixel ordinaire que vous pouvez ouvrir, personnaliser et utiliser comme point de départ pour votre propre projet.
Vous pouvez aussi publier un modèle comme bibliothèque pour donner à votre équipe accès à ses composants, polices, couleurs et images. C’est un moyen rapide de démarrer un projet ou d’enrichir une interface existante.
Pour une présentation complète de la recherche, de l'importation et de la personnalisation des modèles, consultez Comment utiliser les modèles, kits d'interface et applications complètes PicoPixel.
Prochaines étapes
- Comment soumettre un modèle, partagez un design avec la communauté PicoPixel au sens large
- Qu'est-ce qu'un sprite ?, créez des widgets animés multi-états qui méritent d'être transformés en composants
- Travailler avec les polices, ajoutez et convertissez les polices que votre bibliothèque contient
- Travailler avec le widget d'image animée LVGL, créez les images animées que vous pouvez réutiliser entre les fichiers
