gslocalization

Localização iOS e Android usando folhas do Google

Ideia básica

1. Export seus arquivos de localização para as folhas do Google .
2. Traduza as localizações ausentes ou atualize as existentes nas planilhas do Google .
3. Execute o script novamente para importar as localizações da planilha para o seu projeto .

Instalação

O Python 2.7 ou, de preferência, o Python 3 deve ser instalado em sua máquina com o comando pip também disponível.

Clone o repositório e execute pip install -r requirements.txt .

Autorizando gslocalization com as folhas do Google

1. Obtenha um arquivo JSON service account key do seu console do Google Developer Console
   • Faça login em https://console.developers.google.com
   • Selecione seu projeto (ou crie um novo)
   • Certifique -se de que a Google Drive API e Google Sheets API estejam ativadas
   • Vá para Credentials e, no menu Create credentials , selecione Service account key
   • Selecione sua conta de serviço (ou crie uma nova com a função App Engine Admin )
   • Verifique se JSON está selecionado nas opções Key type .
   • Clique em Create
   • Um arquivo JSON começará a baixar. Salve este arquivo e use -o posteriormente para autenticação.

iOS-gslocalization.py

Uso

python ios-gslocalization.py -x {PATH_TO_XCODEPROJ} -o {XLIFF_OUTPUT_DIR} -a {JSON_AUTH_FILE_PATH} -e {SHARE_EMAIL_ADDRESS} -l {LOCALIZATION_LANGUAGES} -d {DEV_LANGUAGE}

1. PATH_TO_XCODEPROJ - caminho para o seu arquivo .xcodeproj
   • Usado para ligar para xcodebuild (exportando e importar localizações)
   • Os arquivos XLIFF gerados são salvos para XLIFF_OUTPUT_DIR
2. XLIFF_OUTPUT_DIR - diretório de saída para os arquivos XLIFF gerados
3. JSON_AUTH_FILE_PATH - PACH para a Service account key do Google Sheets
4. SHARE_EMAIL_ADDRESS - o endereço de email para compartilhar as planilhas criadas
   • Como estamos usando uma Service account key , todas as planilhas são criadas e de propriedade da conta de serviço (por exemplo localizaçõ[email protected])
   • Depois que a conta de serviço cria as planilhas, ela transfere a propriedade do arquivo para o endereço de e -mail fornecido
   • Forneça seu endereço de e -mail para poder visualizar os resultados nas planilhas do Google
5. LOCALIZATION_LANGUAGES ​​- Uma string que contém vários códigos de idiomas usados ​​para localização
   • ex: "es, ru, ja" para espanhol, russo e japonês
   • Isso não permite a localização para um novo idioma em seu projeto Xcode
   • Forneça idiomas que já existem em seu projeto
6. DEV_LANGUAGE (opcional, padrões para en ) - o código do idioma para a linguagem de desenvolvimento do projeto

Notas

• Esse script exporta as localizações atuais para o seu projeto usando xcodebuild .

• Ele analisa os arquivos XLIFF obtidos e os carrega para o Google Sheets.

• Existe uma planilha para cada idioma, com o seguinte formato de nome: {PROJECT_NAME}_{LANGUAGE_NAME}_localizations (ex. MyProject_Spanish_localizations , MyProject_Russian_localizations , etc.). Dentro de cada planilha, há uma planilha por plataforma (Ex. ios_strings , android_strings ). O {PROJECT_NAME} é inferido no nome do xcodeproj .

• Todas as cordas são adicionadas à sua planilha correspondente, com o seguinte cabeçalho:

  Source: SOURCE_LANGUAGE | Target: TARGET_LANGUAGE | Example | Comment | String Key | File Path

  • Source: SOURCE_LANGUAGE = texto na linguagem de origem
  • Target: TARGET_LANGUAGE = Texto traduzido no idioma de destino
  • Example = vazio se a string contiver espaço reservado ( %@, %d, etc. ). Este é um lugar para fornecer um exemplo para os tradutores.
  • Comment = Comentários NSLocalisedString
  • String Key = o ID da string
  • File Path = caminho relativo para o arquivo de origem da string (arquivo .strings ou .storyboard )

