? ? ? ? 最近,項目涉及到集成騰訊云IM纱扭,深受其害牍帚!故特記以此篇,望對各位看客能有所幫助乳蛾!
? ? ? ? 關于騰訊云集成暗赶,我打算分上中下三篇文章來分析鄙币;TIM踩坑記上篇,介紹騰訊云IM的集成和實現(xiàn)蹂随;TIM踩坑記中篇十嘿,針對騰訊云IM的實現(xiàn)代碼,基本邏輯等源碼進行分析岳锁;TIM踩坑記下篇绩衷,對于此次集成過程中碰到的一些問題進行匯總;
? ? ? ? demo中是將云通信需要的一些邏輯代碼激率、sdk等分別封裝到ui咳燕,sdk,presentation和tslibrary四個module中乒躺;考慮到其中有很多是不需要的招盲,為了方便代碼的管理,以及縮小項目apk大小嘉冒,當然也為了避免引入四個module編譯出現(xiàn)的一系列問題曹货,我將module中需要的代碼以及可能需要的代碼模塊導入了進來,然后進行修改讳推。
于是先給大家看看項目效果
集成步驟具體如下:
注:本文僅以截圖示意為主娜遵,具體資源,仍需以云通信文檔以及demo為主壤短!望見諒I枘狻!久脯!
第一步:在騰訊云通信IM上注冊應用纳胧,獲取SDKAPPID;
第二步:下載ImSdk帘撰,導入相關的so庫和依賴包跑慕;(關于這個so庫碰到的問題,將在下篇進行講解摧找;)
第三步:添加相關權限
第四步:聲明相關服務及廣播接收器
云通信相關的服務及廣播接收器
第五步:添加混淆規(guī)則(如果你的項目之前有混淆規(guī)則的話蹬耘,必須添加芝雪!不然打包的時候會報錯,各種文件找不到等等综苔;)
#------------------騰訊云通信----------------------------------
-keepclass com.tencent.**{*;}
-dontwarncom.tencent.**
-keepclass tencent.**{*;}
-dontwarntencent.**
-keepclass qalsdk.**{*;}
-dontwarnqalsdk.**
第六步:終于到正題了惩系;好嘛位岔!開始寫代碼;哦堡牡,不抒抬,是導代碼;首先晤柄,(一些資源文件可以先導進來)和集成其他sdk一樣擦剑,初始化imsdk;
初始化imsdk之后可免,仍需初始化用戶配置(必須得配置抓于,并且得在登錄之前進行配置----劃重點啦!=浇琛W酱椤),最初我是在messageFragment中初始化過一次妇垢,天真的我原以為巾遭,只需在初始化之后再次登錄即可;后來才發(fā)現(xiàn)闯估,這樣可能會導致一些問題灼舍;下篇將進行詳細解析!
第七步:初始化完了涨薪,那當然得開始搞事情啦骑素!將demo里的有用部分拉過來:主要包括event(實現(xiàn)被觀察者模式的幾個類)、imadapter(回話列表適配器刚夺、聊天列表適配器)献丑、imbeans(封裝的一些實體類,比較重要的就是消息的幾種類型侠姑,中篇會進行詳細的解析创橄,主要針對自定義消息。騰訊云IM文檔雖然寫的不怎么樣莽红,但是基本的消息發(fā)送還是沒問題的妥畏。所以大家主要關注下自定義消息即可)、imcontroller(消息相關的activity和fragment)安吁、imutil(一些工具類醉蚁,可以篩選優(yōu)化)、imwidgets(一些騰訊云封裝好的自定義控件)柳畔、presenter(ChatPresenter----聊天頁面邏輯馍管,conversationPresenter------回話列表頁面邏輯)、viewfeatures(接口)薪韩;
接下來就是刪除和修改一些沒必要的确沸;這就需要大家根據(jù)自己需求來修改捌锭。我就不一一貼出來了。
第八步:登錄
準確的講登錄是得服務器實現(xiàn)的罗捎,畢竟需要將我們app的賬號直接使用观谦;所以需要后臺提供一個根據(jù)token或者uid之類的值來獲取用戶、客服桨菜,或者賣家的identity和usersig豁状,然后,使用sharedpreferences來存儲這些信息倒得,再進行登錄泻红;大致思路是這樣的,其他細節(jié)霞掺,大家可以見仁見智谊路,自由發(fā)揮;
哦菩彬!還有一個那啥缠劝,,骗灶,需要實現(xiàn)離線推送的話惨恭,需要特別處理小米和華為手機(由于小米和華為ROM深度定制了安卓系統(tǒng),加強了權限的控制耙旦,第三方APP默認不會在系統(tǒng)的自啟動白名單里脱羡,APP在后臺很容易被系統(tǒng)殺掉,或者用戶手動將APP殺死免都, 因為沒有自啟動權限轻黑,APP的service無法自動重啟,從而導致被殺死后無法收到消息琴昆。為了保證APP被殺后,在小米設備和華為上仍然能夠收消息馆揉,可以集成小米和華為推送)业舍;具體實現(xiàn)步驟如下:
? ? ? ? ? ? ?1、分別在小米和華為開發(fā)者平臺中啟用推送服務升酣,獲取appkey等參數(shù)舷暮;這里不細說,可以查閱im文檔噩茄;
? ? ? ? ? ? ?2下面、在云通信IM的個人中心中,添加證書绩聘,獲取推送證書id沥割,并記錄小米推送的appid和appkey耗啦;
? ? ? ? ? ? 3、分別創(chuàng)建一個HwPushMessageReceiver和MiPushMessageReceiver机杜;
? ? ? ? ? ? 4帜讲、注冊推送服務
? ? ? ? 5椒拗、接下來就是清單文件中注冊服務和廣播接收器似将;
? ? ? ? 6、添加混淆規(guī)則
#------------------小米推送----------------------------------
-keepclass com.sinosoft.nanniwan.im.imutil.MiPushMessageReceiver {*;}
-dontwarncom.xiaomi.push.**
#------------------華為推送----------------------------------
-keepclass com.huawei.android.**{*;}
-dontwarncom.huawei.android.**
-keepclass com.baidu.mapapi.**{*;}
-dontwarncom.baidu.mapapi.**
? ? ? ? 詳細見云通信im文檔蚀苛;(云通信文檔中的華為的混淆規(guī)則在验,中間有空格,還請大家仔細堵未!莫被坑R干唷!P肆铩)
? ? ? ? 以上侦厚,基本上就實現(xiàn)了云通信IM的集成;當然拙徽,有很多細節(jié)刨沦,本文沒能講述,需要大家自行揣度膘怕!關于云通信的一些拓展和排坑想诅,將在接下來兩篇文章中講解!