แปล UI ด้วยเครื่องมือแก้ไขการแปล

เครื่องมือแก้ไขการแปลจะแสดงมุมมองที่รวมและแก้ไขได้ของทรัพยากรสตริงเริ่มต้นและที่แปลแล้วทั้งหมด

หากต้องการดูข้อมูลเบื้องต้นเกี่ยวกับการแปลแอปเป็นภาษาต่างๆ โปรดอ่านรองรับภาษาและวัฒนธรรมที่แตกต่างกัน

เครื่องมือแก้ไขการแปลแสดงข้อความของแอปก่อนการแปล
รูปที่ 1 เครื่องมือแก้ไขคำแปลแสดงข้อความของแอปก่อนการแปล

ทรัพยากรสตริง

ทรัพยากรสตริงสำหรับโปรเจ็กต์จะอยู่ในไฟล์ strings.xml โปรเจ็กต์ของคุณมีไฟล์ strings.xml เริ่มต้นที่มีทรัพยากรสตริงในภาษาเริ่มต้นสำหรับแอป ซึ่งเป็นภาษาที่คุณคาดว่าผู้ใช้แอปส่วนใหญ่จะพูด นอกจากนี้ คุณยังสามารถแปลไฟล์ strings.xml ที่มีทรัพยากรสตริงสำหรับภาษาอื่นๆ ที่คุณต้องการให้แอปรองรับได้ด้วย

เมื่อคุณมีไฟล์ strings.xml ค่าเริ่มต้นที่สมบูรณ์แล้ว คุณสามารถเพิ่มคำแปลด้วยตนเอง หรือจ่ายเงินให้ผู้ให้บริการบริการทางวิชาชีพทำการแปลให้ก็ได้ ไม่ว่าจะด้วยวิธีใด คุณควรใช้ประโยชน์จากฟีเจอร์ของ Android Studio เพื่อช่วยจัดการและทดสอบข้อความที่แปลได้ ดูข้อมูลเกี่ยวกับบริการแปลภาษาโดยมืออาชีพได้ที่บริการแปลภาษา

เปิดเครื่องมือแก้ไขการแปล

คุณเข้าถึงเครื่องมือแก้ไขการแปลได้จากตำแหน่งต่อไปนี้ใน Android Studio

เปิดจากมุมมอง Android

  1. ในแผง Project > Android ทางด้านซ้าย ให้เลือก ModuleName > res > values
  2. คลิกขวาที่ไฟล์ strings.xml แล้วเลือกเปิดเครื่องมือแก้ไขการแปล

    เครื่องมือแก้ไขการแปลจะแสดงคู่คีย์และค่าจากไฟล์ strings.xml

รูปที่ 1 แสดงข้อความเริ่มต้นของแอป (ในกรณีนี้คือภาษาอังกฤษ) ในเครื่องมือแก้ไขคำแปลสำหรับแอปก่อนที่จะมีการแปล เนื้อหาของไฟล์ strings.xml ที่แปลแล้วจะปรากฏทางด้านขวาของคอลัมน์แปลไม่ได้ โดยมี 1 คอลัมน์ต่อภาษา ดังที่แสดงในรูปที่ 2

เปิดจากภายใน strings.xml

คุณสามารถเข้าถึงเครื่องมือแก้ไขคำแปลได้จากภายในไฟล์ strings.xml

  1. ในแผง Project > Android ทางด้านซ้าย ให้เลือก ModuleName > res > values
  2. ดับเบิลคลิก strings.xml เพื่อเปิดแก้ไข
  3. ใน strings.xml ให้คลิกลิงก์เปิดเครื่องมือแก้ไขที่มุมขวาบน

กำหนดค่าแถวที่แปลไม่ได้

ในเครื่องมือแก้ไขการแปล คุณสามารถเลือกแปลไม่ได้เพื่อระบุว่าไม่ต้องการให้แปลข้อความในแถวนี้ ข้อความที่คุณไม่ต้องการให้แปลอาจเป็นข้อความเฉพาะผลิตภัณฑ์ เช่น ชื่อทางการค้าและเครื่องหมายการค้า หรือคำศัพท์ทางเทคนิคที่ไม่มีคำแปล

เมื่อเลือกแปลไม่ได้ บรรทัดที่เกี่ยวข้องในไฟล์ strings.xml เริ่มต้นจะเพิ่ม translatable="false" ในตัวอย่างต่อไปนี้ EasyApp ในบรรทัดบนสุดจะไม่แปลเนื่องจากเป็นชื่อผลิตภัณฑ์

