Um build remoto termina enquanto você verifica outro servidor. Um agente de programação pausa para aprovação em um terminal diferente. O NeoServer agora suporta notificações de status de programa OSC 7501 no iOS e macOS, então uma tarefa pode avisar quando termina, falha ou precisa de aprovação sem que você fique conferindo o terminal repetidamente.
Toque em uma notificação para voltar à sessão de terminal existente. No macOS, o NeoServer também pode localizar o painel dividido da sessão.
O que é OSC 7501?
OSC 7501 é uma sequência de escape de terminal que um programa em execução usa para informar seu estado. Ela pode descrever um trabalho em andamento, uma tarefa concluída, uma falha ou uma pausa que precisa de entrada do usuário. O programa envia informações de status estruturadas pela saída do terminal; o terminal decide como apresentá-las. Consulte a especificação do Program Status Protocol para o formato de transmissão.
O programa em execução precisa emitir relatórios OSC 7501. Ativar as notificações não faz com que todo comando do shell informe seu status. Uma ferramenta de linha de comando compatível pode enviar relatórios por conta própria, e seus próprios scripts podem enviá-los com printf.
Quais estados geram uma notificação?
O NeoServer usa estas regras tanto no iOS quanto no macOS:
| Relatório | Notificação do sistema |
|---|---|
state=done | Tarefa concluída |
state=error | Tarefa falhou |
state=blocked:kind=permission | Aprovação necessária |
state=idle ou state=working | Sem notificação |
state=blocked:kind=question ou kind=auth | Sem notificação |
O NeoServer suprime notificações de um terminal que você já está vendo enquanto o app está ativo. Relatórios de outras sessões podem notificá-lo. Quando o app não está ativo, as notificações podem aparecer desde que o NeoServer ainda esteja recebendo a saída do terminal.
Mensagens repetidas ou atualizações de progresso não criam alertas repetidos. O NeoServer combina mudanças rápidas, espaça notificações da mesma sessão em pelo menos cinco segundos e substitui a notificação anterior dessa sessão pela mais recente.
Ative as notificações de status de programa
- Abra as configurações do NeoServer e localize Terminal Settings.
- Localize Program Status Notifications na parte inferior da página de configurações do terminal. Ela vem ativada por padrão no iOS e no macOS.
- Execute um programa que envie relatórios OSC 7501. O NeoServer pede a permissão de notificação do sistema depois de receber o primeiro relatório de status não vazio, e não quando você abre um terminal ou alterna a configuração.
- Permita as notificações na caixa de diálogo de permissão do sistema. Se a permissão foi negada antes, ative as notificações do NeoServer nas configurações de notificação do sistema operacional.
Para um teste inicial, permaneça no terminal até responder à caixa de diálogo de permissão. Depois execute o exemplo com atraso abaixo e mude para outro terminal no NeoServer.
Teste uma notificação de conclusão por SSH
Conecte-se a um servidor usando um terminal SSH comum e cole:
printf '\033]7501;state=working:id=demo:app=demo\033\\'
sleep 10
printf '\033]7501;state=done:id=demo:app=demo\033\\'
Durante o atraso de dez segundos, mude para uma sessão de terminal diferente no NeoServer. Manter o NeoServer aberto torna esse um teste direto do fluxo de notificação de status. Uma notificação de conclusão deve chegar depois que o relatório final for processado, sujeita às configurações de notificação do sistema.
Para testar notificações de falha ou de aprovação, execute qualquer um dos exemplos e mude para outra sessão durante o atraso:
# Report a failed task.
sleep 10
printf '\033]7501;state=error:id=demo:app=demo\033\\'
# Report a task waiting for approval.
sleep 10
printf '\033]7501;state=blocked:id=demo:kind=permission:app=demo\033\\'
sleep 10
O atraso final no exemplo de aprovação mantém o relatório bloqueado no lugar antes de o shell voltar ao prompt. Dê tempo para a notificação chegar antes de voltar ao terminal de origem. Limpar ou substituir um relatório imediatamente pode cancelar um alerta pendente.
Esses comandos apenas informam um status. O exemplo de aprovação não executa nenhuma operação nem concede permissão. Tocar na notificação dele abre o terminal, onde você pode revisar a solicitação do programa real.
Adicione relatórios de status aos seus próprios scripts
Envolva um comando para que seu resultado de saída se torne um relatório explícito de conclusão ou de falha:
#!/bin/sh
printf '\033]7501;state=working:id=job:app=script\033\\'
# Replace this command with your build or other task.
if sh -c 'sleep 10'; then
result=0
state=done
else
result=$?
state=error
fi
printf '\033]7501;state=%s:id=job:app=script\033\\' "$state"
exit "$result"
Execute o script no terminal conectado para que o NeoServer receba sua saída. Este exemplo preserva o código de saída do comando. Para um texto de notificação personalizado, os campos title e msg do protocolo recebem texto UTF-8 de linha única codificado em Base64; app é um identificador curto do programa.
Comportamento em segundo plano no iOS e alertas ausentes
Estas são notificações locais do sistema geradas a partir da saída do terminal recebida. O NeoServer precisa continuar podendo receber e analisar essa saída. Se o iOS suspender ou encerrar o app, ele não consegue gerar novas notificações a partir de mudanças de status remotas. Um trabalho remoto pode continuar em execução sem que um novo alerta chegue ao seu iPhone.
Se um alerta não aparecer, verifique estes pontos:
- Comece com SSH direto. Se os exemplos funcionarem ali, mas falharem dentro do tmux ou do screen, verifique se essa camada encaminha a sequência OSC para o NeoServer.
- Saia do terminal de origem. Um terminal ativo e visível fica em silêncio de propósito.
- Verifique a permissão e a opção do app. As configurações de notificação do sistema e o modo Foco podem afetar se um banner aparece.
- Mantenha o relatório ativo por tempo suficiente. Limpar rapidamente um relatório ou mudar seu estado pode cancelar ou substituir a notificação pendente.
- Confira o estado informado. Uma pausa de pergunta ou de autenticação não aciona a notificação de aprovação; ela exige
blockedcomkind=permission.
Tocar em uma notificação seleciona uma sessão existente. Se essa sessão já foi encerrada, o NeoServer avisa; ele não reconecta nem executa comandos automaticamente. Se o app estiver bloqueado, a navegação espera até você desbloqueá-lo.
Para configurar a conexão, leia o guia de início rápido do NeoServer. Para o restante das preferências de terminal, consulte Terminal Settings.
Pronto para experimentar?
NeoServer · SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac
Grátis na App Store