Android
To use the WBC SDK in your Android project
Link WBCSDK.aar from the OneSpan Mobile Security Suite package to your project's classpath.
Add the file generated by the White-Box Table Generator to the assets folder of your project.
You are now ready to use the WBC SDK. For more information on the functions, refer to the API documentation.
Additional Considerations
The integration of the WBC SDK on Android can cause some performance issues on low-end devices, during the loading of the WBC tables.
iOS
White-Box Cryptography SDK provides native protocols for Objective-C and Swift.
The following procedure enables you to integrate and use the WBC SDK in your iOS project.
If you use the White-Box Cryptography SDK on the iOS Simulator, the following warning can be included in the logs:
libMobileGestalt MobileGestalt.c:890: MGIsDeviceOneOfType is not supported on this platform.You can ignore this warning!
To use the WBC SDK in your iOS project
Link MSSWBC.xcframework from the OneSpan Mobile Security Suite package to your Xcode project (linked framework and libraries).
Add the file generated by the White-Box Table Generator to your project and verify that file is included in the app bundle.
To see the Objective-C error codes mapped to Swift error cases, refer to the WBCErrorCodes enum in the SDK's public header MSSWBC-Swift.h.
You are now ready to use the WBC SDK.
API reference documentation
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!