Brand TruID client

This article describes how to brand a TruID client that shall be used with Smart ID Digital Access component.

TruID is a client application that generates One-Time Passwords (OTP). There is one generic TruID client and one TruID client for Android.

In the generic TruID client both text and graphics can be branded. The generic TruID client is located on the distribution disks under <DISK>/Client/Java/TruID.jar. This file is a ZIP file containg code, graphics and texts for the client.
In the TruID for Android client only the graphics can be branded. The application is an apk file that is packed using the zip format.

Step-by-step instructions

Generic TruID client, update graphics

Unpack the zip-file in the images directory.
To update the icon used for the application, update icon.png.
To update the logotype, update the files 0.png (the largest logotype), 1.png (the second largest logotype) and so on.
To update the black-and-white logotypes, update the files in the images/mono directory in the same way.

Note: When changing any files in the zip archive, the corresponding JAD file has to be updated with the new file size of the JAR file.

Generic TruID client, update texts

Find the locale for the client in the locale directory.
Use the file en.properties as a template for other locale files (en.properties is for English, this is the default).
If Swedish shall be used, create a file called sv.properties in the locale directory. When the application is started, the application will use the Swedish locale for showing all texts.

The client reports the current locale when opening the “about” page in the client. For example, if the phone’s locale is set to Swedish, the about page will report “sv” as language.

TruID for Android client, update graphics

Acquire the application and unzip the contents.

Modify any of these images in the res/drawable directory:

Filename	Resolution	Usage
pw_eye_smal.png	32x32	The low-res application icon used when displaying the application
pw_eye.png	48x48	The standard application icon used when displaying the application
pw_eye_large.png	72x72	The high-res application icon used when displaying the application
pw_logo_android.png	Logo used in application. Default is the PortWise logo.

After the graphics has been updated a new application has to be created. These are the tools used to create the new application:

keytool, jarsigner and zipalign (3:rd party tools).
- keytool and jarsigner comes from the JDK.
- zipalign comes from the Android SDK. Download and install SDK according to its documentation to use zipalign.

Remove the old signature by removing the META-INF directory.
Pack up the application:
1. Zip up all the files into a zip file with the modified graphics.
2. Rename the zip file to TruID-unaligned.apk.
Sign the application. All Android applications must be signed.
1. Generate key to be used for signing. It is important that the signature keys are safely stored.
  CODE
```
keytool -genkey -v -keystore my-release-key.keystore -alias alias_name -keyalg RSA -validity 10000
```
2. Sign the .apk file
  CODE
```
jarsigner -verbose -keystore my-release-key.keystore TruID-unaligned.apk alias_name
```

Align the signed apk.

CODE

zipalign -v 4 TruID-unaligned.apk TruID.apk