427
逸創雲客服
逸創雲客服 Android SDK常見問題FAQ
該文檔主要集中客戶在集成開發SDK過程中遇到的問題，後續會陸續更新。
注：以下SDK未作特殊說明，均指KF5AndroidSDK。
問題1:
原因分析：這種問題的出現由於Android Studio的Gradle配置不正確所致，當前問題多出現在Mac係統中的Android Studio。
答：找到全局Gradle，查看是否有以下配置；若沒有，加上再次編譯。
allprojects {
repositories {
jcenter()
}
}問題2：
java.lang.ClassNotFoundException:org.support.imageloader.core.assist.ImageScaleType。
原因分析：應該是應用程序方法總數超出了65535限製;
答：1.找到App目錄下的Gradle文件（如下圖），添加multiDexEnabled true配置；
2.在應用程序中Application類中添加MultiDex.install(this);然後編譯打包。
問題3：com.chosen.kf5sdk/kf5sdklibrary/1.3.2/AndroidManifest.xml;Suggestion: use tools:overrideLibrary="com.kf5sdk.library" to force usage
原因分析：由於SDK的minSdkVersion版本與項目中minSdkVersion版本不一致；
答：根據Suggestion意思，在AndroidManifest.xml文件中Application標簽中添加<uses-sdk tools:overrideLibrary="xxx.xxx.xxx"/>，其中的xxx.xxx.xxx為第三方庫包
名，如果存在多個庫有此異常，則用逗號分割它們，例如：<uses-sdk tools:overrideLibrary="xxx.xxx.aaa, xxx.xxx.bbb"/>，這樣做是為了項目中AndroidMani
fest.xml和第三方庫的AndroidManifest.xml合並時可以忽略最低版本限製。
問題4：android.content.ActivityNotFoundException: Unable to find explicit activity class {xxx.xxx.xxx/com.chosen.kf5sdk.xxxActivity}
原因分析：SDK中Activity未在應用程序中AndroidManifest.xml聲明；該異常隻會出現在以Module方式導入集成的工程中，Android Studio采用Gradle集成編譯不會此異常。
答：將下載的Module下的AndroidManifest.xml裏聲明的所有Activity以及Service以及各種Permission等全部複製到應用程序下的AndroidManifest.xml，然後編譯運行；Android Studio采用Gradle集成SDK不需要再次聲明，直接運行即可。
問題5：集成了SDK，混淆打包怎麼配置？
答：
-keep enum com.kf5sdk.model.MessageStatu { *; }
-dontwarn org.support.v4.**
-keepclassmembers class * {
void onEvent*(**);
}問題6：SDK是否會與我們的工程發生衝突？
答：發生衝突的是由於自己的工程與集成的第三方框架都引用了其他相同的框架；SDK對資源與組件命名都已kf5_開頭，正常情況是不會出現衝突；對於集成SDK之後出現finished with non-zero exit value異常，請確認自己的工程是否與其他第三方框架發生了衝突導致編譯不成功。
問題7：SDK主要包含哪些功能塊？
答：SDK 目前支持創建工單、查看工單列表、查看知識庫以及即時交談。
問題8：我們目前對於SDK有些功能塊暫時用不上，不知能否分包減少Apk大小？
答：為方便能夠快速方便集成以及SDK開發者高效管理版本，SDK目前的包完全支持發送工單、查看工單列表、查看知識庫以及即時交談功能；不支持分包。
問題9：集成你們的SDK，需要走哪些流程？
答：使用我們的SDK，首先需要在www.kf5.com注冊屬於您的平台地址。然後請仔細瀏覽官方提供的SDK開發文檔：https://developer.kf5.com/android/；SDK裏的用戶信息都將直接關聯到您所注冊的平台地址，所以前提必須先注冊。
問題10：瀏覽了SDK的官方文檔，對SDK的配置還不太清晰，請Support一下我們應該怎樣使用？
答：SDK能夠正常運行必須的步驟：
1. 在應用程序的Application中
調用SDK的全局初始化方法：
KF5SDKInitializer.initialize(context);
2. 調用SDK初始化用戶信息的方法
KF5SDKConfig.INSTANCE.init(context, userInfo, callBack);
回調接口回調onSuccess方法，初始化用戶信息合法，可在需要的時候啟動SDK。
回調接口回調onFailure方法，初始化用戶信息異常，請根據返回值定位問題。
初始化方法UserInfo參數詳細說明:
email:當前使用SDK的用戶郵箱。
phone:當前使用SDK的用戶手機號，座機號是不可以的；
appid:傳輸秘鑰，對每一個平台開發SDK時所生成的唯一的一串字符；這就是為什麼使用SDK之前需要先在www.kf5.com注冊平台的原因；
helpAddress:即您公司或者個人所注冊的平台地址，例如helptest.kf5.com;
name:用戶昵稱，即是注冊的平台後台所顯示的當前用戶的昵稱；與微信昵稱同理；
deviceToken:設備推送標識。即能夠代表當前設備唯一性的一串字符，具有唯一性，需要推送功能才賦值，不需要推送可以不賦值。顧名思義，推送標識也就是在需要發送推送時能夠通過當前標識找到有且唯一的設備。如果采用第三方的推送服務，第三方的服務有提供接口獲取代表當前設備的唯一推送標識；如果公司自己搭建推送服務，則開發者自行計算或者獲取（比如UUID或者getDeviceId()）能夠代表當前設備的唯一推送標識。
sdkName: 創建工單時工單的標題，默認值為“來自 android sdk 的工單反饋”；
verifyPriorityType ：驗證優先級；如果為VerifyPriorityTypePhone，則用手機號獲取用戶信息或者驗證信息是否合法，其他都用郵箱去獲取用戶信息或者驗證信息是否合法。
注意：當前使用SDK的用戶是指當前使用App的用戶，具備唯一性，email與phone是獲取用戶最主要的參數，請務必填寫正確格式，SDK目前支持email和郵箱初始化，兩者至少賦值一個；調用該方法主要獲取用戶信息或者驗證用戶信息是否合法。當後台能夠查詢到當前用戶的相關信息，則返回用戶信息，否則驗證當前初始化的用戶信息是否合法，主要是驗證郵箱格式是否正確、手機號格式是否正確、appid是否存在、郵箱和手機號是否對號入座等等。
問題11：請問AppID從哪裏得到？
答：AppID是KF5為每一個注冊平台的用戶在開發SDK時所生成的唯一字符串；隻代表當前平台，具備唯一性。查看與生成Appid隻有管理員擁有權限，具體生成方式如下：
1、 將菜單轉到係統設置>移動App SDK
2.添加一個APP ，完成之後提交
注意：若啟用推送，需要打開啟用推送通知；填寫回調函數，並且保證回調URL能夠正常訪問。
3. 查看APPID
問題12：請問怎麼自定義TopBar的UI？
答：請瀏覽SDK開發文檔中配置與起步第五條KF5ActivityUiConfig頭部樣式修改 https://developer.kf5.com/android/init/ 。
問題13：請問怎麼自定義其他Activity的UI？
答： 工單模塊UI設置：FeedBackActivity的UI管理類為FeedBackActivityUIConfig；
LookFeedBackActivity的UI管理類為LookFeedBackActivityUIConfig；
LookFeedBackActivity的適配器UI管理類LookFeedBackAdapterUIConfig；
FeedBackDetailsActivity的UI管理類為FeedBackDetailsActivityUIConfig；
FeedBackDetailsActivity的適配器UI管理為FeedBackDetailsAdapterUIConfig；
OrderAttributeActivity的UI管理類為OrderAttributeActivityUIConfig；
OrderAttributeActivity的適配器的UI管理類OrderAttributeAdapterUIConfig；
幫助中心模塊UI設置：HelpCenterActivity、HelpCenterTypeActivity、HelpCenterTypeChildActivity的UI管理類為HelpCenterActivityUIConfig；
即時交談模塊UI設置：ChatActivity的UI管理類為ChatActivityUIConfig；
ChatActivity的適配器UI管理類為ChatAdapterUIConfig；
想把SDK整得更完美？請瀏覽SDK開發文檔https://developer.kf5.com/android/。
最後更新：2017-02-07 22:27:00