作者：?Nate Robinson（ArcBlock 團隊移動開發工程師）

5 天后，ArcBlock 第三場、中國的第一場內測版黑客馬拉松即將在北京舉行，截至本文推送之際，已有 56 人報名，剩余名額 4 個。ArcBlock 研發副總裁陳天、OCAP 項目負責人丁沛靈已經從西雅圖飛來北京，恭候各位黑客大駕光臨。

每場黑客松，我們都會提供越來越完善豐富的 SDK、工具和文檔，幫助開發者能在 ArcBlock 平臺開發更多更好的應用。今天，我們請 ArcBlock 團隊移動開發工程師 Nate Robinson 介紹如何玩轉? OCAP Android SDK。

前面想必大家已經看到了 iOS 的簡易集成攻略，估計 Android 的小伙伴們已經坐不住了，今天就在前幾篇的基礎上再給大家講解一下 ArcBlock Android SDK 的快速集成。文章整體的思路同 iOS，會以如何使用 ArcBlock Android SDK 開發一款簡單的 App 作為整篇文章的主線，那么讓我們開始吧！

1. 閱讀詳細的 ArcBlock Android SDK 入門文檔

詳細的?ArcBlock Android SDK 入門文檔?建議點開鏈接通讀一遍，文檔里面對整個 SDK 的使用做了詳細的說明，看完之后再回來看下面的入門文檔概括會有一個更清晰的理解。

入門文檔概括：

正確配置 maven，引入 Library

下載 schema.json，編寫 .graphql 文件，并配置好文件目錄

普通數據查詢

• CoreKitBeanMapper 初始化

• Query 初始化

• CoreKitViewModel 初始化與數據獲取的監聽事件設置

• 分頁數據查詢

• • CoreKitPagedHelper 初始化

  • CoreKitBeanMapper 初始化

  • CoreKitPagedViewModel 初始化與數據獲取監聽事件的設置

• 訂閱數據與監聽

• • 打開對應的 ABCoreKitClient 的 Socket 開關

  • Subscription 初始化

  • CoreKitSubViewModel 初始化與數據獲取監聽實踐設置

  另外可能需要額外注意一下的是 CustomType 和 ABCoreKitClient 初始化，這些可以在?ArcBlock Android SDK 入門文檔 - 其他配置?找到詳細的說明和代碼示例。

  2. 基于 ArcBlock Android SDK 開發 App 的例子

  首先，我們先看看最終要完成 App 的樣子，整體功能并不復雜，分頁查詢區塊，并以一個個正方形方塊代表一個個發生的交易，方塊顏色的深淺由交易的大小決定，點擊某個方塊進入到交易詳情界面，點擊查看更多跳轉到區塊交易分頁查看界面：

  整個 App 用到了三個數據查詢：

  • 區塊分頁查詢

  • 區塊交易分頁查詢

  • 區塊交易詳情查詢

  上面三個查詢語句保存在?PlayBook，感興趣的話可以打開探索一番

  完整項目代碼

  直接 clone 倉庫到本地即可運行，下面是具體的代碼講解。

  2.1 首頁區塊分頁界面

  在 MainActivity.java 的 initData() 方法中實現了區塊查詢的核心邏輯，重點看一下下面代碼：

  mBlocksByHeightQueryViewModel.getCleanQueryData().observe(this, new Observer<CoreKitPagedBean<List<BlocksByHeightQuery.Datum>>>() {@Overridepublic void onChanged(@Nullable CoreKitPagedBean<List<BlocksByHeightQuery.Datum>> coreKitPagedBean) {//1. handle return dataif (coreKitPagedBean.getStatus() == CoreKitBean.SUCCESS_CODE) {if (coreKitPagedBean.getData() != null) {// new a old listList<BlocksByHeightQuery.Datum> oldList = new ArrayList<>();oldList.addAll(mBlocks);// set mBlocks with new datamBlocks = coreKitPagedBean.getData();DiffUtil.DiffResult result = DiffUtil.calculateDiff(new CoreKitDiffUtil<>(oldList, mBlocks), true);// need this line , otherwise the update will have no effectmListBlocksAdapter.setNewListData(mBlocks);result.dispatchUpdatesTo(mListBlocksAdapter);refreshNextAndPre();}}//2. view status change and loadMore component needif (coreKitPagedHelper.isHasMore()) {mListBlocksAdapter.setEnableLoadMore(true);mListBlocksAdapter.loadMoreComplete();} else {mListBlocksAdapter.loadMoreEnd();}}});

  由于我們在初始化 ABCoreKitClient 的時候，設置的 ResponseFetcher 為 ApolloResponseFetchers.CACHE_AND_NETWORK ，所以這邊其實每次 query 會走兩遍回調事件，為了高效的去重與頁面刷新，這邊使用的是 Android 自帶的 DiffUtil。

  2.2 區塊交易分頁界面

  具體代碼在 BlockTxsActivity.java 界面中，分頁邏輯和首頁類似，這里就不重復講解了，大家看代碼即可。

  2.3 交易詳情界面

  具體代碼在 TxsDetailActivity.java 界面中，這里使用的是簡單的 Query 查詢與結果展示。

  3. 總結

  閱讀完文章與代碼，并一起運行 Demo App 到客戶端之后，大家已經完整體驗了一遍基于 ArcBlock Android SDK 開發 App 的過程，ArcBlock Android SDK 的價值遠不止于此，大家可以在此基礎上繼續探索?OCAP Playground?并思考自己的點子，然后結合 ArcBlock Android SDK 在 Android 客戶端上實現它們。

  相關閱讀

  ArcBlock 北京黑客松，你來不來？
  

  ArcBlock 博客 | OCAP 超簡易集成攻略（ iOS 版篇）
  

  ArcBlock 博客 | 淺析數據對區塊鏈行業發展的重要性
  

  ArcBlock 博客 | 開放鏈訪問協議為何采用 GraphQL
  

  ArcBlock 博客 | 如何解析 BITCOIN 的數據
  

  ArcBlock 博客 | 30 天 21 個版本 OCAP Playground 都經歷了哪些變化？
  

  ArcBlock 博客 | 如何在幾十個 Repo 中游刃有余？
  

  ArcBlock 博客 | OCAP Playground 入門指南

  更多ArcBlock區塊基石信息，柯林斯關注以下渠道了解：?

  • Twitter??|?https://twitter.com/ArcBlock_io

  • Instagram??|?https://www.instagram.com/arcblock/

  • Facebook??|?https://www.facebook.com/arcblock.io/

  • T?elegram??|?https://t.me/ArcBlock

  • LinkedIn??|?https://www.linkedin.com/company/18355951/

  • Reddit??|?https://www.reddit.com/r/arcblock/

  • 中??|?https://medium.com/arcblock

  • 博微??|?https://weibo.com/realArcBlock

  • 信微群??|?加拉群小助手：Ddchain

  • 電報群|?電報組：

    電報（英文）：??https：?//t.me/ArcBlock

    電報（繁體中文）：??https：?//t.me/ArcblockAsian

  ↙ArcBlock 官網 點擊登錄

總結

以上是生活随笔為你收集整理的ArcBlock 博客 | OCAP超简易集成攻略（Android 篇）的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。