在BREW的开发环境中,没有一个联机调试工具,一直是我觉得相当不方便的事情。在S60平台上做开发,至少这一点是能满足我们的需要。
第一种方法:Carbide C++ v1.2 的 Debug On Device
Carbide C++1.2的pro.以上版本都支持设备调试,实在是一件大快人心的事。
要实现这个功能,也是相当的方便,当然前提是你用的是Carbide C++ v1.2的Pro.以上版本。
按正常模式写程序,在模拟器上都弄的差不多了,想放到设备中调试的话,只需要做下面几步:
1、先在设备中安装一个软件,安装包在carbide的安装目录下,我机器上的位置是C:NokiaCarbide.c++ v1.2pluginscom.nokia.carbide.trk.support_1.2.0.29 rks60,下面有两个 sis文件,因为我要在N73上调试,所以我选择其中的s60_3_0_app_trk_2_7.sisx这个,另一个3_1是用于3rd.FP1手机的。安装后在手机里就有一个TRK应用了。
2、安装成功后,在手机上启动这个服务TRK,因为我是用的USB线,所以点选项,改成USB,端口是1(这里比较奇怪,明明我的端口应该是COM6)。启动后窗口显示:Status:Connected.
3、在Carbide C++中,配置一下编译输出目标为Phone Debug(GCCE),这个很重要,只有DEBUG才行。编译出SISX文件。
4、打开DEBUG窗口(即debug...),在配置中的第一项“Symbian OS App Trk“下建立一个新项。几个窗口的输入如下图所示:
5、点Apply,然后Debug,就可以启动调试。余下的事情与在模拟器中调试就一样了,没啥好说了。
第二种方法:利用S60 SDK自带的Ecmt工具进行DEBUG
如果我们用的是Carbide C++ 的Express版(免费版本)的话,我们没办法做设备联机调试,但是可以用SDK中的工具在程序中将调试信息打印到控制台上。在BREW平台上主要就是依靠这种方式。
Symbian提供了一个REmct可以用于远程调试,并且它还提供了两个配套工具:手机端的ecmtagent_cpp.sis和PC端的Device Connection。
这种方式比前一种要稍复杂一点了,因为涉及到代码的修改。
1、首先同样是在手机上安装一个软件ecmtagent_cpp.sis(不过3rd.的SDK下这个东西不能用,说签名过期之类的错误,只能安装3rd. FP1的SDK下的那个同名sis,唉,也不知道Nokia是咋回事)。
2、同样在调试前也是要启动手机上的ecmtagent代理,设置成USB连接(不需要选择端口了)。然后看到窗口上显示listening。
3、在PC上启动那个Device Connection,选择COM6去connect它,状态成为connected。这时发现手机上也显示connected。表明连接成功了。在Device Connection中打开那个Diagnostics工具,所有的调试信息的就是输出到它的窗口里。
4、最麻烦的是需要修改代码。
A) 修改mmp,加上这个lib。即:LIBRARY EcmtClient.lib
B) 在要输出调试信息的那个类的h文件中加上:
#ifdef _DEBUG
#include
#endif
... ...
class CDemoUIAppView : public CCoeControl,MBeating {
... ...
private:
#ifdef _DEBUG
REcmt iEcmt;
#endif
C) 然后在cpp中加上一个初始化与销毁。
void CDemoUIAppView::ConstructL( const TRect& aRect )
...{
CreateWindowL();
... ...
#ifdef _DEBUG
iEcmt.Connect();
#endif
}
CDemoUIAppView::~CDemoUIAppView()
...{
... ...
#ifdef _DEBUG
iEcmt.Close();
#endif
}
D) 然后就是在需要输出的地方这样一下:
void CDemoUIAppView::Beat()
...{
this->total++;
if(this->total>100)
...{
this->total=0;
iHeart->Cancel();
}
TBuf<16> buf;
buf.Format(KMsgFormat,this->total);
iLabel->SetTextL(buf);
DrawNow();
#ifdef _DEBUG
iEcmt.WriteFormat(KFormattedText, this->total);
#endif
}
5、编译程序,同样是GCCE下的Phone Debug,自己手工安装到手机里,执行它就可以了。要注意的一点是,因为此时前面的那个ecmtagent正在运行,需要将它切到后台去(不是关闭啊!!!)。在Diagnostics的窗口中就会看到输出的调试信息了。
最后要补充一点的是,我在尝试这两种调试方法的时候,经常遇到打开端口失败或者连接失败的情况,一般重启一下手机就正常了,不知道是BUG呢还是因为我同时弄了两个代理在手机里照成的冲突,如果你在使用过程中发现不顺了,不妨也重启一下手机吧。
一、基本数据类型
这个比较简单,都在e32def.h中写着呢。也就是以下这几个类型要注意一下,以后照着写罢了,含义也很明了,不用多说。
typedef void TAny;
typedef signed char TInt8;
typedef unsigned char TUint8;
typedef short int TInt16;
typedef unsigned short int TUint16;
typedef long int TInt32;
typedef unsigned long int TUint32;
typedef signed int TInt;
typedef unsigned int TUint;
typedef float TReal32;
typedef double TReal64;
typedef double TReal;
typedef unsigned char TText8;
typedef unsigned short int TText16;
typedef int TBool;
typedef TUint32 TLinAddr; //Defines a linear (virtual) address type.
二、描述符
这个东西比较有趣,其实说白了,也就是两个我们以前常用的玩意儿:String和malloc。不过在symbian中把描述符分为三类:缓冲描述符、指针描述符和堆描述符。
A.缓冲描述符:TBuf、TBufC
类似于char[],也就是说它是一个字符串的表示方法,比如:TBuf<20> str;与我们以前写的char str[20];意思基本一样。
不过,描述符可以包含一些方法,就象我们用String主要就是冲着它的方便的字串处理方法去的。
B.指针描述符:TPtr、TPtrC
类似于char *,也就是说这是一个字符(字节)指针的另类表示罢了。
C.堆描述符:HBufC
类似于我们用malloc开辟的一块空间,比如:HBufC * buf = HBufC::NewL(128);与 byte * buf = (byte*)malloc(128);的意思也是基本一样的。
还有一种抽象的描述符TDes和TDesC,是其它描述符的基类。
所有描述符名称后面的C表示它是一个不可修改的描述符。换句话说就是,所有不带C的描述符是在带C描述符的基础上增加了一些进行修改操作的函数。
要记住的是描述符带给我们的便利。
比如这几个函数:
Length() 得到字串的真实长度(元素个数),而Size()则是得到它所占的字节数。
Left()/Right()/Mid() 是用来获取子字符串的函数。
Compare() 比较函数。
Locate()/LocateReverse()/Find()/Match() 则可以查找子串或字符。
Copy()/Delte()/Insert()/Replace()/Trim()/Append()/Zero() 则可以对描述符的内容进行修改操作。
Num() 可以将数值转成字符串。
Format() 类似于sprintf,比较常用,格式化输出。不过还有同系的其它函数也许更方便,如AppendFormat()/AppendNum()等等。
对于堆描述符,需要注意的地方有三点:
一是Des(),因为HBufC带C是不可修改的描述符,所以如果我们要修改它,则需要用buf.Des()得到一个指向它的指针描述符。如下句:
_LIT(KHello,"hello china");
HBufC * buf = HBufC::NewL(64);
*buf=KHello;
TPtr p = buf->Des();
p[0]='H';
二是在TDesC中有一个AllocLC()可以分配内存得到HBufC描述符,与HBufC::NewL()是一样的。而且HBufC中也有ReAllocL可以重新分配内存,就象realloc一样。
三是区分一下两句话的含义:
TPtr p=buf->Des();
TPtr p(buf->Des());
第一句只是根据buf当前的真实长度得到一个指针(p的最大长度与当前的实际长度一样,就是buf此时的真实长度11),而第二句则完全用buf的信息来构造了p,所以它的最大长度应该是64,虽然当前的真实长度也是11。
还有一个与描述符相关的宏很常用,需要注意一下:_LIT(常量名称,字串值)。比如:
_LIT(KSayHelloSTR,"Hello world.");
而那个_L宏不提倡用了,因为效率太低的原因。
这里的KSayHelloSTR是另一种描述符TLitC。而TLitC提供两个运算符要注意:
&操作符能得到它的const TDesC*,而()操作符则得到它的const TDesC&。
KSayHelloSTR().Length(); //得到这个字串的长度
TBuf<256> str;
str.Format(KFormatSTR,&KSayHelloSTR); //得到这个字串的引用地址
具体关于描述符的信息可以参考H文件:e32des16.h
三、错误处理
有三个概念,一是Leave。最常见的地方是对new操作符的重载new(ELeave),表示此时的构造会产生内存不足的现象。
有了new(ELeave),我们就可以放心地在new一个对象之后直接使用它而不需要去判断是否构造成功,因为如果不成功会抛出错误并返回上层。
第二个概念配合Leave,有一个宏TRAPD(error,Func)类似于try...catch...。
也就是说如果Func函数中发生了Leave,则error能得到错误码。一般在程序中可以用User::Leave()来抛出错误,类似于throw new Exception的操作。
第三个概念也是最常用的,就是清理栈CleanupStack的使用。
取代TRAPD宏的使用,我们可以在可能发生Leave之前将指针push到cleanupstack中,在正确完成之后再将它pop出来,如果万一不成功,系统会帮我们将cleanupstack中的东西销掉。这样就方便了很多。
一般的代码类似于:
CMyCls * mc=new (ELeave) CMyCls;
CleanupStack::PushL(mc);
me->doSth1L();
me->doSth2L();
CleanupStack::PopAndDestroy();
一般我们是将局部变量用cleanupstack来保护一下,但是对于类的成员变量则不能这样做(否则会二次销毁,产生严重错误)。
此外,在pop时超出范围了,压几个就弹几个,如果不小心把其它的内容给弹出来,也可能会引起严重错误的。所以,Pop有一个重载Pop(3,pA)这里表示弹出三个对象并且比较一下最后出栈的是不是pA。
四、两阶段构造
一般Symbian的类不会提供public的构造函数(不建议这么做),因为它提倡所谓的“两阶段构造”方法。定义为:
A)构造函数是protected或者privted的,并且不能包含引起Leave的操作。
B)实现两个静态函数NewL和NewLC,来代替构造函数提供给用户使用。
C)实现一个ContructL函数实现第二阶段的构造,其实大多数初始化的工作可以放在这里进行。
两阶段构造的代码相当地格式化了,比如两个静态函数NewL和NewLC的代码一般是这样的:
CMyClass * CMyClass::NewL()
...{
CMyClass * self=NewLC();
CleanupStack::Pop();
return self;
}
CMyClass * CMyClass:NewLC()
...{
CMyClass * self = new(ELeave) CMyClass;
CleanupStack::PushL(self);
self->ContructL();
return self;
}
而在ContructL中一般可以做一些真正的构造函数里的操作,例如分配内存、创建窗体之类的活儿。
五、命名规则
这也是一个需要注意的地方,按教材上所言列举如下:
类的名称前缀有T、C、M和R四个,分述如下:
T表示基本类,它位于栈里,就当作是一个结构吧。
C表示常规的类,继承于CBase的,这是C++标准的类的概念,所以有构造要析构。
M表示是一个接口,很好理解,它肯定含有纯虚函数。
R表示是一个系统资源,比如文件、网络等等,所以它肯定有Open有Close。
还有,K开头表示常量、E开头表示枚举也要记得。
形参用a开头,类成员变量用i开头,这此规则我们在自动生成的代码中也能看到。
还有函数的命名上也有讲究,不过不是开头而是结尾:象L表示可能会有Leave,LC表示不但可能有Leave而且它会被自动放在CleanupStack中。
还有两个二阶段构造又有三个函数名称固定了:NewL、NewLC和ContructL。