Terminal Linux

A tela de boas-vindas

A tela de boas-vindas é a página inicial do módulo. Ela mostra o título Terminal e a frase “Shell local, SSH remoto e ferramentas Linux em um só lugar”.

O shell local

O shell local é um processo de verdade no seu celular, não uma emulação.

• Shell. ash do BusyBox v1.34.1, incluído no app e iniciado em um pseudoterminal nativo (TERM=xterm-256color, redimensionado junto com a tela). Se o BusyBox não estiver disponível, recorre ao sh do próprio Android.
• Applets. O binário do BusyBox exporta 373 applets. Na primeira vez que você abre um shell, o PocketCode vincula todos eles, entre os quais awk, vi, sed, find, tar, gzip, unzip, wget, nc, ping, nslookup, traceroute, ifconfig, ip, netstat, top e less. Se essa etapa falhar, vincula uma lista básica de 70. Os vínculos são reparados na próxima vez que você abre um shell depois de uma atualização do app.
• Node. O node é vinculado ao shell quando o build o inclui para a arquitetura do seu dispositivo (arm64-v8a e x86_64), com NODE_OPTIONS=--no-addons. O npm não está incluído.
• Pasta pessoal. ~ é a sua pasta de projetos. ls, grep e diff são aliases coloridos e ll é ls -la (o PocketCode verifica o .ashrc do shell a cada início e o restaura se for diferente).
• Banco de dados. Enquanto o motor PostgreSQL local está rodando, DATABASE_URL e as variáveis PG* são definidas apenas no shell local, nunca nas sessões SSH.
• Saída. A saída é uma lista de linhas (as últimas 10.000 por aba). Cores e estilos são desenhados (cores de 16, 256 e RGB, negrito, esmaecido, itálico, sublinhado), os retornos de carro fazem as barras de progresso colapsarem, e o backspace e as tabulações funcionam. Movimento do cursor, limpeza de tela, rastreamento do mouse e outras sequências de controle são descartados.

O que não existe aqui, e por quê

• Um gerenciador de pacotes: não há apt, dpkg nem pkg. O app não instala pacotes.Google Play
• git. Use o Painel Git (ele conversa com o JGit) ou o Controle de código do editor.De propósito
• python, docker, curl, ssh, scp, zip e nano. Eles não estão no build do BusyBox e o app não baixa executáveis. Para outra máquina, use a tela SSH.Google Play
• Root, chroot/proot ou uma distribuição Linux: o shell tem o usuário do próprio app e nada mais.Dispositivo
• Programas que redesenham a tela inteira, como vi, top ou less: eles não aparecem como tela cheia porque o movimento do cursor é descartado. top -n 1 é oferecido como chip em Processos.De propósito

Sessões, abas e gestos

Cada aba é uma sessão. A barra de abas é compartilhada pelas telas local e SSH, mas cada tela mostra só as abas do seu tipo.

Abas, tela dividida e busca

• + abre outro shell local nesta tela (na tela SSH, abre a lista de hosts).
• Mantenha uma aba pressionada para Renomear e Fechar outros separadores (uma aba remota também oferece Duplicar sessão). Fechar uma aba local é imediato; fechar as outras pergunta antes.
• Cada aba tem um ponto de status (a aba local é sempre verde), e um ponto extra aparece na aba que recebeu saída nova enquanto você estava em outra. Os chips LOG e REC aparecem na barra enquanto o registro ou a gravação está ligado.
• O botão de divisão alterna entre Dividir horizontal, Dividir vertical e Sem divisão. O segundo painel mostra a aba seguinte, o painel ativo tem uma borda de destaque e um toque em um painel o foca. A tela dividida é Pro.
• A lupa (Buscar saída) abre Buscar na saída… com uma contagem (“N de M”) e botões de anterior e próximo. Ela encontra o texto em qualquer ponto da linha, ignorando maiúsculas e minúsculas, e cada painel dividido é pesquisado separadamente.
• Broadcast (enviar o que você digita a todas as abas conectadas) e Shell multiplexado pertencem às abas remotas. Estão na página de SSH.

Gestos e teclas

A barra de entrada

