appfunctions

appfunctions

  

เอกสารอ้างอิง API
androidx.appfunctions

สิ่งที่ต้องทำ

อัปเดตล่าสุด	รุ่นที่เสถียร	รุ่นที่อาจได้รับการเผยแพร่	รุ่นเบต้า	รุ่นอัลฟ่า
19 พฤศจิกายน 2025	-	-	-	1.0.0-alpha07

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

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

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

ดึงดูด

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha07"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha07"
    // 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-alpha07"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha07")
    implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha07")
    // 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-alpha07")
}

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

ความคิดเห็น

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

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

ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของเครื่องมือติดตามปัญหา

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

รุ่น 1.0

เวอร์ชัน 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

• เพิ่ม ResourceHolder API (I08c1c, b/447530724)
• เพิ่ม AppFunctionTextResource API (I7d54f, b/447530724)
• เพิ่ม AppFunctionOneOfTypeMetadata API (I12c67, b/449915612)
• นำคำต่อท้าย Compat ออกจาก Service API (Ib9291, b/449797980, b/449797980)
• รองรับบิลด์ AppFunctionData จาก AllOfType (Ib1176, b/447535093)
• เพิ่ม API get/set Parcelable ใน AppFunctionData (I3aec7, b/447530985)

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

• แก้ไขปัญหาที่การละเว้นฟิลด์ที่ต้องกรอกซึ่งอนุญาตให้เป็นค่าว่างจะทำให้การสร้าง 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

• เพิ่ม AppFunctionService Compat API (I2f1b1, b/445388953)

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

• เพิ่มช่องที่ต้องกรอก AppFunctionsData ตรวจสอบ (I36b16, b/394553462)
• แก้ไขปัญหาที่ระบบไม่สนใจสถานะพารามิเตอร์ที่ไม่บังคับเมื่อลบล้างอินเทอร์เฟซ
• สร้างไฟล์ XML ว่างเปล่าแม้ว่าจะไม่มี AppFunctions เนื่องจาก AppSearch คาดหวังให้มีไฟล์ที่เกี่ยวข้องซึ่งระบุไว้ใน App 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)
• เพิ่มองค์ประกอบคำอธิบายใน XML ข้อมูลเมตาของ AppFunction's ที่สร้างขึ้น (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