2022年11月6日
背景
事情的起因是，想找個跨 Windows 和 Mac 的構建方案。第一考慮自然是 CMake，畢竟基本上是事實標準了。
但是研究了一下 Modern CMake，也就是以 target 為核心的理念。但發現看了好幾天文檔，也折騰出了可用的東西，但仍然是沒梳理清楚什么理念、原理。然后 CMake 本身語法就很復雜，再加上搞 target 一套概念，要給 target 設置各種屬性之類的，有點強行 OOP 的感覺……但其實我們只是需要一個 include_dir 和 lib_dir 而已，其他都是浮云~
但如果退回到傳統模式，不用 Modern 概念呢，好像可以將就，但第一不去用一個工具的最新模式，好像有點不上進的感覺（python 2 除外）；第二，CMake 的兩大痛點——語法特立獨行、文檔晦澀難懂——還是讓人有點不爽。
那跳出來看別的選擇呢？目前相對成熟的也只有 Google 的 gn+ninja 方案了。gn 這套東西在 Chromium 里是完全配置好的，用起來還算順手，但要是獨立拿出來呢，就沒那么便宜了。關鍵是它的 toolchain 是要自己定義的。
之前還在公司搞客戶端的時候，大家就從 Chromium 里面把 build、build_overrides 等等東西全部拷出來，好家伙，幾百 MB 甚至上 G。但是公司里嘛，沒人管干不干凈，怎么快怎么來。后來又看到 Google 自家的 Crashpad 里面也用了這套構建，但工具鏈被簡化了一下，叫 mini_chromium。這個比 Chromium 里的小多了，是可以拿過來直接用的，缺少一些配置可以自己加。但是呢，像我們這種潔癖，仍然是受不鳥的。所以呢，我們要干干凈凈的建立一套工具鏈。
構建系統安裝
首先，我們明確定位。gn 和 ninja 都是開發機上需要預裝的，不是軟件提供的。Chromium 的搞法是自己提供，gn 的文檔也說讓開發者提供工具。但這套思路跟傳統的理念是沖突的。同時，自己安裝工具成本是比較低的：
- linux
- ninja 在主流包管理系統里已經有了，包名可能是 ninja 或 ninja-build，直接安裝就可以
- gn 在部分包管理系統有，嘗試包名 gn 或 gn-build 等，沒有的話可以下載二進制版本，或者從源代碼自行編譯
- mac
- ninja 在 brew 里包名叫 ninja，在 MacPorts 里包名叫 ninja-build
- gn 在 brew 里沒有，可以下載二進制版本；在 MacPorts 里叫 gn-devel
- win
自己下載的設置到 PATH，測試 gn --version 以及 ninja --version，能運行即可
目標
希望做到提供一個 git repo，使用者 clone 到自己項目的 build 目錄，然后使用者只要在 .gn 文件里配置
buildconfig = "//build/BUILDCONFIG.gn"
就可以使用我們提供的工具鏈，在 PC 三端進行構建。
使用者的唯一負擔就是編寫自己的 BUILD.gn
工具鏈搭建
首先我們看 gn 的文檔，以及它的例程 simple_build 里的工具鏈配置：
https://gn.googlesource.com/gn/+/HEAD/examples/simple_build/build/toolchain/BUILD.gn
這個是可以直接用的，只不過只有 linux 端（當然 mac 也能用）。我們再結合 chrome 里的工具鏈配置，進行一些完善。
基礎概念
首先我們了解 gn 體系需要的最小配置是什么。
第一，它需要在根目錄寫一個 .gn 文件，在里面定義 buildconfig，指到另一個文件，一般是
buildconfig = "//build/BUILDCONFIG.gn"
第二、BUILDCONFIG.gn 里面需要設置默認工具鏈，也就是寫一行
set_default_toolchain("//build/toolchain:gcc")
第三、定義工具鏈，如上例的 //build/toolchain:gcc。
需要在 build/toolchain 下建立 BUILD.gn 文件，內容是
toolchain("gcc") {
# ...
}
最后在 toolchain 里定義各種 tool。
工具鏈中的工具
這部分文檔在這里：https://gn.googlesource.com/gn/+/main/docs/reference.md#func_tool
簡單復述一下，可被定義的工具有：
- 編譯工具:
"cc": C 編譯器
"cxx": C++ 編譯器
"cxx_module": 支持 module 的 C++ 編譯器
"objc": Objective C 編譯器
"objcxx": Objective C++ 編譯器
"rc": Windows 資源腳本編譯器
"asm": 匯編器
"swift": Swift 編譯器
- 鏈接工具:
"alink": 靜態庫鏈接器
"solink": 動態庫鏈接器
"link": 可執行文件鏈接器
（其他的就先不看了）
我們來看一下 https://gn.googlesource.com/gn/+/HEAD/examples/simple_build/build/toolchain/BUILD.gn 的一些關鍵配置：
toolchain("gcc") {
tool("cc") {
command = "gcc -MMD -MF $depfile {{defines}} {{include_dirs}} {{cflags}} {{cflags_c}} -c {{source}} -o {{output}}"
outputs = [ "{{source_out_dir}}/{{target_output_name}}.{{source_name_part}}.o" ]
# ...
}
tool("cxx") {
command = "g++ -MMD -MF $depfile {{defines}} {{include_dirs}} {{cflags}} {{cflags_cc}} -c {{source}} -o {{output}}"
outputs = [ "{{source_out_dir}}/{{target_output_name}}.{{source_name_part}}.o" ]
# ...
}
tool("alink") {
command = "rm -f {{output}} && ar rcs {{output}} {{inputs}}"
outputs = [ "{{target_out_dir}}/{{target_output_name}}{{output_extension}}" ]
# ...
}
tool("solink") {
command = "g++ -shared {{ldflags}} -o $sofile $os_specific_option @$rspfile"
outputs = [ sofile ]
# ...
}
tool("link") {
command = "g++ {{ldflags}} -o $outfile -Wl,--start-group @$rspfile {{solibs}} -Wl,--end-group {{libs}}"
outputs = [ outfile ]
# ...
}
tool("stamp") {
command = "touch {{output}}"
}
tool("copy") {
command = "cp -af {{source}} {{output}}"
}
}
可以看到，cc 和 cxx 執行 command 后，生成 .o 文件，然后這些 .o 文件可以作為 alink、solink、link 的 inputs，被它們 command 繼續使用，最后輸出靜態庫、動態庫以及可執行文件。
其余屬性可以查文檔了解含義。
對比 Chromium 中的配置
Linux
主要配置在這里：https://source.chromium.org/chromium/chromium/src/+/main:build/toolchain/gcc_toolchain.gni
也是 gcc 的，與 simple_build 里的大同小異，沒有特別的。
Mac
主要配置在這里：https://source.chromium.org/chromium/chromium/src/+/main:build/toolchain/apple/toolchain.gni
區別有：
- 用 clang 系列編譯工具，而不是 gcc
- alink 不是用 ar，而使用 libtool
- solink 的默認擴展名改成了 dylib
- 用了一個 linker_driver.py 來支持生成 dSYM，在里面調用了 dsymutil 和 strip
Win
- 編譯用 cl，靜態庫鏈接用 lib，動態庫和可執行文件的鏈接用 link
- lib_switch = ""，lib_dir_switch = "/LIBPATH:"；前兩者 lib_switch = "-l"，lib_dir_switch = "-L"
建立我們的工具鏈
基本上是根據上面分析的要點配置，最終結果在此：https://github.com/Streamlet/gn_toolchain
新增的一些差異有：
-
增加全局參數 is_debug，可以在 gn gen out --args="is_debug=true"傳入。默認 is_debug 為 false，開啟所有優化。
-
mac 下生成 dSYM 不使用 python 腳本，直接是 $ld ... && dsymutil ... && strip
-
mac 下加了一個 template：app_bundle，用來生成 xxx.app，主要配置來自于 create_bundle 文檔里的例子
-
win 下增加了一些配置集
-
動態/靜態鏈接 CRT：//build/config/win:console_subsystem、//build/config/win:static_runtime
-
控制臺程序、Win32 程序：//build/config/win:console_subsystem、//build/config/win:windows_subsystem
這個其實一般情況下用不著，只要入口函數是 main/WinMain，link 默認就是控制臺程序/Win32 程序
-
XP 支持：//build/config/win:console_subsystem_xp、//build/config/win:windows_subsystem_xp
具體實現是鏈接參數加 /SUBSYSTEM:CONSOLE,5.01 或 /SUBSYSTEM:WINDOWS,5.01。關鍵是后面的版本號 5.01，為了加版本號則必須指定子系統名稱，所以分了 console_subsystem_xp 和 windows_subsystem_xp。又，xp 這里提供了兩個 subsystem 的配置集，非 xp 也提供兩個。
但是我們沒有加 _WIN32_WINNT=0x0501、WINVER=0x0501、_USING_V110_SDK71_，也沒有指定必須使用 7.0 版本的 SDK，這些都是非必須的，只要不用到 XP 以后添加的 API 即可。使用者可以在自己的 target 里面定義這些宏。
使用案例
提供一個使用案例：https://github.com/Streamlet/gn_toolchain_sample
因為它以 git submodule 形式引用了 https://github.com/Streamlet/gn_toolchain，所以 git clone 以后，需要 git submodule update --init一下。
然后在根目錄執行：（確保 gn 和 ninja 已經在 PATH 中）
gn gen out
ninja -C out
即可。
Mac 下會額外生成一個 objc 項目 objc_console_application 以及一個 app_bundle：ns_application.app。
Win 會額外生成一個 Win32 項目 win32_application。
Win 下需要先執行一下 Visual Studio 帶的命令行環境，如 VS 2022 Community 的 “x64 Native Tools Command Prompt for VS 2022”，cl 等工具才會可用。
如果要測試 XP（32位），用“x86 Native Tools Command Prompt for VS 2022”進入，CD 到項目目錄，執行：
gn gen out --args="target_cpu=\"x86\""
ninja -C out
總結
我們只用幾十 KB 的大小完成了跨端支持，是很輕量的一個配置。如果您覺得實用并認可這種方式，歡迎一起來維護、完善。
posted @
2022-11-06 02:05 溪流 閱讀(13406) |
評論 (0) |
編輯 收藏
2020年9月20日
這個“偽需求”是最近才想到的。
關于文章管理的想法，說來話長。我最初是在 CSDN 寫技術文章，就用網頁上的編輯器。后來在 CppBlog 寫，用上了 Windows Live Write，一般在 Word 里面寫好，再貼到 WLW 發布。再后來由于太忙了，一直停到現在。其中除了我懶，有兩個客觀原因，第一是中間好幾年不搞 C++，那么在 CppBlog 上寫非 C++ 的東西好像有點奇怪；第二是，服務端的東西真的沒法每天下班自己玩呀，每天下班提心吊膽地看短信報警，也沒哪個心情和時間再去重新開辟一個和白天工作內容迥異的學習場景維持下去。（佩服自己找借口的能力~）
前些年，Markdown 興起，GitHub Pages 興起，一眾靜態博客工具也蓬勃發展。Markdown 真的太適合用來寫技術博客了，唯一不足是圖片的處理。盡管如此，我還是花了很大的精力把以前所有的文章都轉成了 Markdown。然后曾經一度也玩上了 GitHub Pages，用 Huge 生成靜態博客。然而，博客的這東西我認為價值點和動力還是在于交流、碰撞，自己寫自己看，跟存本地沒啥區別——我的 GitHub Pages 幾乎沒人看……那時候也沒寫幾篇，大概是 2018 年末到 2019 年初的時間。
半年前，我想到了近年來第一個“偽需求”。我嫌 Hugo 這種形態操作太羅嗦：先寫 Markdown，再放到 source repo 的 post 里，提交一把；再生成靜態頁面，把 public 提交到 public repo。如果折騰模版啥的，就更復雜。我就想寫 Markdown，寫完提交一次 .md，能不能就看到呢？甚至干脆不提交，直接同步到服務端。這樣，就得做一套動態系統（相對于 Hogo 的靜態頁面）去做這件事，而生成被瀏覽的數據的邏輯理論上跟 Hugo 之類的沒本質區別。而一般個人博客這種文章量，根本不用納入性能上的考量，因此做成動態是完全可操作的。看了下市面上沒有此類的工具，于是就開搞了。我把它叫“NoteIsSite”，GitHub 地址 https://github.com/Streamlet/NoteIsSite，Demo 地址 https://note-is-site.streamlet.org/，然后把我所有的文章也用這個工具掛在主頁下的一個子分類，見 https://www.streamlet.org/note/。關于這個，以后再開一篇文章細說。
到這里為止，寫的過程代價很小了。但是剛才說了，博客這東西，對于我的動力很大一部分來自于評論、碰撞，還是需要發到公共平臺上去的好。最近看到一個去年離職的前同事的博客 https://gclxry.com/，我驚嘆于人家一直在堅持寫。我想我是不是也要撿起來了，還是回歸 CppBlog 吧。于是問題就來了。最近覺得最好用的 Markdown 編輯器是 typora，然后它沒法發博客；以前的 WLW 雖然還能用，但畢竟不基于 Markdown。然而 typora 不開源，沒法給他加一個“發布”功能了事。所以自己做做看？順便入一下 Electron 的坑，以及前端的坑。
花了這么大篇幅把需求來源說完了。至于為什么選 Electron 呢？就是為了快點搞定……
上周學習了下 Electron 的 demo 以及打包流程：https://github.com/StreamletStudy/ElectronHelloWorld
然后正式用這個 repo：https://github.com/Streamlet/MarkdownBlog
現在功能就兩個：編輯、發布。編輯不是所見即所得的，左邊 Markdown，右邊 HTML。發布要每次填 API 地址、賬號，沒做管理。整個流程通了，于是停下來寫了這篇文章，用剛寫的工具發布上來。
發現了 Electron 的一個坑，只要在頁面里調用了 alert，頁面上的焦點就有問題，輸入框再也無法輸入內容了。目前用 remote.dialog.* 替代。不知道有沒有正解？
后面的規劃:
- 搞清楚前端的語言體系，然后選擇用原生 JS 還是它的衍生語言，把工程組織進一步完善
- 搞清楚 UI 復雜度，看要不要選擇一個虛擬 DOM 方案
- 擼功能，賬號管理等
- 擼功能，做成所見即所得
- 擼功能，支持圖片粘貼、上傳
再后面，先不規劃，做完了再看。當前版本 Release：https://github.com/Streamlet/MarkdownBlog/releases/tag/publish_to_metaweblog_api
posted @
2020-09-20 16:03 溪流 閱讀(2206) |
評論 (0) |
編輯 收藏（原發于 GitHub Pages，2019-01-01 23:22:43）
2019 年，我回來了。
不知不覺中，我入 PHP 的坑已經 3 年有余，入 Go 的坑也大半年了。作為不評論不舒服斯基星人，自然要對 Go 品頭論足一番的。
總的一句話，Go 的一些特性確實恰到好處，然而更多的地方卻是平庸、繁瑣、束縛，以至于我想不到它是適合哪些場景的。
靜態語言里，C、C++ 有著明顯的適用領域：你要想老老實實寫程序，不玩任何花招，就用 C 吧，至少你能掌控一切，實在想玩你還有宏這個大殺器；你要想玩點花招，那就用 C++，代價就是需要自身水平更高，能掌控到多大層次就寫多大層次，不懂的不要不懂裝懂去用，總體來說還是安全的。
腳本語言里，如果要隨便寫點什么工具，python 啥的挺方便的；寫點網絡的，就用世界上最好的語言 PHP 吧。什么？你說 Java？實在沒辦法，體量太大，公司要你用你就用吧。不過就其本質而言，其實 Java 和今天的主角——Go 是同一類的。不是說他們語法像，是指應用場景（不過這個領域拿 PHP 寫顯然會更爽）。
嗯——為了表達出真實的意思，我想用詞稍微犀利點，請先做一下心理建設。
我不怎么懂 Java，就我淺薄的了解而言，如果你的公司、團隊有很多傻逼，甚至你自己也是，業務上又正好可以用 Java 界的一些現成的框架、組件，那么用 Java 肯定是沒錯的啦。它確實有一種魔力，讓你無論多傻逼，也絕對寫不出錯得多么隱蔽、精妙無比的代碼；同時讓你無論多牛逼，也寫不出多么精彩絕倫、言簡意賅的代碼。Go 也有這種特質，甚至有些地方比起 Java 更有過之而不及。不信請看：
別人家的寫法：
r = f(p1, p2 != null ? p2 : p3)
$r = f($p1, $p2 ?? $p3)
Go 家的寫法：
var r someType
if p2 != nil {
r = f(p1, p2)
} else {
r = f(p1, p3)
}
為什么要設計成這樣？Go 爸爸說：你們有些人啊，會嵌套很多層 ?:，導致代碼可讀性太差啦，于是禁止你們使用 ?:，這是家法。在這里，作為熊孩子的代表，我來告訴大家怎樣寫出讓 Go 爸爸無語的代碼：
foo := 1
bar := 2
var foobar int
if foo > bar { if bar > 1 { foobar = 1 } else if bar < 0 { foobar = 2 } else { foobar = 3 } } else { if foo >= 3 { foobar = 4 } else { foobar = 5 } }
怎么樣？可讀性差不差？
看到了吧，這種傻逼是防不住的，他愿意把 ?: 嵌套好多層，它同樣可能會把 if else 嵌套好多層。有素質的人會怎么做？遇到 ?: 嵌套太多立馬拆成 if else。所以結論是，即使去掉 ?:，傻逼還是傻逼，但是正常的人寫代碼就會很啰嗦；支持 ?:，傻逼還是傻逼，正常人用起來爽。要知道一層 ?: 的場景占所有 ?: 場景的比例還是很高的吧。我覺得可以這樣，Go 爸爸可以統計一些工業級代碼庫的 ?: 嵌套層數，作為數據支撐（比如自家 Chrome 里一層 ?: 占 95%，兩層占 4.9），然后再在語言層面只支持一層 ?:，編譯參數可選打開兩層，不支持兩層以上。這就功在千秋了。
除了 不支持 ?:，Go 爸爸還有很多這樣的設計，隨便舉幾個例子：
- 不支持默認參數
- 不支持運算符重載
- 不提供 goroutine id（以及 gls、可重入鎖）
特別是第三點，也是這種思路，因為你們可能會濫用，所以我不提供。類似這種“爸爸思路”，是我今天要噴的最大噴點。前兩點也許是抄 Java 的，不怪 Go 爸爸。
綜上，Go 爸爸通過扼殺一些基本語法或者一些基礎信息，來防止傻逼干壞事，同時讓正常人用起來很啰嗦，同時還可能防止不了傻逼干壞事。這跟 Java 通過不提供高級語法來防止傻逼干壞事是師出同門啊，而且他們正好都能寫網絡服務程序，你說它們像不像？
然而，Go 爸爸也有精分的時候，它居然發明語法糖了耶！比如 if 可以執行一個句句。單就這個語法而言，我的態度是中立偏贊。贊是贊 Go 爸爸確實用過心了，某些時候挺方便，還能縮小變量作用域；不過這個總歸是可有可無的，畢竟換一行寫也不會死，要變量作用域加個大括號就行。
小語法方面倒是有個亮點，那就是 switch 的隱式 break、顯式 fallthrough 處理。不多展開了。
除了防傻逼，Go 爸爸還有一個思路，就是只許州官放火，不許百姓點燈。有兩個語法點——
- 泛型
- 逗號ok斷言
先說泛型吧。不支持泛型其實我挺能理解的，因為他確實比 ?: 復雜多了，傻逼用不起，?: 都沒有，怎么可能會有泛型呢。然而 Go 爸爸有特權呀，它的 map、chan 可都是泛型的哦。但是你要寫一個泛型的語法結構的話，對不起沒有。
再說逗號ok斷言，同樣 Go 爸爸要得起，我們要不起。其實我更想要一個這樣的語法：當返回值是 xxx, ok 或者 xxx, err 的時候，我如果用一個返回值接，那么就返回第一個，以便鏈式調用，同時 !ok 或者 err != nil 的時候 panic。
以上兩小點雖然是在噴，不過還好啦。無所謂的。下面講幾個大的方面。
代碼組織
我特別贊賞 Go 對于 package 級嚴格的循環依賴檢查。然而如果加上其他規則：
- 一個目錄一個 package
- 不同路徑下的同名目錄也是不同 package
- go 代碼無法拆成 .h、.cpp
實際可操作性就會非常差。要拆 package，就要把依賴關系梳理得特別嚴格，半點不得馬虎。這對工一般的程代碼來說是個極大的挑戰。
我更傾向于做成函數級循環依賴檢查，或者不限制（畢竟遞歸函數也是要支持的嘛）。
這部分，中立偏噴，偏噴是因為 Go 爸爸用了我的小名 internal。
OOP
我特別贊賞 Go 對于 OOP 泛濫成災的思考與探索，以及對于終結這陣 Java 帶來的不正之風的決心。怎么可能萬物都是 class 呢。但同時，Go 還是有點矯枉過正的，如果我需要利用傳統的 OOP 來搞事情，就非常麻煩，你甚至都無法寫出一個框架來。你只能寫庫讓別人用。雖然我也不喜歡框架，但有的時候是需要框架的。
defer 非常切中痛點，特別解決一堆錯誤 return 外加資源釋放的問題。相比之下C 里只能用 goto，C++ 本身不支持但可以玩出 LOKI_ON_BLOCK_EXIT 或者 BOOST_SCOPE_EXIT。defer 一舉解決問題。（要是能再增加命名 defer 以及撤銷 defer 的功能就更好了。沒錯，你也許看出來了，我覺得 LOKI_ON_BLOCK_EXIT 是最完美的方案。）
雖然 defer 很好，但不意味著析構就沒用武之地了。理想的情況是，析構、多態、defer 都要有……
這部分我的態度是中立。
錯誤處理
終于要點贊了。錯誤處理是在我看來 go 完勝的地方，恰到好處地處理問題，又防止濫用。也矯正 Java 帶來的歪風邪氣。
Java 的設計，讓人不得不用異常來處理業務。甚至 Java 自己還幫我們分好類了：一種是不是異常的異常，用來處理業務；另一種是真的異常。一些用慣 Java 的傻逼跑到 C++、PHP、Python 里亂拉屎，到處是 try catch。
Go 爸爸一聲令下，萬籟俱寂。
goroutine
最后不得不說說 gorouthine，畢竟是賣點嘛。我的態度中立偏贊。贊是因為這是一種太有創意的方案，居然想在在語言層面解決多線程、并發問題；不過我還是覺得這更多的是應用層面的問題，做到官方庫里會更好，而不是做成語法。
總結
剛開始用 Go 的時候，特別亮眼，簡直處處是亮點，然后越接觸越討厭，一點也不耐看……看得出來，設計者糅合了 C、python、Java 的一些特性，并融入了自己的獨特的理解。Go的設計者真的特別特立獨行且堅持己見，一些我喜歡的特性因為他們的堅持而存在下來，一些我討厭的特性也因為他們的堅（Gu）持（Zhi）而不能有所改觀。就這樣的 Go，想代替 C 作為系統語言，是沒戲的；想在網絡服務有一番作為，搶 Java 的份額，或許是有機會的，不過最多只能搶 Java 的，連 C# 的都搶不了，C++、PHP 更搶不了。
嗯，除了特定的不得不用的場合，反正我是不會特意用 Go 的。
2019，新年快樂！
posted @
2020-09-20 14:16 溪流 閱讀(4468) |
評論 (0) |
編輯 收藏（原發于 GitHub Pages，2018-10-13 13:51:09）
兩年前我從一名光榮的C++程序員專業為PHP程序員以后，告別了世界第一IDE Visual Studio，改用當時覺得特別難用的 PHPStorm。用了這么久以后，覺得IntelliJ系列雖比不上VS，大概也有世界第二吧，至少比eclipse強太多。除了慢大概也沒啥好吐槽的了。
最近又要寫Go又要寫PHP，最開始PHPStorm和GoLand一起用，后來想，用兩個渠道包干嘛呢，還使用他們家的主打產品Idea吧。。。
雖然說程序員一般是要用英文版的，不管是為了實用還是為了裝逼。但為了更多人能入門，我們發起一個開源項目來漢化吧，在 https://github.com/Streamlet/ideaLocalization，歡迎有志之士加入。
我們主要就是翻譯 resources.jar。代碼框架是這樣的，resources\en 是原文件解壓后的，resources\zh-CN是復制了一份resources\en，我們只要在resources\zh-CN里面就地改動即可。
build.py會把散著的文件們打包成resources.jar。jar里的properties文件里，如果有中文，不能直接是UTF或GBK，必須轉成\uXXXX的寫法。這個build.py會幫忙轉，因此resources\zh-CN里直接寫中文（UTF-8）就好。
就是發起個項目意思意思，估計我是沒時間翻譯的……^_^
當前進度
已完成：
使用方法
- 獲取語言包。您可以：
- 直接從 release 列表下載 resource_zh_CN.jar
- clone 本項目，運行本項目根目錄的 build.py 來生成 resource_zh_CN.jar
- 將語言包復制到 idea 安裝目錄的 lib 目錄下，復制到 lib 目錄下，復制到 lib 目錄下
- 重啟 idea
注意事項
- 取決于不同操作系統，您可能需要將系統的界面語言設置為簡體中文（zh-CN）才能生效。
- 本項目目前只針對 idea，對于 jetBrains 的其他產品尚未做適配，理論上可能支持或部分支持，請自行嘗試。
加入我們
本項目誠邀您的加入，歡迎您貢獻自己的力量。
- 您只需原地修改 resources 下的文件即可，可以在空閑的時候修改一個文件、甚至一行
- 本項目謝絕直接的自動翻譯，但不介意您個人使用自動翻譯進行某種形式的協助，但最終請您進行人工核對
- 本項目遵循軟件行業通用的翻譯規范，同時對標 Visual Studio 的翻譯。請自行體會。下面會羅列一些細則。
分支說明
- dev_build_script: 專門修改構建腳本
- dev_readme：專門修改 readme
- original_resources_tracker: 英文資源文件
- dev_translate：翻譯
合并策略
- dev_build_script 每次修改并測試通過后合入 master
- dev_readme 每次修改穩定后合入 master
- original_resources_tracker 每次更新資源后打 tag，合入 master
- dev_translate 經常性地從 master 合并新的提交
- 當 dev_translate 穩定后，從 dev_translate 進行發布
- dev_translate 在發布時必須處于對 master 可 Fast-Forward 狀態
- dev_translate 發布之后 master Fast-Forward 到 dev_translate
協作方式
- Fork 版本庫，在 dev_translate 上修改，提交 pull request 回來
- 未來時機成熟的話，成立一個 github 上的 oraganization，屆時加入
翻譯規范
- 標點：行文中一般使用中文半角，某些形式文案中可能需要用英文半角符號
- 需要打開對話框操作的菜單項，使用英文半角的三個點（“...”）表示
- 菜單項/按鈕后的快捷鍵兩側使用英文半角括號
- 中英文混排：中文和英文之間需要使用一個半角空格進行分隔
- 菜單項/按鈕的快捷鍵：放在文案之后，如“文件(<u>F</u>)”
詞匯表
| 英文 | 推薦翻譯 | 不推薦的翻譯 |
| View | 視圖 | 查看 |
| Build | 生成 | 構建 |
posted @
2020-09-20 14:00 溪流 閱讀(2240) |
評論 (2) |
編輯 收藏4月份就有人留言舊微軟拼音恢復工具不支持Win10 1803了，我自己也遇到了，但因為沒時間搞，勉為其難使用了詞組模式的微軟拼音幾個月，終于在八月份抽個空研究了下，解決了。
這次是因為傻逼大微軟改了 System32\IME\shared 里的東西，導致舊系統拷過來的文件與 System32\IME\shared 的東西不兼容了。解決方式很暴力：從以前的版本復制 System32\IME\shared 過來。
下載：https://www.streamlet.org/software/mspyforever/
（原發于 GitHub Pages，2018-10-13 13:36:04）
posted @
2020-09-20 13:53 溪流 閱讀(609) |
評論 (0) |
編輯 收藏