Hashing libraries for computing unique ids: MD5, SHA256, and SHA512

The Tealeaf SDKs use MD5 hashing for computing some unique ids, such as unique hash for images on the screen and session id. Apple has deprecated this API with iOS 13, and the API will be obsolete in future iOS versions. For this reason, the Tealeaf SDKs are moving away from MD5 hashing and adopting SHA256 and SHA512 algorithms.

The MD5-related code has been removed from tealeaf.framework and eocore.framework and added to a new library called TealeafMD5Hash.framework. This library is optional. If the iOS application is linked to this library, only then will the SDKs use MD5 hashing.

Tealeaf has also created the TealeafSHA512Hash.framework. This library is optional. If the iOS application is linked to this library, only then the SDK will use SHA512.

Tealeaf uses SHA256 as the default hashing algorithm. If the iOS application is not linked to TealeafMD5Hash.framework or TealeafSHA512Hash.framework, Tealeaf uses SHA256 for hashing.

You can use use either the TealeafSHA512Hash.framework, the TealeafMD5Hash.framework, or neither, but never both.

Integrating the MD5 framework

To use MD5 hashing, integrate the TealeafMD5Hash.framework into the iOS Application. For information, see Add the iOS SDK to your project.

When using MD5, consider the following:

If there are no new image files in your application, you do not need to change the images.zip file that you upload to the Tealeaf server. However, if there are new image files in your application, use the most recent version of Tealeaf Image tool to generate a new image set for Tealeaf Server. For details, see Push image files to the replay server.
Link to Tealeaf.framework, EOCore.framework, and TealeafMD5Hash.framework. For integration steps, see Add the iOS SDK to your project.
For testing, troubleshooting, and debugging, use the debug versions of Tealeaf.framework, EOCore.framework, and TealeafMD5Hash.framework.

Integrating the SH256 framework

SHA256 is the default hashing algorithm used by the SDK. There is no separate SHA256 library that needs to be integrated into the iOS application. For integration details, see Add the iOS SDK to your project.

When using SH256, consider the following:

Use the most recent version of Tealeaf Image tool to generate a new image set for the Tealeaf Server. For details, see Push image files to the replay server.
You need the most recent versions of Tealeaf.framework and EOCore.framework. For integration steps, see Add the iOS SDK to your project.
For testing, troubleshooting, and debugging, use the debug versions of Tealeaf.framework and EOCore.framework.

Integrating the SHA512 framework

To use SHA512 hashing, integrate TealeafSHA512Hash.framework into the iOS Application. For information, see Add the iOS SDK to your project.

Use the most recent version of Tealeaf Image tool to generate a new image set for the Tealeaf Server. For details, see Push image files to the replay server.
Link to Tealeaf.framework, EOCore.framework, and TealeafSHA512Hash.framework. For integration steps, see Add the iOS SDK to your project.
For testing, troubleshooting, and debugging, use the debug versions of Tealeaf.framework, EOCore.framework, and TealeafSHA512Hash.framework.