Le Gestionnaire de bibliothèque liste tous les paquets installés dans votre Asterobot. Vous y installez, créez, importez, copiez, exportez et supprimez des paquets, et chaque paquet a sa propre page avec ses détails.
La page du Gestionnaire de bibliothèque
Les boutons du haut sont Vérifier les mises à jour à gauche, et Importer un .zip, Télécharger un paquet et Nouveau paquet à droite.
En dessous, une zone Filtrer... réduit le tableau aux lignes qui contiennent ce que vous tapez. Cliquez sur l'en-tête Nom, Version ou Provenance pour trier selon cette colonne. Le tableau affiche 10 lignes par page, et indique « Aucun script installé pour le moment. » tant que la bibliothèque est vide.
| Colonne | Ce qu'elle affiche |
|---|---|
| Nom | Le nom du paquet. Cliquez dessus pour ouvrir la page du paquet. |
| Version | La version installée. Chaque version d'un paquet a sa propre ligne. |
| Provenance | Local, Communautaire ou Officiel. Voir Qu'est-ce qu'un paquet. |
| Compatibilité | Compatible ou Incompatible, uniquement pour un paquet qui indique avec quelles versions d'Asterobot il fonctionne. |
| Dépendances | Le nombre de paquets dont celui-ci dépend. Survolez le nombre pour voir leurs noms. Vide quand il n'y en a pas. |
| Mise à jour | Un bouton Mettre à jour vers, une fois qu'une vérification des mises à jour a trouvé une version plus récente. Voir Mettre à jour les paquets. |
| Dernière colonne | Le menu de la ligne. Un clic droit n'importe où sur une ligne ouvre le même menu. |
Actions de la ligne
| Action | Proposée pour | Ce qu'elle fait |
|---|---|---|
| Modifier le code | Paquets locaux | Ouvre le paquet dans l'éditeur. Voir L'éditeur. |
| Copier vers une nouvelle version | Paquets locaux | Ouvre la boîte de dialogue Copier ce paquet. Voir Copier un paquet. |
| Exporter | Tous les paquets | Télécharge le paquet sous forme de fichier .zip. Voir Exporter. |
| Supprimer | Tous les paquets | Ouvre la boîte de dialogue Supprimer ce script ?. Voir Supprimer un paquet. |
Seuls les paquets marqués Local peuvent être modifiés ou copiés. Un paquet avec un badge Communautaire ou Officiel reste tel qu'il a été installé.
La page d'un paquet
Cliquez sur le nom d'un paquet dans le tableau pour ouvrir sa page.
Le haut de la page affiche le nom, la version, le badge de provenance et, quand le paquet l'indique, le badge de compatibilité. À droite : Mettre à jour vers une fois qu'une vérification a trouvé une version plus récente, Modifier le code pour un paquet local, et le même menu que dans le tableau.
La fiche de détails a une ligne pour chaque information qui s'applique :
| Ligne | Affichée pour | Ce qu'elle indique |
|---|---|---|
| Éditeur | Paquets du marché | La partie éditeur du nom du paquet. |
| Compatible avec | Paquets qui l'indiquent | Les versions d'Asterobot avec lesquelles le paquet fonctionne, comme >=1.5.0 <2.0.0. |
| Source | Paquets installés depuis le marché | Voir sur asterobot.net ouvre le fichier d'où vient le paquet. |
| Mises à jour | Paquets installés depuis le marché | La vérification des mises à jour pour ce paquet. Voir Mettre à jour les paquets. |
La fiche Manifeste liste ce que le paquet déclare sur lui-même : ses Dépendances, avec la version de chacune, ses Permissions, et Compatible avec. Pour un paquet local, la fiche est un formulaire où vous ajoutez et retirez des dépendances et des permissions, puis cliquez sur Enregistrer le manifeste, ou sur Réinitialiser pour annuler vos modifications. Pour tout autre paquet, elle est en lecture seule et indique « Publié par quelqu'un d'autre : ce manifeste est donc en lecture seule ». La modification d'un manifeste est expliquée aux auteurs dans Le manifeste.
Autres versions installées apparaît quand votre bibliothèque contient d'autres versions du même paquet, avec un bouton pour ouvrir chacune d'elles.
Bots exécutant cette version liste les bots réglés sur cette version précise, que leur script tourne ou non. Cliquez sur un bot pour ouvrir sa page. S'il n'y en a aucun, la section indique « Aucun bot n'est configuré pour exécuter cette version. »
Si le paquet n'existe plus, par exemple parce qu'il a été supprimé dans un autre onglet, la page indique « Ce paquet n'est pas installé (ou a été supprimé). »
Créer un paquet
Nouveau paquet ouvre la boîte de dialogue Nouveau paquet local : saisissez un Nom, gardez ou changez la Version (1.0.0 par défaut) et cliquez sur Créer et modifier. Asteroboard crée un paquet avec du code de départ et l'ouvre dans l'éditeur. Créer un paquet détaille la marche à suivre pour les auteurs de scripts.
Quand ce nom et cette version sont déjà installés, un avertissement indique qu'ils existent déjà et seraient remplacés, mais Créer et modifier reste grisé : contrairement à l'import ou à la copie, la création d'un paquet ne remplace jamais un paquet déjà présent. Changez le nom ou la version pour continuer.
Importer un .zip
Un fichier .zip est la façon dont les paquets circulent en dehors du marché : c'est ce que produit Exporter, et ce que vous obtenez en téléchargeant vous-même le fichier d'un paquet sur asterobot.net.
- Cliquez sur Importer un .zip. La boîte de dialogue Importer un paquet depuis un .zip s'ouvre.
- Déposez le fichier sur « Déposez un .zip ici, ou cliquez pour en choisir un », ou cliquez sur cette zone pour le choisir.
- Saisissez un Nom. Un nom simple, comme
my-harvester, crée un paquet local que vous pouvez modifier. Un nom de la forme@publisher:nameest aussi accepté, et crée un paquet Communautaire, ou Officiel avec@asterobot:, qui ne peut pas être modifié. - Vérifiez la Version. Quand le nom du fichier se termine par une version, comme dans
my-harvester-1.2.0.zip, Asteroboard remplit le champ pour vous, sauf si vous y avez déjà saisi quelque chose. - Cliquez sur Importer.
Paquet importé s'affiche avec le nom et la version du paquet.
Le nom et la version viennent toujours de la boîte de dialogue, jamais du fichier. L'archive contient les fichiers .js ou .mjs du paquet et son asterobot.json s'il en a un, avec index.js à sa racine, comme Exporter la construit. Elle ne peut pas dépasser 32 Mio.
Important
Compressez les fichiers du paquet, pas le dossier qui les contient. Asterobot n'accepte l'archive d'un dossier unique que si elle ne liste rien d'autre que le contenu de ce dossier, or beaucoup d'outils d'archivage ajoutent aussi une entrée pour le dossier lui-même : l'import échoue alors. Fichiers zip et ligne de commande donne les règles exactes.
L'import n'installe pas les paquets dont celui-ci dépend. Installez-les d'abord, sinon le paquet ne démarrera pas.
Un paquet importé n'a aucun lien avec le marché, même quand ses fichiers en viennent : pas de ligne Source, pas de mises à jour, et aucune vérification que ses fichiers restent intacts (voir Faire confiance à un paquet). Pour bénéficier de tout cela, installez plutôt depuis le marché.
| Message | Que faire |
|---|---|
Ceci remplace le paquet installé <name> <version>. |
Un paquet avec ce nom et cette version est déjà installé. L'import remplace ses fichiers. Changez le nom ou la version pour garder les deux. |
Un nom de paquet local ne peut pas contenir « : » ni « @ ». |
Un nom simple ne peut pas contenir ces caractères. |
Un nom du marché s'écrit @editeur:nom. |
Un nom qui commence par @ a besoin d'un éditeur, d'un : et d'un nom. |
Un nom du marché contient exactement un « : » et un « @ » en tête. |
Retirez le : ou le @ en trop. |
| Impossible d'importer le paquet | L'import a échoué. La notification ne donne pas de raison : le fichier n'est peut-être pas un .zip, n'a pas de index.js à sa racine (souvent parce qu'un dossier a été compressé au lieu de ses fichiers), dépasse 32 Mio, ou contient un asterobot.json invalide. |
Exporter
Choisissez Exporter dans le menu d'un paquet. Votre navigateur télécharge le paquet sous forme de fichier .zip nommé d'après le paquet et sa version, sans le @ et avec - à la place du : : la version 1.0.0 de @alice:mining devient alice-mining-1.0.0.zip.
Le fichier contient le code du paquet, et son asterobot.json quand il en a un. Servez-vous-en comme sauvegarde, pour déplacer le paquet vers un autre Asterobot avec Importer un .zip, pour lire le code d'un paquet, ou pour publier votre propre paquet : voir Partagez-le.
Copier un paquet
Copier un paquet local permet de le faire évoluer vers une nouvelle version, ou de démarrer une variante sous un autre nom.
- Dans le menu du paquet, choisissez Copier vers une nouvelle version. La boîte de dialogue Copier ce paquet s'ouvre, avec le même Nom et une Version dont le dernier nombre est augmenté de un :
1.0.0devient1.0.1. - Changez le nom ou la version si vous le souhaitez.
- Cliquez sur Copier.
Une notification indique Copié vers suivi du nouveau nom et de la nouvelle version, et l'éditeur s'ouvre sur la copie. Le code, les dépendances, les permissions et les versions compatibles sont repris. Le paquet d'origine n'est pas touché, et les bots continuent de le lancer jusqu'à ce que vous les passiez sur un autre paquet.
| Message | Que faire |
|---|---|
C'est le paquet que vous copiez. Changez le nom ou la version. |
Copier reste grisé tant que le nom ou la version ne diffère pas. |
Ceci remplace le paquet installé <name> <version>. |
Ce nom et cette version existent déjà, et la copie les remplace. Changez la version pour garder les deux. |
Un nouveau paquet est local : son nom ne peut pas commencer par « @ », réservé au marché. |
Une copie est toujours locale. Retirez le @. |
| Impossible de copier le paquet, avec une raison | La copie a échoué. La raison est affichée dans la boîte de dialogue. |
Supprimer un paquet
- Dans le menu du paquet, choisissez Supprimer. La boîte de dialogue Supprimer ce script ? s'ouvre. Elle nomme la version qu'elle retire de la bibliothèque locale, et rappelle qu'un bot qui l'exécute continue jusqu'à ce que son script soit arrêté.
- Lisez les avertissements, s'il y en a. L'un indique combien de paquets installés dépendent de celui-ci et les liste avec leurs versions. L'autre indique combien de bots sont réglés sur ce paquet et liste leurs noms.
- Cliquez sur Oui, supprimer.
Aucun des deux avertissements ne bloque la suppression. Une fois le paquet supprimé, un script en cours continue de tourner, mais son prochain démarrage échoue avec Impossible de démarrer le comportement, tout comme le prochain démarrage de tout paquet qui en dépendait. Les bots restent réglés sur la version supprimée, avec leurs réglages du paquet, jusqu'à ce que vous leur donniez un autre paquet.
Si la suppression échoue, Impossible de supprimer le script s'affiche.
En ligne de commande
Asterobot a trois commandes pour la bibliothèque : library install installe un paquet depuis un dossier, library list liste toutes les versions installées avec leur provenance et leur éditeur, et library remove supprime une version. Voir Ligne de commande, et Fichiers zip et ligne de commande pour les auteurs.
Pour aller plus loin
- Faire confiance à un paquet
- Fichiers et dossiers, pour savoir où la bibliothèque est stockée