text-vertical

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มทรัพยากร Dependency ใน Text คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google

เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับ แอปหรือโมดูล

dependencies {
    implementation "androidx.text:text-vertical:1.0.0-beta02"
}

dependencies {
    implementation("androidx.text:text-vertical:1.0.0-beta02")
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพาบิลด์

ความคิดเห็น

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

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ Issue Tracker

ข้อความแนวตั้ง

รุ่น 1.0

เวอร์ชัน 1.0.0-beta02

23 กันยายน 2026

androidx.text:text-vertical:1.0.0-beta02 และ androidx.text:text-vertical-compose:1.0.0-beta02 เปิดตัวแล้ว เวอร์ชัน 1.0.0-beta02 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลงที่สำคัญ

• เราได้เพิ่มกรณีทดสอบเพื่อให้มั่นใจว่าสามารถใช้งานร่วมกับเวอร์ชันก่อนหน้าได้จนถึง API 24 (Android 7.0) และผลลัพธ์ที่ได้ก็เป็นไปในเชิงบวกอย่างมาก
• ตอนนี้ไลบรารีรองรับ Kotlin 2.2 และต้องใช้ kotlinc 2.2 (I82396, b/498369605)
• ตอนนี้ไลบรารีข้อความแนวตั้งจะคอมไพล์กับ SDK 37 แล้ว แอป ที่ใช้จะต้องคอมไพล์กับ SDK 37 และใช้ AGP 9.1.0 ขึ้นไป (I0f757, b/562182206)

การแก้ไขข้อบกพร่อง

• EmphasisSpan.position จะย้ายเครื่องหมายเน้น AnnotationPosition.Before จะวางเครื่องหมายไว้เหนือข้อความแนวนอนและทางขวาของข้อความแนวตั้ง AnnotationPosition.After วางไว้ที่ด้านตรงข้าม (Ic9bfd, b/559972132)
• แก้ไขการปรับขนาดเครื่องหมายเน้นในเลย์เอาต์ข้อความแนวนอน ความสูงของบรรทัดที่สงวนไว้จะไม่ถือว่าเครื่องหมายไม่ได้ปรับขนาดอีกต่อไป (I6d7fe, b/562254557)
• แก้ไขการย้อนกลับสำหรับข้อความแนวตั้ง การพอร์ตย้อนกลับ ไม่สนใจออฟเซ็ตที่ขอใน API ระดับต่ำกว่า 34 (I8877a, b/495457561)
• แก้ไขข้อความรูบีแนวนอนที่สงวนพื้นที่แนวตั้งมากเกินไป ใน API ระดับต่ำกว่า 28 ซึ่งอาจทำให้บรรทัดสูงกว่าที่จำเป็น (Iceb60, b/561323466)
• ตอนนี้การทดสอบสำหรับรูบี้แนวตั้งและการวางแนวข้อความจะทำงานใน ระดับ API ที่รองรับทั้งหมด (If07d4, b/495457561)
• อัปเดตทรัพยากร Dependency ของ androidx.lifecycle:lifecycle-runtime เป็น 2.10.0 แล้ว ต้องใช้เวอร์ชันนี้เพื่อให้การตรวจสอบ Lint ของรันไทม์วงจรการใช้งานแบบรวมทำงานร่วมกับ AGP เวอร์ชัน 9.5.0-alpha04 ขึ้นไปได้ (I7264b, b/556807521)
• แก้ไขปัญหาการไม่สนใจ RubySpan.position ในเลย์เอาต์ข้อความแนวนอน AnnotationPosition.After ตอนนี้แสดงข้อความรูบี้ใต้ข้อความฐานได้อย่างถูกต้องแล้ว (Iaffa1, b/559972124, b/561323466)
• แก้ไขปัญหาการไม่สนใจ RubySpan.position ในเลย์เอาต์ข้อความแนวตั้ง AnnotationPosition.After ตอนนี้แสดงข้อความรูบี้ทางด้านซ้ายของข้อความฐานได้อย่างถูกต้องแล้ว (I0be1c, b/495457561)
• อัปเกรดการขึ้นต่อกันของ Compose เป็น 1.11.4 (I9ef07, b/536925341)

เวอร์ชัน 1.0.0-beta01

26 สิงหาคม 2026

androidx.text:text-vertical:1.0.0-beta01 และ androidx.text:text-vertical-compose:1.0.0-beta01 เปิดตัวแล้ว เวอร์ชัน 1.0.0-beta01 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

• เปลี่ยน VerticalTextScope จากอินเทอร์เฟซเป็นคลาสที่เฉพาะเจาะจง (I44e71, b/549288808)

การแก้ไขข้อบกพร่อง

• อัปเดตเอกสารสำหรับ combineUpright (Ib534b, b/548992014)
• นำเอกสารประกอบข้อกำหนดขั้นต่ำของ API 36 ที่ไม่ถูกต้องออกจาก VerticalText (I4f8e9, b/549288799)
• ใช้การคำนวณอัตราส่วนการเด้งตัวขึ้นต่อระยะก้าวสำหรับการชดเชยเส้นฐานแนวตั้งในโหมดพอร์ตย้อนหลัง (07339d7, b/502088091)

เวอร์ชัน 1.0.0-alpha06

29 กรกฎาคม 2026

androidx.text:text-vertical:1.0.0-alpha06 และ androidx.text:text-vertical-compose:1.0.0-alpha06 เปิดตัวแล้ว เวอร์ชัน 1.0.0-alpha06 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลงที่สำคัญ

• การเปิดตัวนี้ถือเป็นเวอร์ชันอัลฟ่าสุดท้ายของไลบรารีตามแผน
• ปรับแต่งและปรับปรุงพารามิเตอร์ใน VerticalText ที่ประกอบได้

การเปลี่ยนแปลง API

• เปิดตัว VerticalTextStyle สำหรับเลย์เอาต์ข้อความแนวตั้ง (I647a8, b/512424512)
• เปิดตัว DSL สาธารณะใหม่ (VerticalTextScope และ buildVerticalText) ในไลบรารี text-vertical-compose (I6faa7, b/502088091)
• เปิดตัว VerticalText Composable (I96509, b/502088091)

การแก้ไขข้อบกพร่อง

• ปรับปรุงเอกสารประกอบสำหรับVerticalTextLayoutลักษณะการทำงานสำรองใน API ระดับเก่า (Ia7ccc, b/449184326)

ไม่มีบันทึกประจำรุ่นสำหรับอาร์ติแฟกต์นี้

ข้อความแนวตั้ง เวอร์ชัน 1.0

เวอร์ชัน 1.0.0-alpha05

22 เมษายน 2026

androidx.text:text-vertical:1.0.0-alpha05 และ androidx.text:text-vertical-compose:1.0.0-alpha05 เปิดตัวแล้ว เวอร์ชัน 1.0.0-alpha05 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เพิ่มฟังก์ชันที่ประกอบได้เพื่อรองรับเลย์เอาต์ข้อความแนวตั้ง ซึ่งสอดคล้องกับโครงการ Compose-first ของ Google

การเปลี่ยนแปลง API

• เปิดตัวอาร์ติแฟกต์ไลบรารี :text:text-vertical-compose (I939e4)
• เพิ่มพร็อพเพอร์ตี้ lineCount ลงในคลาส VerticalTextLayout (I93884, b/502088091)

การแก้ไขข้อบกพร่อง

• อัปเดตเอกสารประกอบ KDoc เพื่อความชัดเจนและความถูกต้อง (I71c8f, b/449184326)

เวอร์ชัน 1.0.0-alpha04

8 เมษายน 2026

androidx.text:text-vertical:1.0.0-alpha04 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha04 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

• ปรับโครงสร้างคลาสสาธารณะทั้งหมดเพื่อให้ API ของ Kotlin ที่สะดวกและเป็นสำนวนมากขึ้นสำหรับการใช้งานทั่วไป ในขณะที่ยังคงความสามารถในการทำงานร่วมกันของ Java ไว้

การเปลี่ยนแปลง API

• เพิ่มตัวสร้างอาร์กิวเมนต์เริ่มต้นเป็น 0 ใน FontShearSpan เพื่อให้เข้ากันได้กับ Java (I73065, b/493692287)
• นำการใช้งาน Parcelable ใน RubySpan และ EmphasisSpan ออกแล้ว (I49884, b/493693386)
• ปรับโครงสร้าง EmphasisSpan เพื่อให้เข้ากันได้ดียิ่งขึ้น (I34c40, b/493693310)
• ปรับโครงสร้าง AnnotationPosition เพื่อปรับปรุงพื้นผิว API (I10dce, b/493693386)
• แปลง TextOrientation เป็นคลาส enum, ปรับโครงสร้าง AnnotationPosition เป็นคลาสที่ปิดผนึก และนำ RubySpan.Builder ออก (Ib4a77, b/493693386)
• เพิ่ม AnnotationPosition enum และปรับโครงสร้างคลาส RubySpan ใหม่ (Ibfcff, b/493692426)
• ปรับโครงสร้าง TextOrientation เพื่อการใช้งานทั่วไปและปรับปรุงส่วนขยายการปรับขนาดข้อความภายใน (I82152, b/493692428)

เวอร์ชัน 1.0.0-alpha03

25 มีนาคม 2026

androidx.text:text-vertical:1.0.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha03 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

• VerticalTextLayout รองรับเลย์เอาต์แนวนอนแล้วในตอนนี้ เพื่อแสดงช่วงพิเศษในภาษาญี่ปุ่น เช่น รูบีและเน้น (โบเต็น)

การเปลี่ยนแปลง API

• RubySpan และ EmphasisSpan จะรับช่วง ReplacementSpan เพื่อรองรับข้อความแนวนอน (I38db6, b/447239659, b/447224892)

เวอร์ชัน 1.0.0-alpha02

8 ตุลาคม 2025

androidx.text:text-vertical:1.0.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เพิ่มVerticalTextLayout#isVerticalTextLayoutSupported()วิธีตรวจสอบความสามารถของข้อความแนวตั้ง (Ie2802, b/442608654)

การเปลี่ยนแปลง API

• เปิดตัวการสำรองข้อมูลที่ราบรื่นใน API < 36.(I8a67a, b/442608654)
• ลดเวอร์ชัน minSDK เป็น 23 เพื่อใช้ในไลบรารี AndroidX อื่นๆ (I2d6b5, b/442608654)

เวอร์ชัน 1.0.0-alpha01

27 สิงหาคม 2025

androidx.text:text-vertical:1.0.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha01 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

• ไลบรารีข้อความแนวตั้งใหม่เพื่อรองรับเลย์เอาต์ข้อความแนวตั้งสำหรับภาษาญี่ปุ่นเป็นหลัก โดยใช้ประโยชน์จาก Flag VERTICAL_TEXT_FLAG ใหม่ที่เพิ่มเข้ามาใน Android 16
• เพิ่ม VerticalTextLayout ที่แสดงข้อความแนวตั้งโดยมีการขึ้นบรรทัดอย่างถูกต้อง มีการวางแนวแบบผสม (เช่น อักขระละตินแนวนอนภายในบรรทัดแนวตั้ง) และข้อความรูบี (8b3a10)
• เพิ่ม FontShearSpan สำหรับรูปแบบคล้ายตัวเอียงในข้อความแนวตั้ง (1ffd78)
• เพิ่ม EmphasisRun สำหรับเครื่องหมายเน้นเสียง (fe12d9)