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 messagesstrings_mtd.xmlā For Ditto ID MTD messagesstrings-idv.xmlā For Ditto ID Core messagesstrings-idv-doc-scan.xmlā For document scanner modulestrings-idv-face-scan.xmlā For selfie capture module
These files correspond to the following SDK components:
| Module | File Name |
|---|---|
| Ditto ID | RELID.strings |
| Ditto MTD | MTD.strings |
| IDV Core | IDVCore.strings |
| Document Capture | IDVDocumentCapture.strings |
| Selfie Capture | IDVSelfieCapture.strings |
š ļø Integration Steps
Step 1: Open Project
Open your Native Android project in Android Studio.
Step 2: Create Locale-Specific Values Folder
- Navigate to
resdirectory. - Right-click ā New ā Android Resource Directory.
- Set Resource Type to
values. - Choose Locale such as
ru-RUfor 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.xmlstrings_mtd.xmlstrings-idv.xmlstrings-idv-doc-scan.xmlstrings-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.
Updated 2 months ago