<resources>
    <string name="app_name" translatable="false">EasyApp</string>
    <string name="action_settings">Settings</string>
    <string name="easy_app">I am a Simple App!</string>
    <string name="next_page">Next Page</string>
    <string name="second_page_message">I am the Second Page!</string>
    <string name="title_activity_second">SecondActivity</string>
</resources>

เพิ่มและลบภาษา

เครื่องมือแก้ไขคำแปลรองรับ BCP 47 และรวมรหัสภาษาและภูมิภาค (ประเทศ) ไว้ในตัวเลือกเดียวสำหรับการแปลที่กำหนดเป้าหมาย ภาษาถิ่นกำหนดมากกว่าแค่ภาษา ภาษาจะรวมการจัดรูปแบบที่ขึ้นอยู่กับประเทศสำหรับสิ่งต่างๆ เช่น วันที่และเวลา สกุลเงิน และทศนิยม

วิธีเพิ่มภาษามีดังนี้

  1. ในเครื่องมือแก้ไขการแปล ให้คลิกไอคอนลูกโลก
  2. เลือกภาษาที่ต้องการเพิ่มจากรายการแบบเลื่อนลง

    ภาษาใหม่จะปรากฏในเครื่องมือแก้ไขการแปล และระบบจะเพิ่มโฟลเดอร์ values-* ที่มีไฟล์ strings.xml ลงในโปรเจ็กต์ เช่น values-es สำหรับภาษาสเปน

หากต้องการลบภาษา ให้ทำดังนี้

คุณลบภาษาในเครื่องมือแก้ไขคำแปลได้โดยลบทุกค่าในคอลัมน์ (ดูแก้ไข เพิ่ม และลบข้อความ) หรือจะลบโฟลเดอร์โปรเจ็กต์สำหรับภาษานั้นก็ได้ โดยทำดังนี้

  1. ในแผง Project > Android ทางด้านซ้าย ให้เลือก ModuleName > res
  2. คลิกขวาที่โฟลเดอร์ values-* สำหรับภาษาที่ต้องการลบ เช่น values-hi สำหรับภาษาฮินดี
  3. จากรายการ ให้เลือกลบเพื่อลบโฟลเดอร์และไฟล์ strings.xml

แก้ไข เพิ่ม และลบข้อความ

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

มุมมองรายการที่ด้านบนและช่องการแปลที่ด้านล่าง
รูปที่ 2 มุมมองรายการที่ด้านบนและช่องคำแปลที่ด้านล่าง

มุมมองรายการ

หากต้องการแก้ไขหรือเพิ่มข้อความ ให้ทำดังนี้

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

หากต้องการลบข้อความ ให้ทำดังนี้

  1. ดับเบิลคลิกเซลล์ที่ต้องการลบ
  2. ในมุมมองรายการ ให้เลือกข้อความแล้วกดลบ
  3. กด Tab หรือเลื่อนเคอร์เซอร์ออกจากช่อง

ช่องการแปล

หากต้องการแก้ไขหรือเพิ่มข้อความ ให้ทำดังนี้

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

หากต้องการลบข้อความ ให้ทำดังนี้

  1. คลิกเซลล์ที่ต้องการลบ 1 ครั้ง
  2. ในช่องคำแปล ให้เลือกข้อความแล้วกดลบ

เพิ่มและลบคีย์

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

วิธีเพิ่มคีย์มีดังนี้

  1. ในเครื่องมือแก้ไขคำแปล ให้คลิกเพิ่มคีย์
  2. ในกล่องโต้ตอบ ให้ป้อนชื่อคีย์ ค่าเริ่มต้น และตำแหน่งของไฟล์ strings.xml เริ่มต้น

    กล่องโต้ตอบเพิ่มคีย์ในเครื่องมือแก้ไขการแปล
    รูปที่ 3 เพิ่มคีย์

