Scripts

Scripts de développement pour des dépôts d’applications basés sur Pankosmia

Table des matières

Utilisation

Exécutez[1] le script run pour démarrer le serveur sans lancer de navigateur.

  • Vérifiez également si vous devez d’abord supprimer ~/pankosmia/[Nom court de l'application]/.
  • Vous devrez redémarrer le serveur si vous supprimez ~/pankosmia_working après avoir démarré le serveur. Pour redémarrer, fermez la fenêtre du terminal où le serveur s’exécute, puis relancez le script run[1].
  • Une seule instance du même serveur peut s’exécuter à la fois.

Développement de clients :

Compilez manuellement le(s) client(s) modifié(s), arrêtez le serveur s’il est en cours d’exécution, puis démarrez le serveur (run). Le script run réassemblera l’environnement pour inclure votre build.

Voir aussi Exécuter votre configuration.

Pour générer un package de release pour le système d’exploitation que vous utilisez, modifiez le numéro de version de la release dans app_config.env puis consultez la section suivante ci-dessous, ou Build d’installateur local ou les scripts de bundle dans Référence des scripts de développement

Pour générer des artefacts :

Exécutez manuellement le workflow souhaité (Actions > [sélectionner le workflow] > Run workflow).

  • La branche main actuelle du dépôt client et des ressources au moment de l’exécution du workflow sera utilisée.

Téléchargez les artefacts résultants (Actions > cliquez sur le nom d’une exécution pour voir le résumé du workflow > faites défiler vers le bas jusqu’à la section Artifacts > pour télécharger, cliquez sur le nom de chaque artefact ou sur la flèche vers le bas de chaque ligne

Tout artefact doublement compressé doit être décompressé d’une couche avant la publication, par exemple :

  • Réduire *.tgz.zip à *.tgz

  • Réduire *.zip.zip à *.zip

  • Si vous travaillez sous Windows, évitez de publier en re-zippant un package zip macOS ou Linux si un .pkg, .sh, .bsh, .zsh se trouvait dans la couche re-zippée sous Windows. Cela supprimerait les permissions de fichier chmod +x là où elles sont nécessaires.

  • Publiez la couche *.pkg.zip en tant que .zip car elle inclut un fichier README dans la même couche que le pkg, contenant les instructions et informations d’installation et de mise à jour.

Téléversez les releases manuellement en allant dans la section Release de votre dépôt et en sélectionnant « Draft a new release ».

Maintenance

Pour mettre à jour le serveur, changez la dernière version de panksomia-web dans /local_server/Cargo.toml et relancez le script build_server.

Pour synchroniser ce dépôt avec son upstream, exécutez le script sync.

Notes de bas de page

[1] … Développeurs Windows, exécutez les scripts .bat depuis un Powershell ou une invite de commandes :
…repos\pankosmia[your-desktop-app-repo-name]\windows\scripts> .[scriptname].bat
Le .\ est facultatif depuis une invite de commandes.
Utilisez un terminal powershell pour les scripts de build .ps1.
Développeurs MacOS, exécutez les scripts .bsh depuis un terminal MacOS :
…repos/pankosmia/[your-desktop-app-repo-name]/macos/scripts> ./[scriptname].bsh
Développeurs Linux, exécutez les scripts .zsh depuis un terminal linux :
…repos/pankosmia/[your-desktop-app-repo-name]/linux/scripts> ./[scriptname].zsh