Comenzando
craftforJ se envía con webforJ, por lo que no hay nada que descargar por separado. Esta página cubre lo que tu aplicación necesita antes de que aparezca craftforJ y cómo abrirlo.
Los proyectos creados con startforJ o a partir de un arquetipo de webforJ vienen con craftforJ habilitado. Si comenzaste desde uno de ellos, ejecuta tu aplicación y salta a Abrir craftforJ.
Requisitos
craftforJ se adjunta a una aplicación solo cuando todas las siguientes condiciones son verdaderas. Si alguna de ellas no se cumple, no aparecerá nada en la página.
Agregar la dependencia
Agrega webforj-devtools a tu proyecto si aún no está allí:
<dependency>
<groupId>com.webforj</groupId>
<artifactId>webforj-devtools</artifactId>
<version>${webforj.version}</version>
</dependency>
Modo de depuración y la bandera de craftforJ
Agrega las siguientes propiedades a tu proyecto. Si tienes una aplicación estándar de webforJ, establece las propiedades en webforj.conf. Para un proyecto de webforJ que utiliza Spring, establece las propiedades en application.properties.
webforj.debug = true
webforj.devtools.craftforj.enabled = true
craftforJ solo funciona cuando ambas propiedades están habilitadas; por lo tanto, una aplicación que va a producción con el modo de depuración activado no expone tu árbol de fuentes.
Un navegador local y una licencia de desarrollador
Abre la aplicación desde la máquina que la ejecuta y asegúrate de tener una licencia de desarrollador válida. Para acceder a craftforJ desde otra máquina, agrega su dirección a hosts-allowed.
Una vez que estos elementos estén en su lugar, reinicia la aplicación y vuelve a cargar la página.
Abrir craftforJ
Cuando craftforJ está activo, un botón de activación aparece sobre tu aplicación. Haz clic en él para abrir craftforJ, o presiona Alt + Shift + D desde cualquier lugar de la aplicación. El mismo atajo cierra nuevamente craftforJ, y puedes arrastrar el activador a cualquier esquina que te convenga.
Sus pestañas cubren el árbol de componentes, rutas, el tema y el asistente. La configuración y la información de la aplicación se encuentran junto a ellos.
- El activador es el botón que abre y cierra craftforJ. Se mantiene fuera del camino mientras craftforJ está cerrado.
- La tira de pestañas corre a lo largo del borde más cercano a la aplicación y cambia entre lo que craftforJ te muestra.
- El menú de la ventana contiene todo lo relacionado con la ubicación de craftforJ, cubierto en Dónde se ubica craftforJ.
craftforJ escribe cada atajo utilizando los modificadores de la plataforma en la que te encuentras, así que Alt aparece como ⌥ y Ctrl como ⌘. Presiona Shift + ? en craftforJ para ver la lista actual.
Dónde se ubica craftforJ
craftforJ flota sobre tu aplicación por defecto. Arrástralo a cualquier lugar de la página, redimensiónalo desde cualquier borde y minimízalo de nuevo a su activador cuando desees la aplicación solo para ti. Arrastrarlo a un borde de la página lo ancla allí, a toda altura o ancho, y cada borde mantiene el tamaño que le diste. Arrastrarlo lejos del borde lo vuelve a flotar.
craftforJ se dibuja sobre la página. Tu aplicación no se redimensiona y nada en ella se mueve fuera del camino, por lo que cualquier cosa debajo de craftforJ queda oculta mientras está allí. Para ver lo que hay debajo, mueve craftforJ a otro borde o sácalo de la página.
Para dejar de cubrir la aplicación por completo, mueve craftforJ fuera de la página y dentro de una ventana o pestaña de navegador propia, lo cual es adecuado para un segundo monitor. Aún inspecciona tu aplicación a través de la página que lo abrió, así que deja esa página abierta. Navega lejos de ella o ciérrala y craftforJ no tendrá nada más que inspeccionar hasta que abras la aplicación nuevamente.
Elige una pestaña en lugar de una ventana si usas la vista dividida de Chrome, que coloca tu aplicación y craftforJ uno al lado del otro y acepta solo pestañas reales. Haz clic derecho en la pestaña de tu aplicación, agréguela a una nueva vista dividida, luego elige la pestaña de craftforJ.
Chrome proporciona el arreglo lado a lado, no craftforJ. Otros navegadores no tienen equivalente, así que craftforJ en otros navegadores se abre en una pestaña ordinaria a la que cambias. craftforJ en sí funciona igual de cualquier manera.
Mover craftforJ a otra ventana termina una respuesta que aún se está transmitiendo. craftforJ pregunta primero, y todo lo escrito hasta ese momento permanece en el chat.
Haciendo un primer cambio
- Presiona Alt + Shift + C para comenzar a seleccionar un componente.
- Pasa el mouse sobre algo en tu aplicación y haz clic en ello.
- El árbol selecciona ese componente, y la barra lateral se llena con sus propiedades.
- Cambia una propiedad. La aplicación en ejecución se actualiza de inmediato.
El cambio afecta solo a la aplicación que tienes delante. Tus archivos permanecen intactos hasta que revises el cambio y lo apliques, lo cual se cubre en Escribir cambios en el origen.
Si no aparece nada, revisa Solución de problemas.