หากต้องการลบคีย์ ให้ทำดังนี้

  1. ในเครื่องมือแก้ไขการแปล ให้เลือกคีย์ที่ต้องการลบ
  2. คลิกนำคีย์ออก
  3. ในกล่องโต้ตอบลบ ให้เลือกว่าต้องการลบอย่างปลอดภัยและต้องการค้นหาในความคิดเห็นและสตริงหรือไม่ แล้วคลิกตกลง

    กล่องโต้ตอบลบคีย์ในเครื่องมือแก้ไขการแปล
    รูปที่ 4 กล่องโต้ตอบการลบ

    หากไม่มีการอ้างอิง (การใช้งาน) คีย์ที่ลบไปแล้ว หรือหากการอ้างอิงทั้งหมดสามารถยุบได้อย่างปลอดภัย ระบบจะลบคีย์ดังกล่าว ไม่เช่นนั้น เครื่องมือแก้ไขคำแปลจะแสดงกล่องโต้ตอบตรวจพบการใช้งานพร้อมข้อมูลเกี่ยวกับปัญหาที่ตรวจพบ

    กล่องโต้ตอบ &quot;ตรวจพบการใช้งาน&quot; ในเครื่องมือแก้ไขการแปล
    รูปที่ 5 กล่องโต้ตอบการใช้งานที่ตรวจพบ
  4. เลือกดูการใช้งานเพื่อตรวจสอบสิ่งที่จะลบ กล่องโต้ตอบค้นหาความขัดแย้งในการลบอย่างปลอดภัยจะแสดงการใช้งานทั้งหมดที่ไม่ปลอดภัยต่อการลบ เพื่อให้คุณแก้ไขโค้ดที่เกี่ยวข้องได้

    กล่องโต้ตอบ &quot;ค้นหาความขัดแย้งในการลบอย่างปลอดภัย&quot; ที่แสดงการใช้งานที่ไม่ปลอดภัย
    รูปที่ 6 การใช้งานที่ไม่ปลอดภัย
  5. คลิกขวาที่การใช้งานเพื่อแสดงเมนูตามบริบท แล้วเลือกข้ามไปที่แหล่งที่มาเพื่อให้คุณทำการเปลี่ยนแปลงที่จำเป็นได้

  6. ในแผงค้นหาความขัดแย้งในการลบอย่างปลอดภัย ให้เลือกเรียกใช้การลบอย่างปลอดภัยอีกครั้งเพื่อให้แน่ใจว่าไม่มีการใช้งานอื่นๆ ที่ต้องดำเนินการ

  7. เมื่อล้างการใช้งานแล้ว ให้คลิก Do Refactor เพื่อลบคีย์

แก้ไขข้อผิดพลาด

รูปที่ 7 แสดงเครื่องมือแก้ไขการแปลภาษาที่แสดงเนื้อหาของไฟล์ strings.xml ภาษาอังกฤษ ฝรั่งเศส และสเปน ข้อความสีแดงจะระบุบรรทัด ที่มีข้อผิดพลาด

เครื่องมือแก้ไขการแปลแสดงข้อผิดพลาดเป็นข้อความสีแดง
รูปที่ 7 ข้อความสีแดงบ่งบอกถึงสภาวะข้อผิดพลาดที่คุณต้องแก้ไข

หากต้องการแก้ไขข้อผิดพลาด ให้วางเมาส์เหนือข้อความสีแดงเพื่อแสดงคำอธิบายปัญหาและวิธีแก้ไข

เมื่อคุณทำการเปลี่ยนแปลงในเครื่องมือแก้ไขคำแปล ไฟล์ strings.xml ที่เกี่ยวข้องจะอัปเดตตามการเปลี่ยนแปลงของคุณ เมื่อคุณทำการเปลี่ยนแปลงในไฟล์ strings.xml คอลัมน์ที่เกี่ยวข้องในเครื่องมือแก้ไขคำแปลจะอัปเดตตามการเปลี่ยนแปลงของคุณ

ตัวอย่างการแก้ไขเครื่องมือแก้ไขคำแปล

  • รูปที่ 7 แสดงให้เห็นว่าแถว app_name มีการเลือกไม่แปล แต่มีคำแปลภาษาสเปนให้ไว้ ลบคำแปลภาษาสเปนเพื่อแก้ไขข้อผิดพลาด
  • รูปที่ 7 แสดงให้เห็นว่าแถว next_page ไม่มีคำแปลภาษาฝรั่งเศส ใช้แป้นพิมพ์เพื่อคัดลอก Page Suivante ลงในเซลล์เพื่อแก้ไขข้อผิดพลาด การคัดลอกและวางด้วยแป้นพิมพ์จะคัดลอกข้อความที่มีเครื่องหมายกำกับการออกเสียงลงในเซลล์

จัดการและทดสอบข้อความที่แปลได้

แพลตฟอร์ม Android และ Android Studio มีฟีเจอร์หลายอย่างที่จะช่วยคุณจัดการและทดสอบข้อความในแอปที่แปลได้ ฟีเจอร์เหล่านี้มีตัวเลือกที่จะช่วยคุณกำหนดเป้าหมายปัญหาเกี่ยวกับสคริปต์ที่เขียนจากขวาไปซ้าย (RTL) เช่น ภาษาอาหรับหรือภาษาฮีบรู การทดสอบข้อความที่แปลได้ช่วยให้คุณปรับเปลี่ยนข้อความ UI และเลย์เอาต์ได้ก่อนที่จะคอมมิตข้อความไปยังที่เก็บต้นทางเพื่อส่งไปแปลในภายหลัง

