เพิ่มลงในหน้าจอโฮม
ปักหมุดแอป internal หรือ private ไว้บนหน้าจอหลักของโทรศัพท์หรือแท็บเล็ต เพื่อให้เปิดแบบเต็มจอพร้อมไอคอนของตัวเอง
ภาพรวม
แอป internal และ private ไม่มี URL สาธารณะให้บุ๊กมาร์กโดยตรง — คุณเปิดผ่าน Stardeck แต่สำหรับแอปที่ใช้ทุกวัน (POS, dashboard หน้าร้าน, เครื่องสแกนในห้องสต็อก) การเปิด Stardeck ก่อนแล้วค่อยแตะเข้าไปเป็นเรื่องยุ่งยาก Home screen pinning ให้คุณเพิ่มแอปลงบนหน้าจอหลักของโทรศัพท์หรือแท็บเล็ตได้โดยตรง เพื่อให้เปิดได้เหมือนแอปเนทีฟ: มีไอคอนของตัวเอง เต็มจอ และเปิดตรงหน้าที่คุณปักหมุดไว้
มีสองส่วนที่ทำให้สิ่งนี้ใช้งานได้:
- Home-screen pin ต่อแอป — เมื่อคุณสั่ง "Add to Home Screen" จาก Safari หรือ Chrome หมุดจะจับแอปนี้ (และหน้าที่คุณเปิดอยู่) ไม่ใช่ทั้งเว็บไซต์ Stardeck
- Standalone mode — ตัวสลับเสริมต่อแอปที่เอา shell ของ Stardeck ออก ให้แอปใช้หน้าจอทั้งหมด
การปักหมุดมีประโยชน์ที่สุดกับแอป internal และ private แอป public มี URL สาธารณะที่คงที่อยู่แล้ว คุณบุ๊กมาร์กหรือปักหมุดได้โดยตรง — ดูความแตกต่างที่ การมองเห็นแอป
ปักหมุดแอปไว้บนหน้าจอหลัก
iPhone และ iPad (Safari)
- เปิดแอปผ่าน Stardeck ดู เปิดแอป internal หรือ private
- ใน Safari แตะปุ่ม Share
- เลือก Add to Home Screen
- ยืนยันชื่อ แล้วแตะ Add
Android (Chrome)
- เปิดแอปผ่าน Stardeck ดู เปิดแอป internal หรือ private
- ใน Chrome แตะเมนู ⋮ (มุมขวาบน)
- เลือก Add to Home screen (อาจแสดงเป็น Install app)
- ยืนยันชื่อ แล้วแตะ Add / Install
ไอคอนใหม่จะเปิดแอปโดยตรง เพราะแต่ละแอปให้เป้าหมายการปักหมุดของตัวเอง ไอคอนจึงเปิดแอปนั้น ไม่ใช่ dashboard ของ Stardeck และไปที่หน้าเดียวกับที่คุณเปิดอยู่ตอนปักหมุด
Standalone mode (Show app shell)
โดยค่าเริ่มต้น เมื่อเปิดแอป internal หรือ private จะเห็นกรอบแอปของ Stardeck ล้อมรอบ พร้อมแท็บสำหรับแอป surface ต่างๆ Guide, Build, Code และ Settings ซึ่งสะดวกขณะที่คุณกำลังสร้างและปรับปรุง แต่สำหรับแอปธุรกิจที่ใช้งานจริงทุกวัน มักต้องการให้แอปใช้หน้าจอทั้งหมด
แอป internal หรือ private แต่ละแอปมีตัวสลับ Show app shell ใต้ Settings → General:
| การตั้งค่า | สิ่งที่เกิดขึ้นเมื่อคุณเปิดแอป |
|---|---|
| Show app shell (ค่าเริ่มต้น เปิดอยู่) | เปิดภายในกรอบแอปของ Stardeck พร้อมแท็บล้อมรอบแอป |
| Standalone (ปิด) | ข้าม shell และเปิดแอปโดยตรงที่ URL ที่เผยแพร่ |
ปิดตัวสลับนี้เพื่อให้ได้ประสบการณ์แบบ standalone เช่น แอปที่ปักหมุดบน iPad ที่ใช้ร่วมกัน
ตัวสลับนี้มีผลกับผู้ที่แก้ไขแอปไม่ได้ ส่วนผู้ที่แก้ไขแอปได้ (มีสิทธิ์ Edit Apps
หรือได้รับสิทธิ์ในแอปนั้น) จะได้กรอบเสมอ ดังนั้นให้ทดสอบ standalone mode
โดยเข้าสู่ระบบในฐานะพนักงาน coding agent ของคุณสลับตัวเลือกนี้ได้ด้วย update_app_settings
ตัวสลับ Show app shell ปรากฏเฉพาะแอป internal และ private เท่านั้น ผู้ที่แก้ไขแอป public ไม่ได้จะเข้าแอปโดยตรงที่ URL สาธารณะเสมอ
ไอคอนแอป
เมื่อคุณปักหมุดแอป ไอคอนบนหน้าจอหลักและ favicon บนแท็บเบราว์เซอร์จะใช้ไอคอนของแอปที่ deploy ของคุณเอง — favicon หรือ apple-touch-icon ของแอป — ไม่ใช่เครื่องหมาย Stardeck ทั่วไป หากแอปของคุณไม่ได้กำหนดไว้ Stardeck จะใช้ไอคอนเริ่มต้น
หากต้องการควบคุมไอคอนที่ผู้ใช้เห็น ให้ตั้ง favicon / apple-touch-icon ในแอปของคุณเหมือนกับเว็บแอปทั่วไป Stardeck จะส่งต่อให้อัตโนมัติ
Surfaces: ตัวตนการติดตั้งแยกตามประสบการณ์
หากผลิตภัณฑ์ของคุณมีหลาย Surface แต่ละ Surface มีชื่อ PWA ไอคอน และเส้นทางเปิดของตัวเองได้ ให้ปักหมุด Surface ที่ต้องการบนอุปกรณ์นั้น เช่น POS บน iPad กับจอครัว แทนที่จะหวังให้หมุดเดียวของทั้งแอปครอบคลุมทุกประสบการณ์
internal Surface ยังรองรับการแทนค่า Show app shell ต่อ Surface เพื่อให้สถานีที่ปักหมุดไว้เปิดได้โดยไม่มีส่วนประกอบของ Stardeck
รวมทุกอย่างเข้าด้วยกัน
สำหรับแอปที่ต้องให้ความรู้สึกเหมือนแอปเนทีฟบนโทรศัพท์หรือแท็บเล็ต:
- ตั้ง visibility ของแอปเป็น internal หรือ private (ดู การมองเห็นแอป)
- ใส่ favicon / apple-touch-icon ให้แอปของคุณเอง เพื่อให้ไอคอนบนหน้าจอหลักเป็นแบรนด์ของคุณ
- ปิด Show app shell ใน Settings → General เพื่อให้เปิดแบบ standalone ที่สะอาด
- เปิดแอปแล้วสั่ง Add to Home Screen จาก Safari (iOS) หรือ Chrome (Android)
ผลลัพธ์: ไอคอนแบรนด์ของคุณที่เปิดแอปเต็มจอ ตรงไปยังหน้าที่ถูกต้อง โดยไม่มีส่วนประกอบของ Stardeck มาบัง
การปักหมุดกำหนดวิธีที่แอปเปิด ไม่ได้กำหนดว่าใครเข้าถึงได้ ขั้นต่อไป ตั้งว่าใครเปิดแอปได้ที่ การมองเห็นแอป