• Um campo de uma linha com Enviar. Tudo o que você envia daqui é adicionado ao histórico de comandos desta aba.
• Até cinco sugestões aparecem enquanto você digita: comandos conhecidos, comandos do histórico desta aba e caminhos que começam com / ou ~ (só no shell local, um nível de profundidade).
• Comando anterior volta pelo histórico desta aba.
• Anexar arquivo escolhe um arquivo. No shell local ele é copiado para a sua pasta de projetos, com (1), (2) acrescentado quando o nome já existe, e o caminho dele é inserido no campo. Em uma aba remota, ele é enviado para /tmp.
• Explicar com IA aparece quando a saída mais recente parece uma falha (veja abaixo).

Limites da tela de sessão

• Uma fileira de teclas extras (ESC, TAB, Ctrl, F1 a F12). As únicas teclas que você pode enviar são Ctrl+C (toque duplo), as setas (deslizar) e o que uma macro enviar.Ainda não
• Abrir um arquivo a partir da saída: caminhos de arquivo e referências file:line:column são destacados, mas não reagem ao toque. Só os endereços da web abrem.Ainda não
• Uma segunda sessão na mesma tela no plano Grátis, e a tela dividida.Pro

Avisos que uma sessão pode levantar

O painel de ferramentas

Quase tudo o que você faz além de digitar comandos acontece nas ferramentas. Elas aparecem de duas maneiras, conforme a tela.

As 20 ferramentas do shell local, na ordem do painel

Snippets, Histórico de comandos, Gerenciador de arquivos, Painel Git, Processos, Informações do sistema, Uso de disco, Rede, Variáveis de ambiente, Gerenciador de aliases, Tarefas em segundo plano, Scripts rápidos, Macros de teclado, Regras Expect, Gravação, Registros de sessão, Partilha o teu servidor, Perfis, Sincronização e equipes e Importar / Exportar. Uma aba remota acrescenta mais 12, 32 no total (veja a página de SSH).

Painel acoplado

Em tela larga (660 dp ou mais) e sem tela dividida, um painel de 380 dp se acopla à direita: uma faixa de ícones com a ferramenta selecionada logo abaixo. Há sempre uma ferramenta selecionada (Snippets na primeira vez) e o painel lembra a última. A seta da barra de abas (Recolher painel) o recolhe.

Menu de ferramentas

No celular, ou com a tela dividida ligada, o botão de chave inglesa (Mais opções) abre um menu com um campo de busca (Buscar ação…), uma linha de FREQUENTES (uma ação aparece ali depois de dois usos, no máximo seis) e estas categorias:

Em uma aba SSH há uma sétima categoria, Conexão, e mais ações nas outras. Copiar saída e Limpar terminal também estão no menu de toque longo da saída.

Ferramentas Linux

Estas ferramentas são atalhos para coisas que você digitaria de qualquer jeito. As listas que elas mostram são lidas por um shell separado e não interativo (cada leitura é limitada a 15 segundos e 512 KB). O que você muda por elas (criar, apagar, encerrar, exportar) é digitado na sua sessão como um comando comum, então você também vê isso na saída.

Gerenciador de arquivos

Ferramenta do painel Gerenciador de arquivos; menu → Ferramentas Linux.

Um navegador de pastas construído sobre ls -la.

Painel Git

Ferramenta do painel Painel Git; menu → Ferramentas Linux.

Um pequeno painel Git com quatro abas: Estado, Branches, Histórico e Ações. No shell local ele usa o JGit (não existe programa git); em uma aba SSH, digita comandos git no shell remoto. Ele procura o repositório subindo a partir da pasta do Gerenciador de arquivos, ou da sua pasta de projetos.

Processos

Ferramenta do painel Processos; menu → Ferramentas Linux.

Os processos em execução, lidos com ps.

Informações do sistema

Ferramenta do painel Informações do sistema; menu → Ferramentas Linux.

Três abas de cartões: Visão geral (SO, kernel, tempo ligado), Hardware (arquitetura, mais o modelo do seu celular, a versão do Android e o nível do SDK) e Ambiente (usuário e id).

Uso de disco

Ferramenta do painel Uso de disco; menu → Ferramentas Linux.

Um cartão por partição, a partir de df -hP, com uma barra de uso e os tamanhos Usado, Livre e Total.

Rede