• Depois de atualizar a tradução no Google Sheets, execute o mesmo script novamente para importar as novas seqüências para o seu projeto Xcode.

Android-Gslocalization.py

Uso

python android-gslocalization.py -p {PROJECT_NAME} -r {PATH_TO_RES_FOLDER} -a {JSON_AUTH_FILE_PATH} -e {SHARE_EMAIL_ADDRESS} -l {DEVELOPMENT_LANGUAGE}

1. PROJECT_NAME - Nome do projeto (usado para prefixar o nome da planilha)
2. PATH_TO_RES_FOLDER - PATH para sua pasta Android res
   • olha para esta pasta para todos os arquivos strings.xml
   • Para qualquer arquivo strings.xml , o idioma de destino é detectado pelo nome da pasta Parrent (por exemplo, values-es para espanhol)
3. JSON_AUTH_FILE_PATH - PACH para a Service account key do Google Sheets
4. SHARE_EMAIL_ADDRESS - o endereço de email para compartilhar as planilhas criadas
   • Como estamos usando uma Service account key , todas as planilhas são criadas e de propriedade da conta de serviço (por exemplo localizaçõ[email protected])
   • Depois que a conta de serviço cria as planilhas, ela transfere a propriedade do arquivo para o endereço de e -mail fornecido
   • Forneça seu endereço de e -mail para poder visualizar os resultados nas planilhas do Google
5. DEVELOPMENT_LANGUAGE - o código do idioma do seu idioma de desenvolvimento (padrão = en )

Notas

• Este script carrega todos os arquivos strings.xml dentro PATH_TO_RES_FOLDER .

• Ele analisa os arquivos XML obtidos e os carrega para o Google Sheets.

• Existe uma planilha para cada idioma, com o seguinte formato de nome: {PROJECT_NAME}_{LANGUAGE_NAME}_localizations (ex. MyProject_Spanish_localizations , MyProject_Russian_localizations , etc.). Dentro de cada planilha, há uma planilha por plataforma (Ex. ios_strings , android_strings ).

• Todas as cordas são adicionadas à sua planilha correspondente, com o seguinte cabeçalho:

  Source: SOURCE_LANGUAGE | Target: TARGET_LANGUAGE | String ID

  • Source: SOURCE_LANGUAGE = texto na linguagem de origem
  • Target: TARGET_LANGUAGE = Texto traduzido no idioma de destino
  • String ID = o id da string

• Depois de atualizar a tradução nas folhas do Google, execute o mesmo script novamente para substituir os arquivos strings.xml em sua pasta de recursos.

Dependências

 # parsing arguments
argparse

# provides access to Google Sheets API
pygsheets

# XML parsing for XML/XLIFF files
lxml

# type hinting
typing

# colored output in consolde
colorama

# conversion between language code and language name
langcodes; python_version>'3'
langcodes-py2; python_version<'3'

Dicas gerais

1. Mantenha seu projeto sob controle de origem Isso permite restaurar seus arquivos de localização ao estado anterior, caso esse script quebre alguma coisa.

Dicas para iOS

1. Use um valor padrão para seqüências localizadas. Ao fazer isso, você terá o valor padrão (geralmente a string no idioma de desenvolvimento) na coluna do idioma de origem, em vez da tecla String.
   • Para Objective C , use NSLocalizedStringWithDefaultValue(@"KEY", nil, [NSBundle mainBundle], @"DEFAULT_VALUE", @"COMMENT")] em vez de NSLocalizedString(@"KEY", @"COMMENT")]
   • Para Swift , use NSLocalizedString("KEY", tableName: nil, bundle: Bundle.main, value: "DEFAULT_VALUE", comment: "COMMENT") em vez de NSLocalizedString("KEY", comment: "COMMENT")
   • Use este script python para converter as chamadas NSLocalizedString para incluir um valor padrão