توابع برنامه

  
به برنامه‌ها اجازه می‌دهد عملکرد و داده‌ها را با دستیارهای هوش مصنوعی هم‌رسانی کنند و به آن‌ها امکان می‌دهد وظایف را مستقیماً در دستگاه کشف و اجرا کنند تا درخواست‌های کاربر را برآورده کنند.
جدیدترین به‌روزرسانی نسخه پایدار نامزد انتشار انتشار نسخه بتا نسخه آلفا
۷ اکتبر ۲۰۲۶ - - - 1.0.0-alpha13

اعلام وابستگی‌ها

برای افزودن وابستگی به appfunctions، باید مخزن Google Maven را به پروژه‌تان اضافه کنید. برای اطلاعات بیشتر، مخزن Maven در Google را بخوانید.

وابستگی‌های آرتیفکت‌های موردنیازتان را در فایل build.gradle برای برنامه یا واحدتان اضافه کنید:

شیک

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

کاتلین

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

برای اطلاعات بیشتر درباره وابستگی‌ها، افزودن وابستگی‌های ساخت را ببینید.

بازخورد

بازخوردتان به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی پیدا کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل‌از ایجاد کتابخانه جدید، مشکلات موجود در این کتابخانه را بررسی کنید. با کلیک کردن روی دکمه ستاره می‌توانید رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد مشکل جدید

برای کسب اطلاعات بیشتر، به مستندات «پیگیری مسائل» مراجعه کنید.

برای این آرتیفکت، یادداشت انتشار وجود ندارد.

نسخه 1.0

نسخه 1.0.0-alpha13

۷ اکتبر ۲۰۲۶

‫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 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

  • برای پشتیبانی از تنظیم محدودیت دسترسی، شرح ‎ @AppFunctionAccessLevel را اضافه کنید. (Id47e1)
  • تغییر نام AppFunction گزارمان به AppFunctionDeclaration (I4b15d)
  • تغییر نام ObserveAppFunctionsEvent به AppFunctionsChangeEvent (Iec918)
  • ‫Surface AppFunctionMetadata در AppFunctionService. (If1117)

رفع اشکال‌ها

  • از همه انواع پراکسی داخلی (LocalDate،‏ LocalTime،‏ Instant،‏ ZoneId) در AppFunctionData پشتیبانی کنید. (I61c16)

نسخه 1.0.0-alpha12

‫۲۳ سپتامبر ۲۰۲۶

‫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 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

  • تماس‌گیرنده AppFunctionData#serialize باید فراداده ارائه دهد. (I61eca)
  • علاوه‌بر سربار موجود مبتنی بر Class، getHandleAppFunctionRequestAdapter عینیت‌یافته درخط را اضافه می‌کند. (Ic1b4e)
  • ‫AppFunctionContext و AppFunctionConfiguration را برمی‌دارد (I9dd8f)
  • ‫activityId را به ExecuteAppFunctionRequest (I6ac86) اضافه می‌کند
  • ‫registerAppFunction،‏ registerAppFunctions،‏ RegisterAppFunctionRequest، و CallbackAppFunction را به‌عنوان @ExperimentalAppFunctionsApi اضافه می‌کند. (Idb2ca)
  • ‫scope را در AppFunctionMetadata و AppFunctionSearchSpec اضافه می‌کند (I4344c)
  • ‫AppFunctionUriValueConstraint را به‌عنوان میانای برنامه‌سازی کاربردی عمومی اضافه می‌کند. (I75070)
  • به‌روزرسانی سازنده AppFunctionPackageMetadata (I096f7)

نسخه 1.0.0-alpha11

۲۶ اوت ۲۰۲۶

‫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 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

  • ‫@AppFunctionSignature را به‌عنوان میانای برنامه‌سازی کاربردی عمومی آزمایشی اضافه کنید. این API از ثبت پویای AppFunction ازطریق Jetpack پشتیبانی می‌کند. (I72e23، b/501032667)
  • ‫AppFunctionState و AppFunctionManager#getAppFunctionStates را اضافه کنید. این مورد جایگزین AppFunctionMetadata#isEnabled می‌شود. فراداده اکنون کاملاً از وضعیت جدا شده است. (I8e490، b/494238383)
  • ‫Add getAppFunctionActivityStates. (I41093،‏ b/542075714)
  • برای پشتیبانی از عملکرد برنامه‌ها با «فضای جانبی»، ExtensionsAppFunctionService را اضافه کنید. (I7cf10،‏ b/524941402)
  • «میانای برنامه‌سازی کاربردی» observeAppFunctions را به‌روز کنید تا با «میانای برنامه‌سازی کاربردی» پلاتفرم مطابقت داشته باشد. (Ifa6fb، b/494238381)

