STK App源码解析

STK这个应用，源码比较少，但理解起来并太容易懂，理解这一部分代码，需要对Java的消息机制非常熟悉，它在底层的流程，基本上都是收发消息的处理，而上层的UI很简单，只有两种UI：Dialog和Menu,所有的Dialog都是在StkDialogActivity显示出来的，List都是在StkMenuActivity中显示，具体显示什么内容和哪种UI，上层主要是通过对底层上报上来的消息类型来处理的,在上层所有的UI是没有这些固定内容的，需要根据Modem临时上报上来的内容进行显示，不同的SIM卡具有不同的UI,下面就对每一层的源码进行详细分析

STK 应用层：

BootCompletedReceiver：继承了 BroadcastReceiver，它是一个广播接收类，它只负责接收一个广播，Intent.ACTION_BOOT_COMPLETED，即开机启动完成的广播，当接收到开机启动完成后，开启服务StkAppService,传递参数StkAppService.OPCODE,为StkAppService.OP_BOOT_COMPLETED。

StkCmdReceiver：继承BroadcastReceiver，广播接收类，主要接收来自framework层的StkService发送的针对RIL层上报上来的处理结果的响应信息（详见StkService的handleProactiveCommand（）方法），它接收两种广播：
一种是AppInterface.STK_CMD_ACTION：处理从StkService服务上报上来的cmd回复信息，调用handleCommandMessage（）方法，该方法中新建一个启动StkAppService服务的Intent，intent中装载参数StkAppService.OPCODE为StkAppService.OP_CMD，OP_CMD所作的具体处理详见StkAppService的onStart()方法。

另一种是AppInterface.STK_SESSION_END_ACTION：处理从RIL层上报上来的cmd回复信息，调用handleSessionEnd（）方法，与handleCommandMessage（）方法作用相同，启动StkAppService服务，但是Intent对象传递的参数StkAppService.OPCODE为StkAppService.OP_END_SESSION ,结束会话的响应信息，上层具体操作详见StkAppService的onStart()方法。

StkAppService：继承自Service实现了Runnable接口，由开机后通过开机广播接收器第一次启动该服务（详见BootCompletedReceiver类说明）。
onCreate（）方法：通过调用StkService.getInstance()获取了StkService的实例（该   实例的创建详见StkService类说明）;
onStart（）方法：对接收到得intent传递的参数进行解析，通过mServiceHandler.obtainMessage()创建一个消息msg,匹配intent传递的参数OPCODE的值，对每一种值进行相应的处理，然后通过mServiceHandler.sendMessage(msg)发送（传递）消息，进行处理响应;
ServiceHandler类：是一个Handle类，处理onStart（）方法传递过来的消息，
OP_LAUNCH_APP：传递menu消息，将menu装载到Intent里，启动StkMenuActivity
OP_CMD：来自底层AT指令响应后的处理，消息来自于StkCmdReceiver发送的上报信息，创建一个StkCmdMessage 消息，调用handleCmd方法（详见handleCmd方法的说明）
 OP_RESPONSE：处理上层的请求，主要来自于ToneDialog、StkInputActivity、StkMenuActivity的操作请求，然后调用handleCmdResponse方法（详见该方法说明）
OP_END_SESSION：处理会话结束，调用handleSessionEnd()方法（详见该方法说明）
OP_BOOT_COMPLETED：处理开机启动完成消息，通过调mStkService.stkResponse()给StkService发响应通知。StkService中会给Ril层下发一个请求RIL_REQUEST_STK_RESPONSE，告诉modem已经开机并要求启动STK，没有返回的响应信息。
OP_DELAYED_MSG：处理延时消息，调用handleDelayedCmd()

handleCmd（）方法：这个方法主要通过对底层上报上来的消息的处理，在应用层执行相应的UI显示，获取的StkCmdMessage消息，根据不同的type的响应操作：
DISPLAY_TEXT：在屏幕上显示文字或图片,文字编码有三种格式
SELECT_ITEM：启动StkMenuActivity
SET_UP_MENU：建立一个菜单
GET_INPUT：
GET_INKEY：
SET_UP_IDLE_MODE_TEXT：
SEND_DTMF：
SEND_SMS：
SEND_SS：发送补充业务
SEND_USSD：发送USSD
LAUNCH_BROWSER：启动StkDialogActivity,显示一个确认Dialog
SET_UP_CALL：
PLAY_TONE：播放一个audio tone

handleCmdResponse（）方法：这个方法，是对上层的请求的下发处理，根据接收到得消息，创建新的响应信息StkResponseMessage，通过mStkService.onCmdResponse(resMsg)下发消息到StkService，被StkService的handleMessage接收消息，调用handleCmdResponse((StkResponseMessage) msg.obj)处理响应（详见StkService的 handleCmdResponse()方法说明）。
StkMenuActivity:主要是装载title、ListView、dialog

