Aplicativos e ferramentas de exemplo para o Gea Stack. Este repositório é a galeria de aplicativos usada pelo simulador, alvos embarcados, Gea OS, alvos Apple, a extensão VS Code/Cursor e demos de marketing. Cada exemplo é um pequeno pacote com um manifesto gea em package.json.

O que está aqui: apps/* Aplicativos Gea. A maioria são aplicativos TSX direcionados para web, ESP32 e/ou Gea OS. apps/*/package.json Manifesto do aplicativo, compatibilidade de alvos, scripts e metadados do lançador. tools/dialer-browser Pequena ferramenta auxiliar do lado do navegador para fluxos de trabalho de discagem. package.json Marcador de espaço de trabalho para a coleção de exemplos. docs Catálogo e orientação de contribuição.

Início rápido: Execute verificações para um exemplo individual: cd apps/watch npm install npm run check npm run build. Alguns exemplos também possuem testes, principalmente protegendo um layout ou uma configuração de dispositivo que nada mais detectaria -- npm test na pasta do aplicativo os executa. O loop web é conduzido pelo simulador, que é um repositório separado: geastack/simulator. Seus scripts leem aplicativos de uma raiz de projeto de aplicativos, que eles obtêm de GEA_APPS_ROOT -- este repositório, ou o seu próprio. Não há padrão, então defina-o ou passe --app-dir; nada assume que os dois checkouts fiquem um ao lado do outro. cd /path/to/simulator GEA_APPS_ROOT=/path/to/examples ./targets/web/dev-web.mjs watch # loop de desenvolvimento GEA_APPS_ROOT=/path/to/examples ./targets/web/build-web.sh watch # build para web ./targets/web/dev-web.mjs --app-dir /path/to/examples/apps/watch # ou nomeie um aplicativo. Grave uma placa compatível através do Gea CLI: npx gea flash watch --board <alias> npx gea flash watch --board <alias> --monitor.

Documentação: docs/EXAMPLE-CATALOG.md: categorias de exemplos, compatibilidade de alvos e como os manifestos são usados. docs/DEVELOPMENT.md: como adicionar, testar e manter um aplicativo de exemplo.

Noções básicas do manifesto do aplicativo: Todo aplicativo construível deve ter um package.json com um campo gea: {"gea": {"id": "watch","name": "Watch","entry": "index.tsx","runtime": "gea","targets": {"web": true,"esp32": true,"geaos": true}}}. O manifesto é consumido pelo simulador, scripts de placas embarcadas, Gea OS, alvos Apple e a extensão IDE. Mantenha-o preciso.

Notas de manutenção: Mantenha os exemplos pequenos e focados. Um bom exemplo prova um comportamento claramente. Prefira APIs de framework compartilhadas em vez de truques específicos de alvo dentro dos exemplos. Adicione testes para exemplos com lógica não trivial, física ou análise. Atualize a documentação do catálogo ao adicionar, renomear, ocultar ou alterar a compatibilidade de alvos de um aplicativo.

Licença: MIT (ver LICENSE). Use-a, altere-a, envie produtos de código fechado sobre ela, sem condições. O único código do Gea Stack sob uma licença diferente é o suporte a placas embarcadas (targets e @geastack/chips, GPL-3.0-only): enviar firmware de código fechado através deles requer uma licença comercial. Contate [email protected] para termos comerciais, suporte e builds hospedados.

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

Perguntas frequentes: Qual é o propósito do repositório geastack/examples?

O repositório geastack/examples serve como a galeria de aplicativos para o Gea Stack, fornecendo aplicativos e ferramentas de exemplo usados pelo simulador, alvos embarcados, Gea OS, alvos Apple, a extensão VS Code/Cursor e demos de marketing.

Pergunta frequente: Qual é o propósito do repositório geastack/examples?

Resposta frequente: O repositório geastack/examples serve como a galeria de aplicativos para o Gea Stack, fornecendo aplicativos e ferramentas de exemplo usados pelo simulador, alvos embarcados, Gea OS, alvos Apple, a extensão VS Code/Cursor e demos de marketing.