nanoclr 1.0.637

.NET nanoFramework nanoCLR

此 .NET Core 工具 允许在 Windows 机器上运行 nanoCLR。这对于开发目的的虚拟设备，在管道或其他环境中执行自动化测试以及其他从虚拟设备中受益的用途很有用。虚拟设备可以通过虚拟串行端口、命名管道或 TCP/IP 端口访问，就像真正的设备一样。

是 .NET nanoFramework 工具箱的一部分，同时还包含其他在 .NET nanoFramework 开发、使用或存储库管理中所需的工具。

安装 .NET nanoFramework nanoCLR

使用以下 .NET Core CLI 命令一次性安装 .NET nanoFramework nanoCLR 工具

dotnet tool install -g nanoclr

安装成功后，会显示一条消息，显示用于调用该工具的命令以及安装的版本。类似于以下示例

You can invoke the tool using the following command: nanoff
Tool 'nanoclr' (version '9.9.9') was successfully installed.

更新 .NET nanoFramework nanoCLR

要更新 .NET nanoFramework nanoCLR 工具，请使用以下 .NET Core CLI 命令

dotnet tool update -g nanoclr

用法

工具安装后，您可以通过其命令 nanoclr 调用它，这是名称的简写，以方便输入。

nanoclr [command] [args]

该工具包含所有可用命令的帮助。您可以通过输入以下内容查看所有可用命令的列表

nanoclr --help

虚拟串行端口

此动词允许管理暴露虚拟设备的虚拟串行端口。虚拟串行端口只能在 Windows 机器上使用。它是由 HHD Software 赞助的，该软件公司慷慨地赞助了一个免费许可证，以便运行他们的工具。

列出虚拟串行端口

此命令列出系统中安装的虚拟串行端口网桥。

nanoclr virtualserial --list

创建虚拟串行端口

此命令创建一个虚拟串行端口，将用于暴露 nanoCLR 实例。将创建一个随机的 COM 端口。可以作为选项指定 COM 端口。在这种情况下，如果该 COM 端口未在使用中，则将其创建。

nanoclr virtualserial --create [COM99]

删除虚拟串行端口

此命令删除现有虚拟串行端口。

nanoclr virtualserial --remove [COM99]

安装虚拟串行端口工具

此命令安装HHD 软件公司的虚拟串行端口工具软件。安装程序将从其网站下载并执行。执行安装程序需要“安装驱动程序”权限，并且必须提升权限。如果运行此进程的进程没有所需的权限，将显示用户帐户控制(UAC)提示。

nanoclr virtualserial --install

运行虚拟nanoCLR

这些选项运行nanoCRL实例，加载指定的程序集并在指定的接口上公开设备。请注意，为了成功运行nanoCLR实例，需要加载一组程序集并且指定一个接口来公开它，否则就没有用了。

加载一组程序集

这将加载一组.NET nanoFramework程序集并运行nanoCLR。它们必须是.NET nanoFramework PE（可移植可执行文件）格式。它们位于Visual Studio项目的输出文件夹中（通常是bin\Debug或bin\Release）。需要提供PE文件的完整路径。

nanoclr run --assemblies "C:\nano\my_nice_project\bin\Debug\mscorlib.pe" "C:\nano\my_nice_project\bin\Debug\my_nice_project.pe"

指定串行端口

此选项指定将要用于公开要在其上运行的虚拟nanoCLR的COM端口。它需要提前设置一个虚拟串行端口（参见创建虚拟串行端口）。

nanoclr run --serialport COM99  (--assemblies ...)

指定命名管道

此选项指定一个命名管道，该管道将用于公开要在其上运行的虚拟nanoCLR。

nanoclr run --namedpipe MyNanoDevice  (--assemblies ...)

解决引用

此选项尝试解决加载的程序集之间的跨程序集引用。

nanoclr run --resolve (--assemblies ...)

控制调试器连接的选项

有两个选项可以控制nanoCLR执行如何与调试器交互。如果打算在程序终止并退出执行后连接调试器，则应包含选项--loopafterexit。如果预计nanoCLR启动后立即连接到它，则应包含选项--waitfordebugger。

对nanoCLR的维护操作

实际上，nanoCLR是一个包装器，将nanoCLR实例作为DLL分发，以便可以轻松更新。以下操作可用于管理此操作。

nanoCLR版本

获取当前nanoCLR实例的版本。

nanoclr instance --getversion

更新nanoCLR实例

检查nanoCLR的稳定版本，并根据需要更新它。可以指定版本。要检查预览版本，请添加选项--preview。

nanoclr instance --update [--preview] [--clrversion 1.22.333.4444]

卸载.NET nanoFramework nanoCLR

要卸载.NET nanoFramework nanoCLR工具，请使用以下.NET Core CLI命令

dotnet tool uninstall -g nanoclr