Scripts

Scripts de desarrollo para repositorios de aplicaciones basados en Pankosmia

Tabla de contenidos

Uso

Ejecute[1] el script run para iniciar el servidor sin abrir un navegador.

  • Considere también si necesita eliminar ~/pankosmia/[Nombre corto de la aplicación]/ primero.
  • Deberá reiniciar el servidor si elimina ~/pankosmia_working después de haberlo iniciado. Para reiniciar, cierre la ventana del terminal donde se ejecuta el servidor y vuelva a ejecutar el script run[1].
  • Solo puede ejecutarse una instancia del mismo servidor a la vez.

Desarrollo de clientes:

Compile manualmente el/los cliente(s) modificado(s), detenga el servidor si está en ejecución, luego inicie el servidor (run). El script run reensamblará el entorno para incluir su build.

Vea también Ejecutar su configuración.

Para generar un paquete de release para el sistema operativo que está usando, edite el número de versión del release en app_config.env y luego consulte la siguiente sección a continuación, o Build de instalador local o los scripts de bundle en Referencia de scripts de desarrollo

Para generar artefactos:

Ejecute manualmente el workflow deseado (Actions > [seleccionar workflow] > Run workflow).

  • Se utilizará la rama main actual del repositorio del cliente y de los recursos en el momento de ejecutar el workflow.

Descargue los artefactos resultantes (Actions > haga clic en el nombre de una ejecución para ver el resumen del workflow > desplácese hacia abajo hasta la sección Artifacts > para descargar, haga clic en el nombre de cada artefacto o en la flecha hacia abajo de cada fila

Cualquier artefacto doblemente comprimido debe descomprimirse una capa antes de la publicación, por ejemplo:

  • Reducir *.tgz.zip a *.tgz

  • Reducir *.zip.zip a *.zip

  • Si trabaja desde Windows, evite publicar re-comprimiendo un paquete zip de macOS o Linux si un .pkg, .sh, .bsh, .zsh estaba en la capa re-comprimida en Windows. Hacerlo eliminaría los permisos de archivo chmod +x donde son necesarios.

  • Publique la capa *.pkg.zip como .zip ya que incluye un archivo README en la misma capa que el pkg, que contiene instrucciones e información de instalación y actualización.

Suba los releases manualmente yendo a la sección Release de su repositorio y seleccionando “Draft a new release”.

Mantenimiento

Para actualizar el servidor, cambie la última versión de panksomia-web en /local_server/Cargo.toml y vuelva a ejecutar el script build_server.

Para sincronizar este repositorio con su upstream, ejecute el script sync.

Notas al pie

[1] … Desarrolladores Windows, ejecuten los scripts .bat desde un Powershell o símbolo del sistema:
…repos\pankosmia[your-desktop-app-repo-name]\windows\scripts> .[scriptname].bat
El .\ es opcional desde un símbolo del sistema.
Use un terminal powershell para los scripts de build .ps1.
Desarrolladores MacOS, ejecuten los scripts .bsh desde un terminal MacOS:
…repos/pankosmia/[your-desktop-app-repo-name]/macos/scripts> ./[scriptname].bsh
Desarrolladores Linux, ejecuten los scripts .zsh desde un terminal linux:
…repos/pankosmia/[your-desktop-app-repo-name]/linux/scripts> ./[scriptname].zsh