Aller au contenu principal

Partager votre app

MnemoHub est une sortie. L'autre, c'est un lien.

N'importe qui sous Mnemosyne OS peut installer votre cartouche depuis l'URL d'un dépôt public. Sans fiche, sans revue, sans attendre. Vous envoyez le lien, la personne le colle, l'app lit votre manifeste et installe.

Ce que fait votre utilisateur​

MnemoHub → Apps → « Ajouter une cartouche externe » → « Un dépôt », coller l'URL, puis « Installer ».

Avant d'écrire quoi que ce soit sur le disque, l'app télécharge le dépôt, lit mnemo-plugin.json et affiche le nom et la version de la cartouche pour confirmation.

Git n'est pas requis sur sa machine. L'installation est une archive HTTPS.

Le slot gratuit​

  • Sans licence : une cartouche externe, gratuite.
  • Avec une licence Engramm active : illimité.

Deux choses à savoir :

  • Les apps du store ne comptent jamais. La limite porte sur le sideload, donc tout ce qui vient du catalogue signé laisse le slot gratuit intact.
  • Les deux portes partagent le slot. Un dossier du disque et une URL de dépôt dépensent la même place.

Ce que votre dépôt doit contenir​

Les mêmes quatre règles qu'une soumission au store :

  1. mnemo-plugin.json à la racine du dépôt.
  2. entrypoints.renderer à "index.html", en relatif. Un point d'entrée http://localhost:5185/… pointe vers un serveur de dev que votre utilisateur ne fait pas tourner.
  3. dist/ committé. Le protocole mnemo-plugin:// sert dist/<fichier> en premier, et aucun build ne tourne sur la machine de votre utilisateur.
  4. base: './' dans vite.config.ts. Un chemin absolu /assets/… fait un 404 sous le protocole personnalisé.

github.com, gitlab.com ou bitbucket.org, en HTTPS. Tout le reste est refusé avant le premier octet téléchargé.

Livrer une mise à jour​

Une installation récupère la branche par défaut telle qu'elle est. Vous poussez, la personne suivante l'a.

Incrémentez la version dans mnemo-plugin.json à chaque changement. C'est le numéro que votre utilisateur voit à la confirmation.

Rendre le oui facile​

Une cartouche s'exécute dans Mnemosyne OS, et l'app le dit à l'étape de confirmation. La sandbox la borne : pas de Node, pas d'Electron, pas de système de fichiers, chaque capacité derrière une permission accordée.

  • Demandez le minimum de permissions. Une cartouche qui ne déclare jamais vault:write est visiblement inoffensive.
  • Gardez le code lisible dans le dépôt même depuis lequel on installe.
  • Écrivez un README qui nomme ce que la cartouche stocke, et où.

Quand passer par le store​

MnemoHub sert à être trouvé plutôt qu'envoyé : une fiche, une catégorie, une icône, et une installation qui ne coûte rien du slot gratuit de vos utilisateurs. Signée, relue par un humain, gardée par une licence Engramm active.

Les deux voies portent le même dépôt. Le bouton de publication est dans Votre première cartouche.