gslocalization

Localización de iOS y Android utilizando hojas de Google

Idea básica

1. Exporte sus archivos de localización a las hojas de Google .
2. Traduce las localizaciones faltantes o actualice las existentes en las hojas de cálculo de Google .
3. Ejecute el script nuevamente para importar las localizaciones de la hoja de cálculo en su proyecto .

Instalación

Python 2.7 o preferiblemente Python 3 debe instalarse en su máquina con el comando pip también disponible.

Clone el repositorio y ejecute pip install -r requirements.txt .

Autorizar gslocalization con hojas de Google

1. Obtenga un archivo JSON service account key de su consola de desarrollador de Google
   • Iniciar sesión en https://console.developers.google.com
   • Seleccione su proyecto (o cree uno nuevo)
   • Asegúrese de que la Google Drive API y Google Sheets API estén habilitados
   • Vaya a Credentials y desde el menú Create credentials , seleccione Service account key
   • Seleccione su cuenta de servicio (o cree una nueva con el rol de App Engine Admin )
   • Asegúrese de que JSON esté seleccionado en las opciones Key type .
   • Haga clic en Create
   • Un archivo JSON comenzará a descargar. Guarde este archivo y úselo más tarde para la autenticación.

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 - Ruta a su archivo .xcodeproj
   • Se utiliza para llamar xcodebuild (exportación e importación de localizaciones)
   • Los archivos XLIFF generados se guardan en XLIFF_OUTPUT_DIR
2. XLIFF_OUTPUT_DIR - directorio de salida para los archivos XLIFF generados
3. JSON_AUTH_FILE_PATH - Ruta a la Service account key de Google Sheets
4. SHARE_EMAIL_ADDRESS : la dirección de correo electrónico para compartir las hojas de cálculo creadas
   • Dado que estamos utilizando una Service account key , todas las hojas de cálculo son creadas y propiedad de la cuenta de servicio (ex. [email protected])
   • Después de que la cuenta de servicio crea las hojas de cálculo, transfiere la propiedad del archivo a la dirección de correo electrónico proporcionada
   • Proporcione su dirección de correo electrónico para poder visualizar los resultados en las hojas de cálculo de Google
5. LOCALIZATION_LANGUAGES : una cadena que contiene múltiples códigos de idioma utilizados para la localización
   • Ej: "Es, Ru, Ja" para español, ruso y japonés
   • Esto no habilita la localización para un nuevo idioma en su proyecto Xcode
   • proporcionar idiomas que ya existen en su proyecto
6. DEV_LANGUAGE (opcional, predeterminado a en ): el código de idioma para el idioma de desarrollo del proyecto

Notas

• Este script exporta las localizaciones actuales para su proyecto utilizando xcodebuild .

• Analiza los archivos XLIFF obtenidos y los sube a las hojas de Google.

• Hay una hoja de cálculo para cada idioma, con el siguiente formato de nombre: {PROJECT_NAME}_{LANGUAGE_NAME}_localizations (ex. MyProject_Spanish_localizations , MyProject_Russian_localizations , etc.). Dentro de cada hoja de cálculo, hay una hoja de trabajo por plataforma (ex. ios_strings , android_strings ). El {PROJECT_NAME} se infiere del nombre de archivo xcodeproj .

• Todas las cuerdas se agregan a su hoja de cálculo correspondiente, con el siguiente encabezado:

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

  • Source: SOURCE_LANGUAGE = texto en el idioma de origen
  • Target: TARGET_LANGUAGE = Texto traducido en el idioma de destino
  • Example = vacío si la cadena contiene marcadores de posición ( %@, %d, etc. ). Este es un lugar para proporcionar un ejemplo para los traductores.
  • Comment = NSLocalisedString COMENTARIOS
  • String Key = la ID de la cadena
  • File Path = ruta relativa al archivo de origen del archivo String ( .strings o .storyboard )

• Después de actualizar la traducción en las hojas de Google, ejecute el mismo script nuevamente para importar las nuevas cadenas a su proyecto 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 - Nombre del proyecto (utilizado para prefijo el nombre de la hoja de cálculo)
2. PATH_TO_RES_FOLDER - ruta a su carpeta Android res
   • Busca esta carpeta para todos los archivos de strings.xml
   • Para cualquier archivo strings.xml , el idioma de destino se detecta mediante el nombre de la carpeta de Parrent (por ejemplo, values-es para español)
3. JSON_AUTH_FILE_PATH - Ruta a la Service account key de Google Sheets
4. SHARE_EMAIL_ADDRESS : la dirección de correo electrónico para compartir las hojas de cálculo creadas
   • Dado que estamos utilizando una Service account key , todas las hojas de cálculo son creadas y propiedad de la cuenta de servicio (ex. [email protected])
   • Después de que la cuenta de servicio crea las hojas de cálculo, transfiere la propiedad del archivo a la dirección de correo electrónico proporcionada
   • Proporcione su dirección de correo electrónico para poder visualizar los resultados en las hojas de cálculo de Google
5. DEVELOPMENT_LANGUAGE : el código de idioma de su lenguaje de desarrollo (default = en )

Notas

• Este script carga todos los archivos strings.xml dentro de PATH_TO_RES_FOLDER .

• Analiza los archivos XML obtenidos y los sube a las hojas de Google.

• Hay una hoja de cálculo para cada idioma, con el siguiente formato de nombre: {PROJECT_NAME}_{LANGUAGE_NAME}_localizations (ex. MyProject_Spanish_localizations , MyProject_Russian_localizations , etc.). Dentro de cada hoja de cálculo, hay una hoja de trabajo por plataforma (ex. ios_strings , android_strings ).

• Todas las cuerdas se agregan a su hoja de cálculo correspondiente, con el siguiente encabezado:

  Source: SOURCE_LANGUAGE | Target: TARGET_LANGUAGE | String ID

  • Source: SOURCE_LANGUAGE = texto en el idioma de origen
  • Target: TARGET_LANGUAGE = Texto traducido en el idioma de destino
  • String ID = la id de la cadena

• Después de actualizar la traducción en las hojas de Google, ejecute el mismo script nuevamente para sobrescribir los archivos strings.xml en su carpeta de recursos.

Dependencias

 # 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'

Consejos generales

1. Mantenga su proyecto bajo control de origen, esto le permite restaurar sus archivos de localización a su estado anterior, en caso de que este script rompa algo.

consejos de iOS

1. Use un valor predeterminado para cadenas localizadas. Al hacer esto, tendrá el valor predeterminado (generalmente la cadena en el lenguaje de desarrollo) en la columna del lenguaje de origen, en lugar de la tecla de cadena.
   • Para Objective C , use NSLocalizedStringWithDefaultValue(@"KEY", nil, [NSBundle mainBundle], @"DEFAULT_VALUE", @"COMMENT")] en lugar de NSLocalizedString(@"KEY", @"COMMENT")]
   • Para Swift , use NSLocalizedString("KEY", tableName: nil, bundle: Bundle.main, value: "DEFAULT_VALUE", comment: "COMMENT") en lugar de NSLocalizedString("KEY", comment: "COMMENT")
   • Use este script de Python para convertir las llamadas NSLocalizedString para incluir un valor predeterminado