Ferramenta do painel Rede; menu → Ferramentas Linux.

Ao abri-la, ela executa ifconfig (ou ip addr) e mostra o resultado. A saída aparece na janela como texto monoespaçado simples, não na sessão.

Variáveis de ambiente

Ferramenta do painel Variáveis de ambiente; menu → Ferramentas Linux.

As variáveis, listadas com env e pesquisáveis.

Gerenciador de aliases

Ferramenta do painel Gerenciador de aliases; menu → Sessão.

Aliases da sessão, listados com alias.

Tarefas em segundo plano

Ferramenta do painel Tarefas em segundo plano; menu → Sessão.

Tarefas listadas com jobs -l. Quando não há nenhuma, a janela diz “Sem tarefas em segundo plano” e “Use comando & para executar em segundo plano”.

Snippets e histórico

Comandos reutilizáveis e os comandos que você já executou.

Snippets

Ferramenta do painel Snippets (aquela com que o painel abre); menu → Snippets.

98 comandos prontos em 14 categorias, criados na primeira vez que o terminal roda, mais os seus. No shell local os seis snippets de Pacotes ficam ocultos, então aparecem 92.

Histórico de comandos

Ferramenta do painel Histórico de comandos; menu → Sessão.

Os comandos que você enviou pela barra de entrada desta aba.

Automação (Pro)

Scripts rápidos, Macros de teclado e Regras Expect são Pro: a trava está em salvá-los, e em executar um Script rápido. No Grátis as janelas abrem, mostram uma marca PRO, e Terminal Pro aparece quando você tenta salvar. O paywall os lista como Automação avançada (regras Expect, Watchdog, macros).

Scripts rápidos

Ferramenta do painel Scripts rápidos; menu → Automação.

Scripts de várias linhas que você envia à sessão com um toque.

Macros de teclado

Ferramenta do painel Macros de teclado; menu → Automação.

Uma sequência de teclas com nome, enviada à sessão como bytes brutos.

Regras Expect

Ferramenta do painel Regras Expect; menu → Automação.

Quando um padrão aparece na saída, o PocketCode digita uma resposta por você. As regras são verificadas linha a linha na saída de toda sessão aberta, e só a primeira regra que combina com uma linha responde.

Perfis

Os perfis são a parte menos acabada do terminal. Estão listados aqui porque a janela está no painel e no menu.

Ferramenta do painel Perfis; menu → Segurança.

Uma lista de Perfis de terminal. Cinco vêm com o app: Default, Bash, Dev (Node), Docker e Python Env.

Gravação e registros

Duas formas de guardar o que uma sessão imprimiu. Ambas são Grátis.

Gravação

Ferramenta do painel Gravação; menu → Sessão → Iniciar gravação.

“Guarda a sessão como um ficheiro .cast do asciinema que podes reproduzir depois.” O arquivo é asciicast v2, chamado session_<name>_<date>.cast, e não é criptografado.

Registros de sessão

Ferramenta do painel Registros de sessão; menu → Configurações.

Um registro em texto simples de tudo o que uma sessão imprimiu, guardado criptografado no dispositivo (AES-256-GCM, com uma chave mantida no Android Keystore). O texto simples só existe enquanto o registro está ativo; ao parar, o arquivo é selado.

Compartilhe seu servidor de desenvolvimento

Um link público para o servidor de desenvolvimento que roda no seu celular.

Ferramenta do painel Partilha o teu servidor; menu → Sessão.

Com um servidor de desenvolvimento rodando no celular (iniciado a partir de um projeto), a janela diz “Dá um endereço público ao servidor que corre neste telemóvel, na porta N”. O link sai por um encaminhamento remoto SSH para o localhost.run: sem conta e sem software extra.

Explicar com IA

Ajuda em linguagem simples quando um comando falha.

O botão de brilho (Explicar com IA) na barra de entrada. Ele só aparece quando a saída mais recente parece uma falha.

O PocketCode envia as últimas 40 linhas da aba (8 KB no máximo) ao seu provedor de IA conectado, com os segredos mascarados antes, e mostra a resposta em Explicação da IA: o que falhou, por quê e o que executar em seguida. Ele espera até 60 segundos. Você usa o seu próprio provedor, então isso não custa nada ao PocketCode.