Primeros pasos

Configurar el framework es muy sencillo.

1. Clonar el repositorio, o descarlo y extraerlo, dentro del directiorio de archivos de tu servidor local (Apache).

2. Debe construirse el código fuente del framework ingresando en http://localhost/experimental-foxtrot-framework/construir/ (reemplazando localhost/experimental-foxtrot-framework por la URL del servidor). Ante cambios en el código fuente del núcleo del framework, debe repetirse este proceso.

Nota: Esto solo es necesario ya que se está trabajando con el repositorio fuente de Foxtrot. Eventualmente, se realizarán lanzamientos de producción, con el núcleo del framework ya construído, y este paso será necesario solo para aquellos que deseen realizar modificaciones sobre el mismo.

¿localhost ya está en uso? En un entorno de desarrollo, usualmente no tendremos un dominio distinto para cada aplicación. Lo ideal es crear dominios locales modificando el archivo hosts.

Requerimientos

• PHP 7.4+

Para el gestor de aplicaciones:

• Para poder realizar la compilación, Java (JRE) debe estar disponible en PATH (puede omitirse utilizando los modos de depuración al construir)
• Tanto para poder realizar la compilación como para construir Cordova automáticamente desde el gestor, debe estar habilitada la función shell_exec(). Además, se recomiendan valores elevados de max_execution_time y max_input_time (0 no es recomendable).

Notas:

• Utilizando FCGI, los tiempos de ejecución de FCGI (ej. FcgidIOTimeout) pueden ser limitantes.
• Usualmente en instalaciones locales predeterminadas, también suele sobreescribirse el PATH desde la configuración de Apache.
• Las variables de entorno USERPROFILE (Windows), HOME (*nix), CORDOVA_HOME, ANDROID_SDK_ROOT y JAVA_HOME son requeridas.
• Utilizando FCGI, es probable (usualmente en Windows) que las variables de entorno deban establecerse en la configuración de Apache mediante FcgidInitialEnv.
• Luego de intentar la construcción o ejecución de la aplicación, el archivo desarrollo/exec.log puede servir para depurar problemas.

Acceso a la documentación

PHP

https://gquagliano.github.io/experimental-foxtrot-framework/docs/phpdoc/ (en desarrollo)

JS

https://gquagliano.github.io/experimental-foxtrot-framework/docs/jsdoc/ (en desarrollo)

Acceso al gestor de aplicaciones

Para ingresar al gestor de aplicaciones, acceder a http://localhost/experimental-foxtrot-framework/desarrollo/editor/ (reemplazando localhost/experimental-foxtrot-framework por la URL del servidor de desarrollo).

Desde allí se podrá:

• Crear una aplicación en blanco
• Crear y editar vistas
• Crear controladores de servidor
• Crear y sincronizar el modelo de datos
• Ejecutar los asistentes
• Construir la aplicación para embeber (Cordova) o producción

Ver Gestor y editor para más información.

Configurar la aplicación de ejemplo

1- Para configurar la aplicación de ejemplo, primero se debe editar el archivo desarrollo/aplicaciones/ejemplo/config.php asignando los parámetros correctos de la base de datos, o removiéndolos si se desea tomarlos desde el archivo config.php global.

2- Instalar la base de datos de la aplicación de ejemplo mediante el comando Sincronizar modelo del gestor de aplicaciones

Vista de inicio

La vista de inicio será inicio.

Probar la aplicación

Puede ejecutarse la aplicación en el navegador web simplemente ingresando a http://localhost/experimental-foxtrot-framework/desarrollo/ (reemplazando http://localhost/experimental-foxtrot-framework/ por la URL del servidor de desarrollo).

Compilación para producción

Utilizar el comando correspondiente del gestor. Una vez construída la aplicación, puede publicarse el contenido del directorio produccion directamente en el servidor web.

Compilación para Cordova

1- Crear la aplicación mediante la línea de comandos de Cordova.

Ejemplo:

cd /ruta/
cordova create aplicacion
cordova platform add android

2- Utilizar el comando correspondiente del gestor. Una vez construída la aplicación, el contenido del directorio embeber debe copiarse tal cual al directorio www de la aplicación (el gestor de aplicaciones puede hacerlo automáticamente).

Nota: Si se ha construido la aplicación previamente desde la línea de comandos o desde el IDE de Android, la construcción desde Foxtrot puede fallar. En ese caso, ejecutar cordova clean y desinstalar la aplicación en el dispositivo suelen resolver el problema.

Probar una vista para Cordova

Para ejecutar una vista diseñada para Cordova en el navegador web, se debe acceder a http://localhost/experimental-foxtrot-framework/desarrollo/simular-cordova.php?vista=nombre_vista, (reemplazando localhost/experimental-foxtrot-framework por la URL del servidor de desarrollo) donde nombre_vista es el nombre de la vista que se desea ejecutar, sin extensión.