Aplicaciones y herramientas de ejemplo para Gea Stack. Este repositorio es la galería de aplicaciones utilizada por el simulador, objetivos embebidos, Gea OS, objetivos Apple, la extensión VS Code/Cursor y demos de marketing. Cada ejemplo es un pequeño paquete con un manifiesto gea en package.json.

Qué hay aquí: apps/* Aplicaciones Gea. La mayoría son aplicaciones TSX dirigidas a web, ESP32 y/o Gea OS. apps/*/package.json Manifiesto de la aplicación, compatibilidad de objetivos, scripts y metadatos del lanzador. tools/dialer-browser Pequeña herramienta auxiliar del lado del navegador para flujos de trabajo de marcación. package.json Marcador de espacio de trabajo para la colección de ejemplos. docs Catálogo y guía de contribución.

Inicio rápido: Ejecutar comprobaciones para un ejemplo individual: cd apps/watch npm install npm run check npm run build. Algunos ejemplos también incluyen pruebas, principalmente para proteger un diseño o una configuración de dispositivo que nada más detectaría -- npm test en la carpeta de la aplicación las ejecuta. El bucle web es impulsado desde el simulador, que es un repositorio separado: geastack/simulator. Sus scripts leen aplicaciones desde una raíz de proyecto de aplicaciones, que toman de GEA_APPS_ROOT -- este repositorio, o el tuyo propio. No hay valor predeterminado, así que configúralo o pasa --app-dir; nada asume que los dos checkouts estén uno al lado del otro. cd /path/to/simulator GEA_APPS_ROOT=/path/to/examples ./targets/web/dev-web.mjs watch # bucle de desarrollo GEA_APPS_ROOT=/path/to/examples ./targets/web/build-web.sh watch # compilar para web ./targets/web/dev-web.mjs --app-dir /path/to/examples/apps/watch # o nombra una aplicación. Flashear una placa compatible a través de Gea CLI: npx gea flash watch --board <alias> npx gea flash watch --board <alias> --monitor.

Documentación: docs/EXAMPLE-CATALOG.md: categorías de ejemplos, compatibilidad de objetivos y cómo se utilizan los manifiestos. docs/DEVELOPMENT.md: cómo agregar, probar y mantener una aplicación de ejemplo.

Fundamentos del manifiesto de la aplicación: Cada aplicación compilable debe tener un package.json con un campo gea: {"gea": {"id": "watch","name": "Watch","entry": "index.tsx","runtime": "gea","targets": {"web": true,"esp32": true,"geaos": true}}}. El manifiesto es consumido por el simulador, scripts de placas embebidas, Gea OS, objetivos Apple y la extensión del IDE. Mantenlo preciso.

Notas de mantenimiento: Mantén los ejemplos pequeños y enfocados. Un buen ejemplo demuestra un comportamiento claramente. Prefiere APIs de framework compartidas sobre trucos específicos de objetivos dentro de los ejemplos. Agrega pruebas para ejemplos con lógica no trivial, física o análisis. Actualiza la documentación del catálogo al agregar, renombrar, ocultar o cambiar la compatibilidad de objetivos de una aplicación.

Licencia: MIT (ver LICENSE). Úsala, cámbiala, envía productos de código cerrado sobre ella, sin condiciones. El único código de Gea Stack bajo una licencia diferente es el soporte de placas embebidas (targets y @geastack/chips, GPL-3.0-only): enviar firmware de código cerrado a través de ellos requiere una licencia comercial. Contacta a [email protected] para términos comerciales, soporte y compilaciones alojadas.

Entidades clave: Empresas: Gea Stack, GeaOS, Apple, VS Code, Cursor

Preguntas frecuentes: ¿Cuál es el propósito del repositorio geastack/examples?

El repositorio geastack/examples sirve como la galería de aplicaciones para Gea Stack, proporcionando aplicaciones y herramientas de ejemplo utilizadas por el simulador, objetivos embebidos, Gea OS, objetivos Apple, la extensión VS Code/Cursor y demos de marketing.

Pregunta frecuente: ¿Cuál es el propósito del repositorio geastack/examples?

Respuesta frecuente: El repositorio geastack/examples sirve como la galería de aplicaciones para Gea Stack, proporcionando aplicaciones y herramientas de ejemplo utilizadas por el simulador, objetivos embebidos, Gea OS, objetivos Apple, la extensión VS Code/Cursor y demos de marketing.