StkMenuActivity中下边的每一个视图的装载，都是通过在onCreate()中向StkAppService发Intent,StkAppService接收到StkMenuActivity发送过来的Intent，Intent中绑定了Bundle对象，通过Bundle对象中的OPCODE值，决定需要装载哪个ListView的数据。装载数据成功后，StkMenuActivity中的onResume()获取StkAppService中的Menu数据，并通过适配器显示出来。

 

 

 

STK framework层：
StkService：extends Handler implements AppInterface，通过AppInterface这个接口，使STK的应用层和framework层有一个很好的交互。

getInstance（）方法：遵循单例模式的原则创建创建StckService实例，如果该实例没有被初始化，则初始化，否则直接返回。此方法在GSMPhone的构造函数中被初始调用进行创建实例，在StkAppService的onCreate（）方法中调用的StkService.getInstance()获取了已经初始化了的StkService实例。
StkService（）方法：StkeService的构造方法，在getInstance()初始化StkService实例时被调用，new StkService(ci, sr, context, fh, sc); 同时获取RilMessageDecoder传来的处理消息，然后通过CommandsInterface的接口对象注册对RIL事件的处理，这些注册方法是在BaseCommands类中实现，注册后，能接收到来自RIL层的通知，详见RIL类的说明，注册的事件包括：

MSG_ID_SESSION_END，
MSG_ID_PROACTIVE_COMMAND，
MSG_ID_EVENT_NOTIFY，
MSG_ID_CALL_SETUP，

然后调用函数reportStkServiceIsRunning函数通知RIL层（详见RIL类说明），StkService服务已经启动。
handleMessage（）：StkService接收RIL层上报信息的重要消息处理方法，它接收的消息种类有：
MSG_ID_SESSION_END：此消息在StkService（）构造函数中注册，当RIL层接收到上报消息RIL_UNSOL_STK_SESSION_END时，通知发送此消息，通知StkService会话结束

MSG_ID_PROACTIVE_COMMAND：此消息在StkService（）构造函数中注册，当RIL层接收到上报消息RIL_UNSOL_STK_PROACTIVE_COMMAND时，通知发送此消息，发送来自modem的主动上报

MSG_ID_EVENT_NOTIFY：此消息在StkService（）构造函数中注册，当RIL层接收到上报消息RIL_UNSOL_STK_EVENT_NOTIFY时，通知发送此消息，
MSG_ID_REFRESH：
MSG_ID_CALL_SETUP：此消息在StkService（）构造函数中注册，当RIL层接收到上报消息RIL_UNSOL_STK_CALL_SETUP时，通知发送此消息，发送来自modem的拨打电话的主动上报消息

MSG_ID_SIM_LOADED：此消息在StkService()构造函数中注册，当Sim卡loaded完成，在SimRecords.java中会通知发送此消息，具体详见SimRecords.java中的onAllRecordsLoaded()方法

MSG_ID_RIL_MSG_DECODED：在RilMessageDecoder.java中对Ril上报消息进行解析后，将解析后的结果通过此消息发送回来，被StkService接收执行处理，接收此消息后，调用handleRilMsg((RilMessage) msg.obj)处理消息，详见handleRilMsg（）方法说明

MSG_ID_RESPONSE：处理上层发过来的请求消息，调用handleCmdResponse((StkResponseMessage) msg.obj)，详见handleCmdResponse（）方法说明
handleRilMsg（）方法:对各种消息进行解析处理后，调用此方法，具体处理各种消息：
MSG_ID_EVENT_NOTIFY：调用handleProactiveCommand（）方法，详见handleProactiveCommand（）方法说明
MSG_ID_PROACTIVE_COMMAND：调用handleProactiveCommand（）方法，详见handleProactiveCommand（）方法说明
MSG_ID_REFRESH：调用handleProactiveCommand（）方法，详见handleProactiveCommand（）方法说明
MSG_ID_SESSION_END：结束会话，调用handleSessionEnd()方法，创建一个Intent发送会话结束广播AppInterface.STK_SESSION_END_ACTION,此广播会被上层的StkCmdReceiver广播接收器接收，详见StkCmdReceiver类说明
MSG_ID_CALL_SETUP：
 
