首页
/ MagicOnion项目迁移至Source Generator模式的技术指南

MagicOnion项目迁移至Source Generator模式的技术指南

2025-06-16 22:33:39作者:房伟宁

MagicOnion作为一款基于gRPC的C#通信框架,近期从传统的moc.exe代码生成工具迁移到了Source Generator模式。这一变化带来了更现代化的开发体验,但也让部分用户在迁移过程中遇到了困惑。本文将详细介绍如何从旧版MagicOnion迁移到新版Source Generator架构。

项目结构重构

在旧版MagicOnion中,典型的项目结构包含三个部分:Server、Client和Shared。Shared项目存放服务接口定义和DTO对象,通过moc.exe工具生成客户端代理代码。

新版架构中,Shared项目的角色依然重要,但配置方式发生了变化:

  1. 创建一个独立的类库项目作为Shared项目
  2. 在该项目中定义服务接口和DTO
  3. 确保所有项目都引用了MagicOnion.Client.SourceGenerator包

依赖配置

迁移过程中需要特别注意NuGet包的引用:

  • 服务端项目:引用MagicOnion.AspNetCore和MessagePack
  • 客户端项目:引用MagicOnion.Client和MessagePack
  • Shared项目:引用MagicOnion.Abstractions和MessagePack

服务接口定义

服务接口定义方式基本保持不变,但不再需要moc.exe工具生成代码。例如:

using MagicOnion;
using MessagePack;

public interface IHealthCheck : IService<IHealthCheck>
{
    UnaryResult<bool> IsHealthy();
}

Source Generator配置

新版MagicOnion使用Source Generator自动生成客户端代码,无需手动运行工具。只需在客户端项目中:

  1. 添加MagicOnion.Client.SourceGenerator包引用
  2. 在需要生成客户端代码的地方添加[MagicOnionClientGeneration]特性
[MagicOnionClientGeneration(typeof(IHealthCheck))]
public partial class MagicOnionGeneratedClient {}

Unity项目集成

对于Unity项目,需要特别注意:

  1. 确保Unity支持C# 9.0或更高版本
  2. 将MagicOnion.Client.SourceGenerator.dll放入Assets/Plugins目录
  3. 在Unity中创建Shared程序集定义,包含服务接口

常见问题解决

  1. MagicOnionClientGeneration未找到:确保正确引用了MagicOnion.Client.SourceGenerator包
  2. 代码未生成:检查项目是否启用了Roslyn分析器
  3. 序列化问题:确保DTO类都添加了[MessagePackObject]特性

性能优化建议

Source Generator模式相比旧版有以下优势:

  1. 编译时生成代码,无需额外构建步骤
  2. 更好的IDE集成和代码导航
  3. 更快的开发迭代速度

迁移完成后,开发者将获得更流畅的开发体验,同时保持原有的高性能通信能力。通过合理规划项目结构和正确配置依赖,可以顺利完成从传统代码生成工具到Source Generator的过渡。

登录后查看全文
热门项目推荐

项目优选

收起
kernelkernel
deepin linux kernel
C
22
6
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
163
2.05 K
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
8
0
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
60
16
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
199
279
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
951
557
ShopXO开源商城ShopXO开源商城
🔥🔥🔥ShopXO企业级免费开源商城系统,可视化DIY拖拽装修、包含PC、H5、多端小程序(微信+支付宝+百度+头条&抖音+QQ+快手)、APP、多仓库、多商户、多门店、IM客服、进销存,遵循MIT开源协议发布、基于ThinkPHP8框架研发
JavaScript
96
15
apintoapinto
基于golang开发的网关。具有各种插件,可以自行扩展,即插即用。此外,它可以快速帮助企业管理API服务,提高API服务的稳定性和安全性。
Go
22
0
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Python
77
70
giteagitea
喝着茶写代码!最易用的自托管一站式代码托管平台,包含Git托管,代码审查,团队协作,软件包和CI/CD。
Go
17
0