رفع اشکال‌ها

  • رفع مشکلی که باعث می‌شد فراداده زمان اجرای ازدست‌رفته باعث ازکارافتادن برنامه هنگام فراخوانی setAppFunctionEnabled درطول OOBE شود. (Ibe229، b/536750020)
  • تا زمانی که فراداده از همان منبع حقیقت می‌آید، هنگام استفاده از AppFunctionData#serialize API، درستی‌سنجی داده‌ها را موقتاً غیرفعال کنید. (I6c95، b/545200019)

نسخه 1.0.0-alpha10

۱ ژوئیه ۲۰۲۶

‫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 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

  • AppFunctionServiceEntryPoint اضافه شد. همه شرح‌های AppFunction باید در AppFunctionService که با AppFunctionServiceEntryPoint شرح‌گذاری شده است (Idc5d5، b/463909015) اعلام شود
  • میاناهای برنامه‌سازی کاربردی 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 از زبان نشانه‌گذاری توسعه‌پذیر تولیدشده برای AppFunctionSignatures (Ie2996، b/501032667)

نسخه 1.0.0-alpha09

۶ مه ۲۰۲۶

‫androidx.appfunctions:appfunctions-*:1.0.0-alpha09 منتشر شد. نسخه 1.0.0-alpha09 شامل این تغییرات است.

تغییرات میانای برنامه‌سازی کاربردی

  • ‫AppInteractionAttribution را در ExecuteAppFunctionRequest بپذیرید (I70ad8،‏ b/462092640)

رفع اشکال‌ها

  • مشکل سازگاری AppFunctionUriGrant در SDK37 را برطرف کنید (I21110، b/485613578)

نسخه 1.0.0-alpha08

۱۱ مارس ۲۰۲۶

‫androidx.appfunctions:appfunctions-*:1.0.0-alpha08 منتشر شد. نسخه 1.0.0-alpha08 شامل این تعهدها است.

ویژگی‌های جدید

  • پشتیبانی از Parcelable (ها) علاوه‌بر PendingIntent (I8ab9f) اضافه شد
  • میاناهای برنامه‌سازی کاربردی برای تبدیل از/به درخواست و پاسخ «پلاتفرم» (Ifdf20)،

تغییرات میانای برنامه‌سازی کاربردی

  • مطابقت پارامتر با راهنمای سبک. (I69b2d)
  • افزودن میاناهای برنامه‌سازی کاربردی برای تبدیل از/به درخواست و پاسخ «پلاتفرم» (Ifdf20، b/476047880)
  • نام AppFunctionManagerCompat به AppFunctionManager تغییر کند. (Id9a78, b/448372122)
  • میاناهای برنامه‌سازی کاربردی دریافت/تنظیم را برای PendingIntent بردارید. (Ic7fd6, b/447530985)
  • از Parcelable پشتیبانی کنید و PendingIntent را منتقل کنید تا به‌عنوان Parcelable نمایش داده شود. (I8ab9f، b/447530985)

رفع اشکال‌ها

  • کتابخانه‌ها را به هدف Java 11 منتقل می‌کند. این یعنی کدبایت تولیدشده Java 11 (نسخه فایل کلاس 55) خواهد بود و ممکن است برای استفاده از کتابخانه به تبدیل نیاز داشته باشد (If4c2a، b/457821470)

نسخه 1.0.0-alpha07

‫۱۹ نوامبر ۲۰۲۵

‫androidx.appfunctions:appfunctions-*:1.0.0-alpha07 منتشر شد. نسخه 1.0.0-alpha07 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

رفع اشکال‌ها

  • رفع مشکل پارامترهای سطح بالای الزامی غیرتهی (Ic60fc، b/456717542)

نسخه 1.0.0-alpha06

۵ نوامبر ۲۰۲۵

‫androidx.appfunctions:appfunctions-*:1.0.0-alpha06 منتشر شد. نسخه 1.0.0-alpha06 شامل این تعهدات است.

ویژگی‌های جدید

  • پشتیبانی از جاسازی منبع به‌عنوان بخشی از پاسخ AppFunction
  • استفاده از FLAG_GRANT_PERSISTABLE_URI_PERMISSION در AppFunctionUriGrant مجاز شود

تغییرات میانای برنامه‌سازی کاربردی

رفع اشکال‌ها

  • رفع مشکلی که باعث می‌شد هنگام ساختن AppFunctionData، نادیده گرفتن فیلد الزامی تهی‌پذیر با خطا مواجه شود (I52195)
  • رفع مشکلی که باعث می‌شد استفاده از List<PendingIntent> با AppFunction در زمان ترجمه ناموفق باشد (Iebde7)
  • رفع مشکل مربوط به اینکه فراداده ByteArray به‌اشتباه به‌عنوان List<ByteArray> (I2e499) تولید شده است

نسخه 1.0.0-alpha05

‫۸ اکتبر ۲۰۲۵

‫androidx.appfunctions:appfunctions-*:1.0.0-alpha05 منتشر شد. نسخه 1.0.0-alpha05 شامل این تعهدات است.

ویژگی‌های جدید

  • هنگام ساختن AppFunctionData، فیلدهای الزامی ارائه می‌شوند
  • درحال اعتبارسنجی AppFunctionData دربرابر مقادیر محدودیت

