HTML5+ SDK 可以按照“獨(dú)立應(yīng)用”和“單頁面”兩種種方式進(jìn)行集成,兩種集成方式各有優(yōu)點(diǎn)宠漩。
獨(dú)立應(yīng)用集成方式:即Widget集成方式,開發(fā)者在集成后可在需要時(shí)啟動(dòng)HTML5+ SDK命爬,顯示指定目錄下的5+ WebAPP
單頁面集成方式:即Webview集成方式土匀,用戶可在需要時(shí)顯示一個(gè)支持5+擴(kuò)展API的Webview頁面。使用單頁面方式集成5+ SDK舱殿,在頁面內(nèi)不能調(diào)用plus.webview的API創(chuàng)建新的頁面奥裸,其他5+API的使用不受影響。
集成方法請參考SDK內(nèi)HBuilder-Integrate工程點(diǎn)擊下載最新SDK
集成步驟
一 將5+SDK導(dǎo)入現(xiàn)有原生工程
開發(fā)者需要根據(jù)加載的HTML頁面中將要用到的5+API沪袭,將涉及的5+SDK的jar包和資源文件導(dǎo)入到現(xiàn)有的Android原生工程中湾宙,并根據(jù)需求修改工程的Androidmanifest.xml文件。
各API需要導(dǎo)入的資源和AndroidManifest.xml文件需要修改地方請點(diǎn)擊查看以下文檔
二 5+SDK集成代碼編寫
1 創(chuàng)建一個(gè)繼承自ICoreStatusListener的類冈绊,并實(shí)現(xiàn)其中的方法侠鳄。
ICoreStatusListener類用來監(jiān)聽5+內(nèi)核的運(yùn)行事件,當(dāng)5+內(nèi)核運(yùn)行狀態(tài)發(fā)生變化時(shí)會(huì)觸發(fā)相應(yīng)的方法焚碌,包含以下幾個(gè)方法
void onCoreReady(ICore arg0)
說明:
5+內(nèi)核開始初始化時(shí)觸發(fā)
SDK的方法必須在調(diào)用SDK.init()之后才可以調(diào)用畦攘,在使用中通常在onCoreReady方法觸發(fā)時(shí)初始化5+SDK。
代碼示例:
@OverridepublicvoidonCoreReady(ICorecoreHandler){// 調(diào)用SDK的初始化接口十电,初始化5+ SDKSDK.initSDK(coreHandler);// 設(shè)置當(dāng)前應(yīng)用可使用的5+ APISDK.requestAllFeature();}
void onCoreInitEnd(ICore arg0)
說明:
5+內(nèi)核初始化完成時(shí)觸發(fā)
開發(fā)者要在5+內(nèi)核初始化完成才能調(diào)用SDK.startWebApp()等接口啟動(dòng)指定目錄下的5+Webapp
boolean onCoreStop()
說明:
5+內(nèi)核關(guān)閉時(shí)觸發(fā)
Object onCreateSplash(Context pContextWrapper)
說明:
Splash頁面創(chuàng)建時(shí)觸發(fā)
void onCloseSplash()
說明:
Splash頁面關(guān)閉時(shí)觸發(fā)
2 調(diào)用SDK.createWebview方法創(chuàng)建并啟動(dòng)5+ Webview
在5+內(nèi)核初始化完畢后可調(diào)用SDK.createWebview() 方法啟動(dòng)5+Webview知押,方法會(huì)創(chuàng)建并返回一個(gè)IWebview對象叹螟。
5+WebView創(chuàng)建后需要添加到要顯示該應(yīng)用的父View中。
在調(diào)用createWebview方法時(shí)需要傳入一個(gè)IWebviewStateListener用來監(jiān)聽頁面加載的進(jìn)度台盯。
IWebview對象創(chuàng)建成功后我們可以添加一個(gè)setOnKeyListener用來監(jiān)聽當(dāng)按鍵事件罢绽。
代碼示例
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){//設(shè)置單頁面集成的appidStringappid="test1";// 單頁面集成時(shí)要加載頁面的路徑,可以是本地文件路徑也可以是網(wǎng)絡(luò)路徑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:// 準(zhǔn)備完畢之后添加webview到顯示父View中静盅,設(shè)置排版不顯示狀態(tài)良价,避免顯示webview時(shí),html內(nèi)容排版錯(cuò)亂問題((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:// 頁面加載完畢蒿叠,設(shè)置顯示webviewwebview.obtainFrameView().obtainMainView().setVisibility(View.VISIBLE);break;}returnnull;}});finalWebViewwebviewInstance=webview.obtainWebview();// 監(jiān)聽返回鍵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 啟動(dòng)5+ 內(nèi)核
5+SDK在使用前首先要進(jìn)行5+內(nèi)核的初始化明垢,在啟動(dòng)時(shí)需要添加一個(gè)ICoreStatusListener用來監(jiān)聽5+內(nèi)核啟動(dòng)狀態(tài)。io.dcloud.feature.internal.sdk.SDK類的方法需要在5+內(nèi)核初始化后才能夠調(diào)用市咽。
同時(shí)還需要在5+內(nèi)核初始化后指定當(dāng)前將要使用哪種集成方式痊银。單頁面集成方式使用SDK.IntegratedMode.WEBVIEW參數(shù)指定當(dāng)前SDK將使用單頁面方式啟動(dòng)。
示例中5+ SDK是在Activity的onCreate方法中初始化施绎,在具體使用中可在任意時(shí)刻初始化5+內(nèi)核溯革。
publicvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);requestWindowFeature(Window.FEATURE_NO_TITLE);if(mEntryProxy==null){FrameLayoutrootView=newFrameLayout(this);// 創(chuàng)建5+內(nèi)核運(yùn)行事件監(jiān)聽WebviewModeListenerwm=newWebviewModeListener(this,rootView);// 初始化5+內(nèi)核mEntryProxy=EntryProxy.init(this,wm);// 啟動(dòng)5+內(nèi)核,并指定內(nèi)核啟動(dòng)類型mEntryProxy.onCreate(savedInstanceState,SDK.IntegratedMode.WEBVIEW,null);setContentView(rootView);}}
4 傳遞Activity事件給5+ SDK
開發(fā)者在集成5+SDK時(shí)可根據(jù)需要將Activity的事件傳遞給5+SDK引擎谷醉,5+引擎會(huì)將事件傳遞給監(jiān)聽事件的Webview致稀,由Webview進(jìn)行事件處理。
@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){// 非點(diǎn)擊icon調(diào)用activity時(shí)才調(diào)用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 平臺(tái)5+SDK常用接口說明