Native iOS

šŸŽ Native iOS Localization for Ditto ID SDK

This guide provides instructions to configure localization in a Native iOS application integrating the Ditto ID SDK, based on Section 11.4.1 of the integration guide.


🧾 Overview

Ditto ID Framework supports multilingual localization for custom languages. English is provided by default. Developers can add more languages and override existing string values.


šŸ“„ Required Files

The following .strings files are used by various components of the SDK:

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

These files are provided by Ditto.


šŸ› ļø Integration Steps

Step 1: Get the .strings Files

Request these files from the Ditto ID team.

Step 2: Add Files to Xcode

  • Drag and drop the string files into your Xcode project.

Step 3: Enable Localization

  • Select the string file (e.g., IDVCore.strings) in the project navigator.
  • In the Identity Inspector, click Localize.

Step 4: Add New Language

  • Go to Project > Info > Localizations.
  • Enable Use Base Internationalization if not already selected.
  • Click + to add a new language (e.g., French).

Step 5: Create Language-Specific File

  • Select the .strings file (e.g., IDVCore.strings).
  • Choose the new language (e.g., French).
  • Xcode will create a new file: IDVCore.strings (French).

Step 6: Customize Translations

Override the key-value pairs in the new file to reflect the localized strings.

"SCAN_DOCUMENT_PROMPT" = "Veuillez scanner le document";
"CAPTURE_SELFIE_PROMPT" = "Veuillez capturer un selfie";

šŸ” Repeat for Other Modules

Repeat steps 2–6 for rest of the other modules:


This setup ensures your iOS application delivers a fully localized experience across all Ditto ID SDK components.