STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO
Instalação e requisitos
Instalar pelo Marketplace
Instale a extensão oficial pelo Marketplace. A versão 0.3.0 é ativada por licença e prepara o núcleo separadamente. Consulte Licenciamento e o Instalador.
Onde os processos rodam
A extensão é do tipo workspace. Em Remote SSH, ela roda no servidor SSH; em WSL, na distribuição Linux. Nesse caso, instalar PHP ou MySQL apenas no Windows não atende ao runtime remoto. Instale as dependências no ambiente em que o workspace está aberto.
O host embarcado com MySQL privado usa sockets Unix e é destinado a Linux, WSL e Remote SSH Linux. O modo Windows nativo não inicia esse host nesta versão. Os runners de plugins dependem de PHP/Node compatíveis no host; a matriz de testes executada está no relatório de validação da versão.
Requisitos por recurso
| Recurso | Requisitos externos |
|---|---|
| Criar projeto e validar/FEX | PHP 8.2+, Python 3; Sodium para chaves e assinaturas |
| Executar PHP | PHP 8.2+ com as extensões usadas pelo projeto |
| Executar TypeScript | Node.js 22+; PHP para a validação do SDK |
| Instalar dependências adicionais do projeto | Composer ou npm conforme a linguagem |
| Núcleo local e módulos nativos | Linux/WSL/SSH, MySQL Server 8+, PHP com PDO MySQL, mbstring, pcntl, posix, sockets e extensões requeridas pelo módulo |
O compilador TypeScript e o SDK V2 já estão no VSIX. A extensão pode provisionar a dependência local @zerotrusted/forge-sdk quando ela estiver ausente. Dependências adicionais da aplicação continuam sob responsabilidade do projeto. O Studio não executa instaladores remotos silenciosamente.
Configurações de usuário
Abra Configurações e procure por Titan Architect Studio:
{
"titanStudio.phpPath": "php",
"titanStudio.nodePath": "node",
"titanStudio.mysqlServerPath": "mysqld",
"titanStudio.sdkPath": ""
}
Os valores de executável podem ser nomes no PATH ou caminhos absolutos. Exemplos Linux usuais são /usr/bin/php, /usr/bin/node e /usr/sbin/mysqld; confira os caminhos reais do seu ambiente. Configurações de executáveis são de usuário/máquina, não comandos arbitrários fornecidos pelo projeto.
Deixe sdkPath vazio para usar o SDK V2 embarcado. Para experimentar outra distribuição compatível, use Configurar SDK e selecione a pasta que contém tools/titan-sdk.php. Essa seleção não instala o núcleo operacional.
Verifique antes de iniciar
No terminal do mesmo host do VS Code:
php --version
php -m
node --version
python3 --version
mysqld --version
Em seguida, use Diagnosticar ambiente. O comando doctor all também verifica ferramentas opcionais, como Composer e npm. Uma falha do diagnóstico indica o requisito ausente; não significa que todos os recursos da extensão estejam indisponíveis.
Reserve espaço para o snapshot do núcleo, cópias dos módulos e o banco MySQL de desenvolvimento. O primeiro início cria os arquivos do banco e demora mais que os seguintes. Falhas de quota ou permissão devem ser resolvidas antes de repetir a inicialização.
Workspace Trust
A extensão não fica disponível em workspaces não confiáveis. Confiar em uma pasta permite que seus scripts de teste e seus plugins sejam executados como código local. Não use essa decisão para código de procedência desconhecida sem isolamento adicional do ambiente.