20110505 Brew工程师培训笔记——第八章 ISHELL简介

第八章  ISHELL简介

一、主要内容

（1）、介绍IShell所提供的八大类服务

（2）、介绍IShell API所提供操作和特点

二、IShell所提供的8类服务

（1）、应用程序管理

（2）、资源文件的管理

（3）、设备和应用程序配置信息

（4）、Notification

（5）、Alarms

（6）、Timers

（7）、对话框, message boxes 和 prompts

（8）、其他功能 (如 Beep)

三、访问SHELL所提供的服务

（1）、Modules和Applets要访问外部服务，需通过IShell接口。

（2）、Modules 和Applets要访问其他的接口，需先获得其接口指针，这也需要使用IShell接口。

（3）、每一个接口用一个唯一的Class ID来标志

四、应用程序管理

（1）、创建、启动和停止BREW类和应用程序

（2）、获得目前手机上的module和类的信息

五、与应用程序管理相关的函数

（1）、ISHELL_CreateInstance()

（a）、一个最重要的函数，可用于创建类的实例，特别是BREW接口

（b）、int ISHELL_CreateInstance(IShell * pIShell,AEECLSID cls, void ** ppobj);

（2）、ISHELL_ActiveApplet()

（3）、ISHELL_Busy()

（4）、ISHELL_CheckPrivLevel()

（5）、ISHELL_CanStartApplet()

（6）、ISHELL_Resume()

（7）、ISHELL_ForceExit()

（8）、ISHELL_CloseApplet()

（9）、ISHELL_EnumAppletInit()

（10）、ISHELL_EnumNextApplet()

（11）、ISHELL_GetHandler()

（12）、ISHELL_QueryClass()

（13）、ISHELL_RegisterHandler()

六、资源文件管理

（1）、能从资源文件（.bar）中读出具体信息

（2）、能从声音或图像文件中装载入相应的资源信息

七、与资源文件管理相关的函数

（1）、ISHELL_LoadResData()

（2）、ISHELL_ReleaseResData()

（3）、ISHELL_LoadResImage()

（4）、ISHELL_LoadResObject() 

（5）、ISHELL_LoadResSound()

（6）、ISHELL_LoadResString()

（a）、可用于从资源文件中读出字符串信息

（b）、int ISHELL_LoadResString( IShell * pIShell, 

const char * pszResFile,

int16 nResID,

AECHAR * pBuff,

int nSize);

（7）、ISHELL_LoadImage()

（8）、ISHELL_LoadSound()

八、设备和应用程序配置信息的管理

（1）、设备配置信息

（a）、ISHELL_GetDeviceInfo()

1、获得设备的信息：如屏幕尺寸、色深、可获得的内存、是否支持GPSone等信息

2、void ISHELL_GetDeviceInfo(  IShell * pIShell, AEEDeviceInfo * pi);

3、例子：

AEEDeviceInfo di;
di.wStructSize = sizeof(  AEEDeviceInfo  );

ISHELL_GetDeviceInfo (  pMe->a.m_pIShell,  &di  );

（2）、应用配置信息

（a）、ISHELL_SetPrefs()

（b）、ISHELL_GetPrefs()

1、提供一个结构以存储或获得应用的信息，如游戏中的最高分等

九、Notification

（1）、若一个应用想在任何时候接收事件通知，甚至当该应用没有运行的时候，则应在.mif文件中注册该通知信息

（2）、若当一个应用在运行的时候接收事件通知，则调用ISHELL_RegisterNotify()即可

十、Alarms

（1）、当指定的时间值到了时，会产生相应的事件通知信息。当应用没有运行时仍然可以接收到该信息

（2）、通常用于一段较长时间的通知，如日历通知

十一、Timers

（1）、当指定时间值到了后去完成指定的操作

（2）、时间间隔通常都较短 (毫秒到秒)

十二、Alarm和Timer函数

（1）、ISHELL_SetAlarm()

（2）、ISHELL_CancelAlarm()

（3）、ISHELL_SetTimer()

（4）、ISHELL_CancelTimer()

（5）、ISHELL_GetTimerExpiration()

十三、对话框, Message Boxes和 Prompts

（1）、利用资源编辑器创建

（2）、BREW AEE为目前的应用维护了一个对话框堆栈

（3）、处于活动状态的对话框接收所有的事件，并将这些事件分配给处于活动状态的控件

（4）、当调用IShell_EndDialog释放了处于活动状态的对话框，则堆栈中的下一个对话框将被激活

十四、与对话框, Message Box和Prompt 相关的函数

（1）、ISHELL_CreateDialog()

（2）、ISHELL_EndDialog()

（3）、ISHELL_GetActiveDialog()

（4）、ISHELL_MessageBox()

（5）、ISHELL_MessageBoxText()

（6）、ISHELL_Prompt()

十五、复习要点

（1）、描述IShell所提供的八大类服务

（2）、描述IShell API中所提供的重要的操作和属性

十六、问题回顾

（1）、Alarm，Timer和通知有和区别？他们分别在什么时候采用？

（2）、如何访问资源文件？

（3）、如何获取配置信息？

（4）、用什么方法可以创建一个接口的实例？