Puesta en marcha de la aplicación

Cómo hacer fork y configurar un repositorio de aplicación de escritorio basado en Pankosmia

Tabla de contenidos

Hacer fork de desktop-app-template

Desktop-app-template es un repositorio diseñado para ser bifurcado (fork) para crear y mantener nuevos repositorios de aplicaciones de escritorio basados en Pankosmia.

  1. Comience en https://github.com/pankosmia/desktop-app-template/fork

  2. Elija un nombre de repositorio de 30 caracteres o menos si desea evitar que los desarrolladores Windows necesiten clonar con un nombre de repositorio local más corto. El compilador C de cargo build en Windows requiere nombres de repositorio de 30 caracteres o menos.

  3. Crear el fork

Configuración

Estructura de directorios recomendada: 

    |-- repos
    |-- pankosmia
        |-- [your-desktop-app-repo-name] (¡30 caracteres o menos en Windows!)

package.json

Reemplace todas las instancias de “desktop-app-template” en package.json por “[your-desktop-app-repo-name]”

En la raíz de su clon de este repositorio, ejecute: 

    npm install

Editar app_config.env

Ingrese el nombre de la aplicación, el número de versión, el nombre corto de la aplicación para el directorio de trabajo, los assets y los clientes.

Assets requeridos:

  • ASSET1=resource-core
  • ASSET1_PATH=/runtime_resources
  • ASSET1_NAME=app_resources
  • ASSET2=resource-core
  • ASSET2_PATH=/templates
  • ASSET2_NAME=templates
  • ASSET3=webfonts-core
  • ASSET3_PATH=/
  • ASSET3_NAME=webfonts

Clientes requeridos:

  • CLIENT1=core-client-dashboard
  • CLIENT2=core-client-content
  • CLIENT[cualquier número]=core-client-settings

Marca

Modifique /globalBuildResources/theme.json directamente para personalizar su aplicación. Para consejos útiles, consulte la sección Tema de las directrices UX/UI.

Para implementar su logo, consulte el README de Branding para los scripts de personalización de /globalBuildResources/.ico, /globalBuildResources/.png y /globalBuildResources/icon.icns, junto con información sobre cómo se usa cada uno.

Scripts de configuración

cd [os]/scripts

Ejecute[1] el script clone para clonar todos los repositorios listados en app_config.env (assets y clientes)

Ejecute[1] el script app_setup para generar los archivos de configuración que correspondan a app_config.env. Vuelva a ejecutar[1] el script app_setup cada vez que se modifique app_config.env.

Ejecute[1] el script build_clients para compilar todos los clientes. Tenga paciencia. Esto tomará un tiempo.

  • Este script está destinado a configurar todos los clientes para el primer uso, o para reconstruir todos los clientes a su rama main más reciente. Cambia a la rama main, obtiene la última versión y compila (o recompila) cada cliente cada vez que se ejecuta.
  • ¡Compile el cliente manualmente cuando desee usar una rama específica, cuando solo necesite recompilar un cliente, o cuando no desee que todos los clientes se compilen desde su última rama main!

Ejecute[1] el script build_server para compilar el servidor Pankosmia y ensamblar el entorno de build. (tenga paciencia, esto también tomará un tiempo.)

(Opcional) Ejecute[1] el script build_viewer para crear un visor Electronite para usar con el entorno de build de desarrollo local.

Ejecutar su configuración

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

  • Solo puede ejecutarse una instancia del mismo servidor a la vez.

Ejecute el script viewer para usar el visor Electronite con el entorno de build de desarrollo local, o abra un navegador en la ubicación indicada.

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