handleCmdResponse（）方法：接收来自上层的处理要求，往RIL下发终端请求，除几种特殊请求外，最终均调用sendTerminalResponse()方法，在该方法中通过调用CommandsInterface的sendTerminalResponse（）方法，将请求下发到RIL层，Ril实现了接口CommandsInterface，的类，sendTerminalResponse（）的具体实现，详见Ril.java，其中文件请求类型有：
HELP_INFO_REQUIRED:
OK:
PRFRMD_WITH_PARTIAL_COMPREHENSION:
PRFRMD_WITH_MISSING_INFO:
PRFRMD_WITH_ADDITIONAL_EFS_READ:
PRFRMD_ICON_NOT_DISPLAYED:
PRFRMD_MODIFIED_BY_NAA:
PRFRMD_LIMITED_SERVICE:
PRFRMD_WITH_MODIFICATION:
PRFRMD_NAA_NOT_ACTIVE:
PRFRMD_TONE_NOT_PLAYED:根据请求类型，做往RIL发相应的请求，请求类型有:
SET_UP_MENU：装载menu的请求，调用sendMenuSelection（）方法，将请求信息创   建为ByteArrayOutputStream字节数组输出流，通过调用CommandsInterface的sendEnvelope（）方法，将请求下发到RIL层，RIL类是实现了CommandsInterface的类，sendEnvelope（）的具体实现，详见RIL.java文件。
SELECT_ITEM：选中item的请求
GET_INPUT：在屏幕上显示文字或图片,文字编码有三种格式,并获取用户输入的字符串
GET_INKEY：在屏幕上显示文字或图片,文字编码有三种格式,并获取用户输入的一个字符
DISPLAY_TEXT：
LAUNCH_BROWSER：
SET_UP_CALL：打电话的请求，通过调用CommandsInterface的handleCallSetupRequestFromSim（）方法，将请求下发到RIL层，RIL类是实现了CommandsInterface的类，handleCallSetupRequestFromSim（）的具体实现，详见RIL.java文件
DISPLAY_TEXT：
LAUNCH_BROWSER
SET_UP_CALL
NO_RESPONSE_FROM_USER
UICC_SESSION_TERM_BY_USER
BACKWARD_MOVE_BY_USER
handleProactiveCommand（）方法：在这个方法中，处理一批请求，请求的处理均是调用sendTerminalResponse（）终端响应方法，sendTerminalResponse（）的说明详见handleCmdResponse（）方法，最后创建一个Intent，发一条广播：AppInterface.STK_CMD_ACTION到上层， AppInterface.STK_CMD_ACTION的处理详见StkCmdReceiver类的说明。

sendTerminalResponse（）方法：此方法在StkService接收到底层上报上来的消息时，会被调用，往RIL层下发请求，告诉modem终端已响应，modem稍后会主动上报会话结束通知回来，同时，StkService会启动上层的StkAppService去处理UI显示。
RIL层：
reportStkServiceIsRunning()方法：通知modem请求，StkService已经启动，转换为一条REQUEST: RIL_REQUEST_REPORT_STK_SERVICE_IS_RUNNING ，无响应返回信息
stkRefresh（）方法：通知modem请求刷新，转换为一条REQUEST: RIL_REQUEST_STK_REFRESH，无返回响应信息

stkResponse（）方法：通知modem，开机完成，启动Stk工具包，转换为一条REQUEST: RIL_REQUEST_STK_RESPONSE ，无返回响应信息
sendTerminalResponse（）方法：处理StkService发过来的终端操作的响应请求，转换为一条REQUEST: RIL_REQUEST_STK_SEND_TERMINAL_RESPONSE,具体AT指令详见reference-sc8800s.c文件说明，无返回的响应信息，在processSolicited（）方法中有相应的处理
sendEnvelope（）方法：处理StkService发过来的

handleCallSetupRequestFromSim（）方法：处理Stk拨打电话请求，转换为REQUEST: RIL_REQUEST_STK_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM, 具体AT指令详见reference-sc8800s.c文件说明，返回的响应信息，在processSolicited（）方法中有相应的处理
processUnsolicited()方法：stk请求modem未响应处理，通知StkService
RIL_UNSOL_STK_SESSION_END:
RIL_UNSOL_STK_PROACTIVE_COMMAND
RIL_UNSOL_STK_EVENT_NOTIFY
RIL_UNSOL_STK_CALL_SETUP

RIL的处理：
********************上报************************
RIL_UNSOL_STK_SESSION_END
RIL_UNSOL_STK_PROACTIVE_COMMAND
RIL_UNSOL_STK_EVENT_NOTIFY
RIL_UNSOL_STK_CALL_SETUP
RIL_UNSOL_SIM_REFRESH
********************命令************************
RIL_REQUEST_STK_GET_PROFILE
RIL_REQUEST_STK_SET_PROFILE
RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND
RIL_REQUEST_STK_SEND_TERMINAL_RESPONSE
RIL_REQUEST_STK_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM