appfunctions

  
อนุญาตให้แอปแชร์ฟังก์ชันการทำงานและข้อมูลกับผู้ช่วย AI ซึ่งจะช่วยให้ผู้ช่วยค้นพบและดำเนินการต่างๆ บนอุปกรณ์ได้โดยตรงเพื่อตอบสนองคำขอของผู้ใช้
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
23 กันยายน 2026 - - - 1.0.0-alpha12

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

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

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

ดึงดูด

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha12"
    // Use Kotlin Symbol Processing (KSP) for the appfunctions compiler plugin.
    // See KSP Quickstart to add KSP to your build
    ksp "androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha12")
    // Use Kotlin Symbol Processing (KSP) for the appfunctions compiler plugin.
    // See KSP Quickstart to add KSP to your build
    ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12")
}

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

ความคิดเห็น

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

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

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

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

รุ่น 1.0

เวอร์ชัน 1.0.0-alpha12

23 กันยายน 2026

androidx.appfunctions:appfunctions:1.0.0-alpha12, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12 และ androidx.appfunctions:appfunctions-testing:1.0.0-alpha12 จะเปิดตัว เวอร์ชัน 1.0.0-alpha12 มีการคอมมิตเหล่านี้

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

  • กำหนดให้ผู้โทร AppFunctionData#serialize ระบุข้อมูลเมตา (I61eca)
  • เพิ่ม getHandleAppFunctionRequestAdapter ที่ทำให้เป็นจริงในบรรทัดนอกเหนือจากการโอเวอร์โหลดที่อิงตาม Class ที่มีอยู่ (Ic1b4e)
  • นำ AppFunctionContext และ AppFunctionConfiguration (I9dd8f) ออก
  • เพิ่ม activityId ลงใน ExecuteAppFunctionRequest (I6ac86)
  • เพิ่ม registerAppFunction, registerAppFunctions, RegisterAppFunctionRequest และ CallbackAppFunction เป็น @ExperimentalAppFunctionsApi (Idb2ca)
  • เพิ่ม scope ใน AppFunctionMetadata และ AppFunctionSearchSpec (I4344c)
  • เพิ่ม AppFunctionUriValueConstraint เป็น API สาธารณะ (I75070)
  • อัปเดต AppFunctionPackageMetadata Constructor (I096f7)

เวอร์ชัน 1.0.0-alpha11

26 สิงหาคม 2026

androidx.appfunctions:appfunctions:1.0.0-alpha11, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha11 และ androidx.appfunctions:appfunctions-testing:1.0.0-alpha11 จะเปิดตัว เวอร์ชัน 1.0.0-alpha11 มีการเปลี่ยนแปลงเหล่านี้

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

  • เพิ่ม @AppFunctionSignature เป็น API สาธารณะเวอร์ชันทดลอง API รองรับการลงทะเบียน AppFunction แบบไดนามิกผ่าน Jetpack (I72e23, b/501032667)
  • เพิ่ม AppFunctionState และ AppFunctionManager#getAppFunctionStates ซึ่งจะแทนที่ AppFunctionMetadata#isEnabled ตอนนี้ข้อมูลเมตาแยกออกจากสถานะโดยสมบูรณ์แล้ว (I8e490, b/494238383)
  • Add getAppFunctionActivityStates (I41093, b/542075714)
  • เพิ่ม ExtensionsAppFunctionService เพื่อรองรับแอปที่ทำงานร่วมกับ Sidecar (I7cf10, b/524941402)
  • อัปเดต observeAppFunctions API ให้ตรงกับ API ของแพลตฟอร์ม (Ifa6fb, b/494238381)

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

  • แก้ไขปัญหาที่ข้อมูลเมตาของรันไทม์ที่ขาดหายไปอาจทำให้แอปขัดข้องเมื่อเรียกใช้ setAppFunctionEnabled ระหว่าง OOBE (Ibe229, b/536750020)
  • ปิดใช้การตรวจสอบข้อมูลชั่วคราวเมื่อใช้ AppFunctionData#serialize API จนกว่าข้อมูลเมตาจะมาจากแหล่งข้อมูลที่เชื่อถือได้เดียวกัน (I6c95, b/545200019)

