Android平台以WebView方式集成HTML5+SDK方法

SDK

最新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导入现有原生工程

点击下载最新 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 平台5+SDK常用接口及使用示例请点击

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,544评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,430评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,764评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,193评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,216评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,182评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,063评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,917评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,329评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,543评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,722评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,425评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,019评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,671评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,825评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,729评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,614评论 2 353

推荐阅读更多精彩内容

  • ¥开启¥ 【iAPP实现进入界面执行逐一显】 〖2017-08-25 15:22:14〗 《//首先开一个线程,因...
    小菜c阅读 6,401评论 0 17
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 172,077评论 25 707
  • WebView·开车指南 2016-08-31BugDev 北京市东城区首席Bug布道师开山之作,一整月交通事故血...
    53c021c38a1d阅读 828评论 0 1
  • 最基础的使用方法 最简单的布局: 在Activity中使用WebView: 但只是这样的话,在模拟器上是会直接调到...
    HolenZhou阅读 7,799评论 12 33
  • 1.如果在react-native start的时候遇到下面问题 原因:端口号被占用 解决方案:在运行react-...
    悦者生存阅读 274评论 0 0