Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

Android localization helper

Project description

[![Build Status](https://api.travis-ci.org/jordanjoz1/android-localization-helper.svg?branch=master)](https://travis-ci.org/jordanjoz1/android-localization-helper)

android-localization-helper
===========================

Make sure that you aren't missing string translations in any language, and keep your localized strings organized.

If you're like us at [DoubleDutch](doubledutch.me), you occassionally lose track of what strings have and haven't been translated in each language. Android Studio [made an awesome GUI](http://tools.android.com/recent/androidstudio087released) to help deal with this issue, but there is no easy way to export missing strings, so if you are missing more than a few strings in a language it can become a tenuous problem.


## Getting started
Requirements:

* Python >= 2.7.*
* [Standard Android project structure](https://developer.android.com/tools/projects/index.html) for localized values-* folders in `res/` folder

Coming soon:
* Ability to install with `pip`

## Usage - general
Navigate to your project's `res/` directory and run the script:

```
python ./translation_helper.py
```

As in the [sample output](./sample_output), the script will create a directory called **to_translate** with files for the strings that need to translated in each language. If a language has translations for all the strings in the default language, then it won't get an output file. Now you know exactly what translations you need to add for each language, and you can send them out for translation.

### Options

#### -h, --help
Prints help message.

#### --res
Path to the app's /res folder. Like, `./main/res`

By default assumes the current directory

#### --output
Output directory path (directory will be created automatically). Like, `~/Desktop`

By default creates *to_translate* folder in the current directory.

#### --clean
Clean the existing `string.xml` files for each language. This will remove strings that are in the localized language but not in the default language (they presumably got removed from the default langauge). It will also sort the strings so that they are in the same order as the default language.


## Release History
* 2015-01-15   v0.1.0   Initial release

CHANGES
=======


0.1.0 (2015-01-03)
------------------

- Initial release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for android-localization-helper, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size android_localization_helper-0.1.0-py2.py3-none-any.whl (7.0 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size android-localization-helper-0.1.0.tar.gz (5.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page