เวอร์ชัน 1.0.0-alpha10

1 กรกฎาคม 2026

androidx.appfunctions:appfunctions:1.0.0-alpha10, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10 และ androidx.appfunctions:appfunctions-testing:1.0.0-alpha10 จะเปิดตัว เวอร์ชัน 1.0.0-alpha10 มีการเปลี่ยนแปลงเหล่านี้

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

  • เพิ่ม AppFunctionServiceEntryPoint แล้ว ต้องประกาศคำอธิบายประกอบ AppFunction ทั้งหมดภายใน AppFunctionService ที่มีคำอธิบายประกอบ AppFunctionServiceEntryPoint (Idc5d5, b/463909015)
  • ย้าย API AppFunction และ AppFunctionConfiguration AppFunctionConfiguration จะถูกนำออกในการเปิดตัวในอนาคตเนื่องจากจะถูกแทนที่ด้วย AppFunctionServiceEntryPoint (Iaff23, I4cf3e, b/517876475)
  • อัปเดต AppFunctionService API เพื่อรองรับการเรียกกลับ (I6e0d7, b/519880977)
  • เพิ่ม searchAppFunctions API (I8c0f9, I1fa27, b/494239238)
  • เพิ่ม functionNames ใน AppFunctionSearchSpec (I95f53, b/494239238)
  • เพิ่มคำอธิบายประกอบ AppFunctionInstruction (I21120, b/488994214)
  • เพิ่มคำอธิบายประกอบ AppFunctionSignature และค่าคงที่ที่เกี่ยวข้องเพื่อประกาศลายเซ็นฟังก์ชันแอปที่ลงทะเบียนรันไทม์ (I82a05, Ie2361, Ib6bb2)

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

  • ละเว้น enabledByDefault จาก XML ที่สร้างขึ้นสำหรับ AppFunctionSignatures (Ie2996, b/501032667)

เวอร์ชัน 1.0.0-alpha09

6 พฤษภาคม 2026

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

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

  • ยอมรับ AppInteractionAttribution ใน ExecuteAppFunctionRequest (I70ad8, b/462092640)

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

  • แก้ไขปัญหาความเข้ากันได้ของ AppFunctionUriGrant ใน SDK37 (I21110, b/485613578)

เวอร์ชัน 1.0.0-alpha08

11 มีนาคม 2026

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

ฟีเจอร์ใหม่

  • เพิ่มการรองรับ Parcelable (s) นอกเหนือจาก PendingIntent (I8ab9f)
  • API เพื่อแปลงจาก/เป็นคำขอและการตอบกลับของแพลตฟอร์ม (Ifdf20)

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

  • พารามิเตอร์เป็นไปตามคู่มือสไตล์ (I69b2d)
  • เพิ่ม API เพื่อแปลงจาก/เป็นคำขอและการตอบกลับของแพลตฟอร์ม (Ifdf20, b/476047880)
  • เปลี่ยนชื่อ AppFunctionManagerCompat เป็น AppFunctionManager (Id9a78, b/448372122)
  • นำ API get/set สำหรับ PendingIntent ออก (Ic7fd6, b/447530985)
  • เพิ่มการรองรับ Parcelable และย้ายข้อมูล PendingIntent เพื่อแสดงเป็น Parcelable (I8ab9f, b/447530985)

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

  • ย้ายไลบรารีไปใช้เป้าหมาย Java 11 ซึ่งหมายความว่าไบต์โค้ดที่สร้างขึ้นจะเป็น Java 11 (ไฟล์คลาสเวอร์ชัน 55) และอาจต้องมีกระบวนการ Desugaring เพื่อใช้ไลบรารี (If4c2a, b/457821470)

เวอร์ชัน 1.0.0-alpha07

