--- title: "Integrate the Secure Messaging SDK Client" slug: "sec-msg-sdk-client-ig-integrate-the-sdk-4-35-0" updated: 2026-10-05T16:02:26Z published: 2026-10-05T16:02:26Z canonical: "docs.onespan.com/sec-msg-sdk-client-ig-integrate-the-sdk-4-35-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Integrate the Secure Messaging SDK Client `MSSSecureMessagingClient.h` is the SDK's umbrella header and should be used for all integrations. Using `SecureMessagingSDKClient.h` may cause build errors when the header is imported directly. `SecureMessagingSDKClient.h` is not intended for public use, it is an internal C++ header, not the SDK's umbrella header. If your project imports this header directly, update your import statement as follows: Change from ```cpp #import ``` to ```cpp #import ``` > A deprecation notice for `SecureMessagingSDKClient.h` will be added in an upcoming release, and it will be removed from public headers in a future version of the SDK. ## Android ### AAR artifact-based integration To integrate the Secure Messaging SDK Client into your Android project via aar file - Link SecureMessagingSDKClient.aar from the OneSpan Mobile Security Suite package to your project's classpath. ### Maven-based integration The SDK artifact is also delivered as a local Maven repository with transitive dependencies, and the package includes a documentation jar file to view the technical documentation in Android Studio (to be used in conjunction with the Maven repository). To integrate the SDK via maven repository: 1. Copy the maven folder from the published artifacts to the root folder of your application. 2. Define the dependency in your build.gradle file: `implementation 'com.onespan:sdk_secure_messaging_client_java:+'`. 3. Comment out any existing definitions, for example: `implementation(name: 'SecureMessagingSDKClient', ext: 'aar'), implementation(name: 'SecureMessagingSDKServer', ext: 'jar')`. ## iOS To integrate the Secure Messaging SDK Client into your iOS project - Link MSSSecureMessagingClient.xcframework from the OneSpan Mobile Security Suite package to your Xcode project. > For Objective-C projects, use the .mm file extension when integrating the SDK. This is required as the SDK uses Objective-C++ and .m files are not supported. > Your project must be compiled with the libc++ standard library. You are now ready to use the Secure Messaging SDK Client. ## API reference documentation and sample applications To learn more about the public APIs and their functions, exceptions, and error codes, refer to the technical documentation that is included in the product package for each SDK and each platform. In the product package, you can also find the sample applications provided for each platform to see examples of how the SDKs can be used. > These sample apps are intended only to demonstrate basic scenarios and SDK usage. They are not designed to be copied directly into production projects!