appfunctions

  
ההרשאה מאפשרת לאפליקציות לשתף פונקציונליות ונתונים עם עוזרים מבוססי-AI, כדי שהם יוכלו לגלות ולבצע משימות ישירות במכשיר ולמלא את בקשות המשתמשים.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫19 בנובמבר 2025 - - - ‎1.0.0-alpha07

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

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

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

Groovy

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")
}

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

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

גירסה 1.0

גרסה ‎1.0.0-alpha07

‫19 בנובמבר 2025

‫androidx.appfunctions:appfunctions-*:1.0.0-alpha07 מופץ. גרסה ‎1.0.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

תיקוני באגים

  • פתרון בעיה שקשורה לפרמטרים נדרשים ברמה העליונה שלא יכולים להיות 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

תיקוני באגים

  • תוקנה הבעיה שבה התעלמות משדה חובה שניתן להגדרה כ-nullable גורמת לכשל בבניית 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 מצפה לקובץ התואם שצוין במניפסט האפליקציה.

גרסה ‎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)
  • הסרה של דרישת ההרשאה מ-API‏ setAppFunctionEnabled (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)
  • הוספת תיאורי נכסים של סוגים ניתנים לסריאליזציה משותפים ב-AppFunction's metadata xml (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.