https://github.com/diamirio/fastlane-plugin-localize

https://github.com/diamirio/fastlane-plugin-localize

Last synced: about 5 hours ago
JSON representation

• Host: GitHub
• URL: https://github.com/diamirio/fastlane-plugin-localize
• Owner: diamirio
• License: mit
• Created: 2019-01-31T18:22:55.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2021-12-16T16:11:00.000Z (almost 3 years ago)
• Last Synced: 2024-11-12T13:54:51.841Z (3 days ago)
• Language: Ruby
• Size: 113 KB
• Stars: 18
• Watchers: 6
• Forks: 3
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# google_sheet_localize plugin

[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-google_sheet_localize)

## Getting Started

This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-google_sheet_localize`, add it to your project by running:

```bash

fastlane add_plugin google_sheet_localize

```

## About google_sheet_localize

Creates .strings files for iOS and strings.xml files for Android

to use our plugin you have to duplicate this google sheet: [_Example_](https://docs.google.com/spreadsheets/d/1fwRj1ZFPu2XlrDqkaqmIpJulqR5OVFEZnN35a9v37yc/edit?usp=sharing) 

Google Drive access token: [_Guide_](https://medium.com/@osanda.deshan/getting-google-oauth-access-token-using-google-apis-18b2ba11a11a)

* The language_titles (the columns which should be exported)

* The default_language (If a string is not present in a specific language, this is the fallback)

* The base_language (The language which is placed in the base values folder)

## Sheet Language 

#### Arguments: (Android + iOS + Web)  

English: `Mario ate a %2s %1s`.   

German: `Mario hat %1s einen %2s gegessen`.   

  

In this case `%2s` stands for __Apple__ and `%1s` for __Today__, the order is different in this example, so we need to take care of it.  

Mapped iOS: `Mario ate a %2$@ %1$@`.   

Mapped Android: `Mario ate a %2s %1s`.   

Mapped Web: `Mario ate a {2} {1}`.   

#### Plurals: (Android + iOS)

one|%d artist  

other|%d artists

#### String Array: (Android)

["Monday", "Tuesday", "Wednesday"]

## iOS specifics

In order to support Objective-C, the plugin provides the `support_objc` argument, which is default `false`.  

Therefore, if you need Objective-C support pass `support_objc: true`.

## Example

```ruby

  lane :localize do

    google_sheet_localize(service_account_path: "./fastlane/google_drive_credentials.json",

                                      sheet_id: "sheet id",

                                      platform: "ios",

                                          tabs: ["3TV"], #array of tab titles in google sheet

                             localization_path: "./Kit/TVKit",

                               language_titles: ["de", "en"], #language titles in google sheet

                              default_language: "de", #default language for google sheet

                                 base_language: "en") #ios: Base.lproj android: values 

  end

```

## Run tests for this plugin

To run both the tests, and code style validation, run

```

rake

```

To automatically fix many of the styling issues, use

```

rubocop -a

```

## Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository.

## Troubleshooting

If you have trouble using plugins, check out the [Plugins Troubleshooting](https://docs.fastlane.tools/plugins/plugins-troubleshooting/) guide.

## Using _fastlane_ Plugins

For more information about how the `fastlane` plugin system works, check out the [Plugins documentation](https://docs.fastlane.tools/plugins/create-plugin/).

## 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](https://fastlane.tools).