Symbian開(kāi)發(fā)入門教程
羅朝輝（飄飄白云） 2009.07.09
http://www.shnenglu.com/kesalin
(轉(zhuǎn)載時(shí)請(qǐng)注明作者和出處。未經(jīng)許可，請(qǐng)勿用于商業(yè)用途)
目錄：
一， 環(huán)境配置
二， 項(xiàng)目設(shè)置
三， 開(kāi)發(fā)流程
四， 參考書籍
一，環(huán)境配置
1，開(kāi)發(fā)工具下載
開(kāi)發(fā)環(huán)境選用Jdk1.5 + ActivePerl-5.6 + S60_3rd + Carbide.C++.V2.0，請(qǐng)依次文件下載一下文件放到D:\SymbianTools目錄下：
Jdk1.5 ：
http://java.sun.com/javase/downloads/index_jdk5.jsp
ActivePerl-5.6.1.635-MSWin32-x86.msi ：
下載地址：http://downloads.activestate.com/ActivePerl/Windows/5.6/
S60 Platform SDKs for Symbian OS, for C++：
下載地址：http://www.forum.nokia.com/info/sw.nokia.com/id/4a7149a5-95a5-4726-913a-3c6f21eb65a5/S60-SDK-0616-3.0-mr.html
選擇：S60 3rd Edition, Feature Pack 1
Carbide.c++ 2.0
下載地址：http://www.forum.nokia.com/Tools_Docs_and_Code/Tools/IDEs/Carbide.c++/
2，開(kāi)發(fā)工具安裝
注意：請(qǐng)將以上3個(gè)工具安裝到同一個(gè)磁盤下（比如C:\盤下），要不在后面可能會(huì)碰到奇怪的問(wèn)題，并且工程代碼也需要與開(kāi)發(fā)工具放到同一個(gè)磁盤下才能運(yùn)行，Nokia的開(kāi)發(fā)工具還真夠挑剔的,:)
先安裝Jdk1.5到 C:\apps\下，安裝完成之后，再安裝ActivePerl到C: \apps\下，安裝完成之后，再安裝S60_3rd SDK到C:\下，在安裝S60 SDK的過(guò)程中會(huì)詢問(wèn)：沒(méi)有安裝CSL Arm Toolchain，要立即安裝么？選擇立即安裝就可以了，之后可能還會(huì)彈出一個(gè)警告對(duì)話框，直接忽略就可以了，不會(huì)有什么影響的。
安裝Carbide.c++ 2.0，安裝過(guò)程中選擇 Professional Edition
3，開(kāi)發(fā)環(huán)境配置
a),語(yǔ)言切換：
默認(rèn)安裝的是英文的模擬器環(huán)境，如果你需要使用中文模擬器或在模擬器上顯示中文，你需要這么做：點(diǎn)擊 開(kāi)始 -> 程序 -> S60 Developer Tools -> 3rd Edition FP2 -> 1.01 -> Languages -> Change to Chinese，這樣就把語(yǔ)言切換成中文了。
b),在命令行中輸入 path 查看下把你的 path 環(huán)境變量中有沒(méi)有包含CSL Arm Toolchain的安裝路徑，如果沒(méi)有將它添加到 path 環(huán)境變量中去，如我的是添加 C:\Program Files\CSL Arm Toolchain\bin
c),控制臺(tái)打印輸出調(diào)試：
修改C:\Symbian\9.2\S60_3rd_FP1_6\Epoc32\Data\epoc.ini 文件中的
LogToFile 0
LogToDebugger 0
為
LogToFile 1
LogToDebugger 1
使用時(shí)，打開(kāi)工程的 mmp 文件，在其中的 static libraries 中添加 ecrt0 庫(kù)，在需要在控制臺(tái)輸出信息的文件中包含頭文件 #include <e32debug.h>，然后我們就可以如在C中使用printf一樣使用：
RDebug::Print(_L("###CImageManager::LoadImage %d\n"), idx); 來(lái)將打印信息輸出到控制臺(tái)了。
d),有時(shí)候編譯會(huì)出現(xiàn)如下問(wèn)題問(wèn)題
the file 'AknExNote.rsg' cannot be opened
或者類似" 工程名_XXXX.rsg" 文件無(wú)法找到的錯(cuò)誤，可以通過(guò)如下辦法解決，打開(kāi)命令行，進(jìn)入 C:\Symbian\9.2\S60_3rd_FP1_6\Series60Ex\note\group 目錄下，依次輸入以下命令：
bldmake bldfiles
abld build winscw udeb
這樣就會(huì)在C:\Symbian\9.2\S60_3rd_FP1_6\Epoc32\BUILD\Carbide\workspace\工程名\group\工程名\WINSCW 下生成對(duì)應(yīng)的 rsg 文件。
e),系統(tǒng)頭文件可能是因?yàn)榘姹静患嫒莸葐?wèn)題，編譯時(shí)可能會(huì)說(shuō)找不到 ecom.h 頭文件，這里需要修改：C:\Symbian\9.2\S60_3rd_FP1_6\Epoc32\include\http\cauthenticationfilterinterface.h 的頭文件包含路徑，將 #include <ecom.h>修改為 #include <ecom/ecom.h> 就可以了。
二， 項(xiàng)目設(shè)置
1,在開(kāi)始 -> 程序 -> Carbide.c++ v2.0 打開(kāi)Carbide.c++編譯器，將workspace設(shè)置在安裝開(kāi)發(fā)工具的同一個(gè)磁盤里面(理由前面說(shuō)了)。在Window -> Preferences -> General -> Editors -> Text Editors 左側(cè)的 Show line numbers前面打勾，這樣就會(huì)顯示代碼行號(hào)。
2,導(dǎo)入工程：選擇 File -> Import，在對(duì)話框中選擇 Symbian OS -> Symbina OS Bld inf file，然后 next, 選擇 C:\Symbian\9.2\S60_3rd_FP1_6\Examples\Basics\HelloWorld\Bld.inf，然后 next，一路默認(rèn)，直到 finish 就可以導(dǎo)入工程了。
3,在工程瀏覽器視圖(Project Explorer)中右擊項(xiàng)目 HelloWorld，在彈出菜單中選擇 Build Project,應(yīng)該可以順利編譯通過(guò)了，然后再在彈出菜單中選擇 Run as -> Run symbina OS Appion，在彈出對(duì)話框中選擇Finish。這樣就可以在模擬器中運(yùn)行程序了。(模擬器啟動(dòng)速度可能比較慢，你點(diǎn)擊模擬器界面中照相機(jī)按鈕下面的藍(lán)色橢圓按鈕進(jìn)入應(yīng)用程序界面，選擇 installed進(jìn)入已安裝程序界面，就可以找到安裝的 HelloWorld 程序)
三，開(kāi)發(fā)流程
1, 如何在工程中導(dǎo)入圖片資源：
a),將bmp圖片(名字要為英文)拷貝到 工程名\gfx 目錄下，這樣你在Carbide.c++打開(kāi)group下面的 工程名.mmp 文件，選擇 Sources欄(題外話：Libraries欄是配置庫(kù)的，前面說(shuō)的調(diào)試庫(kù)就在這里設(shè)置),選擇右邊的 Bitmaps,如果下面沒(méi)有任何mbm文件，就添加一個(gè)；如果有了直接雙擊打開(kāi)。在彈出的對(duì)話框中選擇Add From Project，選擇你剛剛拷貝到gfx目錄下的bmp圖片就可以了，確定。
b),然后重新編譯工程，就會(huì)在C:\Symbian\9.2\S60_3rd_FP1_6\Epoc32\include目錄下自動(dòng)生成工程名.mbg文件，里面是定義了一些enum變量對(duì)應(yīng)你加入的圖片id，在代碼中你可以使用這些id來(lái)引用圖片資源。
c),這樣你就可以在項(xiàng)目中如下代碼所示裝載圖片了：
_LIT (KImagesFilename,"\\System\\Apps\\工程名\\工程名.mbm");
CFbsBitmap* iFbsBmp = m_EikEnv.CreateBitmapL(KImagesFilename, 圖片id);
2,如何在工程中加入中文字符串：
a),只能使用utf8格式的中文字符文本，所以你需要將文本格式(gb2312)的文本文件轉(zhuǎn)換成utf8才能在工程中使用。具體操作見(jiàn)下。
b),在data目錄中添加文本文件: cntext.txt,內(nèi)容如下：(注意CHARACTER_SET UTF8不可少!)
CHARACTER_SET UTF8
#define qtn_connect_confirm "允許應(yīng)用程序訪問(wèn)網(wǎng)絡(luò)么？"
#define qtn_exit_confirm "確定退出應(yīng)用程序么？"
c),在data目錄中添加bat文件:charconverter.bat,內(nèi)容如下：
@echo off
charconv -input=gb2312 cntext.txt -output=utf8 cntext.loc
pause
d),運(yùn)行此bat，就可以在data目錄下生成cntext.loc文件，這時(shí)在Carbide.c++中工程中的data目錄下就可以看到這三個(gè)文件了，打開(kāi)data/工程名.rss文件，添加包含
#include "cntext.loc"
再在下方的Resources for messages處添加以下內(nèi)容：
RESOURCE TBUF32 r_connect_confirm { buf=qtn_connect_confirm; }
RESOURCE TBUF32 r_exit_confirm { buf=qtn_exit_confirm; }
打開(kāi)data\工程名_reg.rss文件，看看有沒(méi)有包含 工程名_0xXXXXXX.rsg 文件(XXXX是16進(jìn)制的UID，編譯項(xiàng)目時(shí)會(huì)在C:\Symbian\9.2\S60_3rd_FP1_6\Epoc32\include目錄下自動(dòng)生成該文件)，如果沒(méi)有就添加包含：
#include <工程名_0xXXXXXX.rsg>
e),這時(shí)重新編譯項(xiàng)目，就會(huì)在工程名_0xXXXXXX.rsg文件中生成字符串資源ID
#define R_CONNECT_CONFIRM 0x5edfa00e
#define R_EXIT_CONFIRM 0x5edfa00f
f), 這樣在項(xiàng)目中你就可以通過(guò)如下代碼來(lái)使用中文字符串了。
CAknQueryDialog* dlg = CAknQueryDialog::NewL();
HBufC* pFormat = StringLoader::LoadLC(R_EXIT_CONFIRM);
dlg->SetPromptL(*pFormat);
if(dlg->ExecuteLD(R_STAR_CONFIRMATION_QUERY))
{
Exit();
}
3),發(fā)布到手機(jī)上，在Carbide.c++中右擊項(xiàng)目，在彈出菜單中選擇項(xiàng)目屬性Properties，選擇
Carbider.C++欄目下面的Build Configurations，在右邊的Configuration中選擇Phone Release
(GCCE) ，然后在下面的SIS Builder中Add新的sis，選擇sis\項(xiàng)目名_s60_.._.pkg文件，然后OK，
Apply，OK，重新編譯就會(huì)在sis目錄下生成：
項(xiàng)目名_s60_.._.sis
項(xiàng)目名_s60_.._.six
兩個(gè)文件，將它們拷貝到手機(jī)上就可以安裝應(yīng)用程序了。
4)，常見(jiàn)的按鍵值：
左軟鍵 0xa4 164
右軟鍵 0xa5 165
確定鍵 0xa7 167
左鍵 0xe 14
右鍵 0xf 15
上鍵 0x10 16
下鍵 0x11 17
5),去除項(xiàng)目向?qū)ё詣?dòng)生成的默認(rèn)左菜單，只要將 工程名.rss 中的 r_menu 清空就可以了。
RESOURCE MENU_PANE r_menu
{}
四， 參考書籍
對(duì)比了一下，比較好的參考書籍是<Symbian OS C++ for Mobile Phones>中文版第三版