.NET 6,7,8 本地化的 IntelliSense 文件
内容提要
该文章介绍了一个名为IntelliSenseLocalizer的工具,用于生成和安装本地化的智能感知文件。该工具通过下载和分析在线文档中的API页面,生成目标XML文件。使用该工具可以安装已生成好的智能感知文件,也可以自己构建本地化智能感知文件。该工具适用于.NET5及以下版本,不支持.NET6及以上版本。
延伸解读
工具诞生的背景与必要性
微软官方在.NET 6发布后不再提供本地化的IntelliSense文件,但在线文档中仍保留本地化描述。IntelliSenseLocalizer通过抓取在线文档的API页面,分析并匹配原始智能感知文件,生成目标XML,从而填补官方支持的空白。这为需要中文智能感知的开发者提供了一种替代方案。
使用方式与灵活性
用户可以通过dotnet tool安装该工具,并利用命令行参数灵活操作。既可以从nuget.org安装已生成的智能感知包,也可以自行构建。构建时支持指定目标框架和语言,还能通过-cc参数设置双语对照类型,满足不同开发习惯。
潜在限制与注意事项
该工具依赖在线文档的页面布局,一旦布局变动可能无法自动适配,需要人工调整。此外,它仅适用于.NET 5及以下版本,不支持.NET 6及以上,且Net9预览版暂不支持。构建过程可能耗时较长,但缓存后再次生成会加快。
Q&A
IntelliSenseLocalizer是什么工具?
IntelliSenseLocalizer是一个用于生成和安装本地化智能感知文件的工具。
如何安装IntelliSenseLocalizer?
可以通过命令行运行命令'dotnet tool install -g islocalizer'来安装该工具。
IntelliSenseLocalizer支持哪些.NET版本?
IntelliSenseLocalizer适用于.NET5及以下版本,不支持.NET6及以上版本。
如何从nuget.org安装已生成的智能感知文件?
可以使用命令'islocalizer install auto -m net6.0 -l zh-cn'来尝试从nuget.org安装zh-cn的net6.0智能感知包。
如何自己构建本地化智能感知文件?
可以使用命令'islocalizer build -m net6.0'来构建相关的本地化智能感知文件。
IntelliSenseLocalizer的生成过程有什么限制?
如果在线文档的页面布局发生变化,IntelliSenseLocalizer可能无法自动适配新的布局。