多目标框架
从单个项目为多个目标框架构建一个库；使用条件编译和回退垫片处理 API 差异。
多目标框架 是 CoddyKit 上的免费 C# Academy 课时。 这是第 3 节课，共 3 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 3 节课。
概念与优势
目标：发布一个可在多个平台上运行的程序包。
- 单个项目生成多个二进制文件
- 使用者会自动获得最适合的程序集
- API 存在差异时，使用较小的 #if 保护块
资产选择基础
- 程序包包含按目标划分的文件夹（例如 lib/net45、lib/netstandard2.0）
- NuGet 会选择最接近且兼容的资产
- 保持公共 API 一致；只有内部代码可以不同
条件编译示例
使用较小的 #if 代码块来改变实现。保持公共方法签名完全一致。
#define NET45 // simulate building for different targets
// #define NETSTANDARD2_0
using System;
public class Program
{
public static void Main(string[] args)
{
Console.WriteLine("Target: " + TargetName());
}
// Public API: stays the same across targets
public static string TargetName()
{
#if NET45
return "net45 build";
#elif NETSTANDARD2_0
return "netstandard2.0 build";
#else
return "unknown target";
#endif
}
}
稳定的 API，内部适配层
保持相同的公共 API；通过较小的适配层隐藏差异，让调用方无需关心使用的是哪个目标。
#define NET45
using System;
using System.IO;
public class Program
{
// Public API is stable; internal implementation differs.
public static string ReadAllTextCompat(string path)
{
#if NET45
// net45 has File.ReadAllText; use it directly.
return File.ReadAllText(path);
#else
// Example shim path (for an older TF that lacks some helper API)
using (var fs = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read))
using (var sr = new StreamReader(fs))
{
return sr.ReadToEnd();
}
#endif
}
public static void Main(string[] args)
{
// For demo, write then read
string p = "demo.txt";
File.WriteAllText(p, "hello");
Console.WriteLine(ReadAllTextCompat(p));
}
}
设置提示
- 在项目中使用 TargetFrameworks（复数）列出目标
- 将 #if 限制在很小的辅助方法中；大部分代码保持共享
- 测试每个目标；针对每个 TFM 运行单元测试
- 发布一个包含所有目标资产的程序包
常见陷阱
- 不要为每个目标公开不同的公共 API
- 避免深层嵌套的 #if；使用较小的适配层
- 留意隐式行为差异（路径、编码）
- 记录任何特定于目标的限制
为什么要支持多目标
回顾
回顾：多目标支持可以从一个项目生成多个二进制文件。保持公共 API 一致，通过微小的 #if 适配层隐藏差异，并将所有目标一起打包。
常见问题解答
「多目标框架」课时是免费的吗？
是的 — 「多目标框架」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 3 节课。
「多目标框架」这节课中我会学到什么？
从单个项目为多个目标框架构建一个库；使用条件编译和回退垫片处理 API 差异。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 C# Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 3 节。
「多目标框架」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 C# Academy 课中编写并运行代码吗？
能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。