LocalizableGen

The tool takes a lot of inspiration from Poes.

A Swift command-line tool works with localizable file from Google Sheet. An easy way to help Business Analytics, Product Owner, Designer or non-tech will interact to the app with less involved from Developers.

LocalizableGen will helps you working with Localizable.strings(iOS) and strings.xml(Android):

• Generate that files from Spreadsheet for each languages you selected.
• Update the Spreadsheet from the files you already generated.

Dependencies

Thanks a lot to all of dependencies I have used in this project. If not, this tool can not be done. 🙏🙏🙏

• Auth Library for Swift
• Swift Argument Parser
• SWXMLHash
• ColorizeSwift

Requirements

• Xcode 13 or above
• Log in to Google Sheet and make copy from Template
• Give the access from this email localizable-gen-service-accoun@localizable-generator.iam.gserviceaccount.com to your Spreadsheet.

Setup Google Sheet

• Template have two sheets: ISO-639 and the base sheet template which include keys and values for each languages.

google-sheet-setup.mov

Note: Before Make a copy from that template and login to Google Sheet you won't see the select option from B1 -> Z1 which I have set up for easy select the language.

Usage

$ localizable-gen --help
OVERVIEW: A Swift command-line tool to generate localizable from Google
Sheet.localizable-gen-service-accoun@localizable-generator.iam.gserviceaccount.com

USAGE: localizable-gen <subcommand>

OPTIONS:
  -h, --help              Show help information.

SUBCOMMANDS:
  generate                Generate localizable file from your Spreadsheet.
  update                  Update current localizable file to your Spreadsheet.

Installation using Mint

You can install LocalizableGen using Mint as follows:

$ mint install huynguyen-n/LocalizableGen

Development

• Clone this repo
• Open Xcode by Package.swift file.

FAQ

Why is it "LocalizableGen"?

When app/module stable and not much feature in that Sprint. Frequently developers will be ask for update the strings file 🤔 I feel it's take time and would like to have a solution for that -> LocaliableGen came.

What problem does it solve?

BA, PO or Designers will be ask to update the Spreadsheet. Developer will generate the Localizable.strings or strings.xml and replace the current file.

Why is there a LocalizableGenCore framework?

This makes it really easy to eventually create a Mac App with a UI around it 🚀

Donation

LocalizableGen is free for you to use. I work on the app in my spare time. If you would like to support the development by donating, you can do so.

Thank you for being a part of the LocalizableGen community and supporting my open-source project!