android sdk 封装html5,Android平台以WebView方式集成HTML5+SDK方法
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常用接口說明
總結
以上是生活随笔為你收集整理的android sdk 封装html5,Android平台以WebView方式集成HTML5+SDK方法的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 5类主题词汇(4)
- 下一篇: android power 按键,And