process.dotnet 库模块帮助文档

默认调用

import process.dotnet;

//不要与标准库 dotNet 混淆，aardio 标识符区分大小写
var dotnet,err = process.dotnet();
if(!dotnet) error(err);

var pipe,err = dotnet("--info"); 
if(!pipe) error(err);

var output,stderr,exitCode = pipe.readAll();
print(output,stderr,exitCode);

独立选择 SDK

import process.dotnet;
var dotnet,err = process.dotnet("8.0");
if(!dotnet) error(err);

print("实际 SDK：",dotnet.version);
var pipe,err = dotnet("--version");

if(!pipe) error(err);
print(pipe.readAll());

process.dotnet("8.0") 选择 SDK 8，不会因同时安装 SDK 10 而偷偷使用 SDK 10。 要用 SDK 10 编译 net8.0 项目，则选择 SDK 10，并在 csproj 中设置 TargetFramework=net8.0。 dotnet(...)（等同于 dotnet.run(...)）直接运行所选 SDK 的 CLI 程序；普通应用 DLL 可用 process.popen(dotnet.path,"应用.dll") 执行。 构造 SDK 对象不连接 AutoCAD，也不把现代程序集载入 aardio 的 .NET Framework CLR。

工作目录通常只需设置一次 dotnet.workDir，各实例互不影响。构造时依次采用 options.workDir、process.dotnet.workDir、应用程序基准目录；单次调用第 2 个参数中的 workDir 可临时覆盖，但不修改实例的默认值。

编译 C# 为 DLL

import process.dotnet;

print("正在准备 .NET SDK"); //交互环境应提示，避免长时间安装阻塞，Agent 环境可省略
var dotnet,err = process.dotnet("8.0");
if(!dotnet) error(err);

print("正在编译"); //无头自动化环境可省略
dotnet.workDir = "/build-dotnet-demo";
string.saveFiles(dotnet.workDir,{
    "Hello.csproj" = /***
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup><TargetFramework>net8.0</TargetFramework></PropertyGroup>
</Project>
***/;
    "Hello.cs" = /***
public static class Hello { 
    public static int Add(int a,int b) => a+b; 
}
***/;
});

/*
命令行参数支持多种写法，与 process/process.popen 相同：
STARTUPINFO 只放在第 2 个用户参数，不从多个参数的末尾提取表。
dotnet("build Hello.csproj -c Release",{workDir="/build-dotnet-demo"}); //临时覆盖目录
dotnet("build","Hello.csproj","-c","Release"); //多个字符串由 aardio 负责命令行转义与拼接
dotnet(["build","Hello.csproj","-c","Release"]); //数组由 aardio 负责命令行转义与拼接
dotnet(["build","Hello.csproj","-c","Release"],{workDir="/build-dotnet-demo"});
*/
var pipe,err = dotnet("build Hello.csproj -c Release");
if(!pipe) error(err);

var output,stderr,exitCode = pipe.readAll();
if(exitCode!=0) error(output);

var dll = io.joinpath(dotnet.workDir,"bin/Release/net8.0/Hello.dll");
print(dll);

安装使用微软官方脚本，默认目录为 %LOCALAPPDATA%\Microsoft\dotnet，无需管理员权限，不改系统 SDK/PATH。 首次安装、还原参考包需要联网；复用已安装 SDK 不联网。显式 latest 首次查询在线发布索引。 构建的完整错误可能在 stdout；以 readAll() 的第 3 个返回值 exitCode==0 判断构建进程成功，不能仅检查 stderr 或旧 DLL 是否存在。