macos-menubar-tuist-app

Crie e mantenha aplicativos de barra de menu do macOS com um fluxo de trabalho "Tuist-first" e scripts de inicialização estáveis. Preserve limites de arquitetura rigorosos para que rede, estado e interface do usuário permaneçam testáveis e previsíveis.

Quando Usar

• Ao trabalhar em utilitários de barra de menu LSUIElement criados com Tuist e SwiftUI.
• Quando você precisa de manifestos Tuist, scripts de inicialização ou orientação de arquitetura para um aplicativo de barra de menu.

Regras Principais

• Mantenha o aplicativo apenas na barra de menu, a menos que explicitamente instruído de outra forma. Use LSUIElement = true por padrão.
• Mantenha a lógica de transporte e decodificação fora das visualizações. Não chame a rede a partir de corpos de visualização SwiftUI.
• Mantenha as transições de estado em uma camada de armazenamento (@Observable ou equivalente), não no código de apresentação de linha/visualização.
• Mantenha a decodificação de modelos resiliente a desvios de API: campos opcionais, fallbacks seguros e análise defensiva.
• Trate os manifestos Tuist como a fonte da verdade. Não confie em artefatos do Xcode gerados e editados manualmente.
• Prefira a inicialização baseada em script para iteração local quando tuist run for não confiável para resolução de destino/dispositivo macOS.
• Prefira tuist xcodebuild build em vez de xcodebuild bruto em scripts de execução local ao compilar projetos gerados.

Formato de Arquivo Esperado

Use esta colocação por padrão:

• Project.swift: destino do aplicativo, configurações, recursos, chaves Info.plist
• Sources/*Model*.swift: modelos de API/domínio e decodificação
• Sources/*Client*.swift: solicitações, mapeamento de resposta, preocupações de transporte
• Sources/*Store*.swift: estado observável, política de atualização, filtragem, cache
• Sources/*Menu*View*.swift: composição de menu e estado de UI de nível superior
• Sources/*Row*View*.swift: renderização de linha e interações leves
• run-menubar.sh: caminho canônico local de reinício/compilação/inicialização
• stop-menubar.sh: auxiliar de parada explícito quando necessário

Fluxo de Trabalho

1. Confirme a propriedade do Tuist

• Verifique se Tuist.swift e Project.swift (ou manifestos de workspace) existem.
• Leia os scripts de execução existentes antes de alterar o comportamento de inicialização.

2. Investigue o comportamento do backend antes de codificar suposições

• Use curl para verificar a forma do endpoint, requisitos de autenticação e comportamento de paginação.
• Se o endpoint ignorar limit/page, implemente o tratamento de lista completa com corte local no armazenamento.

3. Implemente camadas de baixo para cima

• Defina/ajuste modelos primeiro.
• Adicione ou atualize a lógica de solicitação/decodificação do cliente.
• Atualize a atualização do armazenamento, filtragem e política de cache.
• Conecte as visualizações por último.

4. Mantenha a conexão do aplicativo mínima

• Mantenha a entrada do aplicativo focada na conexão de cena/menu e injeção de dependência.
• Evite incorporar lógica de negócios em App ou declarações de cena de menu.

5. Padronize a ergonomia de inicialização

• Garanta que o script de execução reinicie uma instância existente antes de relançar.
• Garanta que o script de execução não abra o Xcode como um efeito colateral.
• Use tuist generate --no-open quando a geração for necessária.
• Quando o script de execução compilar o projeto gerado, prefira TUIST_SKIP_UPDATE_CHECK=1 tuist xcodebuild build ... em vez de invocar xcodebuild bruto diretamente.

Matriz de Validação

Execute as validações após as edições:

TUIST_SKIP_UPDATE_CHECK=1 tuist xcodebuild build -scheme <TargetName> -configuration Debug

Se o fluxo de trabalho de inicialização foi alterado:

./run-menubar.sh

Se os scripts shell foram alterados:

bash -n run-menubar.sh
bash -n stop-menubar.sh
./run-menubar.sh

Padrões de Falha e Direção de Correção

• tuist run não consegue resolver o destino do macOS: Use scripts de execução/parada como caminho de execução local canônico.

• A UI do menu está lenta ou inconsistente após a atualização: Mova o estado derivado e a filtragem para o armazenamento; mantenha as visualizações apenas para renderização.

• Mudanças no payload da API quebram a decodificação: Relaxe a decodificação de modelos com campos opcionais e padrões, em seguida, apresente dados ausentes com segurança na UI.

• O recurso solicita um patch rápido na UI: Rastreie a causa raiz no modelo/cliente/armazenamento antes de alterar a apresentação da linha/menu.

Lista de Verificação de Conclusão

• Preserve o comportamento apenas na barra de menu, a menos que explicitamente alterado.
• Mantenha a lógica de rede e estado fora dos corpos de visualização SwiftUI.
• Mantenha os manifestos Tuist e os scripts de execução alinhados com o fluxo real de compilação/execução.
• Execute a matriz de validação para as áreas tocadas.
• Relate comandos concretos executados e resultados.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.