aardio + PowerShell 可视化快速开发独立 EXE 桌面程序

aardio 可以方便地调用 PowerShell ，PowerShell 中也可以自由调用 aardio 对象与函数。不用带上体积很大的
System.Management.Automation.dll，直接调用系统组件，可以生成体积很小的独立 EXE。向下兼容到 .NET 2.0、PowerShell 2.0，支持 Win7，Win8，Win10，Win11 ……

dotNet.ps 扩展库

aardio 调用 PowerShelll 的功能由基于 dotNet 库 实现的 dotNet.ps 库提供。请参考：aardio + .NET 快速开发独立 EXE 程序，可防 ILSpy 反编译。

aardio 调用 PowerShell 命令

我们直接上代码看示例：

import console;
import dotNet.ps;

console.showLoading(" 正在执行PowerShell命令");
console.log(
  dotNet.ps.command("Get-Command",{"ListImported"})
);

console.pause();

dotNet.ps.command 的第一个参数指定要调用的 PowerShell 命令名，第二个参数用一个表对象指定 PowerShell 命令参数 —— 可以包含仅由参数名字组成的数组成员。

参数表也可以包含由名值对指定的命名参数，例如：

dotNet.ps.command("Get-Command"
                  ,{Name="*Process"} );

要注意参数名前面不需要加 $ 或 - 前缀。
等号前面是参数名（必须是字符串），等号后面是参数值（可传入 .NET 对象、COM 对象、aardio 对象）。

aardio 调用 PowerShell 脚本

使用匿名参数调用 PowerShell 脚本的示例：

var ps1 = /*
for ( $i=0; $i -lt $args.count; $i++){
    write-host $args[$i]
}
*/

import dotNet.ps;
var output = dotNet.ps(ps1,{
  "匿名参数1","匿名参数2","匿名参数3","匿名参数4"
});

import console;
console.log(output);
console.pause();

匿名参数也可以这样写：

dotNet.ps(ps1,"匿名参数1","匿名参数2","匿名参数3","匿名参数4");

也可以指定命名参数，如下：

var ps1 = /*
    # 定义命名参数，参数前加$号，aardio 参数表里去掉$号
    param($username,$password)

    Write-host $username,$password
*/

import dotNet.ps;
var output = dotNet.ps(ps1,{
    username = "名字";//参数名前不要加$
    password = "密码";//参数名前不要加$
});

import console;
console.log(output);
console.pause();

这里请注意：

1、PowerShell 通常用 param 声明参数名称（函数里也可以这样写）。

2、PowerShell 要在变量（或参数名）前加上 $ 符号，在 aardio 中指定 PowerShell 参数时要去掉这个 $ 符号。

dotNet.ps() ， dotNet.ps.command() 的传参数规则是完全一样的。

PowerShell 调用 aardio 对象

下面就要进入最神奇的部分了，在 PowerShell 里还可以方便地调用 aardio 对象。

我们直接看 aardio 代码示例：

var ps1 = /*
    # 定义命名参数
    param($win,$external,$username)

    # 自由调用参数传进来的 aardio 对象
    $win.msgboxTest("这是 PowerShell 调用 aardio 打开的对话框。") #返回值会自动输出一行

    # 自由调用 aardio 函数
    $external.func("参数1","参数2")
*/

import win;
import dotNet.ps;
var output = dotNet.ps(ps1,{
    win = win;
    external = {
        func = function(title,text){
            win.msgbox(text,title)
        }
    };
});

Win10 / Win11 自带的 PowerShell 5.1 可以支持这种舒服的写法。如果要兼容 Win7 只要简单地调用 dotNet.ps.export( aardio对象 ) 导出参数给 PowerShell 就可以了，不过 Win7 的市场份额已经很小，这种事太追求完美也不好。

用 JSON 解析 PowerShell 输出

aardio 代码示例：

import console;
import dotNet.ps;

var psVersion = dotNet.ps.json(
  `ConvertTo-Json $PSVersionTable.PSVersion`)
console.dumpJson(psVersion);    

console.pause(true);

捕获 PowerShell 输出

很简单，我们直接看 aardio 代码示例：

import console;
import dotNet.ps;

// PowerShell 输入都会传给这个 aardio 函数
dotNet.ps.onWrite = function(str){
  console.log(str);
}

dotNet.ps.command("Get-Command",{Name="*Process"});
console.pause(output);

我们也可以指定 dotNet.ps.onWriteProgress 回调以自定义 PowerShell 进度条，一个例子：

这个进度条范例的源码在这里：
aardio 自带范例 / 调用其他语言 / PowerShell / 进度条

上面范例里有一些方便的小工具，例如操作系统默认禁止单独运行 *.ps1 脚本文件。上面范例里就提供了一个小工具 —— 可以一键开启或关闭这个权限：

PowerShell 里有很多 Cmdlet 是用 C# 写的，而 C# 写的软件可以用 ILSpy 直接查看源码。其实看看一些 Cmdlet 的源码很有意思，但这个操作步骤有些多。

