Fantasy框架（服务器快速启动）

Fantasy文档https://github.com/qq362946/Fantasy/tree/main/Docs

第一步 创建项目

推荐使用Rider

1.创建空解决方案

2.创建项目

先创建一个控制台

然后创建两个类库 分别是Entity 和Hotfix

现在整个项目就是这样

从文件夹看是这样的

现在基本项目就创建好了，接下来该引用Fantasy框架了

第二步 引用Fantasy

我使用下载源码的方式 文档里还有NuGet 包方式 Fantasy文档https://github.com/qq362946/Fantasy/tree/main/Docs

1.下载源码

GitHubhttps://github.com/qq362946/FantasyGiteehttps://gitee.com/Sining/Fantasy

下载解压后是这样的

2.新建一个文件夹，放Fantasy相关的文件

把源码中的这些文件拷贝过来

就像这样

3.引用

回到我们创建的项目

添加项目

选择Fantasy.Net.csproj

继续添加

选择 Fantasy.SourceGenerator.csproj

接下来我们给Entity 添加引用

选择这两个

添加Hotfix的引用

添加Main的引用

4.拷贝配置文件

把这两个文件拷贝到Entity下面

5.修改Entity.csproj

打开不出所料应该是这样的

接下来拷贝这个添加到Entity.csproj中

<!– Debug 配置 –>
<PropertyGroup Condition=" '$(Configuration)' == 'Debug' ">
<!– FANTASY_NET 宏：激活 Source Generator 代码生成 –>
<DefineConstants>TRACE;FANTASY_NET</DefineConstants>
<!– AllowUnsafeBlocks：允许 unsafe 代码 –>
<AllowUnsafeBlocks>true</AllowUnsafeBlocks>
</PropertyGroup>

<!– Release 配置 –>
<PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
<DefineConstants>TRACE;FANTASY_NET</DefineConstants>
<AllowUnsafeBlocks>true</AllowUnsafeBlocks>
</PropertyGroup>

然后把这个替换一下

修改框住的替换为下面的

<ProjectReference Include="..\\..\\Fantasy\\Fantasy.Net\\Fantasy.SourceGenerator\\Fantasy.SourceGenerator.csproj"
OutputItemType="Analyzer"
ReferenceOutputAssembly="false"/>

完成之后整个文件是这样的

下面提供完整的

<Project Sdk="Microsoft.NET.Sdk">

<PropertyGroup>
<TargetFramework>net9.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>

<PropertyGroup Condition=" '$(Configuration)' == 'Debug' ">
<DefineConstants>TRACE;FANTASY_NET</DefineConstants>
</PropertyGroup>

<PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
<DefineConstants>TRACE;FANTASY_NET</DefineConstants>
</PropertyGroup>

<ItemGroup>
<ProjectReference Include="..\\..\\Fantasy\\Fantasy.Net\\Fantasy.Net\\Fantasy.Net.csproj"/>
<ProjectReference Include="..\\..\\Fantasy\\Fantasy.Net\\Fantasy.SourceGenerator\\Fantasy.SourceGenerator.csproj"
OutputItemType="Analyzer"
ReferenceOutputAssembly="false"/>
</ItemGroup>

<ItemGroup>
<None Update="Fantasy.config">
<Pack>true</Pack>
<PackagePath>build;buildTransitive</PackagePath>
</None>
<None Update="Fantasy.xsd">
<Pack>true</Pack>
<PackagePath>build;buildTransitive</PackagePath>
</None>
</ItemGroup>

</Project>

引用Fantasy就完成了

第三步 编写启动代码和程序集加载辅助类

1.添加程序集加载辅助类

添加一个名为     AssemblyHelper    类   

AssemblyHelper

接下来提供完整代码

using System.Runtime.Loader;
using Fantasy.Generated;
using Fantasy.Helper;

namespace Fantasy
{
public static class AssemblyHelper
{
private const string HotfixDll = "Hotfix";
private static AssemblyLoadContext? _assemblyLoadContext = null;

public static void Initialize()
{
LoadEntityAssembly();
LoadHotfixAssembly();
}

private static void LoadEntityAssembly()
{
// .NET 运行时采用延迟加载机制，如果代码中不使用程序集的类型，程序集不会被加载
// 执行一下，触发运行时强制加载从而自动注册到框架中
// 因为AssemblyHelper代码在Entity项目里，所以需要获取这个项目的Assembly
// 然后调用EnsureLoaded方法强制加载一下
typeof(AssemblyHelper).Assembly.EnsureLoaded();
}

public static System.Reflection.Assembly LoadHotfixAssembly()
{
if (_assemblyLoadContext != null)
{
_assemblyLoadContext.Unload();
System.GC.Collect();
}

_assemblyLoadContext = new AssemblyLoadContext(HotfixDll, true);
var dllBytes = File.ReadAllBytes(Path.Combine(AppContext.BaseDirectory, $"{HotfixDll}.dll"));
var pdbBytes = File.ReadAllBytes(Path.Combine(AppContext.BaseDirectory, $"{HotfixDll}.pdb"));
var assembly = _assemblyLoadContext.LoadFromStream(new MemoryStream(dllBytes), new MemoryStream(pdbBytes));
// 强制触发 ModuleInitializer 执行
// AssemblyLoadContext.LoadFromStream 只加载程序集到内存，不会自动触发 ModuleInitializer
// 必须访问程序集中的类型才能触发初始化，这里通过反射调用生成的 AssemblyMarker
// 注意：此方法仅用于热重载场景（JIT），Native AOT 不支持动态加载
// 拿到Assembly就用EnsureLoaded()方法强制触发
assembly.EnsureLoaded();
return assembly;
}
}
}

2.编写启动代码

复制这段代码就行了

using Fantasy;

try
{
// 1. 初始化程序集（触发 Source Generator 生成的代码）
AssemblyHelper.Initialize();

// 日志实例
var logger = new ConsoleLog();

// 2. 启动 Fantasy 框架
await Fantasy.Platform.Net.Entry.Start(logger);
}
catch (Exception ex)
{
Console.Error.WriteLine($"服务器启动失败：{ex}");
Environment.Exit(1);
}

最后就像这样

第四步  编写启动命令

就像这样

添加参数

下面提供完整的可以直接复制粘贴覆盖

{
"$schema": "http://json.schemastore.org/launchsettings.json",
"profiles": {
"Main": {
"commandName": "Project",
"environmentVariables": {},
"commandLineArgs": "–m Develop"
}
}
}

最后

删除无用文件

接下来设置启动配置文件

去掉这个无用的启动配置

最后留下的就是这样

现在就可以启动了

启动完成

恭喜你成功启动Fantasy 2.0

如果有下面这个报错就是   Entity下面的Class1没有删除

本文只是初步启动，也没有讲解原理，详细过程可以去看框架具体文档，非常清晰

GitHubhttps://github.com/qq362946/FantasyGiteehttps://gitee.com/Sining/Fantasy

作者更新了目录，你们跟着操作的时候可能目录稍微有些不同，需要自行修改，但是总体基本不变。我就不做修改了

Fantasy框架作者太给力了，又更新了超级简单的创建项目方式，这篇没有操作成功也没关系，下篇是超级简单版的安装，只需2分钟搞定

Fantasy框架快速安装（脚手架安装）|超级简单|超级快速-CSDN博客