SQLitePCLRaw代码生成内幕：T4模板如何一键生成Provider代码
【免费下载链接】SQLitePCL.rawA Portable Class Library (PCL) for low-level (raw) access to SQLite项目地址: https://gitcode.com/gh_mirrors/sq/SQLitePCL.raw
SQLitePCLRaw 是 .NET 生态中最流行的 SQLite 底层（raw）访问库，但它仓库里 7 个 Provider 的源码并非手写，而是由一份 T4 模板一键生成。本文带你揭开 SQLitePCLRaw 代码生成的完整流水线：8 个模板参数、一段 F# 编排脚本，如何自动产出 16 份不同配置的 Provider 源文件。
为什么 Provider 要"生成"而不是手写
Provider 是 SQLitePCLRaw 的核心概念：它是 isqlite3.cs 中ISQLite3Provider接口的实现，负责把 C# 调用桥接到某一实例的原生 SQLite 库。仓库中并列存在 7 种 Provider：
e_sqlite3—— 项目官方构建的加密版 SQLitesqlite3—— 系统自带的 SQLite（如 iOS）sqlcipher—— Zetetic 的 SQLCipher 加密库winsqlite3—— Windows 系统库dynamic_cdecl/dynamic_stdcall—— 运行时动态加载internal—— 编译进程序集内部
每份 Provider 都要为上百个 SQLite C API 生成 P/Invoke 或函数指针声明。如果手写，7 份近似拷贝极易不同步；用 provider.tt 这份 T4 模板，一次修改即可全量同步——这正是"代码生成"要解决的隐藏成本。
模板核心：provider.tt 的 8 个参数
provider.tt 是标准 T4 模板（输出.cs），通过参数区声明 8 个开关，决定生成物的形态：
| 参数 | 作用 | 典型取值 |
|---|---|---|
NAME | Provider 名（类名后缀） | e_sqlite3 |
CONV | 调用约定 CallingConvention | Cdecl/StdCall |
KIND | 绑定方式：动态加载还是 DllImport | dynamic/dllimport |
NAME_FOR_DLLIMPORT | DllImport 使用的原生库名 | __Internal |
FEATURE_FUNCPTRS | 回调机制：C# 委托还是 .NET 5+ 函数指针 | false/callingconv |
FEATURE_WIN32DIR | 是否生成sqlite3_win32_set_directory | true/false |
FEATURE_KEY | 是否支持sqlite3_key加密 API | true/false |
FEATURE_LOADEXTENSION | 是否支持load_extension | true/false |
模板内部还嵌入了一组 C# 辅助函数（如get_cb_type、get_cb_delegate_field），根据FEATURE_FUNCPTRS的取值，自动在"MonoPInvokeCallback + 委托桥"与"UnmanagedCallersOnly + 函数指针"两套回调实现之间切换——这就是同一份模板能覆盖 .NET Framework 4.x 到 .NET 8 全部版本的关键。
F# 编排脚本：一键产出 16 份文件
真正"一键"的角色是 gen_providers/Program.fs 这个 F# 可执行程序，它借助 exec.fs 封装的进程调用工具，把参数拼成t4命令行并逐个执行：
t4 -o src/.../Generated/provider_xxx.cs -p:NAME=... -p:CONV=Cdecl -p:KIND=dllimport ... provider.tt调用矩阵如下：
| Provider | 子变体 | 数量 |
|---|---|---|
| dynamic_cdecl / dynamic_stdcall | 各 1 份 | 2 |
| internal / winsqlite3 | 各 1 份 | 2 |
| e_sqlite3 / sqlite3 / sqlcipher | 每个 4 份（prenet5_win、prenet5_notwin、funcptrs_win、funcptrs_notwin） | 12 |
子变体的命名揭示了"双维度矩阵"思路：行按 .NET 版本分（prenet5走委托回调，funcptrs走函数指针），列按平台分（win含 Win32 专用 API，notwin不含）。各 Provider 的 csproj 再把子文件映射到对应的 TargetFramework 实现多目标编译。生成产物示例：provider_e_sqlite3_funcptrs_win.cs、provider_dynamic_cdecl.cs。
手动运行 t4 模板：完整命令步骤
想亲手试一次？providers/README.TXT 记录了可直接运行的命令：
t4 -o tmp.cs -p:NAME=tmp -p:CONV=Cdecl -p:KIND=dynamic provider.tt前置条件（见 README.md 的构建说明）：
- 安装 .NET SDK
- 安装 T4 CLI 工具：
dotnet tool install --global dotnet-t4（模板项目 tool.csproj 也引用了dotnet-t4-project-tool） - 在
src/providers目录下执行上述命令，即可得到一份临时 Provider 源码
生成物如何落盘与分发
每个 Provider 包都有一个Generated目录存放生成物，例如src/SQLitePCLRaw.provider.e_sqlite3/Generated/下的 4 个文件正是上面矩阵中 e_sqlite3 的 4 个子变体。这些文件只依赖 SQLitePCLRaw.core 的接口与工具类（如 utf8z.cs），最终随SQLitePCLRaw.provider.*NuGet 包分发给用户，运行时无需感知代码生成的存在。
小结：模板化代码生成的三重收益
- 一致性：新增一个 SQLite API 只需改模板或函数表，16 份文件全量同步，杜绝手写漂移
- 配置化：8 个 FEATURE 参数代替条件编译，任何组合都能精确裁剪功能（如
sqlite3禁用 KEY、sqlcipher启用 KEY） - 多目标：同一接口在 .NET Framework 与 .NET 5+、Windows 与其他平台间无缝适配
下次当你调用SQLitePCL.raw.SetProvider(...)时，不妨回味一下：这份"薄得像 C"的 raw 桥接层背后，是一条优雅的 T4 模板 + F# 脚本自动化流水线。
【免费下载链接】SQLitePCL.rawA Portable Class Library (PCL) for low-level (raw) access to SQLite项目地址: https://gitcode.com/gh_mirrors/sq/SQLitePCL.raw
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
