NativeProcess  - AS3

Indique si l’exécution de processus natifs est prise en charge dans le profil actuel. Cette propriété renvoie true uniquement lorsqu’elle est exécutée dans le profil de bureau étendu. En outre, NativeProcess.isSupported est toujours false pour les applications installées comme un fichier AIR. Vous devez mettre en package une application AIR à l’aide de l’indicateur -target native d’ADT pour pouvoir utiliser la classe NativeProcess.

Indique si ce processus natif est actuellement en cours d’exécution. Le processus est en cours d’exécution si vous avez appelé la méthode start() et si l’objet NativeProcess n’a pas encore distribué d’événement exit. Une occurrence de NativeProcess correspond à un processus unique sur le système d’exploitation sous-jacent. Cette propriété reste true à condition que le processus du système d’exploitation sous-jacent soit en cours d’exécution (lors du lancement du processus natif et jusqu’à ce que ce dernier renvoie un code de sortie au système d’exploitation).

Permet l’accès à la sortie d’erreurs standard à partir de ce processus natif. Lorsque les données sont disponibles sur ce canal, l’objet NativeProcess distribue un objet ProgressEvent. Si vous tentez de lire les données à partir de ce flux alors qu’aucune donnée n’est disponible, l’objet NativeProcess renvoie une exception EOFError.

Le type est IDataInput, car l’entrée des données est considérée depuis la perspective du processus en cours, même s’il s’agit d’un flux de sortie du processus enfant.

Eléments de l’API associés

Permet d’accéder du flux d’entrée standard de ce processus natif. Utilisez ce canal pour envoyer des données à ce processus. Chaque fois que des données sont écrites dans la propriété input, elles sont écrites dès que possible dans le canal d’entrée du processus natif.

Le type est IDataOutput, car la sortie des données est considérée depuis la perspective du processus en cours, même s’il s’agit d’un flux d’entrée du processus enfant.

Eléments de l’API associés

Permet d’accéder au canal de sortie standard de ce processus natif. Utilisez ce canal pour lire les données depuis la sortie standard du processus natif. Lorsque ce canal contient des données, l’objet NativeProcess distribue un événement ProgressEvent. Si vous tentez de lire les données à partir de ce flux alors qu’aucune donnée n’est disponible, l’objet NativeProcess renvoie une exception EOFError.

Le type est IDataInput, car l’entrée des données est considérée depuis la perspective du processus en cours, même s’il s’agit d’un flux de sortie du processus enfant.

Eléments de l’API associés

Construit un objet NativeProcess non initialisé. Appelez la méthode start() pour démarrer le processus.

Eléments de l’API associés

Ferme le flux d’entrée sur ce processus. Certaines applications de ligne de commande attendent que le flux d’entrée soit interrompu pour lancer certaines opérations. Une fois que le flux est fermé, il ne peut pas être rouvert tant que le processus n’existe pas et n’est pas à nouveau lancé.

Tente de quitter le processus natif.

Paramètres

Démarre le processus natif identifié par les informations de lancement spécifiées. Une fois que le processus démarre, tous les flux d’entrée et de sortie sont ouverts. Cette méthode est immédiatement renvoyée après avoir sollicité le lancement du processus natif auprès du système d’exploitation. L’objet NativeProcess renvoie une exception IllegalOperationError si le processus est en cours d’exécution. Le processus est en cours d’exécution si la propriété running de l’objet NativeProcess renvoie true. Si le système d’exploitation ne parvient pas à lancer le processus, un événement error est renvoyé.

Une occurrence de NativeProcess correspond à un processus unique sur le système d’exploitation sous-jacent. Si vous souhaitez exécuter simultanément plusieurs occurrences du même processus sur le système d’exploitation, vous devez créer une occurrence de NativeProcess par processus enfant.

Vous pouvez appeler cette méthode chaque fois que la propriété running de l’objet NativeProcess renvoie false. Cela signifie que l’objet NativeProcess peut être réutilisé. En d’autres termes, vous pouvez créer une occurrence de NativeProcess, appeler la méthode start(), attendre l’événement exit, puis rappeler la méthode start(). Vous pouvez utiliser un objet NativeProcessStartupInfo différent comme valeur du paramètre info lors de l’appel suivant de la méthode start().

La classe NativeProcess et ses fonctionnalités sont disponibles uniquement sur des applications AIR installées avec un programme d’installation natif. Lors du débogage, vous pouvez transmettre l’argument -profile extendedDesktop à l’application de débogage du lanceur AIR (ADL) pour activer la fonctionnalité NativeProcess. Vérifiez la propriété NativeProcess.isSupported pour déterminer si la communication du processus natif est prise en charge.

Consignes de sécurité importantes :

L’API du processus natif peut lancer tout fichier exécutable sur le système de l’utilisateur. Prenez un soin extrême lorsque vous générez et exécutez des commandes. Si l’une des parties d’une commande à exécuter provient d’une source externe, vérifiez bien qu’il est possible d’exécuter la commande en toute sécurité. De même, votre application AIR doit valider les données transmises à un processus en cours.

Il peut néanmoins s’avérer difficile de vérifier la source d’entrée. Pour éviter de telles difficultés, il est préférable d’écrire une application native (par exemple un fichier EXE sous Windows) qui dispose d’API spécifiques. Ces API doivent traiter uniquement les commandes requises expressément par l’application AIR. Par exemple, il est possible que l’application n’accepte qu’un nombre limité d’instructions via le flux d’entrée standard.

