Introduction

This project's aim is to help with the translation of an Android app.
It will extract the strings.xml file of an app to a nice readable xlsx file, which can be sent to translators to work on.

If, after the translators will finish translating the file, you also interested in converting the translated file back to a strings.xml file, use the complementary library (os_android_strings_importer-py)

Installation

Install via pip:

pip install os_android_strings_extractor

Usage

Say you have this strings.xml file:

<resources>
    <string name="app_name">Memorizer</string>
    <string name="capital">Capital</string>
    <string name="country">Country</string>
    <string name="add_tab">Add List</string>
    <string name="action_settings">Settings</string>
    <string name="settings">Lists Settings</string>
    <string name="save">Save</string>
    <string name="delete">DELETE</string>
    <string name="entries">%1$s Entries</string>
    <string name="entry">%1$s Entry</string>
    <string name="from_definition_hint">Like: Date In History </string>
    <string name="to_definition_hint">To: Event</string>
    <string name="from_translation_hint">Like: Spanish</string>
    <string name="to_translation_hint">To: Hebrew</string>
    <string name="go">Go</string>
    <string name="entries_count">total entries: %1$s</string>
    <string name="entries_hard_count">hard entries: %1$s</string>
    <string name="tabs_list_title" translatable="false">Lists</string>
</resources>

Convert it to a readable excel file:

from os_android_strings_extractor import strings_extractor

strings_extractor.extract_to_xlsx(strings_file_path='/path/to/strings.xml',
                                  output_path='/your/output/file.xlsx',
                                  src_language='English',
                                  languages_list=['French', 'German', 'Hindi'])

And you will get the output: (notice the worksheets at the bottom -> 'French', 'German', 'Hindi')

Links

os_android_strings_importer-py -> Will import an xlsx file (made by os_android_strings_extractor) and convert it to an Android strings.xml file, after translation.

Licence

MIT