brew资源文件的使用

BREW资源文件的使用,计算机系计算机科学与技术教研室办公室：C117,SunBin2009,BREW技术开发与应用,资源编辑器,BREWSDK中提供的资源编辑器可以将应用程序中使用的各种资源（包括字符串、图片等）编译为资源文件，从而将应用程序的源代码和具体资源分离开,SunBin2009,BREW技术开发与应用,资源编辑器BREWResourceEditor,BREW资源编辑器允许您创建应用程序中使用的对话框、字符串、二进制以及对象。还可以使用资源编辑器创建控件，如：菜单、列表、日期选择器以及计时器等。如果创建的应用程序需要使用不同语言在各种无线设备上运行，这些资源将十分有用。,SunBin2009,BREW技术开发与应用,BREW资源文件类型,源文件.brx-是XML格式的中间文件。在用作BREW资源编译器的输入以生成最终输出之前，可以使用资源编辑器对其进行编辑和保存。注意：资源编辑器不要求此中间文件使用BRX扩展名。只要文件包含正确的XML格式有效数据，不管扩展名是什么，资源编辑器都能够对其进行解释。资源文件.bar是由资源编译器作为最终输出的一部分生成的二进制文件。资源文件头文件.brh是由资源编译器作为最终输出的一部分生成的头文件。资源编译器可以将brx文件编译为bar文件和brh文件，以用于最终应用程序。,SunBin2009,BREW技术开发与应用,BREW资源编辑器的作用,使用资源编辑器创建资源并保存成.brx文件将.brx文件编译为.bar和.brh文件在源程序.c中用include语句包含.brh文件编译生成.dll文件在模拟器中加载.dll运行过程中，从.bar中加载资源,SunBin2009,BREW技术开发与应用,创建资源,使用资源编辑器可以创建四种类型资源：字符串资源对象资源二进制资源对话框资源,SunBin2009,BREW技术开发与应用,创建资源-字符串资源,对于字符串资源，需要输入标识、属性两类信息：标识：ID资源编辑器将自动指定一个1001到5000之间的数字；但如果需要指定一个特定的ID，您也可以更改它。该ID必须是同一资源文件(BRX)内字符串资源中的唯一确定整数。名称为创建的资源输入一个唯一的名称。系统也会自动制定一个名称：如字符串资源ID为1001，则字符串资源名为IDS_STRING_1001,SunBin2009,BREW技术开发与应用,创建资源-字符串资源,对于字符串资源，需要输入标识、属性两类信息：属性来源为资源指定来源类型,包括Text、File、Hex数据根据资源来源类型，为资源指定数据值。编码为资源选择编码格式备注为资源输入备注信息，不会保存在.bar中资源的各项信息输入之后，应点击“应用”,SunBin2009,BREW技术开发与应用,创建资源对象资源,对象资源可以是各种不同的格式或类型，但一定具有MIME类型。对象资源通常为图形图像。对象资源的另一个常见用法是在应用程序资源中嵌入HTML文件。,SunBin2009,BREW技术开发与应用,创建资源对象资源,对于对象资源，需要输入标识、属性等信息：标识：ID系统将自动指定一个5001到6000之间的数字；但如果需要指定一个特定的ID，您也可以更改它。该ID必须是同一资源文件(BRX)内字符串资源中的唯一确定整数。名称为创建的资源输入一个唯一的名称。系统也会自动制定一个名称：如图片对象资源ID为5001，则该图片资源名为IDI_OBJECT_5001,SunBin2009,BREW技术开发与应用,创建资源-对象资源,属性来源为资源指定来源类型,包括Text、File、Hex数据根据资源来源类型，为资源指定数据值。当来源为File时，为资源制定相应的文件编码为资源选择编码格式备注为资源输入备注信息，不会保存在.bar中资源的预览信息Mime类型输入关联的mime类型。资源编辑器将尝试自动检测mime类型。宽度高度位/像素如果选中BMP、PNG或JPEG图像，此处将给出图像的尺寸。这些字段不能进行编辑。对象预览如果选中BMP、PNG或JPEG图像，此处将显示图像的预览效果。此字段不能进行编辑。,SunBin2009,BREW技术开发与应用,创建资源-对象资源,资源的预览信息Mime类型输入关联的mime类型。资源编辑器将尝试自动检测mime类型。宽度、高度、位/像素如果选中BMP、PNG或JPEG图像，此处将给出图像的尺寸。这些字段不能进行编辑。对象预览如果选中BMP、PNG或JPEG图像，此处将显示图像的预览效果。此字段不能进行编辑。,SunBin2009,BREW技术开发与应用,字符串资源使用举例,编写一个程序，在手机屏幕上显示中文字符串“你好，欢迎进入BREW世界”编程思路：创建工程hello使用资源编辑器创建资源文件myhello.brx，在该资源文件中创建一个字符串资源，其ID为1001，资源名为IDS_STRING_1001，资源来源为Text，数据值为“你好，欢迎进入BREW世界”，将该资源文件编译为myhello.bar和myhello.brh，保存在工程hello的文件夹中在源代码hello.c中添加#includemyhello.brh在源代码中使用ISHELL_GetResSize()函数计算该字符串的大小根据大小，分配内存空间MALLOC()使用ISHELL_LoadResString()函数从资源文件中加载字符串到所分配的内存空间中使用IDISPLAY_DrawText()函数显示该字符串,SunBin2009,BREW技术开发与应用,字符串资源使用举例,使用资源编辑器创建资源文件myhello.brx，在该资源文件中创建一个字符串资源，ID为1001，资源名为IDS_STRING_1001，资源来源为Text，数据值为“你好，欢迎进入BREW世界”，将该资源文件编译为myhello.bar和myhello.brh,SunBin2009,BREW技术开发与应用,字符串资源使用举例,将该资源文件编译为myhello.bar和myhello.brh,SunBin2009,BREW技术开发与应用,字符串资源使用举例,在源代码hello.c中添加#includemyhello.brh另外程序中用到助手函数MALLOC，因此还需要包含头文件AEEStdLib.h,SunBin2009,BREW技术开发与应用,字符串资源使用举例,在资源文件头文件myhello.brh中包含以下宏定义：#ifndefMYHELLO_BRH#defineMYHELLO_BRH/WARNING:DONOTMODIFYTHISFILE/AUTO-GENERATEDBYBREWResourceEditor#defineMYHELLO_RES_FILEmyhello.bar#defineIDS_STRING_10011001#endif/MYHELLO_BRH,SunBin2009,BREW技术开发与应用,字符串资源使用举例,在源代码hello.c的事件处理函数hello_HandleEvent的EVT_APP_START事件中添加代码（红色为添加部分）：staticbooleanhello_HandleEvent(hello*pMe,AEEEventeCode,uint16wParam,uint32dwParam)switch(eCode)caseEVT_APP_START:AECHAR*mystring;uint32resSize;ISHELL_GetResSize(pMe-pIShell,MYHELLO_RES_FILE,IDS_STRING_1001,RESTYPE_STRING,/AppistolditisexitingcaseEVT_APP_STOP:,SunBin2009,BREW技术开发与应用,字符串资源使用举例,下面对添加的代码分别进行解释：1、AECHAR*mystring;定义一个指向AECHAR类型缓冲区的指针，该缓冲区用于从资源文件中装入要显示的字符串2、uint32resSize;定义一个整形变量，用于保存字符串资源的长度3、ISHELL_GetResSize(pMe-pIShell,MYHELLO_RES_FILE,IDS_STRING_1001,RESTYPE_STRING,该函数用于获取指定资源文件中指定资源的大小，其参数如下：第一个参数是指向IShell的指针（因为这是IShell接口的函数）第二个参数指定资源文件的名字，其值取自资源文件头文件中；第三个参数指定资源文件中资源的ID；第四个参数为资源文件的类型，此处字符串资源的类型为RESTYPE_STRING第五个参数是存放资源大小的变量的地址，获取的资源大小将填入该变量中,SunBin2009,BREW技术开发与应用,字符串资源使用举例,4、mystring=(AECHAR*)MALLOC(resSize);根据上条语句获取的字符串大小，使用MALLOC函数为mystring指向的AECHAR类型缓冲区分配内存空间5、ISHELL_LoadResString(pMe-pIShell,MYHELLO_RES_FILE,IDS_STRING_1001,mystring,resSize);将字符串从资源文件中加载到内存的mystring缓冲区中，其参数如下：第一个参数是指向IShell的指针（因为这是IShell接口的函数）第二个参数指定资源文件的名字，其值取自资源文件头文件中；第三个参数指定资源文件中资源的ID；第四个参数为字符串加载到内存的目标地址，为mystring指向的缓冲区第五个参数是给出要加载资源的大小,SunBin2009,BREW技术开发与应用,字符串资源使用举例,6、IDISPLAY_DrawText(pMe-pIDisplay,AEE_FONT_NO