gslocalization

การแปล iOS และ Android โดยใช้ Google Sheets

แนวคิดพื้นฐาน

1. ส่งออก ไฟล์การแปลของคุณ ไปยัง Google Sheets
2. แปล การแปลที่ขาดหายไปหรืออัปเดตสิ่งที่มีอยู่ ใน Google สเปรดชีต
3. เรียกใช้สคริปต์อีกครั้งเพื่อ นำเข้าการแปล จากสเปรดชีต ลงในโครงการของคุณ

การติดตั้ง

Python 2.7 หรือ Python 3 ควรติดตั้งบนเครื่องของคุณด้วยคำสั่ง pip ด้วย

โคลนพื้นที่เก็บข้อมูลและเรียกใช้ pip install -r requirements.txt

อนุญาตให้ใช้ gslocalization ด้วย Google Sheets

1. รับไฟล์ service account key จากคอนโซลผู้พัฒนา Google ของคุณ
   • เข้าสู่ระบบ https://console.developers.google.com
   • เลือกโครงการของคุณ (หรือสร้างใหม่)
   • ตรวจสอบให้แน่ใจว่าเปิดใช้งาน Google Drive API และ Google Sheets API
   • ไปที่ Credentials และจากเมนู Create credentials เลือก Service account key
   • เลือกบัญชีบริการของคุณ (หรือสร้างบัญชีใหม่ด้วยบทบาท App Engine Admin )
   • ตรวจสอบให้แน่ใจว่า JSON ถูกเลือกในตัวเลือก Key type
   • คลิก Create
   • ไฟล์ JSON จะเริ่มดาวน์โหลด บันทึกไฟล์นี้และใช้งานในภายหลังเพื่อตรวจสอบสิทธิ์

ios-gslocalization.py

การใช้งาน

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 - พา ธ ไปยังไฟล์ .xcodeproj ของคุณ
   • ใช้สำหรับการโทร xcodebuild (การส่งออกและนำเข้า localizations)
   • ไฟล์ xliff ที่สร้างขึ้นจะถูกบันทึกไว้ที่ XLIFF_OUTPUT_DIR
2. XLIFF_OUTPUT_DIR - ไดเรกทอรีเอาต์พุตสำหรับไฟล์ xliff ที่สร้างขึ้น
3. JSON_AUTH_FILE_PATH - เส้นทางไปยัง Service account key Google Sheets
4. SHARE_EMAIL_ADDRESS - ที่อยู่อีเมลเพื่อแบ่งปันสเปรดชีตที่สร้างขึ้น
   • เนื่องจากเราใช้ Service account key สเปรดชีตทั้งหมดจึงถูกสร้างและเป็นเจ้าของโดยบัญชีบริการ (เช่น [email protected])
   • หลังจากบัญชีบริการสร้างสเปรดชีตมันจะโอนการเป็นเจ้าของไฟล์ไปยังที่อยู่อีเมลที่ให้ไว้
   • ระบุที่อยู่อีเมลของคุณเพื่อให้เห็นภาพผลลัพธ์ใน Google Spreadsheets
5. LOCALIZATION_LANGUAGES ​​- สตริงที่มีรหัสภาษาหลายภาษาที่ใช้สำหรับการแปล
   • ตัวอย่าง: "ES, RU, JA" สำหรับสเปนรัสเซียและญี่ปุ่น
   • สิ่งนี้ไม่ได้เปิดใช้งานการแปลภาษาใหม่ในโครงการ XCode ของคุณ
   • ให้ภาษาที่มีอยู่แล้วในโครงการของคุณ
6. DEV_LANGUAGE (ไม่บังคับ, ค่าเริ่มต้นเป็น en ) - รหัสภาษาสำหรับภาษาที่พัฒนาของโครงการ

หมายเหตุ

• สคริปต์นี้ส่งออกการแปลปัจจุบันสำหรับโครงการของคุณโดยใช้ xcodebuild

• มันแยกวิเคราะห์ไฟล์ XLIFF ที่ได้รับและอัปโหลดไปยัง Google Sheets

• มีหนึ่งสเปรดชีตสำหรับทุกภาษาที่มีรูปแบบชื่อต่อไปนี้: {PROJECT_NAME}_{LANGUAGE_NAME}_localizations (เช่น MyProject_Spanish_localizations , MyProject_Russian_localizations ฯลฯ ) ภายในแต่ละสเปรดชีตมีแผ่นงานหนึ่งแผ่นต่อแพลตฟอร์ม (เช่น ios_strings , android_strings ) {PROJECT_NAME} ถูกอนุมานจากชื่อไฟล์ xcodeproj

• สตริงทั้งหมดจะถูกเพิ่มลงในสเปรดชีตที่สอดคล้องกันด้วยส่วนหัวต่อไปนี้:

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

  • Source: SOURCE_LANGUAGE = ข้อความในภาษาต้นทาง
  • Target: TARGET_LANGUAGE = ข้อความที่แปลในภาษาเป้าหมาย
  • Example = ว่างเปล่าหากสตริงมีตัวยึดตำแหน่ง ( %@, %d, etc. ) นี่คือสถานที่สำหรับตัวอย่างสำหรับนักแปล
  • Comment = NSLocalisedString ความคิดเห็น
  • String Key = ID ของสตริง
  • File Path = พา ธ สัมพัทธ์ไปยังไฟล์ต้นฉบับของสตริง ( .strings file หรือ .storyboard )

