Skip to content

i18n-agent/android-studio-plugin

Repository files navigation

i18n Agent for Android Studio

One-click localization for Android. Translate your strings.xml into any language without leaving Android Studio.

Install

  1. In Android Studio: Settings → Plugins → Marketplace → search i18n Agent → Install
  2. Install the CLI: npm install -g i18nagent
  3. Log in: i18nagent login

Usage

Action How to trigger
Pull Translations Tools → i18n Agent → Pull Translations, or right-click any strings.xml
Push Translations Tools → i18n Agent → Push Translations, or right-click any strings.xml

Pull scans your project for res/values/strings.xml, lets you pick target languages, translates via i18n Agent API, and writes results to res/values-{locale}/strings.xml.

Push finds all existing res/values-{locale}/strings.xml files and uploads them as translation memory pairs for future use.

Settings

Android Studio → Settings → Tools → i18n Agent

  • CLI Path — auto-detected from PATH, /usr/local/bin, /opt/homebrew/bin. Override here if needed.
  • Status — shows whether i18nagent login has been run.

Requirements

  • Android Studio Hedgehog (2023.1) or later
  • Node.js (for the CLI)
  • i18n Agent account

Development

./gradlew runIde        # Run plugin in a sandbox IDE
./gradlew test          # Run unit tests
./gradlew buildPlugin   # Build distributable ZIP

Release

Push a version tag to trigger automated publishing:

git tag v1.0.0
git push origin v1.0.0

GitHub Actions builds, tests, signs, and publishes to JetBrains Marketplace automatically.

Required GitHub repository secrets:

Secret Description
PUBLISH_TOKEN JetBrains Marketplace token
CERTIFICATE_CHAIN Plugin signing certificate (base64)
PRIVATE_KEY Plugin signing private key (base64)
PRIVATE_KEY_PASSWORD Signing key password

See Plugin Signing docs for how to generate signing keys.

Example

An example Android project for testing the plugin is included in the example/ directory. See example/README.md for setup and testing instructions.

License

MIT License - see LICENSE file.

Built by i18nagent.ai

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages