Native Android

🤖 Native Android Localization for Ditto ID SDK

This document provides step-by-step guidance for configuring localization support in a Native Android app using the Ditto ID SDK (based on Section 11.5.1).


🧾 Overview

Localization allows you to customize the SDK UI strings and provide support for multiple languages. If localization is not required, this section can be skipped.


📋 Required Files

Ensure you obtain the following XML files from the Ditto ID admin:

  • strings_rel_id.xml — For Ditto ID wrapper and core messages
  • strings_mtd.xml — For Ditto ID MTD messages
  • strings-idv.xml — For Ditto ID Core messages
  • strings-idv-doc-scan.xml — For document scanner module
  • strings-idv-face-scan.xml — For selfie capture module

These files correspond to the following SDK components:

ModuleFile Name
Ditto IDRELID.strings
Ditto MTDMTD.strings
IDV CoreIDVCore.strings
Document CaptureIDVDocumentCapture.strings
Selfie CaptureIDVSelfieCapture.strings

🛠️ Integration Steps

Step 1: Open Project

Open your Native Android project in Android Studio.

Step 2: Create Locale-Specific Values Folder

  • Navigate to res directory.
  • Right-click → New → Android Resource Directory.
  • Set Resource Type to values.
  • Choose Locale such as ru-RU for Russian.

Step 3: Add XML Files

Place the following XML files in the appropriate locale-specific directory (e.g., values-ru-rRU):

  • strings_rel_id.xml
  • strings_mtd.xml
  • strings-idv.xml
  • strings-idv-doc-scan.xml
  • strings-idv-selfie-capture.xml

Step 4: Customize Strings

Open the XML files and modify the strings for localization.

<string name="scan_document_prompt">Пожалуйста, отсканируйте документ</string>
<string name="capture_selfie_prompt">Пожалуйста, сделайте селфи</string>

Repeat this for each string that needs translation.


📌 Notes

  • You may optionally merge these into your main strings.xml, but the key names must remain unchanged.
  • Repeat for every language/region by creating additional values-<locale> folders.

With this setup, your Native Android app will support localized Ditto ID SDK workflows across all integrated components.