19 พฤศจิกายน 2025

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

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

  • รองรับการเลิกใช้งาน AppFunction (I39229, b/454661174)

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

  • แก้ไขปัญหาเกี่ยวกับพารามิเตอร์ระดับบนสุดที่ต้องมีซึ่งไม่ใช่ค่า Null (Ic60fc, b/456717542)

เวอร์ชัน 1.0.0-alpha06

5 พฤศจิกายน 2025

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

ฟีเจอร์ใหม่

  • รองรับการฝังทรัพยากรเป็นส่วนหนึ่งของการตอบกลับ AppFunction
  • อนุญาตให้ใช้ FLAG_GRANT_PERSISTABLE_URI_PERMISSION ใน AppFunctionUriGrant

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

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

  • แก้ไขปัญหาที่การละเว้นฟิลด์ที่จำเป็นซึ่งอนุญาตให้เป็น Null จะทำให้การสร้าง AppFunctionData ล้มเหลว (I52195)
  • แก้ไขปัญหาที่การใช้ List<PendingIntent> กับ AppFunction จะล้มเหลวในเวลาคอมไพล์ (Iebde7)
  • แก้ไขปัญหาที่ระบบสร้างข้อมูลเมตาของ ByteArray ไม่ถูกต้องเป็น List<ByteArray> (I2e499)

เวอร์ชัน 1.0.0-alpha05

8 ตุลาคม 2025

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

ฟีเจอร์ใหม่

  • บังคับให้ระบุช่องที่ต้องกรอกเมื่อสร้าง AppFunctionData
  • การตรวจสอบ AppFunctionData กับค่าข้อจำกัด

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

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

  • เพิ่มช่องที่ต้องกรอก AppFunctionsData ตรวจสอบ (I36b16, b/394553462)
  • แก้ไขปัญหาที่ระบบไม่สนใจสถานะพารามิเตอร์ที่ไม่บังคับเมื่อลบล้างอินเทอร์เฟซ
  • สร้างไฟล์ XML ว่างเปล่าแม้ว่าจะไม่มี AppFunctions เนื่องจาก AppSearch คาดหวังให้มีไฟล์ที่เกี่ยวข้องซึ่งระบุไว้ในไฟล์ Manifest ของแอป

เวอร์ชัน 1.0.0-alpha04

10 กันยายน 2025

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

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

  • แก้ไขปัญหา R8 สำหรับบิลด์ที่เผยแพร่

เวอร์ชัน 1.0.0-alpha03

13 สิงหาคม 2025

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

ฟีเจอร์ใหม่

  • ใช้ KDoc(s) เป็นคำอธิบาย AppFunction
  • จำกัดค่าสำหรับประเภท Int และ String โดยใช้คำอธิบายประกอบ AppFunctionIntValueConstraint และ AppFunctionStringValueConstraint ตามลำดับ
  • ระบุคำอธิบายภาษาธรรมชาติสำหรับโมเดลภาษาขนาดใหญ่และคำอธิบายที่ผู้ใช้มองเห็นซึ่งแสดงภายในแอปตัวแทน
  • ให้สิทธิ์แก่ URI ที่ส่งคืนจากฟังก์ชันของแอปโดยอัตโนมัติโดยใช้คลาส AppFunctionUriGrant
  • เขียนการทดสอบ Robolectric โดยใช้ AppFunctionTestRule เพื่อทดสอบการตั้งค่าฟังก์ชันของแอป

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

  • เพิ่ม AppFunctionStringValueConstraint (I10e3f)
  • เพิ่ม AppFunctionIntValueConstraint (Ifda13)
  • ปรับโครงสร้าง AppFunctionPrimitiveTypeMetadata เป็นคลาสประเภทข้อมูลที่เฉพาะเจาะจง (I1a3b2)
  • เพิ่มฟิลด์คำอธิบายใน AppFunctionResponseMetadata (I2332b)
  • นำข้อกำหนดด้านสิทธิ์ออกจาก setAppFunctionEnabled API (I1b92a)
  • เพิ่มฟิลด์คำอธิบายใน AppFunctionParameterMetadata (I40a67)
  • เพิ่ม AppFunctionUriGrant (I67ca9)
  • เพิ่ม resolveAppFunctionAppMetadata API (I17408)
  • เพิ่ม isDescribedByKdoc ในคำอธิบายประกอบ @AppFunctionSerializable (Ie14e7)
  • เพิ่มฟิลด์คำอธิบายใน AppFunctionDataTypeMetadata (I1bcac)
  • ส่งคืน AppPackageMetadata จาก observeAppFunctions API (I68c7e)
  • เพิ่มฟิลด์คำอธิบายใน AppFunctionMetadata (I060e2)
  • เพิ่ม AppFunctionTestRule (Id5ed0)
  • เพิ่ม isDescribedByKdoc ในคำอธิบายประกอบ @AppFunction (Ia84d2)

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

  • AppFunctionManagerCompat รองรับเฉพาะอุปกรณ์ U+ (Ifa8d0)
  • เพิ่มคำอธิบายพร็อพเพอร์ตี้ของประเภทที่แชร์ซึ่งแปลงเป็นอนุกรมได้ใน XML ของข้อมูลเมตาของ AppFunction (I2aab2)
  • เพิ่มองค์ประกอบคำอธิบายใน AppFunction's metadata xml (Ie5bf6) ที่สร้างขึ้น