• หลังจากอัปเดตการแปลใน Google Sheets ให้เรียกใช้สคริปต์เดียวกันอีกครั้งเพื่อนำเข้าสตริงใหม่ลงในโครงการ XCode ของคุณ

Android-gslocalization.py

การใช้งาน

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 - ชื่อโครงการ (ใช้เพื่อนำหน้าชื่อสเปรดชีต)
2. PATH_TO_RES_FOLDER - พา ธ ไป res Android ของคุณ
   • ดูในโฟลเดอร์นี้สำหรับไฟล์ strings.xml ทั้งหมด
   • สำหรับไฟล์ strings.xml ใด ๆ ภาษาเป้าหมายจะถูกตรวจพบโดยชื่อโฟลเดอร์ parrent (เช่น values-es สำหรับภาษาสเปน)
3. JSON_AUTH_FILE_PATH - เส้นทางไปยัง Service account key Google Sheets
4. SHARE_EMAIL_ADDRESS - ที่อยู่อีเมลเพื่อแบ่งปันสเปรดชีตที่สร้างขึ้น
   • เนื่องจากเราใช้ Service account key สเปรดชีตทั้งหมดจึงถูกสร้างและเป็นเจ้าของโดยบัญชีบริการ (เช่น [email protected])
   • หลังจากบัญชีบริการสร้างสเปรดชีตมันจะโอนการเป็นเจ้าของไฟล์ไปยังที่อยู่อีเมลที่ให้ไว้
   • ระบุที่อยู่อีเมลของคุณเพื่อให้เห็นภาพผลลัพธ์ใน Google Spreadsheets
5. DEVELOPMENT_LANGUAGE - รหัสภาษาของภาษาการพัฒนาของคุณ (default = en )

หมายเหตุ

• สคริปต์นี้โหลดไฟล์ strings.xml ทั้งหมดภายใน PATH_TO_RES_FOLDER

• มันแยกวิเคราะห์ไฟล์ XML ที่ได้รับและอัปโหลดไปยัง Google Sheets

• มีหนึ่งสเปรดชีตสำหรับทุกภาษาที่มีรูปแบบชื่อต่อไปนี้: {PROJECT_NAME}_{LANGUAGE_NAME}_localizations (เช่น MyProject_Spanish_localizations , MyProject_Russian_localizations ฯลฯ ) ภายในแต่ละสเปรดชีตมีแผ่นงานหนึ่งแผ่นต่อแพลตฟอร์ม (เช่น ios_strings , android_strings )

• สตริงทั้งหมดจะถูกเพิ่มลงในสเปรดชีตที่สอดคล้องกันด้วยส่วนหัวต่อไปนี้:

  Source: SOURCE_LANGUAGE | Target: TARGET_LANGUAGE | String ID

  • Source: SOURCE_LANGUAGE = ข้อความในภาษาต้นทาง
  • Target: TARGET_LANGUAGE = ข้อความที่แปลในภาษาเป้าหมาย
  • String ID = ID ของสตริง

• หลังจากอัปเดตการแปลใน Google Sheets ให้เรียกใช้สคริปต์เดียวกันอีกครั้งเพื่อเขียนทับไฟล์ strings.xml ในโฟลเดอร์ทรัพยากรของคุณ

การพึ่งพาอาศัยกัน

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

เคล็ดลับทั่วไป

1. เก็บโครงการของคุณไว้ภายใต้การควบคุมต้นทางสิ่งนี้ช่วยให้คุณสามารถกู้คืนไฟล์การแปลของคุณไปยังสถานะก่อนหน้าของพวกเขาในกรณีที่สคริปต์นี้แบ่งบางสิ่งบางอย่าง

เคล็ดลับ iOS

1. ใช้ค่าเริ่มต้นสำหรับสตริงที่แปลเป็นภาษาท้องถิ่น ด้วยการทำเช่นนี้คุณจะมีค่าเริ่มต้น (โดยปกติจะเป็นสตริงในภาษาการพัฒนา) ในคอลัมน์ภาษาต้นฉบับแทนที่จะเป็นคีย์สตริง
   • สำหรับ Objective C ใช้ NSLocalizedStringWithDefaultValue(@"KEY", nil, [NSBundle mainBundle], @"DEFAULT_VALUE", @"COMMENT")] แทน NSLocalizedString(@"KEY", @"COMMENT")]
   • สำหรับ Swift ใช้ NSLocalizedString("KEY", tableName: nil, bundle: Bundle.main, value: "DEFAULT_VALUE", comment: "COMMENT") แทน NSLocalizedString("KEY", comment: "COMMENT")
   • ใช้สคริปต์ Python นี้เพื่อแปลงการโทร NSLocalizedString เพื่อรวมค่าเริ่มต้น