CodeBlocks插件開發(fā)指南(一)
By Lymons(lymons@gmail.com) 2010/4/14
CodeBlocks是一個(gè)優(yōu)秀的C/C++ IDE開發(fā)環(huán)境,另外它也是開源的,也是跨平臺(tái)的.你能夠利用它的源代碼進(jìn)行二次開發(fā),也能為它制作自己的插件. 它的GUI是利用了跨平臺(tái)的wxWidgets庫來做成的,所以它才能夠?qū)崿F(xiàn)跨平臺(tái).
下面將介紹CodeBlock的插件制作方法,當(dāng)然它必須得通過編寫自己的程序才能實(shí)現(xiàn),所以懂得一些C++的編程知識(shí)能夠幫你更容易去理解它的內(nèi)容.
1． 準(zhǔn)備CodeBlocks的開發(fā)環(huán)境
① 下載的安裝文件
請(qǐng)到官網(wǎng)(www.codeblocks.org)下載最新版的安裝程序，我當(dāng)時(shí)的最新版本是8.02
注意上圖中的第一個(gè)文件：codeblocks-8.02-setup.exe 僅僅是一個(gè)不帶編譯器的IDE，我們這里需要的是帶編譯器的開發(fā)環(huán)境，所以選擇第二個(gè)：codeblocks-8.02mingw-setup.exe（圖中畫紅線的那個(gè)） , 這個(gè)安裝程序中集成了一個(gè)MingW的Gcc編譯器。
② 安裝IDE開發(fā)環(huán)境
安裝非常簡單，只要按照安裝向?qū)нM(jìn)行安裝就沒有問題。
安裝完成后，除了可執(zhí)行程序本身之外，在安裝目錄下還會(huì)創(chuàng)建一個(gè)MinGW目錄，它就是CodeBlocks的默認(rèn)編譯器Gnu Gcc.
③ 下載zip工具
CodeBlocks在編譯插件的時(shí)候需要把 .dll文件和.cbplugin文件壓縮成.zip文件，所以我們需要用到zip命令。
請(qǐng)到zip作者的主頁(http://www.info-zip.org/) 去下載Windows版的zip命令。
#注意：該網(wǎng)站上的大部分連接都訪問不了，也可以下在我這里提供的壓縮包。
下載完畢后，請(qǐng)把壓縮包中的可執(zhí)行文件zip.exe拷貝到上面的MinGW的bin目錄下。
2． 準(zhǔn)備wxWidget編譯環(huán)境
因?yàn)?/span>CodeBlocks的窗口系統(tǒng)使用的wxWidgets這個(gè)跨平臺(tái)的GUI開發(fā)庫。所以，它的插件也要使用wxWidgets進(jìn)行開發(fā)。所以，我們首先做成wxWidgets的編譯環(huán)境。
① 下載源代碼
#注意：一定要下載源代碼，不要圖省事兒就去下載編譯好的安裝文件。因?yàn)樵蹅冮_發(fā)的時(shí)候需要的都是可調(diào)試版本的wxWidgets的庫，而安裝文件中往往包含的都是發(fā)布版的庫文件；另外，CodeBlocks的插件工程關(guān)聯(lián)的是gcc_dll目錄下的wxWidgets的庫文件，發(fā)布版中則沒有它，需要編譯wxWidgets的源代碼才會(huì)出現(xiàn)這個(gè)目錄。
到官網(wǎng)(http://www.wxwidgets.org/) 上下載wxWidget的穩(wěn)定版。因?yàn)?/span>CodeBlocks的版本是8.02版，它是基于2.8版本的wxWidget開發(fā)的，所以我們選擇的是2.8.10版本的wxWidget. 下載地址：
http://prdownloads.sourceforge.net/wxwindows/wxWidgets-2.8.10.tar.gz
② 解壓縮
請(qǐng)使用7-zip或者winrar來解壓縮你下載的.tar.gz壓縮包。
#注意：請(qǐng)不要把wxWidgets的源代碼放到Program Files這樣的中間帶一個(gè)空格的目錄下，因?yàn)?/span>CodeBlocks8.02在解析帶有空格的路徑時(shí)會(huì)存在一個(gè)錯(cuò)誤(我想著應(yīng)該是一個(gè)bug)。最好能把wxWidgets放置到磁盤的根目錄下。
③ 設(shè)置MingW編譯器的path的環(huán)境變量
A) 執(zhí)行cmd.exe命令，打開DOS窗口
B) 在PATH環(huán)境變量中添加編譯器的路徑
這個(gè)路徑就是剛才咱們安裝到CodeBlocks下的MinGW的路徑。開發(fā)程序時(shí)，我們需要用的編譯器的可執(zhí)行文件在以下的兩個(gè)路徑下：
F:\Program Files\CodeBlocks\MinGW\bin
F:\Program Files\CodeBlocks\MinGW\libexec\gcc\mingw32\3.4.5
因此使用下面的命令把上面的兩個(gè)路徑加入到PATH環(huán)境變量中：
set path=%PATH%; F:\Program Files\CodeBlocks\MinGW\bin; F:\Program Files\CodeBlocks\MinGW\libexec\gcc\mingw32\3.4.5
請(qǐng)注意：在每一個(gè)路徑之間都必須用分號(hào)進(jìn)行隔開。
④ 編譯wxWidget
A) 在Dos窗口中進(jìn)入到wxWidgets的安裝目錄下：
wxWidgets的編譯文件被放在build目錄下，其中msw目錄存放的就是Windows下的編譯配置文件。 這里我們的編譯器是GCC,所以要使用該目錄下的配置文件：ｍａｋｅｆｉｌｅ．ｇｃｃ
B) 用MinGW的GCC編譯器來編譯wxWidgets
首先是清除原來編譯的垃圾文件：
mingw32-make -f makefile.gcc SHARED=1 MONOLITHIC=1 BUILD=release UNICODE=1 clean
然后實(shí)施真正的編譯：
mingw32-make -f makefile.gcc SHARED=1 MONOLITHIC=1 BUILD=release UNICODE=1
在這里我們是編譯的是release版本，如果你想要攜帶一些調(diào)試信息，在這里你也可以編譯它的debug版本。只需要把命令中的release換成debug即可。
C) 如果編譯成功，在F:\wxWidgets-2.8.10\lib目錄下創(chuàng)建一個(gè)叫gcc_dll的目錄
這個(gè)目錄很重要，在CodeBlocks編譯程序文件時(shí)，它會(huì)自動(dòng)去找gcc_dll目下的靜態(tài)庫；而從網(wǎng)上下載的官方編譯好的庫文件中卻沒有這個(gè)目錄。下面是gcc_dll目錄下的文件：
如果上面lib/gcc_dll目錄被成功的創(chuàng)建，目錄下也生成了上述的庫文件，恭喜你，你得wxWidgets已經(jīng)編譯成功了。
⑤ 在CodeBlocks中設(shè)置wx變量
A) 執(zhí)行codeblocks.exe命令打開CodeBlocks的IDE環(huán)境
B) 在主菜單中選擇Settings -> Global variables
C) 此時(shí)會(huì)打開環(huán)境變量編輯器
我們要對(duì)上面的Current Variable, 和 base 進(jìn)行設(shè)置。
D) 點(diǎn)擊Current Variable下拉列表框，選擇wx
注意：圖中的cb是后面要用到的環(huán)境變量，它是CodeBlocks開發(fā)庫本身的環(huán)境變量，編譯插件的時(shí)候需要用到它。所以，它也應(yīng)該被設(shè)置。設(shè)置方法同wx的設(shè)置。
E) 在base中設(shè)置wxWidgets的根目錄
點(diǎn)擊 … 按鈕，找到wxWidgets的根目錄，設(shè)定即可。我們這里的根目錄是：F:\wxWidgets-2.8.10
將來cb這個(gè)環(huán)境變量也是同樣的進(jìn)行設(shè)置。
注意：include, lib的路徑不用設(shè)置，因?yàn)?/span>CodeBlocks會(huì)根據(jù)base的路徑自動(dòng)引用base下的include,lib的路徑。
3． 準(zhǔn)備CodeBlocks編譯環(huán)境
CodeBlocks在編譯插件的時(shí)候需要用，CodeBlocks的SDK開發(fā)庫(sdk.h , libcodeblocks.a, libwxscintilla.a)。 而CodeBlocks的IDE安裝程序中并沒有這些東西，所以需要我們根據(jù)CodeBlocks的源代碼，把它編譯成我們所需要的庫。
① 下載源代碼
請(qǐng)到官網(wǎng)(www.codeblocks.org)下載8.02版的源程序，注意請(qǐng)不要下載最新版的源程序，因?yàn)樽钚掳娴?/span>CodeBlocks可能關(guān)聯(lián)上了2.8.10以后的wxWidgets,所以在編譯的時(shí)候會(huì)出現(xiàn)：找不到wx/scintilla.h文件 這樣的錯(cuò)誤。
下載地址：
http://downloads.sourceforge.net/codeblocks/codeblocks-8.02-src.tar.bz2
② 解壓縮
請(qǐng)使用7-zip或者winrar來解壓縮你下載的.tar.gz壓縮包。
③ 用CodeBlocks打開CodeBlocks的源代碼工程文件
進(jìn)入CodeBlocks的源代碼目錄，CodeBlocks.cbp就是工程文件。如果該文件已經(jīng)被CodeBlocks關(guān)聯(lián)上的的話，鼠標(biāo)雙擊這個(gè)文件就可以打開CodeBlocks的源代碼工程。
如果.cbp沒有被CodeBlocks關(guān)聯(lián)的話，你可以從CodeBlocks的File主菜單中選擇Open…打開上面目錄中的CodeBlocks.cbp文件。
④ Build全工程
從CodeBlocks的主菜單中選擇 Build -> Build workspace, 就可以編譯整個(gè)工程了。
如果編譯成功，則會(huì)在codeblocks-8.02\src目錄下生成devel目錄
該目錄存放的是編譯好的codeblocks可執(zhí)行文件，以及相關(guān)的庫，這個(gè)庫中最重要的是libcodeblocks.a, 這個(gè)庫是將來在編譯插件時(shí)需要的一個(gè)最重要的庫文件(sdk.h頭文件中接口都被包含在這個(gè)靜態(tài)庫里) 另外還有share目錄，該目錄是編譯好的插件
到這步為止，咱們?cè)谙到y(tǒng)里就有兩個(gè)CodeBlocks的可執(zhí)行文件了。一個(gè)是最開始我們直接安裝的IDE開發(fā)環(huán)境，另一個(gè)則是我們現(xiàn)在根據(jù)源代碼編譯出來的可執(zhí)行文件。而后面要提到的運(yùn)行和調(diào)試插件就是用到目前這個(gè)codeblocks.exe.
然后，把libcodeblocks.a, libwxscintilla.a拷貝到先前安裝的CodeBlocks的IDE環(huán)境的目錄下，因?yàn)樵诰幾g插件的時(shí)候，需要用到它們。
我這里的目錄是：
F:\Program Files\CodeBlocks
⑤ 執(zhí)行update.bat
進(jìn)入到codeblocks-8.02/src目錄下，執(zhí)行update.bat批處理文件。該文件的作用把devel目錄下的文件拷貝到output目錄下，不過debug信息會(huì)被剔除。
其實(shí)，這步不做也可以。因?yàn)?/span>output下的東西我們幾乎不會(huì)用到。
⑥ 設(shè)置CodeBlocks中設(shè)置cb變量
在全局環(huán)境變量編輯器中設(shè)置cb的base路徑為存放CodeBlocks源代碼的目錄，即codeblocks-8.02/src目錄。我們這里是：
F:\Program Files\CodeBlocks\codeblocks-8.02\src
具體的設(shè)置方法跟wx變量的設(shè)置方法一樣。
到目前為止，所有的編譯前的準(zhǔn)備都完成了。接下來就可以創(chuàng)建一個(gè)Plugin工程，來做成我們自己的插件了。
下面的內(nèi)容將在<<CodeBlock插件開發(fā)指南 二>>中進(jìn)行講解.
4． 創(chuàng)建Plugin工程
<<CodeBlock插件開發(fā)指南 二>>
5． 添加右鍵彈出菜單
CodeBlocks插件開發(fā)指南(三)
6． 主菜單中添加下拉菜單
CodeBlocks插件開發(fā)指南(三)
7． 添加工具條
8． 在”Log&others”中添加一個(gè)面板(Panel)
9． 添加一個(gè)單獨(dú)的面板