Troubleshooting

SDK Integration

Duplicate class error for apache/commons/codec/language

If you get a dex error like below which indicates that the apache/commons/codec/language classes are being added to the app more than once

You can remove these classes from the Helpshift.jar in two possible ways :

command line

zip -d Helpshift.jar org/apache/commons/codec/language/**

custom ant task

<target name="clean-apache" >
  <mkdir dir="./backup"/>
  <copy file="./libs/Helpshift.jar" todir="./backup"/>
  <jar destfile="./libs/Helpshift-temp.jar">
    <zipfileset src="./libs/Helpshift.jar" excludes="org/apache/commons/codec/language/**"/>
  </jar>
  <rename src="./libs/Helpshift-temp.jar" dest="./libs/Helpshift.jar"/>
</target>
<target name="restore-helpshift" >
  <move file="./backup/Helpshift.jar" todir="./libs"/>
</target>

Once done you can run a clean & compile. As these classes are already included in your application lib; they will be compiled into the final APK build and will work fine with Helpshift.

Dex merger error

If you get a dex merger error like below, enable the jumbo mode.

UNEXPECTED TOP-LEVEL EXCEPTION:
com.android.dex.DexException: Cannot merge new index 68218 into a non-jumbo
instruction!

To enable jumbo mode in Gradle add the following to your build.gradle -

android {
    dexOptions {
        jumboMode = true
    }
}

To enable jumbo mode in Ant add the following to your project.properties -

dex.force.jumbo=true

Duplicate class error for Lcom/helpshift/BuildConfig

If you get a dex error like below,

UNEXPECTED TOP-LEVEL EXCEPTION:
com.android.dex.DexException: Multiple dex files define
Lcom/helpshift/BuildConfig;

This indicates that two BuildConfig files are getting added to the App, once via the Helpshift.jar file and then via the helpshift-android-sdk resources

You can resolve this by deleting the BuildConfig file which comes with the Helpshift.jar by using the following command -

zip -d Helpshift.jar com/helpshift/BuildConfig.class

Miscellaneous

Helpshift Logs with low priority DEBUG

02-19 20:35:49.853: D/HelpShiftDebug(7651): org.json.JSONException: No value for pr
02-19 20:35:49.853: D/HelpShiftDebug(7651): at org.json.JSONObject.get(JSONObject.java:354)
02-19 20:35:49.853: D/HelpShiftDebug(7651): at

You can safely ignore the Helpshift SDK debug logs (log priority "DEBUG" / "Log.d") that are seen in DDMS / Android Monitor. These will not cause any issues with the proper functioning of the SDK.

Helpshift Warning with low priority

03-13 16:49:52.667 30615-1447/? W/MessageQueue : Handler (com.helpshift.HSApiData$4){427f1eb8} sending message to a Handler on a dead thread

This is just a warning, and this has been handled by the helpshift SDK. You can safely ignore it. These will not cause any issues with the proper functioning of the SDK.

UI Issues

Cannot scroll FAQ list, cannot switch FAQ tabs, keyboard input not working when creating a new conversation etc.

These UI issues are caused when hardware acceleration is turned off for Helpshift's activities. To ensure that hardware acceleration is turned on, add this to your AndroidManifest.xml file.

<activity
    android:name="com.helpshift.support.activities.ParentActivity"
    android:hardwareAccelerated="true"
    android:theme="@style/Helpshift.Theme.Activity"/>

Known Issues

No. Known Issue SDK
Version
Device OS Version Occurs When & Frequency Workaround
1 Clicking on search icon in FAQs screen causes an ANR when appcompat library version 25.1.0 is used. This happens due to unprecedented fragment lifecycle changes introduced in appcompat 25.1.0. Link here v4.7.0, v4.8.0 All

Frequency: Always

Use appcompat library version 25.0.1
2 Helphift SDK redraws layout with animations in multi-window mode when user resizes the window v4.7.0 Android v7.0

Frequency: Always

3 Issue due to storage permission invoke-revoke action v4.1.0 Android v6.0
  • Help -> Contact us -> Report conversation
  • Perform action like Revoke - invoke storage permission multiple times
  • Go to chat screen via help
  • You will notice that attach screenshot icon is not visible
  • Go back from chat screen.
  • Here you will have to press back button multiple times to go in main screen

Frequency : Rare

4 Crash due to FragmentTransaction animation on Samsung S3 v4.1.0 Samsung S3 (v4.3)

Frequency : Always

5 Chat screen goes up with keyboard while typing reply v4.1.0 Any

Frequency: Rare