إنشاء تطبيقات Android ذكية: دمج التطبيقات في نظام Android الذكي باستخدام AppFunctions
مدّة القراءة: 6 دقائق
مرحبًا بكم مجددًا في سلسلة منشورات المدوّنة "إنشاء تطبيقات Android ذكية" التي نتناول فيها كيفية تحويل تطبيق Android أساسي إلى تجربة مخصّصة وذكية واستباقية. في منشورنا السابق، استكشفنا كيفية الاستفادة من Firebase AI Logic لإنشاء ميزات تستخدم الذكاء الاصطناعي وتكون مستضافة على السحابة الإلكترونية ومختلطة.
تتميّز واجهات المستخدم التقليدية على الأجهزة الجوّالة في تنفيذ المهام المركّزة والعملية، ويقدّم نظام Android الذكي ميزات تكميلية لتسهيل الإجراءات المعقّدة والمتعدّدة الخطوات. من خلال استكمال واجهات المستخدم التقليدية، توفّر AppFunctions نقطة دخول جديدة وفعّالة: يمكن لوكيل مميّز على الجهاز الوصول إلى ميزات التطبيق في الخلفية. يمكن أن يكون ذلك مفيدًا بشكل خاص عندما يقود المستخدمون السيارة أو يمشون أو يؤدون مهام متعددة.
في هذه المقالة، سنوضّح كيفية تصميم هذه الإمكانات ودمجها في تطبيق التخطيط للسفر JetPacker باستخدام Android AppFunctions. سنستكشف الأسباب وراء اختيارنا للميزات، ونناقش الأدوات المتخصصة التي استخدمناها لتسريع عملية التطوير، ونتعمق في الرمز البرمجي الذي يجعل كل ذلك يعمل.
تصميم ميزات جاهزة للذكاء الاصطناعي: اتخاذ خيارات مهمة للمستخدمين
لاختيار الميزات التي يجب توفيرها لنظام الذكاء، بحثنا عن المهام التي يكون فيها الطلب الصوتي أو النصي أسرع من النقر على الشاشات. في هذا التسجيل الذي يعرض الشاشتين جنبًا إلى جنب، يمكنك رؤية هذا التباين بوضوح: على اليمين، ينقر المستخدم على شاشات متعددة لتسجيل نفقات، وعلى اليسار، يتم إكمال المهمة نفسها على الفور في الخلفية من خلال وكيل ذي امتيازات.
كان خيارنا الأول هو تتبع النفقات. يتطلب تسجيل نفقات القهوة أثناء الرحلة عادةً بضع نقرات، مثل فتح قفل الهاتف وفتح التطبيق والعثور على الرحلة النشطة والانتقال إلى علامة التبويب "النفقات" والنقر على زر الإضافة والتقاط صورة للإيصال والتحقق من النتيجة. من خلال توفير ميزتَي addExpense وgetExpenses كـ AppFunctions، يتولّى وكيل النظام تنفيذ المهام الصعبة. عندما يقول المستخدم: "أضِف نفقات قهوة بقيمة خمسة دولارات إلى رحلتي إلى باريس"، يبحث الوكيل تلقائيًا عن رقم تعريف الرحلة الصحيح في الخلفية ويُدرج النفقات، متجاوزًا مسار واجهة المستخدم اليدوي بالكامل.
لقد منحنا أيضًا الأولوية لإدارة برامج الرحلات. يتطلب العثور على النشاط التالي في برنامج رحلة مزدحم عادةً التمرير عبر عرض مخطط زمني كثيف. من خلال توفير getItinerary وaddItineraryEvent للنظام، يمكن للمستخدم ببساطة أن يسأل "ما هي خطوتي التالية في باريس؟" والحصول على إجابة فورية.
أخيرًا، ركّزنا على تدوين الملاحظات بدون لمس الجهاز. كتابة التذكيرات أو الملاحظات أثناء المشي في شارع مزدحم أمر صعب وغير آمن. من خلال إتاحة ميزة الملاحظات الصوتية، يمكن للمستخدم أن يقول: "كانت الرحلة رائعة، ورأيت غروب شمس جميلاً وتمكّنت من النوم جيدًا"، ويحوّل الوكيل المميّز الصوت تلقائيًا إلى نص ويحفظه مباشرةً في قاعدة بيانات السفر باستخدام دالة AppFunction addVoiceNote.
بروتوكول سياق النموذج (MCP) لـ Android المستنِد إلى AppFunctions
تستند هذه التجربة بالكامل إلى "بروتوكول سياق النموذج" (MCP) في Android. بموجب هذا التصميم، يعمل التطبيق كخادم MCP محلي. بدلاً من واجهات برمجة التطبيقات عن بُعد، يمكنك توفير ميزات تطبيقك مباشرةً لنظام الذكاء على الجهاز فقط.
Android AppFunctions هي واجهة برمجة التطبيقات التي تحقّق هذا المفهوم. فهي تقرأ دوال Kotlin التي تتضمّن تعليقات توضيحية وتجمّعها في تعريفات أدوات آمنة من حيث النوع ومعزولة يمكن للوكيل المميّز اكتشافها واستدعاؤها محليًا على الجهاز.
بموجب نموذج MCP في Android، يعمل تطبيقك كخادم MCP محلي يعرض أدوات منظَّمة، بينما يعمل نظام Android الأساسي كسجلّ مركزي للأدوات. على جانب عميل MCP، يتم تسجيل تطبيقات الوكلاء في نظام الذكاء بعد منحها أذونات مميّزة للنظام للوصول إلى السجلّ.
عندما يتفاعل مستخدم مع وكيل مسجَّل، يحدّد النموذج اللغوي الكبير الخاص به ما إذا كان يمكن معالجة الطلب من خلال AppFunction، ويستعلم عن البيانات الوصفية للمنصة، وينفّذ الدوال المسجَّلة المناسبة في الخلفية. يمنحك تصميم خادم العميل المحلي لبروتوكول MCP تحكّمًا كاملاً، إذ يمكنك اختيار الميزات التي يمكن للوكيل الوصول إليها بدقة، مع الحفاظ على خصوصية بقية بيانات تطبيقك.
كيفية تسريع عملية التطوير باستخدام مهارات Android
لتبسيط عملية الدمج، استخدمنا مهارة تطوير AppFunctions. تُعدّ مهارة تطوير AppFunctions أداة تطوير متكاملة. فقد أرشدنا خلال دورة الحياة الكاملة: بدءًا من ربط فئات بيانات Kotlin لتسلسل المَعلمات، وإنشاء نقاط دخول Service اللازمة، وتحسين مستندات KDoc لضمان فهم النموذج اللغوي الكبير لحدود المَعلمات، وإعداد الاختبارات الآلية باستخدام ADB.
توفير ميزات التطبيق لنظام الذكاء الاصطناعي
يكفينا الحديث عن النظريات، ولنبدأ الآن في التنفيذ.
الضبط وإعداد التبعيات
نبدأ بإضافة تبعيات AppFunctions. أحدهما لواجهة برمجة التطبيقات والآخر لبرنامج تجميع Kotlin Symbol Processing.
implementation("androidx.appfunctions:appfunctions:1.0.0-alpha10")
ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10")نمذجة أنواع البيانات المخصّصة
يجب إضافة التعليق التوضيحي @AppFunctionSerializable إلى أي عنصر مخصّص يتم تبادله مع الوكيل. في ملف TripSerializable.kt، نحدّد نموذج بيانات الرحلة:
@AppFunctionSerializable(isDescribedByKDoc = true) data class TripSerializable( /** The trip's unique identifier. */ val id: String, /** The trip's title. */ val title: String, /** The trip's destination location. */ val location: String, /** The trip's start date in milliseconds. */ val startDate: Long, /** The trip's end date in milliseconds. */ val endDate: Long, /** A list of participants. */ val participants: List<String>, )
توفير الميزات باستخدام التعليق التوضيحي @AppFunction
بعد ذلك، كتبت المهارة دوال Kotlin التي تنفّذ طلبات البحث في قاعدة البيانات وتضيف إليها تعليقات توضيحية باستخدام @AppFunction. يمكننا عرض ذلك في searchTrip:
/** * Looks for trips based on optional filters like id, title (name), location, and dates. * * @param id The unique identifier of the trip. * @param title The title or name of the trip. * @param location The destination location. * @param startDate The minimum start date in milliseconds. * @param endDate The maximum end date in milliseconds. * @return A list of trips matching the filters. */ @AppFunction(isDescribedByKDoc = true) suspend fun searchTrip( id: String? = null, title: String? = null, location: String? = null, startDate: Long? = null, endDate: Long? = null ): List<TripSerializable> { return withContext(Dispatchers.IO) { // implementation }
بما أنّ واجهات AppFunctions تعمل على سلسلة واجهة المستخدم تلقائيًا، نستخدم withContext(Dispatchers.IO) للتبديل إلى مُرسِل في الخلفية. بالإضافة إلى ذلك، نحسّن KDoc لاستخدام أفعال واضحة بصيغة الأمر وتحديد قيود المَعلمات. يتم تجميع هذه المستندات مباشرةً في مخطط الأداة، والذي يستخدمه الوكيل المميّز لحلّ المَعلمات ومعالجة الأخطاء أثناء التشغيل.
نقطة دخول الخدمة ودمج Hilt
لتسجيل هذه الميزات في نظام الذكاء الاصطناعي، ننشئ صنفًا أساسيًا مجردًا يوسّع AppFunctionService. ونضيف إليه التعليق التوضيحي @AppFunctionServiceEntryPoint:
@RequiresApi(36) @AndroidEntryPoint @AppFunctionServiceEntryPoint( serviceName = "JetPackerAppFunctionService", appFunctionXmlFileName = "jetpacker_app_function_service" ) abstract class BaseJetPackerAppFunctionService : AppFunctionService() { @Inject internal lateinit var tripDao: TripDao // DAOs and database references are injected here... }
أثناء عملية التجميع، تنشئ KSP الفئة الفرعية النهائية للخدمة الملموسة، JetPackerAppFunctionService، كما تم الإعلان عنها باستخدام المَعلمة serviceName. ونسجّل أيضًا app_metadata.xml في بيان التطبيق. يوفّر هذا الملف قواعد تشغيلية عامة لـ AppFunctions المُعلَن عنها في JetPacker.
اختبار واجهات AppFunctions والتحقّق منها
بعد تنفيذها، عليك التأكّد من أنّ AppFunctions مسجَّلة وتعمل بشكل صحيح.
عند تشغيل الأجهزة المتصلة أو المحاكيات التي تعمل بنظام التشغيل Android 17 أو إصدار أحدث، يمكنك استخدام أوامر Adb من Terminal لعرض الدوال واستدعائها. يؤدي تشغيل adb shell cmd app_function list-app-functions إلى عرض جميع الدوال المسجَّلة لحزمتك. يمكنك بعد ذلك تنفيذ دالة معيّنة واختبار دمجها في قاعدة البيانات من خلال تشغيل adb shell cmd app_function execute-app-function مع تمرير سلسلة مَعلمات JSON غير مُعالَجة.
بدلاً من أوامر ADB هذه، يمكنك أيضًا استخدام AppFunctions Testing Agent لفحص الإعدادات، وإدراج AppFunctions وتنفيذها، وحتى الاطّلاع على سلوك AppFunctions في مسار محادثة حقيقي.
الخلاصة
عند التفكير في ميزات التطبيق التي يمكن المساهمة بها في نظام الذكاء باستخدام AppFunctions، يتطلّب ذلك تغييرًا طفيفًا في طريقة تفكيرنا في الرموز البرمجية والمستندات. تتيح لك AppFunctions استخدام نموذج التفاعل الجديد هذا للتطبيقات، ما يسمح باستخدام وكيل للوصول إلى ميزات التطبيق.
أولاً، تُعدّ مهارة تطوير AppFunctions أداة أساسية في مراحل نشاط التطبيق، فهي تساعدك في اكتشاف الميزات وتنفيذ AppFunctions وتحسينها لتطبيقاتك. ثانيًا، تعليقات KDoc هي مادة عرض لواجهة برمجة التطبيقات تم تجميعها، وتؤثر أوصاف المَعلمات الواضحة بشكل مباشر في دقة تنفيذ وكيل النظام. أخيرًا، يوفّر Android MCP تنفيذًا محليًا يتيح للتطبيقات التعاون بأمان مع وكلاء الذكاء الاصطناعي.
من خلال المساهمة في ميزات التطبيق عبر AppFunctions، يصبح تطبيقك جاهزًا لنظام الذكاء الاصطناعي. يُرجى إعلامنا بكيفية تكييف تطبيقاتك مع عصر الذكاء الاصطناعي الوكيل.
مزيد من المعلومات
يمكنك الاطّلاع على الأجزاء الأخرى من سلسلة منشورات المدوّنة هذه:
الجزء الأول: مقدّمة عن التطبيق ونظرة عامة شاملة
الجزء الثاني: الذكاء الاصطناعي على الجهاز فقط تعرَّف على واجهات برمجة التطبيقات للذكاء الاصطناعي التوليدي في حزمة تعلّم الآلة وGemini Nano لإنشاء ميزات تركّز على الخصوصية، مثل تلخيص برامج الرحلات وتحليل الإيصالات ومعالجة الصوت على الجهاز.
الجزء الثالث: الاستدلال المختلط والسحابي. يمكنك استكشاف كيفية استخدام Firebase AI Logic لتحديد مصدر إجابات النماذج اللغوية الكبيرة في بيانات من العالم الواقعي، مثل "خرائط Google" وسياق الويب.
الجزء 4 (هذا المنشور): تكامل الأنظمة التكامل مع نظام Android Intelligence باستخدام AppFunctions
الجزء الخامس (قريبًا): مهام سير العمل المستندة إلى الوكلاء داخل التطبيق توسيع نطاق التطبيق من خلال مساعد حجز شامل مستند إلى A2UI وADK
هل يهمّك معرفة المزيد عن تطوير تطبيقات Android؟ يمكنك متابعة حساب مطوّري برامج Android على YouTube أو LinkedIn.
تتّبع جميع مقتطفات الرموز في منشور المدوّنة هذا إشعار حقوق الطبع والنشر التالي:
Copyright 2026 Google LLC. SPDX-License-Identifier: Apache-2.0
-
طرق التنفيذمرحبًا بكم من جديد في سلسلة منشورات المدوّنة "إنشاء تطبيقات Android ذكية" التي نوضّح فيها كيفية تحويل تطبيق Android أساسي إلى تجربة مخصّصة وذكية واستباقية. في منشورنا السابق، تعرّفت على كيفية الربط بنظام الذكاء الاصطناعي باستخدام AppFunctions.
Jolanda Verhoef • مدّة القراءة: 9 دقائق -
طرق التنفيذمرحبًا بكم من جديد في سلسلة منشورات المدوّنة "إنشاء تطبيقات Android ذكية"، حيث نأخذ تطبيق Android أساسيًا ونحوّله إلى تجربة مخصّصة وذكية واستباقية.
Thomas Ezan, Jolanda Verhoef, Caren Chang • مدّة القراءة: 8 دقائق -
طرق التنفيذمرحبًا بكم من جديد في سلسلة منشورات المدوّنة "إنشاء تطبيقات Android ذكية"، حيث نأخذ تطبيق Android أساسيًا ونحوّله إلى تجربة مخصّصة وذكية واستباقية. في منشورنا السابق، قدّمنا Jetpacker، وهو التطبيق التجريبي الذي سنستخدمه في هذه السلسلة.
Caren Chang • مدّة القراءة: 6 دقائق
يمكنك الحصول على آخر الإحصاءات حول تطوير تطبيقات Android في بريدك الوارد أسبوعيًا.