《BREW进阶与精通——3G移动增值业务的运营、定制与开发》连载之84——BREW中的应用加载机制

在BREW中，module是基本的执行单位，在手机上体现为.mod文件，在仿真器中体现为.dll文件。一个module可以包含一个或多个applet，或一个或多个扩展类（关于扩展类有单独的章节进行阐述）。凡是在手机上与其他代码一同编译完成的叫做静态模块，凡是通过下载方式（无线下载或者数据线下载）存于文件系统中的叫动态模块。
每个module都需要有标识自身的MIF文件，从BREW 3.1开始即使是静态module也需要有相应的MIF。而在BREW3.1之前，对于静态module是没有单独的MIF文件的，需要通过AEEAppInfo的结构体来表示module的信息，里面主要包括clsid，应用类型，图标等信息，每个静态 module都需要有一个实例化的AEEAppInfo结构体，AEE从此数据结构中获得必要的module信息。在环境初始化（AEE_init）的时候AEE通过枚举每个MIF文件来获得各个module的必要信息，比如clsid等。
针对BREW3.1以前的版本，由于静态module不存在MIF文件，所以过程有所不同。每个静态module的实现必须提供一个XXX_getmodinfo()，在该函数中返回特定于该module的Mod_Load（）函数指针，通常形式为 XXXMod_Load,同时返回特定于该module的AEEAppInfo结构数据。所有的这些XXX_getmodinfo函数指针构成了一个staticmodinfo的数组。初始化时AEE通过检索该数组（猜测执行其中的每一个函数）来获得每个static module的相关模块信息（比如clsid）以及加载函数。
Module的加载是在运行时才进行的。对于动态应用，加载是通过通用函数AEEMod_Load实现的，而AEEMod_Load实际是调用AEEStaticMod_New，在AeeModGen.c中可以看到该函数的声明。
int AEEStaticMod_New(int16 nSize, IShell *pIShell, void *ph, IModule **ppMod,
PFNMODCREATEINST pfnMC,PFNFREEMODDATA pfnMF)
{
AEEMod *pMe = NULL;
VTBL(IModule) *modFuncs;
if (!ppMod || !pIShell) {
return EFAILED;
}
*ppMod = NULL;
#ifdef AEE_SIMULATOR
if (!ph) {
return EFAILED;
} else {
g_pvtAEEStdLibEntry = (AEEHelperFuncs *)ph;
}
#endif
//Allocate memory for the AEEMod object
if (nSize < sizeof(AEEMod)) {
nSize += sizeof(AEEMod);
}
if (NULL == (pMe = (AEEMod *)MALLOC(nSize + sizeof(IModuleVtbl)))) {
return ENOMEMORY;
}
modFuncs = (IModuleVtbl *)((byte *)pMe + nSize);

// Initialize individual entries in the VTBL
modFuncs->AddRef = AEEMod_AddRef;
modFuncs->Release = AEEMod_Release;
modFuncs->CreateInstance = AEEMod_CreateInstance;
modFuncs->FreeResources = AEEMod_FreeResources;

// initialize the vtable
INIT_VTBL(pMe, IModule, *modFuncs);

// initialize the data members

// Store address of Module's CreateInstance function
pMe->pfnModCrInst = pfnMC;

// Store Address of Module's FreeData function
pMe->pfnModFreeData = pfnMF;
pMe->m_nRefs = 1;
pMe->m_pIShell = pIShell;

// Set the pointer in the parameter
*ppMod = (IModule*)pMe;
return SUCCESS;
}
上述代码在sdk中的AeeModGen.c可以找到，概括起来，就是在为module分配内存，并且实例化vtbl表，其中有两行代码值得注意：
modFuncs->CreateInstance = AEEMod_CreateInstance;
pMe->pfnModCrInst = pfnMC;
第一行是指定module的创建函数为AEEMod_CreateInstance，而第二行是指定该module具有自身特殊的创建函数，该函数即为参数pfnMC指定的函数。而在AEEMod_Load中调用AEEStaticMod_New时该参数为NULL，即所有动态 module采用通用的createinstance 函数（该函数实际上即为AEEClsCreateInstance）, 对于静态module，其实其自身的XXXMod_Load加载函数和通用的AEEMod_Load具体实现几乎一样，最主要的区别在于其调用AEEStaticMod_New时指定了pfnMC参数，即静态 module需要指定自身的创建函数。这是通过在AEEStaticMod_New中代码modFuncs->CreateInstance = AEEMod_CreateInstance 来指定，由AEEMod_CreateInstance函数来创建的。
static int AEEMod_CreateInstance(IModule *pIModule,IShell *pIShell, AEECLSID ClsId, void **ppObj) {
AEEMod *pme = (AEEMod *)pIModule;
int nErr = 0;
// For a dynamic module, they must supply the AEEClsCreateInstance()
// function. Hence, invoke it. For a static app, they will have
if (pme->pfnModCrInst) {
nErr = pme->pfnModCrInst(ClsId, pIShell, pIModule, ppObj);
#if !defined(AEE_STATIC)
} else {
nErr = AEEClsCreateInstance(ClsId, pIShell, pIModule, ppObj);
#endif
return nErr;
}
对于动态 module，由于pme->pfnModCrInst为NULL，所以调用通用的创建函数AEEClsCreateInstance(ClsId, pIShell, pIModule, ppObj)来进行创建。AEEClsCreatelnstance通过调用AEEAppGen.c的AEEApplet_New()方法来完成空间分配、虚函数表构造、初始化等一系列工作。而对于静态module，因为指定了自身的创建函数，所以pme->pfnModCrInst不为NULL，从而执行特定于该module自身的创建函数
不论是 AEEClsCreateInstance还是pme->pfnModCrInst其实都是类似的，通过AEEApplet_New（除extension 外通常都是调用该函数）来最终创建应用，AEEApplet_New无非是具体分配applet内存，初始化applet的vtbl（这里最重要的是实例化applet_handleevent）并返回Iapplet指针，供运行时使用 。