เวอร์ชัน 1.0.0-alpha02

4 มิถุนายน 2025

androidx.appfunctions:appfunctions:1.0.0-alpha02, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02 และ androidx.appfunctions:appfunctions-service:1.0.0-alpha02 จะเปิดตัว เวอร์ชัน 1.0.0-alpha02 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • รองรับ API ของ Android 16
  • รองรับ AppFunctionSerializable(s) ที่กำหนดพารามิเตอร์ได้ดียิ่งขึ้นในเวลาคอมไพล์

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

  • เปิดตัว AppFunctionSchemaDefinition API ซึ่งช่วยให้เอเจนต์กำหนดสคีมาฟังก์ชันที่กำหนดไว้ล่วงหน้าของตนเองได้

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

  • การจัดการข้อผิดพลาดสำหรับสถานะที่ขาดหายไปของรันไทม์ที่เปิดใช้ของ AppFunctions
  • แก้ไขข้อบกพร่องเล็กน้อยใน observeAppFunctions API เพื่อสังเกตการเปลี่ยนแปลงใน AppFunctionComponentMetadata
  • บันทึกข้อผิดพลาดเพิ่มเติม

เวอร์ชัน 1.0.0-alpha01

7 พฤษภาคม 2025

androidx.appfunctions:appfunctions:1.0.0-alpha01, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01 และ androidx.appfunctions:appfunctions-service:1.0.0-alpha01 จะเปิดตัว เวอร์ชัน 1.0.0-alpha01 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

AppFunctions ไลบรารี Jetpack สร้างขึ้นบน API ของแพลตฟอร์ม android.app.appfunctions ไลบรารีนี้ช่วยให้การเปิดเผยฟังก์ชันการทำงานของแอปต่อ Assistant เป็นเรื่องง่าย และช่วยให้ Assistant โต้ตอบกับฟังก์ชันที่เปิดเผยของแอปได้

  • androidx.appfunctions:appfunctions: API ไคลเอ็นต์หลักสำหรับการจัดการ (เปิด/ปิด) และการโต้ตอบ (ค้นหา/เรียกใช้) AppFunctions
  • androidx.appfunctions:appfunctions-service: API ฝั่งบริการเพื่อแสดงฟังก์ชันการทำงานของแอปเป็น AppFunctions ได้อย่างง่ายดาย
  • androidx.appfunctions:appfunctions-compiler: ต้องใช้คอมไพเลอร์ KSP เพื่อสร้างโค้ดที่จำเป็นสำหรับการเปิดเผย AppFunctions