如何在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引擎。

使用流程：

1. 1.  登錄APICloud官網：http://www.apicloud.com

2. 2.  進入控制臺創建 “Native”應用

3. 3.  創建成功后進入該應用的預覽界面，點擊左側“動態生成”，進入SDK編譯界面

4. 4.  在平臺選擇處勾選“騰訊X5(Android)”，如下圖：

1. 1.  點擊“編譯SDK”按鈕進行編譯

2. 2.  將編譯完成后的SDK下載，集成至你的APP項目中使用

3. 3.  集成該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站點將擁有其在微信當中運行效果和體驗。

使用流程：

1. 1.  登錄APICloud官網：http://www.apicloud.com

2. 2.  進入控制臺創建 “Web”應用

3. 3.  創建成功后進入該應用的預覽界面，分別進行 “端設置”、“證書”等配置

4. 4.  點擊左側“云編譯”，進入APP編譯界面

5. 5.  在平臺選擇處勾選“騰訊X5(Android)”，如下圖：

1. 1.  點擊“云編譯”按鈕進行編譯

2. 2.  編譯完成后的APP，將使用X5引擎加載運行

三、在DeepEngine聚合API中使用

我們在聚合API中提供了名為“webBrowser”的內置瀏覽器功能模塊，該模塊內部集成了X5引擎，方便開發者在DeepEngine中使用X5引擎進行H5頁面的展示。該模塊通過可定制度高的“BrowserView”和獨立Browser（類似于微信）兩種方式提供API。詳細API見《webBrowserAPI文檔》

使用流程：

1. 1.  登錄APICloud官網：http://www.apicloud.com

2. 2.  進入控制臺創建 “Native”應用

3. 3.  創建成功后進入該應用的預覽界面，點擊左側“模塊”，進入模塊綁定界面

4. 4.  搜索“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。

相關QA請參考X5官網：

常見問題：http://x5.tencent.com/doc?id=1002_1

CSS相關：http://x5.tencent.com/guide?id=2002

JS相關：http://x5.tencent.com/guide?id=2003

網絡相關：http://x5.tencent.com/guide?id=2005

渲染相關：http://x5.tencent.com/guide?id=2006

音頻視頻相關：http://x5.tencent.com/guide?id=2009

騰訊移動產品論壇X5專區：http://bbs.mb.qq.com/forum-110-1.html