Home

Awesome

logo

translate-gpt plugin

fastlane Plugin Badge Gem Version

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-translate_gpt, add it to your project by running:

fastlane add_plugin translate_gpt

About translate-gpt

translate-gpt is a fastlane plugin that allows you to easily translate your iOS and Android app's strings using the OpenAI GPT API.

Features

Example

The following example demonstrates how to use translate-gpt in a Fastfile to translate an app's strings from English to French:

lane :translate_strings do
  translate_gpt(
    api_key: 'YOUR_API_KEY',
    target_language: 'fr'
  )
end

Options

The following options are available for translate-gpt:

KeyDescriptionEnvironment Variable
api_keyThe API key for your OpenAI GPT account.GPT_API_KEY
model_nameName of the ChatGPT model to useGPT_MODEL_NAME
temperatureWhat sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. Defaults to 0.5GPT_TEMPERATURE
request_timeoutTimeout for the request in seconds. Defaults to 30 secondsGPT_REQUEST_TIMEOUT
skip_translatedWhether to skip strings that have already been translated. Defaults to true.GPT_SKIP_TRANSLATED
source_languageThe source language of the strings to be translated. Defaults to auto-detection.GPT_SOURCE_LANGUAGE
target_languageThe target language of the translated strings. Required.GPT_TARGET_LANGUAGE
source_fileThe path to the Localizable.strings or strings.xml file to be translated.GPT_SOURCE_FILE
target_fileThe path to the output file for the translated strings.GPT_TARGET_FILE
contextCommon context for the translationGPT_COMMON_CONTEXT
bunch_sizeNumber of strings to translate in a single request.GPT_BUNCH_SIZE

Note: I advise using bunch_size. It will reduce the number of API requests and translations will be more accurate.

Providing context

The TranslateGptAction allows you to provide additional context for your translation requests in two ways:

1. Using a common context

You can provide a common context for your project that will be used in all translation requests. This can be done by setting the common property when calling the TranslateGptAction. The common property should be a string that describes the context of your project.

translate_gpt(
  target_language: 'fr',
  common: "This is a mobile app for ordering food online"
)

2. Adding comments for specific keys

You can also add comments to your Localizable.strings file for specific keys. These comments will be included in the translation request for that key. To add a comment for a specific key, simply include a comment before the key in your Localizable.strings file.

/* This is a comment for KEY1 */
"KEY1" = "Value for KEY1";

When you run the TranslateGptAction, the comment will be included in the translation request for KEY1.

Authentication

translate-gpt supports multiple authentication methods for the OpenAI GPT API:

API Key

You can provide your API key directly as an option to translate-gpt:

translate-gpt(
  api_key: 'YOUR_API_KEY',
  target_language: 'fr'
)

Environment Variable

Alternatively, you can set the GPT_API_KEY environment variable with your API key:

export GPT_API_KEY='YOUR_API_KEY'

And then call translate-gpt without specifying an API key:

translate-gpt(
  target_language: 'fr'
)

Issues and Feedback

If you have trouble using plugins, check out the Plugins Troubleshooting guide. For any other issues and feedback about this plugin, please submit it to this repository or contact the maintainers on Twitter.

Using fastlane Plugins

For more information about how the fastlane plugin system works, check out the Plugins documentation.

About fastlane

fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.

Contributing

If you'd like to contribute to this plugin, please fork the repository and make your changes. When you're ready, submit a pull request explaining your changes.

License

This action is released under the MIT License.