📦 安装

前置条件

• .NET 8.0 SDK 或更高版本（也支持 .NET 9.0 和 .NET 10.0）
• .NET 支持的任何平台：Windows、Linux、macOS

检查您的 .NET 版本：

dotnet --version

通过 NuGet 安装

Snet 包发布在 NuGet.org 上。仅安装您需要的协议包。

核心协议

dotnet add package Snet.Siemens

dotnet add package Snet.Modbus

dotnet add package Snet.Mitsubishi

dotnet add package Snet.Omron

dotnet add package Snet.Opc

消息中间件

dotnet add package Snet.Mqtt

dotnet add package Snet.Kafka

dotnet add package Snet.RabbitMQ

dotnet add package Snet.NetMQ

dotnet add package Snet.Netty

一次性添加多个包

dotnet add package Snet.Modbus && dotnet add package Snet.Mqtt

传递依赖

每个 Snet 协议包会自动引入：

依赖	用途
Snet.Core	DaqAbstract、CoreUnify、通信、缓存、通道
Snet.Model	接口、OperateResult、Address、枚举
Snet.Utility	扩展方法、JSON 辅助工具、反射工具
Snet.Driver.Core	驱动级类型（DataFormat、EncodingType）

您无需单独安装这些包。它们会作为传递依赖自动解析。

警告： 不要在 Snet 包之间混用不同的大版本号。项目中所有包应使用相同的版本号。混用版本可能导致 MissingMethodException 或类型冲突。

包引用示例

安装后，您的 .csproj 文件将如下所示：

<ItemGroup>
  <PackageReference Include="Snet.Modbus" Version="1.0.0" />
</ItemGroup>

验证安装

创建一个最简控制台应用来验证一切都能正常解析：

using Snet.Modbus;

var basics = new ModbusData.Basics
{
    IpAddress = "127.0.0.1",
    ProtocolType = ModbusData.ProtocolType.ModbusTcpNet
};

var operate = await ModbusOperate.InstanceAsync(basics);
Console.WriteLine("Snet.Modbus loaded successfully.");

构建并运行：

dotnet run

没有运行时错误即表示安装正确。