如何在 APICloud 平台使用腾讯 X5 引擎

目前 APICloud 与腾讯 X5 引擎已经达成全方位的深度合作， APICloud 在多个产品线深度集成 X5 引擎，广大 APICloud 开发者们即日起可通过以下几方面在你的 APP 中使用 X5 引擎，享受 X5 引擎带来的种种优势。

腾讯 X5 引擎官网： http://x5.tencent.com ；产品及优势介绍，可通过： http://x5.tencent.com/doc?id=1001 了解；

下面介绍如何在 APICloud 平台使用腾讯 X5 引擎：

一、在 SuperWebView 中使用

SuperWebview 是基于 APICloud 核心引擎的解决方案级 SDK 产品，提供给原生开发使用，原生应用集成 SuperWebview SDK 后，即可方便的通过 SuperWebview 来进行 H5 页面展示以及扩展 API 调用。 SuperWebview 详细介绍及使用流程见《 SuperWebview 开发指南里》。

在动态编译 SuperWebview SDK 时，针对 Android 平台，我们提供了基于 APICloud 核心引擎的版本和基于腾讯 X5 引擎的版本供开发者选择，如果开发者勾选了腾讯 X5 的版本，动态编译后的 SDK 中即搭载 X5 引擎。

使用流程：

登录 APICloud 官网： http://www.apicloud.com
进入控制台创建 “ Native ” 应用
创建成功后进入该应用的预览界面，点击左侧“动态生成”，进入 SDK 编译界面
在平台选择处勾选“腾讯 X5(Android)”
点击“编译 SDK ”按钮进行编译
将编译完成后的 SDK 下载，集成至你的 APP 项目中使用
集成该 SDK 后的 APP 在调用 SuperWebview 加载 H5 页面时，将使用 X5 引擎执行

二、在 WebApp 中使用

APICloud 提供对已有 H5 站点的“打包加壳”服务，通过在控制台创建“ WebApp ”项目，填写您的 H5 站点地址，进行启动界面， ICON 图标等简单配置后，即可将您的 H5 站点一键编译生成 Android 和 IOS 两个平台的 APP 安装包，该 APP 上线后能够使用 APICloud 提供的如推送、版本更新等各项云服务。

在编译 WebApp 时，针对 Android 平台，我们提供了基于 APICloud 核心引擎的版本和基于腾讯 X5 引擎的版本供开发者选择，如果开发者勾选了腾讯 X5 的版本，则编译后的 APP 将使用 X5 引擎加载您的 H5 站点。因 X5 引擎兼容微信的缘故，该 H5 站点将拥有其在微信当中运行效果和体验。

使用流程：

登录 APICloud 官网： http://www.apicloud.com
进入控制台创建 “ Web ” 应用
创建成功后进入该应用的预览界面，分别进行 “端设置”、“证书”等配置
点击左侧“云编译”，进入 APP 编译界面
在平台选择处勾选“腾讯 X5(Android)”
点击“云编译”按钮进行编译
编译完成后的 APP ，将使用 X5 引擎加载运行

三、在 DeepEngine 聚合 API 中使用

我们在聚合 API 中提供了名为“ webBrowser ”的内置浏览器功能模块，该模块内部集成了 X5 引擎，方便开发者在 DeepEngine 中使用 X5 引擎进行 H5 页面的展示。该模块通过可定制度高的“ BrowserView ”和独立 Browser （类似于微信）两种方式提供 API 。详细 API 见《 webBrowser API 文档》

使用流程：

登录 APICloud 官网： http://www.apicloud.com
进入控制台创建 “ Native ” 应用
创建成功后进入该应用的预览界面，点击左侧“模块”，进入模块绑定界面
搜索“ webBrowser ”模块，并勾选此后您编译的 APP 或者自定义 loader 中将包含搭载 X5 引擎的 webBrowser 模块，您可以在代码中通过： api.require(“ webBrowser ”)的方式使用搭载 X5 引擎的模块，调用其 API 完成您的需求。如：打开一个 X5View 到当前 Window ： webBrowser.openView({param});

加载 Url ： webBrowser.loadUrl({param});

执行脚本： webBrowser.loadScript({param});

直接打开独立浏览器： webBrowser.open({param});

等等

四、一些 X5 引擎相关的事项 X5 引擎目前只提供 Android 版本 X5 引擎采用动态加载机制，即只有当设备和网络环境满足 X5 引擎的加载要求时，才会使用 X5 引擎，其他情况下，将使用系统自带 Webkit 。