تغییرات میانای برنامه‌سازی کاربردی

  • ‫AppFunctionService میانای برنامه‌سازی کاربردی سازگاری را اضافه کنید. (I2f1b1،‏ b/445388953)

رفع اشکال‌ها

  • بررسی فیلد الزامی AppFunctionsData را اضافه کنید. (I36b16، b/394553462)
  • رفع مشکلی که باعث می‌شد وضعیت اختیاری پارامتر هنگام ملغی کردن میانای کاربری رعایت نشود.
  • حتی اگر AppFunctions وجود نداشته باشد، فایل XML خالی تولید کنید زیرا AppSearch انتظار دارد فایل مربوطه در «مانیفست برنامه» مشخص شده باشد.

نسخه 1.0.0-alpha04

‫۱۰ سپتامبر ۲۰۲۵

‫androidx.appfunctions:appfunctions-*:1.0.0-alpha04 منتشر شد. نسخه 1.0.0-alpha04 شامل این تعهدها است.

رفع اشکال‌ها

  • مشکلات R8 را برای ساخت‌های نسخه پخش برطرف کنید.

نسخه 1.0.0-alpha03

‫۱۳ اوت ۲۰۲۵

‫androidx.appfunctions:appfunctions-*:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 شامل این تعهدها است.

ویژگی‌های جدید

  • استفاده از KDoc(s) به‌عنوان شرح AppFunction
  • مقادیر انواع «عدد صحیح» و «رشته» را به‌ترتیب بااستفاده از گزارمان‌های AppFunctionIntValueConstraint و AppFunctionStringValueConstraint محدود کنید.
  • شرحی به زبان طبیعی برای مدل‌های زبانی بزرگ و شرحی نمایان برای کاربر که در برنامه‌های کارگزار نمایش داده می‌شود مشخص کنید.
  • اجازه‌ها به‌طور خودکار به نشانی(های) وب برگشت‌داده‌شده از عملکرد برنامه بااستفاده از کلاس AppFunctionUriGrant اعطا می‌شود.
  • بااستفاده از AppFunctionTestRule، آزمایش‌های Robolectric برای آزمایش تنظیمات عملکرد برنامه بنویسید.

تغییرات میانای برنامه‌سازی کاربردی

  • افزودن AppFunctionStringValueConstraint (I10e3f)
  • افزودن AppFunctionIntValueConstraint (Ifda13)
  • ‫AppFunctionPrimitiveTypeMetadata را به کلاس‌های نوع داده خاص بازسازی کنید. (I1a3b2)
  • افزودن فیلد شرح در AppFunctionResponseMetadata (I2332b)
  • برداشتن الزام اجازه از میانای برنامه‌سازی کاربردی setAppFunctionEnabled‏ (I1b92a)
  • افزودن فیلد شرح در AppFunctionParameterMetadata (I40a67)
  • افزودن AppFunctionUriGrant (I67ca9)
  • میانای برنامه‌سازی کاربردی resolveAppFunctionAppMetadata را اضافه کنید. (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

‫۴ ژوئن ۲۰۲۵

‫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 شامل این تعهدات است.

ویژگی‌های جدید

  • از Android 16 API(s) پشتیبانی کنید.
  • پشتیبانی بهتر برای AppFunctionSerializable(s) پارامتری در زمان کامپایل.

تغییرات میانای برنامه‌سازی کاربردی

  • میانای برنامه‌سازی کاربردی AppFunctionSchemaDefinition معرفی شد که به کارگزاران امکان می‌دهد طرحواره‌های تابع ازپیش‌تعریف‌شده خودشان را تعریف کنند.

رفع اشکال‌ها

  • خطا در مدیریت وضعیت فعال نبودن زمان اجرای AppFunctions.
  • رفع اشکال جزئی در observeAppFunctions API برای مشاهده تغییرات در AppFunctionComponentMetadata.
  • گزارش‌های خطای اضافی.

نسخه 1.0.0-alpha01

۷ مه ۲۰۲۵

‫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 روی android.app.appfunctions میانای برنامه‌سازی کاربردی پلاتفرم ساخته شده است. این کتابخانه نمایش عملکرد برنامه شما به «دستیار» را ساده می‌کند و به «دستیار» اجازه می‌دهد با عملکردهای نمایان برنامه تعامل داشته باشد.

  • androidx.appfunctions:appfunctions: میاناهای برنامه‌سازی کاربردی کارخواه اصلی برای مدیریت (فعال/غیرفعال کردن) و تعامل با (جستجو/اجرا) AppFunctions.
  • androidx.appfunctions:appfunctions-service: میاناهای برنامه‌سازی کاربردی سمت سرویس برای آشکار کردن آسان کارکردهای برنامه به‌عنوان AppFunctions.
  • androidx.appfunctions:appfunctions-compiler: برای تولید کد لازم برای نمایان کردن AppFunctions، به کامپایلر KSP نیاز است.