官方的中文化教程
目前僅提供了.NET5 在地化 IntelliSense 檔
IntelliSenseLocalizer
用於生成和安裝在地化IntelliSense檔的工具。
簡介
在
.net6
之前，我們可以在這個頁面 -
Download localized .NET IntelliSense files
下載在地化的智慧感知檔。但
.net6
釋出很長一段時間後，這個頁面也沒有添加
.net6
的在地化的智慧感知檔。根據
dotnet/docs
中的這個
issue
，裏面說不再提供在地化智慧感知檔了 - "
Yes, unfortunately, we will no longer be localizing IntelliSense.
"。但是
線上文件
裏面還有在地化描述。所以有了這個工具。
IntelliSenseLocalizer
使用
線上文件
生成在地化智慧感知檔。工具會下載所有的api頁面並分析頁面以匹配原始的智慧感知檔，然後生成目標
xml
。
得益於
線上文件
良好的在地化和統一的頁面布局。這個工具理論上可以生成所有區域的智慧感知檔。但是
如果頁面布局變動了，這個工具無法自動的適配新的布局
。
如何使用
1. 安裝本工具
dotnet tool install -g islocalizer
執行
islocalizer -h
可以看到更多的命令和幫助資訊.
在命令最後加上參數 -h 即可檢視命令的幫助，例如：
islocalizer install auto -h
islocalizer cache -h
2. 嘗試從nuget.org安裝已生成好的智慧感知檔
檢視可用的包 Nuget
這個命令將嘗試從nuget.org找到並安裝
zh-cn
的
net6.0
智慧感知包:
islocalizer install auto -m net6.0 -l zh-cn
你也可以使用
-cc
來指定內容雙語對照型別
islocalizer install auto -m net6.0 -l zh-cn -cc LocaleFirst
3. 自己構建在地化智慧感知檔
構建
net6.0
相關的檔:
islocalizer build -m net6.0
這個命令可能會執行很久。。。不過緩存完檔後，第二次生成會快很多。生成的壓縮包將會存放到預設輸出目錄，可以在控制台輸出中找到路徑。
4. 安裝生成的智慧感知檔
islocalizer install {ArchivePackagePath}
ArchivePackagePath
是build命令輸出的路徑.
Net9目前還是預覽版，暫時不支持，敬請更新
