NativeProcess  - AS3

指出目前的描述檔是否支援執行中的原生處理程序。只有在 extendedDesktop 描述檔中執行時，此屬性才會傳回 true。此外，對於安裝為 AIR 檔案的應用程式，NativeProcess.isSupported 永遠為 false。您必須用 ADT -target native 旗標來包裝 AIR 應用程式，以便使用 NativeProcess 類別。

指出這個原生處理程序目前是否執行中。若您呼叫 start() 方法，而且 NativeProcess 物件尚未傳送 exit 事件，此處理程序就是在執行中。NativeProcess 實體是對應至相關作業系統的單一處理程序。只要相關作業系統處理程序仍在執行中 (從原生處理程序啟動，一直到處理程序將結束代碼傳回給作業系統為止)，此屬性會一直是 true。

可以從這個原生處理程序存取標準錯誤輸出。只要在這個管道有可以使用的資料，NativeProcess 物件會傳送 ProgressEvent 物件。若在沒有資料時，您嘗試從這個串流讀取資料，則 NativeProcess 物件會擲出 EOFError 異常狀況。

類型為 IDataInput，因為是從目前處理程序輸入資料，即使它是子處理程序的輸出串流。

相關 API 元素

可以從這個原生處理程序存取標準輸入。使用此管道，將資料傳送至此處理程序。每一次將資料寫入 input 屬性後，會儘快將資料寫入原生處理程序的輸入管道。

類型為 IDataOutput，因為是從目前處理程序輸出資料，即使它是子處理程序的輸入串流。

相關 API 元素

可以從這個原生處理程序存取標準輸出管道。使用這個管道，從原生處理程序的標準輸出讀取資料。當這個管道有可以使用的資料時，NativeProcess 物件會傳送 ProgressEvent 物件。若在沒有資料時，您嘗試從這個串流讀取資料，則 NativeProcess 物件會擲出 EOFError。

類型為 IDataInput，因為是從目前處理程序輸入資料，即使它是子處理程序的輸出串流。

相關 API 元素

建構未初始化的 NativeProcess 物件。呼叫 start() 方法來開始處理程序。

相關 API 元素

關閉此處理程序中的輸入串流。某些命令列應用程式會等候輸入串流關閉後才開始某些作業。當串流關閉後，要等到處理程序結束並重新開始後，才可以重新開啟串流。

嘗試結束原生處理程序。

參數

開始由特定啟動資訊所指定的原生處理程序。處理程序啟動之後，就會開啟所有輸入和輸出串流。此方法會在要求作業系統啟動指定的處理程序之後立即傳回。若處理程序目前執行中，則 NativeProcess 物件會擲出 IllegalOperationError 異常狀況。若 NativeProcess 物件的 running 屬性傳回 true，則此處理程序正在執行中。若作業系統無法啟動處理程序，就會擲出 Error。

NativeProcess 實體是對應至相關作業系統的單一處理程序。若您想在同時執行數個相同的作業系統處理程序，可以為每一個子處理程序建立一個 NativeProcess 個體。

只要 NativeProcess 物件的 running 屬性傳回 false，就可以隨時呼叫此方法。這表示 NativeProcess 物件可以重複使用。換言之，您可以建構一個 NativeProcess 執行處理，呼叫 start() 方法，等候 exit 事件，然後再次呼叫 start() 方法。您可以使用不同的 NativeProcessStartupInfo 物件做為後續呼叫 start() 方法的 info 參數值。

只有使用原生安裝程式的 AIR 應用程式，才可以使用 NativeProcess 類別以及它的功能。除錯時，您可以將 -profile extendedDesktop 引數傳送至 ADL，來啟用 NativeProcess 功能。檢查 NativeProcess.isSupported 屬性，判斷是否支援原生處理程序通訊。

重要安全性注意事項：

原生處理程序 API 可以在使用者的系統上執行任何執行檔。建構以及執行命令時請務必小心。如果要執行之命令的任何部分是從外部來源產生的，請仔細驗證命令是否可以放心執行。否則，您的 AIR 應用程式應該會驗證傳送至運行中執行程序的資料。

不過，驗證輸入實屬不易。若要避免類似的困難，最好是編寫一個擁有特定 API 的原生應用程式 (例如 Windows 上的 EXE)。這些 API 應該只處理 AIR 應用程式特別需要的命令。例如，原生應用程式只會透過標準輸入串流來接受有限的指令集。

Windows 上的 AIR 不允許直接執行 .bat 檔案。命令解譯器應用程式 (cmd.exe) 會執行Windows .bat 檔案。呼叫 .bat 檔案時，當其他應用程式啟動時，這個命令應用程式可以解譯傳送至命令的引數。引數字串中外部字元的惡意插入，會造成 cmd.exe 執行有害或不安全的應用程式。例如，沒有適當的資料驗證，您的 AIR 應用程式會呼叫 myBat.bat myArguments c:/evil.exe。除了執行您的批次檔之外，這個命令應用程式會啟動 evil.exe 應用程式。

如果您使用 .bat 檔案來呼叫 start() 方法，NativeProcess 物件會擲回例外。Error 物件的 message 屬性包含「錯誤 #3219：無法啟動 NativeProcess」字串。

參數

相關 API 元素

發出訊號，說明原生處理程序已經結束。exitCode 屬性包含處理程序在結束時傳回至主機作業系統的值。如果 AIR 應用程式是呼叫 NativeProcess 物件的 exit() 方法來終止處理程序，則 exitCode 屬性會設定為 NaN。

發出訊號，說明 NativeProcess 已經關閉它的錯誤串流。

發出訊號，說明原生處理程序在標準錯誤 (stderror) 串流上有可以讀取的資料。當子處理程序清除它的標準錯誤串流，或者用於在處理程序之間通訊的內部緩衝區已滿時，NativeProcess 物件就會傳送此事件。不要撰寫依賴此內部緩衝區大小的程式碼；它在各種版本和作業系統之間會所有不同。

發出訊號，說明讀取標準錯誤 (stderror) 串流已經失敗。當執行階段無法從原生處理程序的標準錯誤管道讀取資料時，NativeProcess 物件可以傳送這個事件。

發出訊號，說明 NativeProcess 物件已經呼叫 closeInput 方法，關閉它的輸入串流。當實際原生處理程序自己關閉輸入串流時，NativeProcess 物件並不會發出此事件。

發出訊號，說明寫入標準輸入 (stdin) 串流已經失敗。當 closeInput() 方法失敗，或者當執行階段無法將資料寫入原生處理程序的標準輸入管道，NativeProcess 物件就會發出此事件。

發出訊號，說明 NativeProcess 已經將資料寫入子處理程序的輸入串流。當資料寫入串流後，NativeProcess 物件會送出這個事件。此事件「不會」指出子處理程序是否讀取任何資料。

發出訊號，說明 NativeProcess 已經關閉它的輸出串流。

發出訊號，說明原生處理程序在輸出串流上有可以讀取的資料。當子處理程序清除它的 stdout 串流，或者用於在處理程序之間通訊的內部緩衝區已滿時，NativeProcess 物件就會傳送此事件。不要撰寫依賴此內部緩衝區大小的程式碼；它在各種版本和作業系統之間會所有不同。

發出訊號，說明讀取 stdout 串流已經失敗。當執行階段無法從原生處理程序的標準輸出管道讀取資料時，NativeProcess 物件可以傳送這個事件。

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)