Guides

Localization

The ComPDF React Native SDK supports the following languages by default:

• English (en)
• Simplified Chinese (zh-Hans)
• Spanish (es)

Adding Additional Localization to ComPDF

Android Platform

You can add additional translations by putting them into the res/strings-XX directory of your app. Android will automatically merge all string resources at build time. You can also override ComPDF strings of existing languages by putting them into the respective string folders.

Tip: To view a list of all available ComPDF string resources, copy them to your project from the following URL:

strings.xml

Here’s an example of adding French support:

1. Create a app/src/main/res/values-fr directory in your project and create a strings.xml file in that directory.
2. Copy the content from the link above into the strings.xml file.

3. Translate the strings in the file to French. For example:

Original content:

<string name="tools_document_info">Document Info</string>

Translated to French:

<string name="tools_document_info">Informations du document</string>

4. Switch your device to French, run the project, and you will see the translated content:

iOS Platform

Configure the languages that require internationalization

1. Open your React Native project's iOS project using Xcode. Then, select Project -> Info -> Localizations, click '+', and add the desired language for internationalization/localization, as shown below (make sure to check 'Use Base Internationalization' by default):

   

2. Here, we'll use adding French as an example, as shown below:

   

3. Pop up the following dialog, and click 'Finish' directly, as shown below:

   

Internationalizing the application name

Internationalizing the application name refers to displaying different names for the same app in various language environments (i.e., the language settings on the mobile device).

1. Creating Localizable.strings file

   

2. Select Localizable.strings , click on Localize in the File inspection (right-side file inspector) in Xcode. Next, check French and English, as shown below:

   

3. Then open the ComPDF React Native iOS example, find the Localizable (English) file, select all the text, copy it, and paste it into the Localizable (English) file you created.

   

4. Finally, select the Localizable (French) file and configure the corresponding French translations according to the Localizable (English) file, ensuring that the number of text segments in both files is the same. For example, if the Localizable (English) file has "Viewer" = "Viewer";, the Localizable (French) file should have the corresponding "Viewer" = "Téléspectatrice";.