ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release
แทน aosp-main
เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP
วิดเจ็ตและทางลัด
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
Flow API ใหม่สําหรับการเพิ่มทางลัดและวิดเจ็ตใน Android 8.0 ช่วยให้นักพัฒนาแอปเพิ่มทางลัดและวิดเจ็ตจากภายในแอปได้โดยไม่ต้องใช้ถาดวิดเจ็ต นอกจากนี้ ยังเลิกใช้งานวิธีการแบบเก่า (การส่งการออกอากาศ) ในการเพิ่มทางลัดด้วยเหตุผลด้านความปลอดภัย
โปรแกรมเปิดใช้ต้องรองรับการใช้งานใหม่นี้เพื่อให้นักพัฒนาแอปสามารถพึ่งพาระบบในการเพิ่มทางลัดหรือวิดเจ็ต
ตัวอย่างและแหล่งที่มา
เอกสารมีให้บริการในคลาสของระบบต่างๆ ข้อมูลอ้างอิงมีดังนี้
- ShortcutManager.java
เผยแพร่ส่วนแป้นพิมพ์ลัดที่ปักหมุดไว้ในส่วนหัว
- Intent.java
Javadoc สําหรับ ACTION_CREATE_SHORTCUT
- AppWidgetManager.java
Javadoc สำหรับ requestPinAppWidget
การใช้งาน
ผู้ติดตั้งใช้งานอุปกรณ์ต้องเพิ่มกิจกรรมใน Launcher ที่มีการดำเนินการของตัวกรอง Intent ดังนี้
android.content.pm.action.CONFIRM_PIN_SHORTCUT
android.content.pm.action.CONFIRM_PIN_APPWIDGET
ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับ API
กิจกรรมนี้ควรแสดงข้อความยืนยันให้ผู้ใช้เพิ่มวิดเจ็ต/ทางลัดที่ขอ และเมื่อยอมรับแล้ว ให้เพิ่มวิดเจ็ต/ทางลัดที่เกี่ยวข้องในหน้าจอหลัก
ในกรณีของวิดเจ็ต การเรียกใช้ accept()
ควรมีรหัสวิดเจ็ตของวิดเจ็ตที่เพิ่มใหม่
การใช้ UI ของระบบ
พาร์ทเนอร์ต้องอัปเดตแอป Launcher โดยใช้การติดตั้งใช้งาน Launcher3 (packages/apps/Launcher3
) เป็นข้อมูลอ้างอิง
ดูการเปลี่ยนแปลง Launcher3 ที่เกี่ยวข้องในโครงการโอเพนซอร์ส Android (AOSP)
การตรวจสอบความถูกต้อง
หากต้องการตรวจสอบฟีเจอร์ ให้ลองเพิ่มทางลัดจาก Chrome หรือแอปรายชื่อติดต่อ และตรวจสอบว่าข้อความยืนยันที่เหมาะสมแสดงขึ้น เมื่อยอมรับแล้ว ระบบจะเพิ่มไอคอนในหน้าจอหลักและ Chrome ควรแสดงข้อความแจ้งความสำเร็จ
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-27 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-07-27 UTC"],[],[],null,["# Widgets and shortcuts\n\nThe new flow API for adding shortcuts and widgets in Android 8.0 allows\napp developers to add shortcuts and widgets from inside the app instead\nof relying on the widget tray. It also deprecates the old method (sending a\nbroadcast) of adding shortcuts for security reasons.\n\n\nLaunchers need to support this new implementation so that app developers can\nrely on the system to add their shortcut or widget.\n\nExamples and source\n-------------------\n\n\nDocs are available in various system class. References include the following:\n\n- **[ShortcutManager.java](https://developer.android.com/reference/android/content/pm/ShortcutManager.html)** \n Publish Pinned shortcut section in header.\n- **Intent.java** \n Javadoc for ACTION_CREATE_SHORTCUT.\n- **AppWidgetManager.java** \n Javadoc for requestPinAppWidget.\n\nImplementation\n--------------\n\n\nDevice implementers need to add an activity in their launcher with intent filter actions:\n\n- `android.content.pm.action.CONFIRM_PIN_SHORTCUT`\n- `android.content.pm.action.CONFIRM_PIN_APPWIDGET`\n\n\nRefer to the [API\ndocumentation](https://developer.android.com/reference/android/content/pm/LauncherApps.html) for more details.\n\n\nThis activity should display a confirmation prompt to the user to add the [requested\nwidget/shortcut](https://developer.android.com/reference/android/content/pm/LauncherApps.html) and upon accepting, add the corresponding widget/shortcut on\nthe homescreen.\n\n\nIn case of widgets, the `accept()` call should include the widget ID\nof the newly added widget.\n\n### Implementing a System UI\n\n\nPartners need to update their Launcher app using the Launcher3 implementation\n(`packages/apps/Launcher3`) as reference.\n\n\nFind the relevant Launcher3 changes in the Android Open Source Project (AOSP):\n\n- Change-Id: [8b2002e28072c52d78f6d052c6ff6da50a2d0324](https://android.googlesource.com/platform/packages/apps/Launcher3/+/8b2002e28072c52d78f6d052c6ff6da50a2d0324)\n- Change-Id: [278359539c02ca160caf1df54ce96053a2a2ef59](https://android.googlesource.com/platform/packages/apps/Launcher3/+/278359539c02ca160caf1df54ce96053a2a2ef59)\n\nValidation\n----------\n\n\nTo validate the feature, try to add shortcuts from Chrome or the Contacts app\nand verify that a proper confirmation prompt is shown. Upon accepting, the icon\nshould get added on the homescreen and Chrome should display a success toast."]]