รองรับภาษาที่เขียนจากขวาไปซ้าย

Jetpack Compose จัดการเลย์เอาต์จากขวาไปซ้าย (RTL) โดยค่าเริ่มต้น ตัวแก้ไขเลย์เอาต์และ API สร้างขึ้นตามแนวคิดด้านทิศทาง เช่น start และ end แทนที่จะเป็นทิศทางสัมบูรณ์ เช่น left และ right เมื่อภาษาของระบบเปลี่ยนเป็นภาษาที่เขียนจากขวาไปซ้าย Compose จะมิเรอร์เลย์เอาต์เหล่านี้ให้คุณโดยอัตโนมัติ

เพื่อให้แอปรับรู้ภาษาที่เขียนจากขวาไปซ้ายและทริกเกอร์การมิเรอร์นี้ คุณต้องเลือกใช้ไฟล์ Manifest ของแอป

หากต้องการเปิดใช้การรองรับ RTL ให้ทำดังนี้

  1. เปิดไฟล์ AndroidManifest.xml
  2. เพิ่มแอตทริบิวต์ android:supportsRtl="true" ลงในองค์ประกอบ <application> ดังนี้
<manifest ... >
    <application
        ...
        android:supportsRtl="true">
    </application>
</manifest>

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ Compose จัดการเลย์เอาต์ข้อความ การมิเรอร์ และการกำหนดค่า RTL ที่กำหนดเองได้ที่การทำงานกับภาษาที่อ่านจากขวาไปซ้าย

กำหนดทิศทางข้อความด้วยตนเอง

ใน Jetpack Compose คุณจะไม่ใช้หน้าต่าง Properties แบบภาพเพื่อบังคับเลย์เอาต์หรือทิศทางของข้อความ Compose จะจัดการการมิเรอร์ RTL โดยอัตโนมัติตามภาษาของระบบ

อย่างไรก็ตาม หากต้องการลบล้างทิศทางสำหรับองค์ประกอบข้อความที่เฉพาะเจาะจงด้วยตนเอง (เช่น การแสดงสตริง LTR ในเลย์เอาต์ RTL) คุณสามารถส่งออบเจ็กต์ TextDirection ไปยัง TextStyle ได้

ค่าที่รองรับมีดังนี้

  • TextDirection.Content: (Default): อนุมานทิศทางจากอักขระที่มีทิศทางชัดเจนตัวแรก
  • TextDirection.Ltr: บังคับทิศทางจากซ้ายไปขวา
  • TextDirection.Rtl: บังคับทิศทางจากขวาไปซ้าย

ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบข้อความและการกำหนดค่าทิศทางข้อความด้วยตนเองใน Compose ได้ที่จัดรูปแบบข้อความ

ใช้สตริงที่แปลแล้วในแอป

เมื่อเพิ่มและแปลสตริงโดยใช้เครื่องมือแก้ไขคำแปลแล้ว ระบบจะอัปเดตไฟล์ res/values/strings.xml ที่เกี่ยวข้องโดยอัตโนมัติ และคุณจะใช้ทรัพยากรที่แปลแล้วใน UI ได้โดยตรง

หากต้องการดูวิธีแสดงข้อความที่แปลแล้ว จัดการ RTL แบบเนทีฟ และใช้ @Preview เพื่อทดสอบภาษาและภาษาจำลองต่างๆ โปรดดูส่วนสตริงของทรัพยากรใน Compose

ภาษาจำลอง

ภาษาจำลองคือภาษาที่จำลองขึ้นมาเพื่อใช้สมมติลักษณะของภาษาที่ทำให้เกิดปัญหาเกี่ยวกับ UI, เลย์เอาต์, RTL และการแปลอื่นๆ เมื่อมีการแปลแอป ภาษาเทียมจะให้คำแปลที่อ่านได้ในภาษาอังกฤษสำหรับข้อความที่แปลได้ทั้งหมดโดยอัตโนมัติและทันที ซึ่งจะช่วยให้คุณตรวจจับข้อความที่แปลไม่ได้ในซอร์สโค้ดได้

ดูข้อมูลเกี่ยวกับวิธีใช้ภาษาจำลองได้ที่ทดสอบแอปด้วยภาษาจำลอง

แหล่งข้อมูลเพิ่มเติม

ดูเนื้อหา