appfunctions

appfunctions

  

API Reference
androidx.appfunctions

TODO

העדכון האחרון	גרסה יציבה	גרסה מועמדת להפצה	גרסת בטא	גרסת אלפא
‫8 באוקטובר 2025	-	-	-	‎1.0.0-alpha05

הצהרה על יחסי תלות

כדי להוסיף תלות ב-appfunctions, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

Groovy

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha05"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha05"
    implementation "androidx.appfunctions:appfunctions-compiler:1.0.0-alpha05"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha05")
    implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha05")
    implementation("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha05")
}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לשמוע מכם אם תגלו בעיות חדשות או אם יש לכם רעיונות לשיפור הספרייה הזו. לפני שיוצרים ספרייה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להוסיף את ההצבעה שלכם לבעיה קיימת, לוחצים על לחצן הכוכב.

יצירת בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא כלי המעקב אחר בעיות.

אין הערות לגבי הגרסה של הארטיפקט הזה.

גירסה 1.0

גרסה 1.0.0-alpha05

‫8 באוקטובר 2025

androidx.appfunctions:appfunctions-*:1.0.0-alpha05 משוחרר. גרסה 1.0.0-alpha05 מכילה את הקומטים האלה.

תכונות חדשות

• הקפדה על מילוי שדות החובה כשיוצרים את AppFunctionData
• אימות AppFunctionData מול ערכי אילוץ

שינויים ב-API

• מוסיפים AppFunctionService Compat API(s). (I2f1b1, b/445388953)

תיקוני באגים

• מוסיפים את שדה החובה AppFunctionsData. (I36b16, ‏ b/394553462)
• תוקנה הבעיה שבה המצב האופציונלי של הפרמטר לא כובד כשמבטלים את ברירת המחדל של ממשק.
• צריך ליצור קובץ XML ריק גם כשאין AppFunctions, כי AppSearch מצפה לקובץ התואם שצוין במניפסט האפליקציה.

גרסה 1.0.0-alpha04

‫10 בספטמבר 2025

androidx.appfunctions:appfunctions-*:1.0.0-alpha04 משוחרר. גרסה 1.0.0-alpha04 מכילה את הקומטים האלה.

תיקוני באגים

• פתרון בעיות ב-R8 בגרסאות build להפצה.

גרסה 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)
• מוסיפים את API של resolveAppFunctionAppMetadata. (I17408)
• הוספה של isDescribedByKdoc בהערה @AppFunctionSerializable ‏ (Ie14e7)
• הוספת שדה תיאור ב-AppFunctionDataTypeMetadata (I1bcac)
• החזרת AppPackageMetadata מ-API‏ observeAppFunctions. (I68c7e)
• הוספת שדה תיאור ב-AppFunctionMetadata (I060e2)
• הוספה של AppFunctionTestRule (Id5ed0)
• הוספת ההערה isDescribedByKdoc ב@AppFunction (Ia84d2)

תיקוני באגים

• ‫AppFunctionManagerCompat תומך רק במכשירי U+‎‏ (Ifa8d0)
• הוספת תיאורי מאפיינים של סוגים משותפים שניתנים לסריאליזציה בקובץ ה-XML של המטא-נתונים של AppFunction (I2aab2)
• הוספת אלמנט תיאור בקובץ ה-XML של המטא-נתונים שנוצר AppFunction (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.
• תיקון באג קטן ב-API של observeAppFunctions כדי לעקוב אחרי שינויים ב-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.