gslocalization

Lokalisasi iOS dan Android menggunakan Google Sheets

Ide Dasar

1. Ekspor file lokalisasi Anda ke Google Sheets .
2. Terjemahkan lokalisasi yang hilang atau perbarui yang ada di spreadsheet Google .
3. Jalankan skrip lagi untuk mengimpor lokalisasi dari spreadsheet ke dalam proyek Anda .

Instalasi

Python 2.7 atau lebih disukai Python 3 harus diinstal pada mesin Anda dengan perintah pip juga tersedia.

Klon Repositori dan jalankan pip install -r requirements.txt .

Mengesahkan gslocalization dengan Google Sheets

1. Dapatkan service account key File JSON dari Konsol Pengembang Google Anda
   • Masuk ke https://console.developers.google.com
   • Pilih proyek Anda (atau buat yang baru)
   • Pastikan bahwa Google Drive API dan Google Sheets API diaktifkan
   • Pergi ke Credentials dan dari menu Create credentials , pilih Service account key
   • Pilih Akun Layanan Anda (atau buat yang baru dengan peran App Engine Admin )
   • Pastikan JSON dipilih dalam opsi Key type .
   • Klik Create
   • File JSON akan mulai mengunduh. Simpan file ini dan gunakan nanti untuk otentikasi.

ios-gslocalization.py

Penggunaan

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 - path ke file .xcodeproj Anda
   • Digunakan untuk memanggil xcodebuild (mengekspor dan mengimpor lokalisasi)
   • File Xliff yang dihasilkan disimpan ke XLIFF_OUTPUT_DIR
2. XLIFF_OUTPUT_DIR - Direktori Output untuk file XLIFF yang dihasilkan
3. JSON_AUTH_FILE_PATH - jalur ke Service account key Google Sheets
4. SHARE_EMAIL_ADDRESS - alamat email untuk membagikan spreadsheet yang dibuat
   • Karena kami menggunakan Service account key , semua spreadsheet dibuat dan dimiliki oleh akun layanan (mis. [email protected])
   • Setelah akun layanan membuat spreadsheet, ia mentransfer kepemilikan file ke alamat email yang disediakan
   • Berikan alamat email Anda untuk dapat memvisualisasikan hasil di Google Spreadsheets
5. LOCALIZATION_LANGUAGES ​​- Sebuah string yang berisi beberapa kode bahasa yang digunakan untuk lokalisasi
   • Contoh: "Es, Ru, JA" untuk Spanyol, Rusia dan Jepang
   • Ini tidak memungkinkan lokalisasi untuk bahasa baru dalam proyek XCODE Anda
   • menyediakan bahasa yang sudah ada di proyek Anda
6. DEV_LANGUAGE (opsional, default ke en ) - kode bahasa untuk bahasa perkembangan proyek

Catatan

• Script ini mengekspor lokalisasi saat ini untuk proyek Anda menggunakan xcodebuild .

• Ini mem -parsing file Xliff yang diperoleh dan mengunggahnya ke Google Sheets.

• Ada satu spreadsheet untuk setiap bahasa, dengan format nama berikut: {PROJECT_NAME}_{LANGUAGE_NAME}_localizations MyProject_Russian_localizations MyProject_Spanish_localizations . Di dalam setiap spreadsheet, ada satu lembar kerja per platform (mis. ios_strings , android_strings ). {PROJECT_NAME} disimpulkan dari nama file xcodeproj .

• Semua string ditambahkan ke spreadsheet yang sesuai, dengan header berikut:

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

  • Source: SOURCE_LANGUAGE = teks dalam bahasa sumber
  • Target: TARGET_LANGUAGE = teks diterjemahkan dalam bahasa target
  • Example = Kosong Jika string berisi placeholder ( %@, %d, etc. ). Ini adalah tempat untuk memberikan contoh bagi penerjemah.
  • Comment = Komentar NSLocalisedString
  • String Key = ID dari string
  • File Path = jalur relatif ke file sumber dari string (file .strings atau .storyboard )

• Setelah memperbarui terjemahan di Google Sheets, jalankan skrip yang sama lagi untuk mengimpor string baru ke proyek XCODE Anda.

android-gslocalization.py

Penggunaan

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 - Nama Proyek (Digunakan untuk mengawali nama spreadsheet)
2. PATH_TO_RES_FOLDER - Path to Android res Anda Folder Anda
   • melihat ke folder ini untuk semua file strings.xml
   • Untuk file strings.xml apa pun, bahasa target terdeteksi oleh nama folder Parrent (ex. values-es untuk bahasa Spanyol)
3. JSON_AUTH_FILE_PATH - jalur ke Service account key Google Sheets
4. SHARE_EMAIL_ADDRESS - alamat email untuk membagikan spreadsheet yang dibuat
   • Karena kami menggunakan Service account key , semua spreadsheet dibuat dan dimiliki oleh akun layanan (mis. [email protected])
   • Setelah akun layanan membuat spreadsheet, ia mentransfer kepemilikan file ke alamat email yang disediakan
   • Berikan alamat email Anda untuk dapat memvisualisasikan hasil di Google Spreadsheets
5. DEVELOPMENT_LANGUAGE - Kode bahasa bahasa pengembangan Anda (default = en )

Catatan

• Script ini memuat semua file strings.xml di dalam PATH_TO_RES_FOLDER .

• Ini mem -parsing file XML yang diperoleh dan mengunggahnya ke Google Sheets.

• Ada satu spreadsheet untuk setiap bahasa, dengan format nama berikut: {PROJECT_NAME}_{LANGUAGE_NAME}_localizations MyProject_Russian_localizations MyProject_Spanish_localizations . Di dalam setiap spreadsheet, ada satu lembar kerja per platform (mis. ios_strings , android_strings ).

• Semua string ditambahkan ke spreadsheet yang sesuai, dengan header berikut:

  Source: SOURCE_LANGUAGE | Target: TARGET_LANGUAGE | String ID

  • Source: SOURCE_LANGUAGE = teks dalam bahasa sumber
  • Target: TARGET_LANGUAGE = teks diterjemahkan dalam bahasa target
  • String ID = ID string

• Setelah memperbarui terjemahan di Google Sheets, jalankan skrip yang sama lagi untuk menimpa file strings.xml di folder sumber daya Anda.

Dependensi

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

Kiat Umum

1. Simpan proyek Anda di bawah kontrol sumber ini memungkinkan Anda untuk memulihkan file lokalisasi Anda ke keadaan sebelumnya, jika skrip ini memecahkan sesuatu.

Tip iOS

1. Gunakan nilai default untuk string terlokalisasi. Dengan melakukan ini, Anda akan memiliki nilai default (biasanya string dalam bahasa pengembangan) di kolom bahasa sumber, bukan tombol string.
   • Untuk Objective C , gunakan NSLocalizedStringWithDefaultValue(@"KEY", nil, [NSBundle mainBundle], @"DEFAULT_VALUE", @"COMMENT")] bukan NSLocalizedString(@"KEY", @"COMMENT")]
   • Untuk Swift , gunakan NSLocalizedString("KEY", tableName: nil, bundle: Bundle.main, value: "DEFAULT_VALUE", comment: "COMMENT") bukan NSLocalizedString("KEY", comment: "COMMENT")
   • Gunakan skrip Python ini untuk mengonversi panggilan NSLocalizedString untuk memasukkan nilai default