L’application AIR sous Windows ne vous autorise pas à exécuter des fichiers .bat directement. Les fichiers .bat Windows sont exécutés par l’interpréteur de commande (cmd.exe). Lorsque vous appelez un fichier .bat, cette application de commande peut interpréter les arguments transmis à la commande comme d’autres applications à lancer. Si des caractères supplémentaires sont ajoutés de façon malintentionnée dans la chaîne d’arguments, le fichier cmd.exe risque d’exécuter une application nuisible ou non sécurisée. Par exemple, si les données ne sont pas correctement validées, votre application AIR peut appeler myBat.bat myArguments c:/mal.exe. Dans ce cas, l’application de commande lance l’application evil.exe en même temps qu’elle exécute votre fichier de commandes.

Si vous appelez la méthode start() avec un fichier .bat, l’objet NativeProcess renvoie une exception. La propriété message de l’objet Error contient la chaîne "Erreur #3219 : le processus natif pas pu être démarré".

Paramètres

Eléments de l’API associés

Signale que le processus natif a été finalisé. La propriété exitCode contient la valeur que le processus renvoie au système d’exploitation hôte à la fermeture. Si l’application AIR met fin au processus en appelant la méthode exit() de l’objet NativeProcess, la propriété exitCode est définie sur NaN.

Signale que l’objet NativeProcess a fermé son flux d’erreurs.

Signale que le processus natif a des données à lire sur le flux d’erreurs standard (stderror). L’objet NativeProcess distribue cet événement lorsque le processus enfant efface son flux d’erreurs standard ou lorsque la mémoire tampon interne utilisée pour la communication entre les processus est pleine. N’écrivez pas du code qui dépend de la taille de cette mémoire tampon interne, car cette taille varie selon les versions et les systèmes d’exploitation.

Signale que la lecture du flux d’erreurs standard (stderror) a échoué. L’objet NativeProcess peut distribuer cet événement si le moteur d’exécution ne parvient pas à lire les données depuis le canal de sortie standard du processus natif.

Signale que l’objet NativeProcess a fermé son flux d’entrée en appelant la méthode closeInput(). L’objet NativeProcess ne distribue pas cet événement lorsque le processus natif actuel ferme lui-même le flux d’entrée.

Signale que l’écriture dans le flux d’entrée standard (stdin) a échoué. L’objet NativeProcess distribue cet événement lorsque la méthode closeInput() échoue ou lorsque le moteur d’exécution ne parvient pas à écrire des données dans le canal d’entrée standard du processus natif.

Signale que l’objet NativeProcess a écrit des données dans le flux d’entrée pour le processus enfant. L’objet NativeProcess distribue cet événement lorsque les données sont écrites dans le flux. Cet événement n’indique pas si le processus enfant a lu les données.

Signale que l’objet NativeProcess a fermé son flux de sortie.

Signale que le processus natif a des données à lire sur le flux de sortie. L’objet NativeProcess distribue cet événement lorsque le processus enfant efface son flux de sortie standard ou lorsque la mémoire tampon interne utilisée pour la communication entre les processus est pleine. N’écrivez pas du code qui dépend de la taille de cette mémoire tampon interne, car cette taille varie selon les versions et les systèmes d’exploitation.

Signale que la lecture du flux de sortie standard (stdout) a échoué. L’objet NativeProcess peut distribuer cet événement si le moteur d’exécution ne parvient pas à lire les données depuis le canal de sortie standard du processus natif.

package
{
    import flash.display.Sprite;
    import flash.desktop.NativeProcess;
    import flash.desktop.NativeProcessStartupInfo;
    import flash.events.Event;
    import flash.events.ProgressEvent;
    import flash.events.IOErrorEvent;
    import flash.events.NativeProcessExitEvent;
    import flash.filesystem.File;
    
    public class NativeProcessExample extends Sprite
    {
        public var process:NativeProcess;

        public function NativeProcessExample()
        {
            if(NativeProcess.isSupported)
            {
                setupAndLaunch();
            }
            else
            {
                trace("NativeProcess not supported.");
            }
        }
        
        public function setupAndLaunch():void
        {     
            var nativeProcessStartupInfo:NativeProcessStartupInfo = new NativeProcessStartupInfo();
            var file:File = File.applicationDirectory.resolvePath("test.py");
            nativeProcessStartupInfo.executable = file;

            var processArgs:Vector.<String> = new Vector.<String>();
            processArgs[0] = "foo";
            nativeProcessStartupInfo.arguments = processArgs;

            process = new NativeProcess();
            process.start(nativeProcessStartupInfo);
            process.addEventListener(ProgressEvent.STANDARD_OUTPUT_DATA, onOutputData);
            process.addEventListener(ProgressEvent.STANDARD_ERROR_DATA, onErrorData);
            process.addEventListener(NativeProcessExitEvent.EXIT, onExit);
            process.addEventListener(IOErrorEvent.STANDARD_OUTPUT_IO_ERROR, onIOError);
            process.addEventListener(IOErrorEvent.STANDARD_ERROR_IO_ERROR, onIOError);
        }

        public function onOutputData(event:ProgressEvent):void
        {
            trace("Got: ", process.standardOutput.readUTFBytes(process.standardOutput.bytesAvailable)); 
        }
        
        public function onErrorData(event:ProgressEvent):void
        {
            trace("ERROR -", process.standardError.readUTFBytes(process.standardError.bytesAvailable)); 
        }
        
        public function onExit(event:NativeProcessExitEvent):void
        {
            trace("Process exited with ", event.exitCode);
        }
        
        public function onIOError(event:IOErrorEvent):void
        {
             trace(event.toString());
        }
    }
}

 #!/usr/bin/python
 # ------------------------------------------------------------------------------
 # Sample Python script
 # ------------------------------------------------------------------------------
 
 import sys
 
 for word in sys.argv: #echo the command line arguments
     print word
 
 print "HI FROM PYTHON"
 print "Enter user name" 
 line = sys.stdin.readline()
 
 sys.stdout.write("hello," + line)