Skip to content

快速开始

本页描述了如何在不同类型的项目中快速安装Nino

下载安装

.NET 项目

INFO

Nino支持.NET 5.0 及以上版本的项目,或.NET Standard 2.0 及以上版本的项目

  • Nino支持通过NuGet包管理器进行安装,可以在Visual Studio或Rider中在NuGet管理中搜索Nino并安装
  • 除此之外,也可以使用命令行工具dotnet进行安装:
    shell
    dotnet add package Nino

INFO

Nino需要安装两个NuGet包:Nino.GeneratorNino.Serialization,二者缺一不可

直接在NuGet管理器中安装Nino会自动安装这两个包

WARNING

请注意,此方法不支持.NET Framework项目,同时不支持无法使用Source Generator的IDE(如Visual Studio Code)

Unity 项目

INFO

Nino支持Unity 2022.3 及以上版本的项目,支持在任意平台发布

建议先运行GitHub上的Nino.Unity示例项目,以了解如何在Unity中使用Nino,示例项目还包含一套单元测试(通过TestRunner实现)

Nino可以通过Unity Package Manager(UPM)安装到Unity中,请参考这个链接获取更多信息

INFO

默认情况下,Unity 2022.3 及以上版本应该已经安装了Microsoft.CodeAnalysis,如果没有,请手动安装

我们需要安装Microsoft.CodeAnalysis NuGet包(最新版本即可)以支持Unity内的Source Generator

这个NuGet包可以在Unity项目内安装,例如进入Unity目录(Assets同级目录)后执行dotnet add package Microsoft.CodeAnalysis.CSharp --version 4.10.0

WARNING

如果使用asmdef,请确保已经开启自动引用,或在使用覆盖引用时,需要显式添加对Nino.Core.dll的引用

TIP

遇到问题请先确保已经按照上述步骤操作,同时能够正常运行Nino.Unity示例项目,如果问题依然存在,请在GitHub上提交Issue

代码热更

  • Nino支持HybridCLRILRuntime
  • 如果需要另外在外部创建一个C#工程(不是Unity内的asmdef)来编写热更代码,请创建.NET Core工程并通过NuGet安装Nino库(参考这里),再将编译出来的DLL在HybridCLR或ILRuntime中使用

注意事项

请勿使用Nino v3.9.*版本,该版本主要是实验将在Nino v4.0发布的功能,与3.*版本的API不兼容,如需使用请直接使用Nino v4.0版本