Une compilation distante se termine pendant que vous consultez un autre serveur. Un agent de programmation se met en pause dans un autre terminal en attendant une approbation. NeoServer prend désormais en charge les notifications d’état de programme OSC 7501 sur iOS et macOS, si bien qu’une tâche peut vous prévenir quand elle se termine, échoue ou nécessite une approbation, sans que vous vérifiiez son terminal à répétition.
Touchez une notification pour revenir à la session de terminal existante. Sur macOS, NeoServer peut également localiser le volet fractionné de la session.
Qu’est-ce qu’OSC 7501 ?
OSC 7501 est une séquence d’échappement de terminal qu’un programme en cours d’exécution utilise pour signaler son état. Elle peut décrire un travail en cours, une tâche terminée, un échec ou une pause nécessitant une saisie de l’utilisateur. Le programme envoie des informations d’état structurées via la sortie du terminal ; c’est le terminal qui décide de la manière de les présenter. Consultez la spécification du Program Status Protocol pour le format filaire.
Le programme en cours d’exécution doit émettre des rapports OSC 7501. Activer les notifications ne fait pas de chaque commande shell un compte rendu d’état. Un outil en ligne de commande compatible peut envoyer des rapports lui-même, et vos propres scripts peuvent les envoyer avec printf.
Quels états produisent une notification ?
NeoServer applique ces règles sur iOS comme sur macOS :
| Rapport | Notification système |
|---|---|
state=done | Tâche terminée |
state=error | Tâche échouée |
state=blocked:kind=permission | Approbation requise |
state=idle ou state=working | Aucune notification |
state=blocked:kind=question ou kind=auth | Aucune notification |
NeoServer supprime les notifications pour un terminal que vous consultez déjà lorsque l’app est active. Les rapports d’autres sessions peuvent vous notifier. Quand l’app n’est pas active, des notifications peuvent apparaître tant que NeoServer continue de recevoir la sortie du terminal.
Les mises à jour répétées de message ou de progression ne créent pas d’alertes répétées. NeoServer combine les changements rapides, espace les notifications d’une même session d’au moins cinq secondes et remplace la notification précédente de cette session par la plus récente.
Activer les notifications d’état de programme
- Ouvrez les réglages de NeoServer et repérez Terminal Settings.
- Repérez Program Status Notifications en bas de la page des réglages du terminal. Il est activé par défaut sur iOS et macOS.
- Exécutez un programme qui envoie des rapports OSC 7501. NeoServer demande l’autorisation de notifications système après avoir reçu son premier rapport d’état non vide, et non quand vous ouvrez un terminal ou activez le réglage.
- Autorisez les notifications dans la boîte de dialogue d’autorisation système. Si l’autorisation a été refusée auparavant, activez les notifications pour NeoServer dans les réglages de notifications du système d’exploitation.
Pour un premier test, restez dans le terminal jusqu’à avoir répondu à la boîte de dialogue d’autorisation. Exécutez ensuite l’exemple différé ci-dessous et passez à un autre terminal dans NeoServer.
Tester une notification de fin via SSH
Connectez-vous à un serveur avec un terminal SSH ordinaire et collez :
printf '\033]7501;state=working:id=demo:app=demo\033\\'
sleep 10
printf '\033]7501;state=done:id=demo:app=demo\033\\'
Pendant le délai de dix secondes, passez à une autre session de terminal dans NeoServer. Garder NeoServer ouvert en fait un test simple du flux de notifications d’état. Une notification de fin devrait arriver après le traitement du rapport final, sous réserve des réglages de notifications du système.
Pour tester les notifications d’échec ou d’approbation, exécutez l’un ou l’autre exemple et passez à une autre session pendant le délai :
# 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
Le délai final de l’exemple d’approbation maintient le rapport bloqué en place avant que le shell ne revienne à son invite. Laissez le temps à la notification d’arriver avant de revenir au terminal source. Effacer ou remplacer immédiatement un rapport peut annuler une alerte en attente.
Ces commandes signalent uniquement un état. L’exemple d’approbation n’exécute aucune opération et n’accorde aucune autorisation. Toucher sa notification ouvre le terminal, où vous pouvez examiner la demande du programme réel.
Ajouter des rapports d’état à vos propres scripts
Encapsulez une commande pour que son résultat de sortie devienne un rapport explicite de fin ou d’échec :
#!/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"
Exécutez le script dans le terminal connecté pour que NeoServer reçoive sa sortie. Cet exemple préserve le code de sortie de la commande. Pour un texte de notification personnalisé, les champs title et msg du protocole acceptent du texte UTF-8 sur une seule ligne, encodé en Base64 ; app est un identifiant court du programme.
Comportement en arrière-plan sur iOS et alertes manquantes
Ce sont des notifications système locales générées à partir de la sortie du terminal reçue. NeoServer doit rester capable de recevoir et d’analyser cette sortie. Si iOS suspend ou met fin à l’app, elle ne peut pas générer de nouvelles notifications à partir des changements d’état distants. Une tâche distante peut continuer à s’exécuter sans qu’une nouvelle alerte n’atteigne votre iPhone.
Si une alerte n’apparaît pas, vérifiez ces points :
- Commencez par du SSH direct. Si les exemples fonctionnent là mais échouent dans tmux ou screen, vérifiez si cette couche transmet la séquence OSC à NeoServer.
- Éloignez-vous du terminal source. Un terminal actif et visible reste volontairement silencieux.
- Vérifiez à la fois l’autorisation et l’interrupteur de l’app. Les réglages de notifications système et le mode Concentration peuvent influer sur l’apparition d’un bandeau.
- Maintenez le rapport en place assez longtemps. Effacer rapidement un rapport ou changer son état peut annuler ou remplacer la notification en attente.
- Vérifiez l’état signalé. Une pause de question ou d’authentification ne déclenche pas la notification d’approbation ; il faut
blockedaveckind=permission.
Toucher une notification sélectionne une session existante. Si cette session est déjà fermée, NeoServer vous l’indique ; il ne se reconnecte pas et n’exécute pas de commandes automatiquement. Si l’app est verrouillée, la navigation attend que vous la déverrouilliez.
Pour la configuration de la connexion, lisez le guide de démarrage rapide de NeoServer. Pour le reste des préférences du terminal, consultez Terminal Settings.
Prêt à l'essayer ?
NeoServer · SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac
Gratuit sur l'App Store