aardio 自带的 PowerShell 范例里还提供了一个快速查看 Cmdlet 源码的工具，可以直接列出所有命令，可以搜索查询，可以一键调用 ILSpy 反编译出源代码：

aardio / PowerShell / .NET 共享应用程序域

用大白话讲就是这三者可以直接共享对象，相互调用对象非常方便。

当使用 dotNet.ps 运行 PowerShell 代码是在当前进程中运行（ 没有创建新进程，但创建了新线程），并且 PowerShell 就运行在 aardio 创建的 .NET 应用程序域中 —— 这时候 aardio / PowerShell / .NET 共享一个应用程序域，这让我们可以做一些有趣的事。

请看 aardio 代码示例：

import dotNet.ps;
import dotNet.json;

var json = dotNet.ps( `
    # 哈希表(数组元素要用逗号分开)
    $tab = @{ Name = "张三"; Age = "20"; Array = 1,2,3 } 

    # PowerShell 类型放在 [] 里面，并用 :: 访问类的静态成员
    [Newtonsoft.Json.JsonConvert]::SerializeObject(  $tab  )
` );
var tab = web.json.parse(json);

import console
console.dump(tab)
console.pause()

aardio 库 dotNet.json 内存加载了 .NET 程序集 Newtonsoft.Json.dll，然后我们在 .NET 或是 PowerShell 中就可以直接使用这个程序集导入的类。

注意：PowerShell 将类或类型放在 [中括号] 内，PowerShell 在声明或强制转换类型时都使用这个 [中括号] ，访问类的静态成员使用 :: 而不是圆点 。

下面的例子更进一步：在 aardio 中编译 C# 代码，然后在 PowerShell 中调用该 C# 代码引入的类，然后在 C# 中回调 PowerShell 函数，然后在该 PowerShell 函数中回调 aardio 函数：

import win;
import console;
import dotNet.ps;

var compiler = dotNet.createCompiler("C#");
compiler.Source = /******
namespace CSharpLibrary
{
    public class Object
    {
        public delegate int TestDelegateType(string str,int a);
        public event TestDelegateType onTestEvent; 

        public int Test()
        {
            return onTestEvent("你好",123);
          }

          public static Object New(){return new Object(); }
    }
}
******/

//编译 C# 代码并导入名字空间
compiler.import("CSharpLibrary"); 

var out,err = dotNet.ps( `
param($win) 

$obj = [CSharpLibrary.Object]::New() #创建对象

# 添加事件
$obj.add_onTestEvent( {
    param($str,$a) # 声明参数

    # 调用 aardio 函数
    $temp = $win.msgbox("事件被回调了",$str)

    # return 语句只能改最后一个返回值，与其他语言有较大区别
    return $a
})

$obj.Test()
`,{ win = win; });

console.log(out,err);
console.pause(true);

这里就要注意 PowerShell 有一个非常特别的『 特（大）性（坑）』—— PowerShell 的函数里每句代码的默认输入都会增加一个返回值，例如您执行下面的 PowerShell 代码：

# 添加事件
$obj.add_onTestEvent( {
  param($str,$a) 

  $win.msgbox("事件被回调了",$str)

  return $a
})

这里的返回值实际上有两个，一个是 $win.msgbox() 返回的 object，另一个是 return 返回的 $a，最终返回值是一个数组。然后就会报返回值与 C# 委托回调的返回值类型不匹配。

避免上面这个问题也很简单，把代码放到一个赋值语句里就不会增加返回值了，正确写法：

$temp = $win.msgbox("事件被回调了",$str)

创建管道调用 PowerShell.exe

我们还可以用 aardio 中的 procee.popen 创建进程管道，这样就可以读写 PowerShell.exe 的输出输入，并且隐藏黑窗口。

下面是一个例子：

import console;
import process.popen;
console.showLoading(" 请稍候，正在调用 PowerShell");

var prcs  = process.popen.ps(`-Command`,`&{
    function Get-Version {
        ConvertTo-Json( $PSVersionTable.PSVersion )
    }

    Get-Version
}`);

//读取进程输出
var json = prcs.readAll(); 

//解析返回的 JSON
import web.json;
var psVersion = web.json.parse(json);

console.dump(psVersion);
console.pause(); 

这里要注意，PowerShell 会将仅用大括号包含的 PowerShell 作为字符串输出，在前面加上一个 & 字符才会执行该语句块。

调用更多编程语言

aardio 中还可以非常方便地调用 C语言、C++、C#、Java、Python、R、Javascript、Node.Js、Fortran、VB、Flash ActionScript、PHP、VBScript、PowerShell、NewLISP、AutoLISP、Delphi、FreeBASIC、Ruby、Rust、Julia、Nim、Go 语言、批处理 ...... 甚至可以直接嵌入汇编机器码并且转换为普通的 aardio 函数。