This plugin translates the string resources in your Android project using the [Google Translate] (https://translate.google.com/). It also provides a few extras to help with common translation tasks.
THIS PLUGIN MAY CONTAIN TRANSLATIONS POWERED BY GOOGLE. GOOGLE DISCLAIMS ALL
WARRANTIES RELATED TO THE TRANSLATIONS, EXPRESS OR IMPLIED, INCLUDING ANY
WARRANTIES OF ACCURACY, RELIABILITY, AND ANY IMPLIED WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
The Androlate plugin performs translations for your convenience
using translation software powered by Google Translate. Reasonable efforts have
been made to provide an accurate translation, however, no automated translation
is perfect nor is it intended to replace human translators. Translations are provided
as a service to users of the Androlate tool, and are provided "as is." No warranty of
any kind, either expressed or implied, is made as to the accuracy, reliability,
or correctness of any translations made from <source language> into any other
language. Some content (such as images, videos, Flash, etc.) may not be accurately
translated due to the limitations of the translation software.
Any discrepancies or differences created in the translation are not binding and
have no legal effect for compliance or enforcement purposes.
-
[Google Translate] (https://translate.google.com/) is a PAID service. I am in no way responsible for any fees incurred as a result of using this tool including bugs. IT IS YOUR RESPONSIBILITY TO MONITOR USAGE AND BILLING.
-
In order for translations to work you MUST have the Google Translate API enabled in the [Google Developer Console] (https://console.developers.google.com/).
-
YOU MUST HAVE BILLING ENABLED IN ORDER FOR THE TRANSLATE API TO WORK. This means you must add a credit card to your Google Developer Console account and enable for the google translate API.
-
[Google Translate] (https://translate.google.com/) may shuffle words around since it is designed for natural language translations.
Example: Line1 nl Line2 nl Line3 => Línea 1 Línea 2 nl nl Line3
-
Some escape and formatting characters may not work (\n, %1$s). You will need to review the generated strings and correct mistakes manually.
-
Embedded html markup may be stripped by the Google Translate API (i.e. Hello <b>World!</b>)
- sections inside item elements won't be translated at this time.
An example projects can be found in /examples.
Modify your modules build.gradle file, not the project's root build.gradle file.
Add the androlate plug buildscript.dependencies section
buildscript {
repositories {
jcenter()
}
dependencies {
classpath('com.github.ayvazj.gradle.plugins.androlate:androlate:0.3')
}
}
Apply the plugin after the 'com.android.application' or 'com.android.library' plugins
apply plugin: 'com.android.application'
apply plugin: 'androlate'
Add the following section to your build.gradle file
androlate {
appName = 'API Project'
apiKey = '********************************'
defaultLanguage = 'en'
targetLanguages = ['es']
backup = true
}
Where:
appName
The name of the app you entered into the [Google Developer Console] (https://console.developers.google.com/)
apiKey
The API key obtained when you enable the Translate API key in the
[Google Developer Console] (https://console.developers.google.com/).
defaultLanguage
The source language or the language that values/strings.xml is written in. This value will be passed to
[Google Translate] (https://translate.google.com/) as the input language.
targetLanguages
A list of languages you are targeting. Keep in mind androlate will submit each string to
[Google Translate] (https://translate.google.com/) so complete translations may take a while and result in fees.
backup
True if string files should be backed up before modification.
Run the androlate target to translate the string resources
> ./gradlew -q androlate
Your strings files will be parsed and sent to [Google Translate] (https://translate.google.com/) for translation. The result will be stored in the values- directory with the same name as the source file.
####Unnecessary Translations (and fees) In order to avoid unnecessary translations androlate generates an md5 checksum for all of the strings in your default language. Only when the strings value does not match the md5sum is the string sent for translation. This ensures that on repeated runs only strings that have changed are sent for translation.
<string name="hello_world" xandrolate:md5="86f269d190d2c85f6e0468ceca42a20">Hello world!</string>
Extras tasks were added to help with common translation tasks.
####Export strings to iOS / Mac strings. The resulting files will be located under the export/apple directory.
> ./gradlew -q androlate-export-apple