HTML5+ SDK 可以按照“独立应用”和“单页面”两种种方式进行集成，两种集成方式各有优点。
独立应用集成方式：即Widget集成方式，开发者在集成后可在需要时启动HTML5+ SDK，显示指定目录下的5+ WebAPP
单页面集成方式：即Webview集成方式，用户可在需要时显示一个支持5+扩展API的Webview页面。使用单页面方式集成5+ SDK，在页面内不能调用plus.webview的API创建新的页面，其他5+API的使用不受影响。
集成方法请参考SDK内HBuilder-Integrate工程点击下载最新SDK
集成步骤
一 将5+SDK导入现有原生工程
开发者需要根据加载的HTML页面中将要用到的5+API，将涉及的5+SDK的jar包和资源文件导入到现有的Android原生工程中，并根据需求修改工程的Androidmanifest.xml文件。
各API需要导入的资源和AndroidManifest.xml文件需要修改地方请点击查看以下文档
二 5+SDK集成代码编写
1 创建一个继承自ICoreStatusListener的类，并实现其中的方法。
ICoreStatusListener类用来监听5+内核的运行事件，当5+内核运行状态发生变化时会触发相应的方法，包含以下几个方法
void onCoreReady(ICore arg0)
说明：
5+内核开始初始化时触发
SDK的方法必须在调用SDK.init()之后才可以调用，在使用中通常在onCoreReady方法触发时初始化5+SDK。
代码示例：
@OverridepublicvoidonCoreReady(ICorecoreHandler){// 调用SDK的初始化接口，初始化5+ SDKSDK.initSDK(coreHandler);// 设置当前应用可使用的5+ APISDK.requestAllFeature();}
void onCoreInitEnd(ICore arg0)
说明：
5+内核初始化完成时触发
开发者要在5+内核初始化完成才能调用SDK.startWebApp()等接口启动指定目录下的5+Webapp
boolean onCoreStop()
说明：
5+内核关闭时触发
Object onCreateSplash(Context pContextWrapper)
说明：
Splash页面创建时触发
void onCloseSplash()
说明：
Splash页面关闭时触发
2 调用SDK.createWebview方法创建并启动5+ Webview
在5+内核初始化完毕后可调用SDK.createWebview() 方法启动5+Webview，方法会创建并返回一个IWebview对象。
5+WebView创建后需要添加到要显示该应用的父View中。
在调用createWebview方法时需要传入一个IWebviewStateListener用来监听页面加载的进度。
IWebview对象创建成功后我们可以添加一个setOnKeyListener用来监听当按键事件。
代码示例
classWebviewModeListenerimplementsICoreStatusListener{IWebviewwebview=null;LinearLayoutbtns=null;Activityactivity=null;ViewGroupmRootView=null;publicWebviewModeListener(Activityactivity,ViewGrouprootView){this.activity=activity;mRootView=rootView;btns=newLinearLayout(activity);mRootView.setBackgroundColor(0xffffffff);mRootView.getViewTreeObserver().addOnGlobalLayoutListener(newOnGlobalLayoutListener(){@OverridepublicvoidonGlobalLayout(){webview.onRootViewGlobalLayout(mRootView);}});}@OverridepublicvoidonCoreInitEnd(ICorecoreHandler){//设置单页面集成的appidStringappid="test1";// 单页面集成时要加载页面的路径，可以是本地文件路径也可以是网络路径Stringurl="file:///android_asset/apps/H5Plugin/www/index.html";webview=SDK.createWebview(activity,url,appid,newIWebviewStateListener(){@OverridepublicObjectonCallBack(intpType,ObjectpArgs){switch(pType){caseIWebviewStateListener.ON_WEBVIEW_READY:// 准备完毕之后添加webview到显示父View中，设置排版不显示状态，避免显示webview时，html内容排版错乱问题((IWebview)pArgs).obtainFrameView().obtainMainView().setVisibility(View.INVISIBLE);SDK.attach(mRootView,((IWebview)pArgs));break;caseIWebviewStateListener.ON_PAGE_STARTED:break;caseIWebviewStateListener.ON_PROGRESS_CHANGED:break;caseIWebviewStateListener.ON_PAGE_FINISHED:// 页面加载完毕，设置显示webviewwebview.obtainFrameView().obtainMainView().setVisibility(View.VISIBLE);break;}returnnull;}});finalWebViewwebviewInstance=webview.obtainWebview();// 监听返回键webviewInstance.setOnKeyListener(newOnKeyListener(){@OverridepublicbooleanonKey(Viewv,intkeyCode,KeyEventevent){if(keyCode==KeyEvent.KEYCODE_BACK){if(webviewInstance.canGoBack()){webviewInstance.goBack();returntrue;}}returnfalse;}});}@OverridepublicvoidonCoreReady(ICorecoreHandler){try{SDK.initSDK(coreHandler);SDK.requestAllFeature();}catch(Exceptione){e.printStackTrace();}}@OverridepublicbooleanonCoreStop(){// TODO Auto-generated method stubreturnfalse;}}
3 启动5+ 内核
5+SDK在使用前首先要进行5+内核的初始化，在启动时需要添加一个ICoreStatusListener用来监听5+内核启动状态。io.dcloud.feature.internal.sdk.SDK类的方法需要在5+内核初始化后才能够调用。
同时还需要在5+内核初始化后指定当前将要使用哪种集成方式。单页面集成方式使用SDK.IntegratedMode.WEBVIEW参数指定当前SDK将使用单页面方式启动。
示例中5+ SDK是在Activity的onCreate方法中初始化，在具体使用中可在任意时刻初始化5+内核。
publicvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);requestWindowFeature(Window.FEATURE_NO_TITLE);if(mEntryProxy==null){FrameLayoutrootView=newFrameLayout(this);// 创建5+内核运行事件监听WebviewModeListenerwm=newWebviewModeListener(this,rootView);// 初始化5+内核mEntryProxy=EntryProxy.init(this,wm);// 启动5+内核，并指定内核启动类型mEntryProxy.onCreate(savedInstanceState,SDK.IntegratedMode.WEBVIEW,null);setContentView(rootView);}}
4 传递Activity事件给5+ SDK
开发者在集成5+SDK时可根据需要将Activity的事件传递给5+SDK引擎，5+引擎会将事件传递给监听事件的Webview，由Webview进行事件处理。
@OverridepublicbooleanonCreateOptionsMenu(Menumenu){returnmEntryProxy.onActivityExecute(this,SysEventType.onCreateOptionMenu,menu);}@OverridepublicvoidonPause(){super.onPause();mEntryProxy.onPause(this);}@OverridepublicvoidonResume(){super.onResume();mEntryProxy.onResume(this);}publicvoidonNewIntent(Intentintent){super.onNewIntent(intent);if(intent.getFlags()!=0x10600000){// 非点击icon调用activity时才调用newintent事件mEntryProxy.onNewIntent(this,intent);}}@OverrideprotectedvoidonDestroy(){super.onDestroy();mEntryProxy.onStop(this);}@OverridepublicbooleanonKeyDown(intkeyCode,KeyEventevent){boolean_ret=mEntryProxy.onActivityExecute(this,SysEventType.onKeyDown,newObject[]{keyCode,event});return_ret?_ret:super.onKeyDown(keyCode,event);}@OverridepublicbooleanonKeyUp(intkeyCode,KeyEventevent){boolean_ret=mEntryProxy.onActivityExecute(this,SysEventType.onKeyUp,newObject[]{keyCode,event});return_ret?_ret:super.onKeyUp(keyCode,event);}@OverridepublicbooleanonKeyLongPress(intkeyCode,KeyEventevent){boolean_ret=mEntryProxy.onActivityExecute(this,SysEventType.onKeyLongPress,newObject[]{keyCode,event});return_ret?_ret:super.onKeyLongPress(keyCode,event);}publicvoidonConfigurationChanged(ConfigurationnewConfig){try{inttemp=this.getResources().getConfiguration().orientation;if(mEntryProxy!=null){mEntryProxy.onConfigurationChanged(this,temp);}super.onConfigurationChanged(newConfig);}catch(Exceptione){e.printStackTrace();}}protectedvoidonActivityResult(intrequestCode,intresultCode,Intentdata){mEntryProxy.onActivityExecute(this,SysEventType.onActivityResult,newObject[]{requestCode,resultCode,data});}
Android 平台5+SDK常用接口说明
网友评论