توابع برنامه

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

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

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

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

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

کاتلین 

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

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

بازخورد

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

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

هیچ یادداشت انتشاری برای این مصنوع وجود ندارد.

نسخه ۱.۰

نسخه ۱.۰.۰-آلفا۱۰

۱ ژوئیه ۲۰۲۶

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 ) جایگزین خواهد شد.
  • API AppFunctionService برای پشتیبانی از فراخوانی مجدد ( I6e0d7 ، b/519880977 ) به‌روزرسانی شد.
  • افزودن API searchAppFunctions ( I8c0f9 ، I1fa27 ، b/494239238 )
  • functionNames به AppFunctionSearchSpec اضافه شد ( I95f53 ، b/494239238 )
  • حاشیه‌نویسی AppFunctionInstruction اضافه شد ( I21120 ، b/488994214 )
  • حاشیه‌نویسی AppFunctionSignature و ثابت‌های همراه آن برای اعلان امضاهای تابع برنامه ثبت‌شده در زمان اجرا اضافه شد. ( I82a05 ، Ie2361 ، Ib6bb2 )

رفع اشکالات

  • حذف enabledByDefault از XML تولید شده برای AppFunctionSignatures ( Ie2996 ، b/501032667 )

نسخه ۱.۰.۰-آلفا۰۹

۶ مه ۲۰۲۶

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

تغییرات API

  • Accept AppInteractionAttribution in ExecuteAppFunctionRequest ( I70ad8 , b/462092640 )

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۸

۱۱ مارس ۲۰۲۶

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

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

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

تغییرات API

  • Parameter conformity with styleguide. ( I69b2d )
  • اضافه کردن API برای تبدیل از/به درخواست و پاسخ پلتفرم ( Ifdf20 ، b/476047880 )
  • نام AppFunctionManagerCompat را به AppFunctionManager تغییر دهید. ( Id9a78 ، b/448372122 )
  • API های get/set را برای PendingIntent حذف کنید. ( Ic7fd6 , b/447530985 )
  • Add support for Parcelables and migrate PendingIntent to be represented as a Parcelable. ( I8ab9f , b/447530985 )

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۷

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

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

تغییرات API

رفع اشکالات

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

نسخه ۱.۰.۰-alpha06

۵ نوامبر ۲۰۲۵

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

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

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

تغییرات API

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۵

۸ اکتبر ۲۰۲۵

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

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

  • هنگام ساخت AppFunctionData فیلدهای الزامی را اعمال کنید.
  • اعتبارسنجی AppFunctionData در برابر مقادیر محدودیت

تغییرات API

  • API(های) سازگار AppFunctionService اضافه کنید. ( I2f1b1 ، b/445388953 )

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۴

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

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

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۳

۱۳ آگوست ۲۰۲۵

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

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

  • استفاده از KDoc(ها) به عنوان توضیحات AppFunction
  • مقادیر مربوط به انواع Int و String را به ترتیب با استفاده از حاشیه‌نویسی‌های AppFunctionIntValueConstraint و AppFunctionStringValueConstraint محدود کنید.
  • برای مدل‌های زبانی بزرگ، یک توصیف زبان طبیعی و برای برنامه‌های عامل، یک توصیف قابل مشاهده توسط کاربر مشخص کنید.
  • Automatically grant permissions to URI(s) returned from an app function using AppFunctionUriGrant class.
  • برای آزمایش تنظیمات تابع برنامه خود، با استفاده از AppFunctionTestRule تست‌های Robolectric بنویسید.

تغییرات API

  • Add AppFunctionStringValueConstraint ( I10e3f )
  • اضافه کردن AppFunctionIntValueConstraint ( Ifda13 )
  • Refactor کردن AppFunctionPrimitiveTypeMetadata به کلاس‌های نوع داده خاص. ( I1a3b2 )
  • فیلد توضیحات را در AppFunctionResponseMetadata ( I2332b ) اضافه کنید
  • حذف نیاز به مجوز از API setAppFunctionEnabled ( I1b92a )
  • Add description field in 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 ) اضافه کنید.
  • Add a description element in generated AppFunction 's metadata xml ( Ie5bf6 )

نسخه ۱.۰.۰-آلفا۰۲

۴ ژوئن ۲۰۲۵

androidx.appfunctions:appfunctions:1.0.0-alpha02 , androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02 , and androidx.appfunctions:appfunctions-service:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits .

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

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

تغییرات API

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

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۱

۷ مه ۲۰۲۵

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) را ساده می‌کند و به دستیار اجازه می‌دهد تا با توابع نمایش داده شده برنامه تعامل داشته باشد.

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