สิ่งที่ไม่มีใน Common stdlib

ไม่ใช่ API ของ Kotlin ทุกตัวที่รองรับหลายแพลตฟอร์ม ไลบรารีมาตรฐานของ common เป็นเพียงชุดย่อยที่คัดสรรมาอย่างระมัดระวัง และเครื่องมือ JVM ที่คุ้นเคยหลายอย่างไม่มีให้ใช้

ทุกอย่างในแพ็กเกจ java ใช้ได้เฉพาะบน JVM เท่านั้น โค้ดอาจคอมไพล์บน Android ได้ แต่จะล้มเหลวทันทีเมื่อ iOS พยายามสร้างโค้ด

java.util.Date และ Calendar แบบเก่าไม่มีอยู่ในโค้ด common ให้เลือกใช้ kotlinx-datetime แทน

API ไฟล์ ของ JVM เช่น java.io.File ไม่มีอยู่ใน commonMain การเข้าถึงไฟล์ต้องใช้ไลบรารีหลายแพลตฟอร์มหรือ expect/actual

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

java.lang.Thread ใช้ไม่ได้ใน common สำหรับงานเบื้องหลัง ให้ใช้ โครูทีน ซึ่งรองรับหลายแพลตฟอร์มอย่างสมบูรณ์

หากการนำเข้าเริ่มต้นด้วย java หรือ javax ก็ไม่สามารถอยู่ใน commonMain ได้ คำนำหน้านี้คือสัญญาณเตือนของคุณ

หากใส่โค้ดที่ใช้ได้เฉพาะ JVM ไว้ใน common การสร้างโค้ดจะล้มเหลวอย่างรวดเร็วพร้อม การอ้างอิงที่แก้ไขไม่ได้สำหรับเป้าหมาย iOS ซึ่งเป็นประโยชน์ ไม่ใช่เรื่องน่ากลัว

เมื่อจำเป็นต้องใช้ API ของแพลตฟอร์ม ให้หาไลบรารี หลายแพลตฟอร์ม หรือห่อหุ้มด้วย expect/actual แยกกันในแต่ละเป้าหมาย

ใช้ชนิดข้อมูลจาก Kotlin stdlib และไลบรารี kotlinx ใน common แล้วชั้นโค้ดร่วมของคุณจะพกพาไปได้ทุกที่ 🙂

ก่อนแชร์ตรรกะ ให้ถามว่าต้องใช้ API ที่ เฉพาะ JVM หรือไม่ หากต้องใช้ ให้แยกออกเพื่อให้ commonMain สะอาดอยู่เสมอ

หลีกเลี่ยง API java.* ใน commonMain ใช้ชนิดข้อมูลจาก stdlib ไลบรารี kotlinx หรือ expect/actual เพื่อให้โค้ดร่วมพกพาได้อย่างแท้จริง