HomeGuidesAPI ReferenceChangelog
Log InChangelog
Guides

First time SDK installation

Wallets SDK is available as a signed .aar/.xcframework file in Sharepoint. The Aera Wallets SDK utilizes Aera Secure ID SDK for signing and authentication. To be able to use the Wallets SDK, this peer dependency must also be installed. Secure ID SDK is also available as a signed .aar/.xcframework in Sharepoint. The version must match the version used in the Wallets SDK version. Both files are thus distributed together for each release, together with the release notes.


Android

Installation

  1. Download the newest Wallets SDK version from Sharepoint

  2. Place the Secure ID SDK and Wallets SDK .aar files in your projects lib folder

  3. Add the dependency to your build.gradle.kts file under the dependencies section.

    Example

    implementation(files("./libs/aeraWalletsSDK-debug.aar"))
    implementation(files("./libs/AeraSdk-androidx-release-TEST-signed.aar"))
  4. Gradle sync

Setup

  1. Create a util if necessary*
    import com.aerahost.aerawalletssdk.AeraWalletsFactory
    import com.aerahost.aerawalletssdk.IAeraWalletsSDK
    
    // ...
    
    object WalletsSDKFactoryUtil {
    	@JvmStatic
    	fun get(activity: Activity): IAeraWalletsSDK {
    		if (BuildConfig.DEBUG) {
          return AeraWalletsFactory.getInstance(activity, null)	
        }
        return AeraWalletsFactory.getInstance(activity, PlayDeviceVerification())
    	}
    }

*For PlayDeviceVerification information, see Google Play Integration API.

  1. Initialize the SDK in your activity
    class MainActivity : ComponentActivity() {
      private lateinit var walletsSDK: IAeraWalletsSDK
      	
    	override fun onCreate(savedInstanceState: Bundle?) {
    	super.onCreate(savedInstanceState)
    	walletsSDK = WalletsSDKFactoryUtil.get(this)
    	// ...

🆕 iOS

Plist

  • Ensure the Membership App has the following setup

    • Provide a Privacy description in the plist. For the SDK, Face ID is used, when present, to authenticate with Secure ID, e.g. for opening the wallet or signing transactions. The description will be displayed to the user when the Face ID permission is requested.


Installation

  1. Download the newest Wallets SDK version from Sharepoint
  2. Place the Secure ID SDK and Wallets SDK .xcframeworks files in your projects Frameworks folder. Delete the old frameworks when present.
    1. Ensure the frameworks are embedded with "Embed & Sign" to your Apps target "General", and required under "Build Phases" > "Link Binary with Libraries"

Setup

The iOS SDK can be integrated directly against the Aera Wallets SDK swift code, or via the Objective-C header.


Setup using Swift methods directly


import aerawalletssdk

AeraWalletsSDK.shared.getSDKInfo(...

Setup using the Objective-C header

Some cross-platform applications can not talk directly to Swift and needs to interact with the SDK via the SDK C-header.


Using bridged Objective-C header definitions:

import com.aerahost.aerawalletssdk.AeraWalletsSDK

AeraWalletsSDK.shared.getSDKInfoWithKeychainGroup(...

The Objective-C header file is provided as part of the .xcframework. Add a AeraWalletsSDK.def file to your iOS app root directory when needed

language = Objective-C
headers = aerawalletssdk.h
package = com.aerahost.aerawalletssdk
framework = aerawalletssdk
framework = Aera