appfunctions

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

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

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

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

Groovy

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

Kotlin

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

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

משוב

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

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

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

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

גירסה 1.0

גרסה ‎1.0.0-alpha13

‫7 באוקטובר 2026

הגרסאות androidx.appfunctions:appfunctions:1.0.0-alpha13, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha13 וגם androidx.appfunctions:appfunctions-testing:1.0.0-alpha13 פורסמו. גרסה ‎1.0.0-alpha13 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת הערה (annotation) מסוג ‎ @AppFunctionAccessLevel כדי לתמוך בהגדרת הגבלת גישה. (Id47e1)
  • שינוי השם של ההערה AppFunction ל-AppFunctionDeclaration (I4b15d)
  • שינוי השם של ObserveAppFunctionsEvent לAppFunctionsChangeEvent (Iec918)
  • פלטפורמה AppFunctionMetadata בAppFunctionService. (If1117)

תיקוני באגים

  • תמיכה בכל סוגי ה-proxy המובנים (LocalDate, ‏ LocalTime, ‏ Instant, ‏ ZoneId) ב-AppFunctionData. (I61c16)

גרסה ‎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)
  • עדכון של constructor‏ AppFunctionPackageMetadata (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)

תיקוני באגים

  • תיקון בעיית תאימות ב-SDK37‏ AppFunctionUriGrant (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)
  • הסרת ממשקי get/set API עבור PendingIntent. (Ic7fd6, b/447530985)
  • הוספת תמיכה ב-Parcelables והעברה של PendingIntent כך שיוצג כ-Parcelable. (I8ab9f, b/447530985)

תיקוני באגים

  • הספריות מועברות לשימוש ביעד Java 11. המשמעות היא שקוד הבייט שנוצר יהיה Java 11 (גרסה 55 של קובץ המחלקה) ויכול להיות שיהיה צורך בביטול הסוכר כדי להשתמש בספרייה (If4c2a, ‏ b/457821470)

גרסה ‎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, בהתאמה.
  • מציינים תיאור בשפה טבעית למודלים גדולים של שפה (LLM) ותיאור שגלוי למשתמשים ומוצג באפליקציות של סוכנים.
  • הענקת הרשאות אוטומטית לכתובות 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)
  • הוספה של תיאורי מאפיינים של סוגים ניתנים לסריאליזציה שמשותפים ב-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.