สร้างทางลัด

เมื่อออกแบบและสร้างทางลัดของแอป ให้ทำตามหลักเกณฑ์ต่อไปนี้

ปฏิบัติตามหลักเกณฑ์การออกแบบ

หากต้องการให้ทางลัดของแอปมีความสอดคล้องกับทางลัดที่ใช้กับแอปของระบบในด้านภาพ ให้ทำตามหลักเกณฑ์การออกแบบไอคอนทางลัดของแอป

เผยแพร่ทางลัดที่แตกต่างกันเพียง 4 รายการ

แม้ว่า API จะรองรับการรวมทางลัดแบบคงที่และแบบไดนามิกได้สูงสุด 15 รายการสำหรับแอป แต่เราขอแนะนำให้คุณเผยแพร่ทางลัดที่แตกต่างกันเพียง 4 รายการเพื่อปรับปรุงลักษณะที่ปรากฏใน Launcher

นอกเหนือจากการแสดงทางลัดใน Launcher แล้ว ให้ใช้ ไลบรารีการผสานรวมทางลัดของ Google เพื่อแสดงทางลัดในพื้นผิวของ Google เช่น Google Assistant ไลบรารีนี้รองรับการพุชทางลัดแบบไดนามิกได้ไม่จำกัดจำนวน หากคุณใช้ไลบรารีนี้เพื่อพุชทางลัดจำนวนมาก เราขอแนะนำให้ตั้งค่า rank ของทางลัดที่ต้อง ปรากฏใน Launcher ที่รองรับโดยเรียกใช้เมธอด setRank()

จำกัดความยาวของคำอธิบายทางลัด

พื้นที่ในเมนูที่แสดงทางลัดของแอปใน Launcher มีจำกัด ดังนั้นจึงควรจำกัดความยาวของ "คำอธิบายแบบย่อ" ของทางลัดไม่ให้เกิน 10 อักขระ และจำกัดความยาวของ "คำอธิบายแบบยาว" ไม่ให้เกิน 25 อักขระ

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

เก็บประวัติการใช้งานทางลัดและการดำเนินการ

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

อัปเดตทางลัดเฉพาะเมื่อความหมายยังคงอยู่

เมื่อเปลี่ยนทางลัดแบบไดนามิก และทางลัดที่ปักหมุดไว้ ให้เรียกใช้ updateShortcuts() เฉพาะเมื่อเปลี่ยนข้อมูลของทางลัดที่ยังคงความหมายเดิมไว้ มิฉะนั้น ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้ ทั้งนี้ขึ้นอยู่กับประเภทของทางลัดที่คุณสร้างใหม่

• ทางลัดแบบไดนามิก: pushDynamicShortcut().

• ทางลัดที่ปักหมุดไว้: requestPinShortcut().

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

ตรวจสอบทางลัดแบบไดนามิกทุกครั้งที่เปิดแอป

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