Android Basics

‫بسم هللا الرحمن الرحيم‬
‫عنوان الكتاب‬
‫أساسيات برمجة تطبيقات الهواتف الذكية باستخدام نظام أندرويد‬

‫(متطلب كلية للحصول على درجة الدبلوم المتوسط)‬
‫تأليف‬
‫د‪ .‬إياد محمد قاسم األغا‬

‫أستاذ مساعد في كلية تكنولوجيا المعلومات – الجامعة اإلسالمية‬
‫السنة‪2015 /‬‬
‫عنوان الكتاب‬ ‫الكلية الجامعية للعلوم التطبيقية‬
‫رقم المقرر‬
‫قررت الكلية الجامعية للعلوم التطبيقية تدريس كتاب " أساسيات برمجة تطبيقات الهواتف الذكية باستخدام نظام‬
‫أندرويد" لطلبتها‬
‫بدءاً من العام الدراسي ‪3102/3102‬م‬
‫اإلشراف العام‬
‫أ ‪ .‬د‪ .‬رفعت نعيم رستم‬ ‫رئيس الكلية‬
‫د‪ .‬أحمد فؤاد عبد العال‬ ‫نائب الرئيس للشئون األكاديمية‬
‫مركز التطوير األكاديمي‬

‫د‪ .‬سناء الصايغ‬ ‫إشراف إداري‬
‫تحكيم علمي‬
‫محكم علمي‬
‫محكم علمي‬
‫تدقيق لغوي‬
‫مدقق لغوي‬
‫العمل الفني‬
‫تصميم‬
‫رسوم‬
‫تنضيد‬
‫صفحــة ‪ .‬أ‬
‫الكلية الجامعية للعلوم التطبيقية‬ ‫عنوان الكتاب‬
‫منشورات الكلية الجامعية للعلوم التطبيقية‬

‫قامت الكلية الجامعية للعلوم التطبيقية باإلشراف على إعداد محتوى هذا الكتاب‪ ,‬ويعتبر نتاج علمي لها‪,‬‬
‫وبالتالي فإن حقوق النشر والطبع محفوظة للكلية الجامعية للعلوم التطبيقية‪ ,‬وال يجوز إنتاج أي جزء من هذا الكتاب‬
‫أو تخزينه على حاسوب أو نقله بأي شكل أو وسيلة سوا ًء أكانت إلكترونية أم ميكانيكية (آلية) أو بالنسخ أو التصوير‬
‫أو بالتسجيل أو بأي طريقة أخرى إال بموافقة خطية مسبقة من الكلية‪.‬‬
‫يطلب هذا الكتاب من الكلية الجامعية للعلوم التطبيقية‪ ,‬غزة‪-‬فلسطين‬
‫بيانات االتصال بالكلية الجامعية للعلوم التطبيقية‬
‫بيانات االتصال‬ ‫عنوان الكلية‬

‫‪Tel: (+970) 8 2868999‬‬
‫‪Fax: (+970) 8 2847404‬‬
‫تل الهوا‪-‬متفرع من شارع عون الشوا‬
‫‪P.O Box: 1415 Gaza Palestine‬‬
‫غزة‪-‬فلسطين‬
‫بريد إلكتروني‪info@ucas.edu.ps :‬‬
‫الموقع اإللكتروني‪www.ucas.edu.ps :‬‬
‫بيانات الكتاب‬
‫بيانات الطبعة‬
‫رقم اإليداع‬
‫بيانات النشر‬
‫صفحــة ‪ .‬ب‬
‫إهــــداء‬
‫أهدي هذا العمل المتواضع إلى والدتي العزيزة ووالدي رحمه هللا والذين كانا خير داعمين لي في مسيرتي العلمية‬
‫كما أهدي هذا العمل إلى عائلتي الصغيرة‪ :‬زوجتي وإبنائي لصبرهم على انشغالي عنهم ودعمهم لي إلنجاز هذا‬
‫العمل‬
‫صفحــة ‪ .‬ت‬
‫مقدمة الكتاب‬
‫في ظل التزايد المضطرد في استخدام الهواتف الذكية واألجهزة اللوحية‪ ,‬تعتبر تطبيقات الهواتف الذكية من‬
‫أكثر البرمجيات التي يتطلبها سوق العمل في مجال تكنولوجيا المعلومات‪ .‬على الرغم من وجود العديد من المراجع‬
‫والكتب المتخصصة في تعليم برمجة تطبيقات الهواتف الذكية‪ ,‬إال أن معظم هذه المراجع معدة باللغة اإلنجليزية‬
‫وتستهدف المطورين الذين يتقنون اللغة االنجليزية‪ ,‬حيث اليزال هناك قصور كبير في المراجع العربية في هذا‬
‫المجال‪ .‬يعتبر هذا العمل المتواضع من أوائل األعمال التي تتناول تطوير تطبيقات الهواتف الذكية باستخدام نظام‬
‫أندرويد‪ .‬كما أنه من أوائل األعمال الموجهة أكاديميا ً وذلك ضمن تخصص تطوير تطبيقات الهواتف الذكية في الكلية‬
‫الجامعية للعلوم التطبيقية – غزة‪.‬‬
‫هذا الكتاب هو المرجع الرئيس لمساق تطوير تطبيقات الهواتف الذكية ‪ 0‬حيث تعتمد دراسة هذا المساق على‬
‫متطلبين سابقين هما‪ :‬أساسيات البرمجة والبرمجية الشيئية )‪ (Object Oriented Programming‬وكذلك تصميم‬
‫واجهات الهواتف النقالة‪ .‬لذلك فإن هذا الكتاب اليغطي مبادئ البرمجة الشيئية التي يجب أن يكون الطالب ملماً بها‪.‬‬
‫كذلك لن يتم التطرق في هذا الكتاب إلى الطرق المختلفة لتصميم الواجهات )‪ (Layouts‬باستخدام ‪ ,XML‬حيث‬
‫سيتم التركيز على التعامل مع عناصر واجهة المستخدم برمجيا ً فقط‪ .‬كذلك يجب أن يكون لدا الطالب معرفة بمفهوم‬
‫قواعد البيانات وبناء الجداول وأوامر ‪ SQL‬المختلفة‪.‬‬
‫يراعي الكتاب في تقديمه وعرضه اإلحتياجات األكاديمية وذلك بالدمج ما بين المفاهيم النظرية التي يجب أن‬
‫يلم بها الطالب باإلضافة إلى الجانب العملي الذي يتم تنميته من خالل عدد كبير من األمثلة والتمارين‪ .‬يحتوي‬
‫الكتاب على عشر وحدات تغطي المواضيع األساسية التي يتطلبها المطور المبتدئ‪ .‬كذلك يحتوي الكتاب في وحداته‬
‫العشر على أكثر من عشرين تمرين عملي محلول معدة من قبل مؤلف الكتاب و مفصلة خطوةً بخطوة‪ .‬تهدف هذه‬
‫التمارين إلى تدريب الطالب على بناء تطبيقات متكاملة تغطي مختلف المواضيع التي يتناولها الكتاب‪ .‬كذلك تحتوي‬
‫كل وحدة في نهايتها على عدد من األسئلة للتقييم الذاتي‪.‬‬
‫صفحــة ‪ .‬ث‬
‫محتويات المقرر‬
‫‪3‬‬ ‫الوحدة األولى (الفعالية ‪)Activity -‬‬ ‫‪‬‬
‫‪12‬‬ ‫الوحدة الثانية (بنية التطبيق – ‪)Application Structure‬‬ ‫‪‬‬
‫الوحدة الثالثة (التعامل مع عناصر الواجهة برمجياً – ‪Interacting with UI Components‬‬ ‫‪‬‬
‫‪27‬‬ ‫‪)Programmatically‬‬
‫الوحدة الرابعة (الربط بين الفعاليات باستخدام األهداف – ‪)Linking Activities Using Intents‬‬ ‫‪‬‬
‫‪53‬‬
‫‪74‬‬ ‫الوحدة الخامسة (القوائم وشريط العمل – ‪)Menus and Action Bar‬‬ ‫‪‬‬
‫‪94‬‬ ‫الوحدة السادسة (استدامة البيانات في نظام أندرويد – ‪)Data Persistence in Android‬‬ ‫‪‬‬
‫رقم الصفحة‬
‫‪134‬‬ ‫الوحدة السابعة (مزودات المحتوى – ‪)Content Providers‬‬ ‫‪‬‬
‫‪146‬‬ ‫الوحدة الثامنة (مستقبالت النشر – ‪)Broadcast Receivers‬‬ ‫‪‬‬
‫‪164‬‬ ‫الوحدة التاسعة (القطع – ‪)Fragments‬‬ ‫‪‬‬
‫‪198‬‬ ‫الوحدة العاشرة (نشر تطبيقات أندرويد – ‪)Publishing Android Applications‬‬ ‫‪‬‬
‫صفحــة ‪ .‬ج‬
‫التراجم‬
‫ترجمة المصطلحات التقنية المتعقلة بالبرمجة الشيئية ونظام أندرويد كان من الصعوبات التي واجهت المؤلف في‬
‫إخراج الكتاب‪ .‬لشرح المصطلحات التقنية باللغة العربية بدون اإلخالل بمفاهيم هذه المصطلحات قمنا بترجمة‬
‫المصطلحات إلى العربية وقمنا أثناء الشرح بذكر الترجمة العربية ملحوقة بالمصطلح اإلنجليزي بين قوسين‪.‬‬
‫التراجم المستخدمة للمصطلحات المختلفة موضحة في الجدول التالي‪ .‬نود التأكيد على أن بعض المصطلحات لم‬
‫تترجم حرفيا ً حيث تم االعتماد أحيانا ً على تراجم قريبة لكونها أقرب للمفهوم الفعلي من الترجمة الحرفية من وجهة‬
‫نظر المؤلف‪.‬‬
‫من الضروري أيضا ً أن نؤكد على أن ترجمة المصطلحات هي بغرض مساعدة القارئ العربي على فهم السياق‬
‫وليس الستبدال المصطلحات األصلية بالتراجم العربية‪ .‬لذلك نوصي كالً من المدرس والطالب بالحرص على‬
‫استعمال المصطلح اإلنجليزي قدر اإلمكان‪.‬‬
‫الترجمة المستخدمة في الكتاب‬ ‫المصطلح‬
‫الفعالية‬ ‫‪Activity‬‬
‫الخدمة‬ ‫‪Service‬‬
‫مستقبل النشر‬ ‫‪Broadcast Receivent‬‬
‫ملف الوثيقة‬ ‫‪Manifest File‬‬
‫ملف التصميم‬ ‫‪Layout File‬‬
‫مجلد الممتلكات‬ ‫‪Assets Folder‬‬
‫دورة حياة الفعالية‬ ‫‪Activity Lifecycle‬‬
‫الحافظة الخلفية‬ ‫‪Backstack‬‬
‫الهدف‬ ‫‪Intent‬‬
‫الهدف المعلق‬ ‫‪PendingIntent‬‬
‫الهدف الصريح‬ ‫‪Explicit Intent‬‬
‫الهدف المضمن‬ ‫‪Implicit Intent‬‬
‫مرشح الهدف‬ ‫‪Intent Filter‬‬
‫حدث أو إجراء‬ ‫‪Action‬‬
‫فئة‬ ‫‪Class‬‬
‫فئة فرعية‬ ‫‪Subclass‬‬
‫فئة رئيسية‬ ‫‪Superclass‬‬
‫الواجهة البرمجية‬ ‫‪Interface‬‬
‫كائن‬ ‫‪Object‬‬
‫دالة‬ ‫‪Method‬‬
‫دالة االتصال الراجع‬ ‫‪Callback Method‬‬
‫الباني‬ ‫‪Constructor‬‬
‫حزمة‬ ‫‪Package‬‬
‫مستمع‬ ‫‪Listener‬‬
‫محول‬ ‫‪Adapter‬‬
‫صفحــة ‪0 .‬‬
‫قائمة العرض‬ ‫‪ListView‬‬

‫التفضيالت المشتركة‬ ‫‪Shared Preferences‬‬
‫الحزمة‬ ‫‪Bundle‬‬
‫قائمة الخيارات‬ ‫‪OptionsMenu‬‬
‫قائمة السياق‬ ‫‪Context Menu‬‬
‫القائمة المنبثقة‬ ‫‪Popup Menu‬‬
‫عنصر القائمة‬ ‫‪MenuItem‬‬
‫شريط العمل‬ ‫‪Action Bar‬‬
‫ملحق شريط العمل‬ ‫‪Action Overflow‬‬
‫درج التصفح‬ ‫‪Navigation Drawer‬‬
‫خاصية ‪XML‬‬ ‫‪XML Attribute‬‬
‫إذن‬ ‫‪Permission‬‬
‫إشعار‬ ‫‪Notification‬‬
‫درج اإلشعارات‬ ‫‪Notification Drawer‬‬
‫مزود المحتوى‬ ‫‪Content Provider‬‬
‫مستخرج المحتوى‬ ‫‪Content Resolver‬‬
‫القطعة‬ ‫‪Fragment‬‬
‫مدير القطع‬ ‫‪Fragment Manager‬‬
‫مربع الحوار‬ ‫‪Dialog‬‬
‫الوحدة األولى‪:‬‬
‫الفعالية (‪)Activity‬‬
‫يتعلم الطالب في هذه الوحدة‪:‬‬
‫‪ . ‬مفهوم الفعالية )‪ (Activity‬في نظام أندرويد وطريقة إنشائها‪.‬‬
‫‪ . ‬دورة حياة الفعالية )‪ (Activity‬وطريقة إدارتها بصورة سليمة‪.‬‬
‫‪ . ‬حفظ حالة الفعالية )‪ (Activity‬واستردادها‪.‬‬
‫‪ ‬التعريف بأوضاع العمل الخاصة بالفعالية (‪ )Activity‬واستخدام الحافظة الخلفية (‪.)Back stack‬‬
‫‪ . ‬التدريب العملي على إنشاء الفعالية )‪ (Activity‬ومعالجة حاالتها المختلفة‪.‬‬
‫هناك أنواع مختلفة من المكونات يمكن أن يبنى منها تطبيق األندرويد‪ .‬أول هذه المكونات يسمى بالفعالية‬
‫(‪ )Activity‬وهي جزء من تطبيق أندرويد يوفر للمستخدم واجهة تفاعلية تمكنه من تنفيذ أمر ما مثل تصفح‬
‫األخبار‪ ,‬البحث عن معلومة‪ ,‬االتصال الهاتفي‪ ,‬التقاط الصور‪ ,‬عرض خريطة أو أي مهمة أخرى‪ .‬كل فعالية‬
‫(‪ )Activity‬تمثل نافذة مستقلة في التطبيق‪ .‬هذه النافذة قد تعرض في وضع ملء الشاشة أو قد تحتل جزء صغير‬
‫من الشاشة‪.‬‬
‫تطبيق األندرويد يتكون عادة من مجموعة من الفعاليات )‪ (Activities‬الغير مرتطبة ببعضها‪ .‬كل تطبيق له عادةً‬
‫فعالية رئيسية واحدة )‪ (Main Activity‬وهي التي تعرض على الشاشة عن تشغيل التطبيق‪ .‬بعد تشغيل الفعالية‬
‫الرئيسية )‪ , (Main Activity‬يمكن من خاللها تشغيل فعاليات أخرى لتنفيذ مهمات مختلفة‪ .‬على سبيل المثال‪ ,‬عند‬
‫تشغيل تطبيق إ خباري ألول مرة يتم عرض قائمة األخبار في الواجهة الخاصة بالفعالية الرئيسية ‪(Main‬‬
‫)‪ ,Activity‬وعند اختيار أي خبر محدد بالنقر عليه‪ ,‬يتم تشغيل فعالية جديدة لعرض تفاصيل الخبر‪.‬‬
‫واجهة المستخدم يتم عادةً إنشاؤها وتصميمها من خالل ملفات ‪ XML‬كما درست مسبقاً‪ .‬الفعالية (‪ )Activity‬تقوم‬
‫عند بدء تشغيلها بإنشاء الواجهة بنا ًء على محتوى ملف ‪ .XML‬في ملف الفعالية (‪ )Activity‬يتم كتابة كود يمثل‬
‫اإلجراءات المختلفة التي يجب تنفيذها عند تفاعل المستخدم مع عناصر الواجهة‪ .‬وبذلك يكون هناك فصل كامل بين‬
‫تصميم الواجهات‪ ,‬والذي يتم من خالل ملفات ‪ ,XML‬واإلجراءات الالزم تنفيذها‪ ,‬والتي يتم تحديدها داخل الفعالية‬
‫(‪.)Activity‬‬
‫قبل الحديث عن التعامل مع واجهة المستخدم والتفاعل مع األحداث المختلفة ‪ ,UI Events‬سيتم شرح كيفية إنشاء‬
‫الفعالية (‪ )Activity‬وإدارتها‪.‬‬
‫إنشاء الفعالية (‪)Creating the Activity‬‬
‫إلنشاء فعالية جديدة‪ ,‬يجب عليك إنشاء فئة فرعية )‪ (subclass‬من الفئة (‪ )Activity‬أو أي فئة متفرعة من‬
‫‪ .)Activity‬بعد ذلك عليك كتابة الكود الخاص بدوال االتصال الراجع (‪ .)Callback Methods‬دوال االتصال‬
‫الراجع هي دوال يتم تنفيذها تلقائيا من قبل النظام (بدون تدخل المستخدم) بناء على التغير في دورة حياة الفعالية‬
‫)‪.(Activity Life Cycle‬‬
‫فمثالً عند بدء تشغيل الفعالية يقوم النظام بتشغيل الدالة )(‪ ,onCreate‬وعند إزالة الفعالية (‪ )Activity‬يتم تشغيل‬
‫الدالة )(‪ .onDestroy‬يمكن للمستخدم تنفيذ أي كود عند بدء تشغيل الفعالية )‪ (Activity‬عن طريقة إضافة هذا‬
‫الكود إلى الدالة )(‪ .onCreate‬فمثالً‪ ,‬نقوم عادة بكتابة الكود الخاص بإنشاء محتويات واجهة المستخدم داخل الدالة‬
‫)(‪ onCreate‬وذلك لتجهيز الواجهة للعرض عن بداية تشغيل الفعالية (‪ .)Activity‬أهم الدوال التي نحتاج عادةً‬
‫إلى إضافة كود لها عند إنشاء الفعالية (‪ )Activity‬هي‪:‬‬
‫)(‪ :onCreate‬يجب كتابة الكود الخاص بهذه الدالة والتي ينفذها النظام تلقائيا ً عند إنشاء الفعالية‪ .‬نقوم عادةً في‬ ‫‪‬‬
‫هذه الدالة بتهيأة وانشاء المكونات المختلفة الخاصة بالفعالية‪ .‬من خالل هذه الدالة يتم تحديد هيكلية الواجهة‬
‫الخاصة بالفعالية عن طريق استدعاء الدالة )(‪ .setContentView‬نقوم عادة بتحديد معرف خاص بملف‬
‫‪ XML‬الخاص بالواجهة وتمريره إلى الدالة )(‪.setContentView‬‬
‫)(‪ :onResume‬يتم تنفيذ هذه الدالة عندما تصبح الفعالية مشاهدة ‪ visible‬وذلك بعد إنشائها أو اسئناف عملها‬ ‫‪‬‬
‫بعد توقف‪ .‬أي أن هذه الدالة يتم تنفيذها بعد الدالة )(‪.onCreate‬قد تستخدم هذه الدالة السترجاع حالة الفعالية أو‬
‫لربطها بمكونات التطبيق األخرى مثل الخدمات )‪.(Services‬‬
‫)(‪ :onPause‬يقوم النظام باستدعاء هذه الدالة تلقائيا ً عند ايقاف الفعالية‪ .‬إيقاف الفعالية قد يكون نتيجة تشغيل‬ ‫‪‬‬
‫فعالية اخرى تحجبها جزئيا ً عن المشاهدة‪ ,‬وال يعني بالضرورة إنهاء الفعالية أو إخفائها‪ .‬نحتاج إلى كتابة هذه‬
‫الدالة لحفظ حالة الفعالية والبيانات التي تستخدمها حتى ال تفقد‪ ,‬وحتى يتم استعادتها عن الرجوع للفعالية‪.‬‬
‫)(‪ :onStop‬يتم تنفيذ هذه الدالة عندما تصبح الفعالية غير مشاهدة تماماً‪ .‬يمكن استخدام هذه الدالة إليقاف‬ ‫‪‬‬
‫العمليات التي تنفذها الفعالية‪.‬‬
‫هناك المزيد من دوال االتصال الراجع (‪ )Callback Methods‬والتي سيتم التطرق لها عند الحديث عن دورة‬
‫حياة الفعالية )‪ (Activity Life Cycle‬الحقا ً في هذه الوحدة‪.‬‬
‫اإلعالن عن الفعالية في ملف القائمة ‪Manifest‬‬
‫بعد إنشاء الفئة (‪ )class‬الخاصة بالفعالية‪ ,‬يجب االعالن عن الفعالية في ملف الوثيقة ‪ .Manifest‬ملف الوثيقة‬
‫‪ Manifest‬يحدد اإلعدادات المختلفة للتطبيق والمكونات التي يستخدمها وسيتم شرحه في الوحدة الثانية من هذا‬
‫الكتاب‪ .‬اإلعالن عن فعالية ما )‪ (Activity‬يتم عن طريق إضافة الخاصية >‪ <activity‬داخل الخاصية‬
‫>‪ <application‬كما هو موضح في الكود التالي ( مالحظة‪ :‬قد تقوم بيئة العمل مثل ‪ Eclipse‬بعمل ذلك تلقائياً)‪:‬‬
‫> ‪<manifest ...‬‬
‫> ‪<application ...‬‬
‫>‪<activity android:name=".ExampleActivity" /‬‬
‫‪...‬‬
‫> ‪</application ...‬‬
‫‪...‬‬
‫>‪</manifest‬‬
‫هناك أيضا ً بعض الخصائص التي تضاف داخل المكون >‪ <activity‬والخاصة بالفعالية مثل اسم الفعالية‬
‫‪ android:name‬والذي يجب اضافتها لتحديد اسم الفئة (‪ )class‬الخاص بالفعالية‪.‬‬
‫إدارة دورة حياة الفعالية )‪(Managing the Activity Life Cycle‬‬
‫إدارة دورة حياة الفعالية )‪ (Activity‬عن طريق كتابة الكود الخاص بدوال االتصال الراجع ‪(Callback‬‬
‫)‪ Methods‬إجراء مهم لبناء تطبيق صحيح‪ .‬دورة حياة الفعالية )‪ (Activity‬تتأثر مباشرةً بارتباطها بالفعاليات‬
‫األخرى‪ .‬الفعالية يمكن أن تكون في حالة من ثالثة حاالت‪:‬‬
‫وضع العمل ‪ :running‬وفي هذه الحالة تكون الواجهة في المقدمة ومفعلة من قبل المستخدم‪.‬‬ ‫‪‬‬
‫وضع اإليقاف المؤقت ‪ :paused‬تنتقل فعالية ما إلى وضع ‪ paused‬عندما يتم تشغيل فعالية أخرى تنتقل إلى‬ ‫‪‬‬
‫الواجهة وتكون هذه الفعالية الجديدة شفافة جزئيا ً أو ال تمأل الشاشة بحيث ال يزال باإلمكان رؤية الفعالية‬
‫األولى‪ .‬الفعالية في وضع اإليقاف المؤقت تظل الفعالية في الذاكرة وتحتفظ بحالتها وقيم المتغيرات فيها‪ ,‬ولكن‬
‫قد يلجأ النظام لتدميرها في حالة القصور الشديد في الذاكرة‪.‬‬
‫وضع اإليقاف ‪ :stopped‬تنتقل الفعالية إلى هذه الحالة عندما تصبح غير مشاهدة تماماً ويتم حجبها خلف فعالية‬ ‫‪‬‬
‫أخرى (أي أنها تصبح في المؤخرة)‪ .‬الفعالية في وضع االيقاف تحتفظ كذلك بحالتها وقيم المتغيرات فيها‪ ,‬ولكن‬
‫قد يلجأ النظام لتدميرها في حالة القصور الشديد في الذاكرة‪.‬‬
‫عندما تنتقل الفعالية من حالة إلى أخرى من الحاالت الموضحة أعاله‪ ,‬يتم إعالم الفعالية من قبل النظام عن طريق‬
‫تشغيل دوال االتصال الراجع (‪ )Callback Methods‬المالئمة حسب الحالة‪ .‬لذلك‪ ,‬يمكن كتابة كود في هذه‬
‫الدوال لتنفيذ مهام محددة عندما تتغير حالة الفعالية‪ .‬الكود الموضح باألسفل يوضح هيكلية الفعالية وأهم دوال‬
‫االتصال الراجع(‪:)Callback Methods‬‬
‫{‪public class ExampleActivity extends Activity‬‬
‫‪@Override‬‬
‫{)‪public void onCreate(Bundle savedInstanceState‬‬
‫;)‪super.onCreate(savedInstanceState‬‬
‫‪.‬الفعالية في مرحلة االنشاء ‪//‬‬
‫}‬
‫{)(‪protected void onStart‬‬
‫;)(‪super.onStart‬‬
‫‪.‬الفعالية على وشك أن تصبح مشاهدة‪ .‬تنفذ هذه الدالة قبل العرض مباشرة ‪//‬‬
‫}‬
‫{)(‪protected void onResume‬‬
‫;)(‪super.onResume‬‬
‫تنفذ هذه الدالة بعد ان تصبح الدالة مشاهدة ‪//‬‬
‫}‬
‫{)(‪protected void onPause‬‬
‫;)(‪super.onPause‬‬
‫تنفذ هذه الدالة عن ايقاف الفعالية مؤقتا بسبب تشغيل فعالية أخرى‪//‬‬
‫}‬
‫{)(‪protected void onStop‬‬
‫;)(‪super.onStop‬‬
‫الفعالية غير مشاهدة تماما وعليه تم ايقافها وتنفيذ هذه الدالة ‪//‬‬
‫}‬
‫{)(‪protected void onDestroy‬‬
‫;)(‪super.onDestroy‬‬
‫تنفذ هذه الدالة قبل تدمير الفعالية مباشرة‪//‬‬
‫}‬
‫}‬
‫مالحظة‪ :‬اذا أردت كتابة أي كود في دوال االتصال الراجع فعليك أوالً تنفيذ دوال االتصال الراجع في الفئة األم‬
‫)‪ (superclass‬وذلك قبل تنفيذ أي كود جديد كما هو موضح بالشكل‪ .‬فمثالً‪ ,‬في الدالة )(‪ onCreate‬يتم تنفيذ الدالة‬
‫)(‪ super.onCreate‬ثم يتم كتابة بقية الكود‪.‬‬
‫دورة حياة الفعالية كاملةً موضحة بالشكل ‪ 1-1‬باألسفل حيث تمثل المستطيالت دوال االتصال الراجع ( ‪Callback‬‬
‫‪ , )Methods‬وتمثل الدوائر حاالت الفعالية‪ .‬دورة حياة الفعالية تحصل ما بين تنفيذ الدالة )(‪ onCreate‬والدالة‬
‫)(‪ . onDestroy‬لذلك‪ ,‬كل ما يرتبط بإنشاء الفعالية من إنشاء هيكلية واجهة المستخدم والمتغيرات وتهيئة حالة‬
‫الفعالية واالتصال بقواعد البيانات مثال يتم في الدالة )(‪ .onCreate‬كل ماهو مرتبط بانهاء حالة الفعالية من اغالق‬
‫االتصال بالخدمات أو قواعد البيانات يمكن أن يتم في الدالة )(‪.onDestroy‬‬
‫هناك ما يسمى دورة الحياة المشاهدة للفعالية ‪ Visible lifecycle‬وتحصل ما بين الدالة )(‪ onStart‬و‬
‫)(‪ onStop‬وخاللها تكون الفعالية مشاهدة من قبل المستخدم‪ .‬الحظ أن دورة الحياة المشاهدة هي جزء من دورة‬
‫الحياة الكاملة‪ .‬الحظ أن الفعالية المشاهدة قد ال تكون بالضرورة في وضع العمل ‪( running‬قد تكون في وضع‬
‫االيقاف الموقت نتيجة تشغيل فعالية تحجبها جزئياً)‪.‬‬
‫وهناك أيضا دورة الحياة في المقدمة ‪ Foreground lifecycle‬وهي جزء من الدورتين السابقتين وتحصل بين‬
‫تنفيذ الدالة )(‪ onResume‬والدالة )(‪ .onPause‬خالل هذه الفترة تكون الفعالية في وضع العمل ‪ ,running‬أي‬
‫أنها تكون مشاهدة ويتم التفاعل معها من قبل المستخدم‪ .‬الحظ أن الكود الذي يتم كتابتة في الدالة )(‪ onResume‬و‬
‫الدالة )(‪ onPause‬يتم تنفيذه عندما يحصل أي تغيير في حالة الفعالية‪ ,‬ولذلك تستخدم هذه الدوال بكثرة لحفظ حالة‬
‫الفعالية والبيانات المتعلقة بها عند حصول أي تغيير في حالة الفعالية‪.‬‬
‫المستخدم تصفح إلى الفعالية‬
‫المستخدم يعود للفعالية‬
‫فعالية أخرى جاءت إلى المقدمة‬
‫تطبيق له أولوية بحاجة إلى ذاكرة‬

‫المستخدم تصفح إلى الفعالية‬
‫الفعالية غير مرئية‬
‫الفعالية قيد اإلنهاء أو‬

‫التدمير من النظام‬
‫‪1‬‬
‫شكل ‪ :1-1‬دورة حياة الفعالية )‪(Activity Life Cycle‬‬
‫في كل مرة يتم فيها تشغيل فعالية جديدة‪ ,‬يتم ايقاف الفعالية السابقة‪ .‬يقوم نظام األندرويد بحفظ وترتيب الفعاليات في‬
‫حافظة خلفية تسمى ‪ Back Stack‬كما هو موضح في شكل ‪ .1-2‬كل فعالية جديدة يتم تشغيلها يتم إضافتها إلى‬
‫مقدمة الحافظة تليها الفعاليات السابقة‪ .‬الفعالية (‪ )Activity‬التي في مقدمة الحافظة هي فقط تكون في وضع‬
‫التشغيل ‪ , running‬بينما تكون كل الفعاليات التالية لها متوقفة عن العمل‪ .‬عند إنهاء الفعالية التي في المقدمة عن‬
‫طريق النقر على زر ‪ Back‬يتم إيقافها وإزالتها من الحافظة‪ ,‬وتصبح الفعالية التالية لها في مقدمة الحافظة الخلفية‬
‫‪1‬‬
‫‪Activity, Android Developer, http://developer.android.com/reference/android/app/Activity.html‬‬
‫لتنتقل إلى وضع التشغيل‪ .‬بالرجوع إلى مثال التطبيق اإلخباري‪ ,‬عن تفعيل الفعالية الخاصة بأي خبر تنتقل هذه‬
‫الفعالية إلى مقدمة الحافظة الخلفية‪ ,‬وتتوقف الفعالية الرئيسية عن العمل لتصبح في مؤخرة الحافظة الخلفية‪ .‬عند‬
‫انتهاء المستخدم من استخدام الفعالية الفرعية والنقر على زر ‪ ,Back‬يتم ازالة الفعالية من الحافظة لتعود الفعالية‬
‫الرئيسية للواجهة وتصبح في بداية الحافظة‪.‬‬
‫الحافظة الخلفية‬
‫الفعالية األولى في المهمة‬
‫فعالية تعمل‬
‫فعالية منتهية‬
‫‪1‬‬
‫شكل ‪ :1-2‬استخدام الحافظة الخلفية )‪(Back Stack‬‬
‫تمرين عملي (‪)1-1‬‬

‫يهدف هذا التمرين إلى تتبع دورة حياة الفعالية )‪ (Activity Life Cycle‬والتسلسل المستخدم في تنفيذ دوال‬
‫االتصال الراجع (‪ .)Callback Methods‬سنقوم في هذا التمرين بإنشاء فعالية بدون أي عناصر في واجهة‪ ,‬ومن‬
‫ثم سنكتب كود طباعة في بعض دوال االتصال الراجع‪ .‬كود الفعالية موضح باألسفل‪:‬‬
‫{ ‪public class MainActivity extends Activity‬‬
‫{ )‪protected void onCreate(Bundle savedInstanceState‬‬
‫‪Toast.makeText(this, "onCreate",‬‬
‫;)(‪Toast.LENGTH_SHORT).show‬‬
‫}‬
‫{ )(‪protected void onPause‬‬
‫‪Android for ‘Starters’, http://techiezjunkyard-android.blogspot.com/2012/01/task-and-back- 1‬‬

‫‪stack_8919.html‬‬
‫;)(‪super.onPause‬‬
‫‪Toast.makeText(this, "onPause",‬‬
‫}‬
‫{ )(‪protected void onResume‬‬
‫;)(‪super.onResume‬‬
‫‪Toast.makeText(this, "onResume",‬‬
‫}‬
‫{ )(‪protected void onStop‬‬
‫;)(‪super.onStop‬‬
‫‪Toast.makeText(this, "onStop",‬‬
‫}‬
‫{ )(‪protected void onDestroy‬‬
‫;)(‪super.onDestroy‬‬
‫‪Toast.makeText(this, "onDestroy",‬‬
‫}‬
‫}‬
‫قم بتشغيل التطبيق وتتبع ترتيب الرسائل التي يتم طباعتها‪.‬‬
‫بعد إكتمال تشعيل الفعالية وتوقف طباعة الرسائل‪ ,‬إنقر على زر ‪ Back‬النهاء الفعالية‪ ,‬والحظ تسلسل الرسائل‬
‫التي يتم طباعتها في هذه الحالة‪.‬‬
‫مالحظة‪ :‬إلنشاء رسالة ليتم طباعتها على الشاشة يمكن استخدام الدالة )(‪ .Toast.makeText‬هذه الدالة يمرر لها‬
‫كائن من نوع ‪ Context‬وهو يمثل التطبيق الحالي ويمكن تمرير الفعالية الحالية‪ .‬كما يمرر لها الرسالة المراد‬
‫طباعتها ومدة العرض ( ‪ Toast.LENGTH_SHORT‬أو ‪ .)Toast.LENGTH_LONG‬بعد إنشاء الرسالة‬
‫يتم طباعتها بتنفيذ الدالة )(‪ .Toast.show‬طباعة رسائل من نوع ‪ Toast‬سيتم استخدامه بكثرة في التمارين‬
‫المذكورة في هذا الكتاب‪.‬‬
‫حفظ حالة الفعالية‬

‫ذكرنا مسبقا ً أن الفعالية )‪ (Activity‬في حالة اإليقاف ‪ stopped‬أو اإليقاف المؤقت ‪ paused‬يتم اإلحتفاظ بحالتها‬
‫وال تفقد المعلومات الخاصة بها مثل حالة واجهة المستخدم ولذلك ألن الفعالية ما تزال في الذاكرة‪ .‬ولكن عند إنهاء‬
‫الفعالية من القبل النظام يتم أزالتها من الذاكرة وتفقد كل المعلومات الخاصة بها‪ .‬عند الحاجة إلى تشغيل الفعالية مرة‬
‫أخرى يقوم النظام بإنشاء نسخة جديدة من الفعالية‪ .‬المستخدم يجب أن ال يالحظ أن النظام قام بتدمير الفعالية السابقة‬
‫وأنشاء أخرى جديدة‪ ,‬ولذلك يتوقع أن تحتفظ الفعالية بحالتها وبياناتها‪ .‬ولذلك يجب على المبرمج أن يحرص على‬
‫حفظ حالة الفعالية قبل تدميرها اذا كانت هناك حاجة لتشغيل الفعالية في وقت الحق‪.‬‬
‫هنا ك أكثر من طريقة لحفظ حالة الفعالية والبيانات المتعلقة بها‪ .‬يمكن للمبرمج استخدام الدالة‬
‫)(‪ ,onSaveInstanceState‬والتي يقوم النظام تلقائيا ً بتنفيذها مباشرةً قبل إيقاف الفعالية‪ .‬يمرر النظام لهذه الدالة‬
‫حزمة ‪ Bundle‬وهي عبارة عن حافظة يمكن تخزين بيانات بداخلها عن طريق دوال إدخال مخصصة مثل‬
‫)(‪ putInt‬و )(‪ .putString‬بعد تدمير الفعالية تظل كل البيانات المخزنة في الحزمة ‪ Bundle‬حتى يحتاج‬
‫المستخدم إلى تشغيل الفعالية مرة أخرى‪ .‬عندها‪ ,‬يقوم النظام بإنشاء نسخة جديدة من الفعالية ويقوم بتمرير الحزمة‬
‫‪ Bundle‬إلى الدوال )(‪ onCreate‬و )(‪ .onRestoreInstanceState‬باستخدام أي من هاتين الدالتين‪ ,‬يمكن‬
‫استخراج الحالة والبيانات المحفوظة في الحزمة ‪ .Bundle‬إذا لم يكن هناك أن بيانات السترجاعها (كما في حالة‬
‫تشغيل الفعالية ألول مرة)‪ ,‬تكون قيمة الحزمة ‪ Bundle‬هي ‪.null‬‬
‫الكود التالي يوضح الدوال )(‪ onSaveInstanceState‬و )(‪ onRestoreInstanceState‬وكيفية التعامل مع‬
‫الحزمة ‪ Bundle‬لحفظ واسترجاع البيانات‪ ,‬حيث يتم كتابة هذا الكود داخل الفعالية (‪:)Activity‬‬
‫{ )‪protected void onSaveInstanceState(Bundle outState‬‬
‫;)‪super.onSaveInstanceState(outState‬‬
‫;)"‪outState.putString("username", "someone.ucas.edu.ps‬‬
‫}‬
‫‪protected void onRestoreInstanceState(Bundle‬‬
‫{ )‪savedInstanceState‬‬
‫;)‪super.onRestoreInstanceState(savedInstanceState‬‬
‫= ‪String username‬‬
‫;)"‪savedInstanceState.getString("username‬‬
‫}‬
‫يجب المالحظة أن حالة العناصر الموجودة في واجهة المستخدم ‪ UI Widgets‬مثل القيم الموجودة في ‪EditText‬‬
‫و ‪ CheckBox‬يتم حفظها في الحزمة ‪ Bundle‬واسترجاعها تلقائيا ً عند إعادة إنشاء الفعالية دون الحاجة إلى كتابة‬
‫كود للقيام بذلك‪ .‬كل ما على المبرج القيام به ليضمن الحفظ التلقائي لحالة عناصر واجهة المستخدم هو إعطاء اسم‬
‫معرف غير مكرر لكل عنصر وذلك باستخدام الخاصية ‪ android:id‬في ملف التصميم ‪.Layout‬‬

‫على الرغم من أن حالة عناصر الواجهة يتم حفظها تلقائياً‪ ,‬يمكن استخدام الدالة )(‪ onSaveInstanceState‬لحفظ‬
‫بيانات أخرى مثل قيم المتغيرات والمصفوفات‪.‬‬
‫مالحظة‪ :‬ليس هناك ضمانة أن يتم تنفيذ الدالة )(‪ onSaveInstanceState‬من قبل النظام قبل تدمير الفعالية (كما‬
‫في حالة أن يقوم المستخدم بإنهاء الفعالية بالنقر على زر ‪ ,)back‬لذلك ينصح باستخدام هذه الدالة لكتابة الكود‬
‫الخاص بحفظ حالة واجهة المستخدم فقط‪ ,‬وال ينصح باستخدامها لحفظ بيانات أخرى مثل تلك التي يجب تخزينها في‬
‫قواعد البيانات‪ .‬في حالة الحاجة لحفظ بيانات يفضل استخدام )(‪ onPause‬لكتابة كود الحفظ في قواعد البيانات‬
‫عندما يقرر المستخدم إنهاء الفعالية‪.‬‬
‫يمكنك إختبار قدرة تطبيقك على حفظ حالة فعالية ما عن طريق تدوير جهاز العرض (المحمول أو الجهاز اللوحي)‪:‬‬
‫عندما يتغير اتجاه العرض من رأسي إلى أفقي والعكس‪ ,‬يقوم النظام بتدمير الفعالية وانشائها مرة أخرى (وذلك‬
‫بتنفيذ الدالة )(‪ onDestroy‬ثم تنفيذ الدالة )(‪ onCreate‬وذلك لتطبيق خصائص العرض الخاصة بالوضع الجديد‬
‫للشاشة‪ .‬في هذه الحالة‪ ,‬يجب أن تضمن استعادة حالة الفعالية وكل البيانات الخاصة بها عند تغيير اتجاه الجهاز‪,‬‬
‫وذلك حتى ال يالحظ المستخدم أي فقد للبيانات أو تغيير في حالة الفعالية‪.‬‬
‫أسئلة على الوحدة األولى‬

‫‪ .0‬ما المقصود بالفعالية )‪(Activity‬؟ ولماذا يعتبر من الضرورة إدارة وفهم دورة حياة الفعالية ‪(Activity‬‬
‫)‪Life Cycle‬؟‬
‫‪ .3‬قم بتشغيل التطبيق الذي تم إنشاؤه في التمرين ‪ 0-0‬ثم قم بتدوير الجهار لتغيير اتجاه العرض من أفقي إلى‬
‫رأسي والعكس‪ .‬ماذا تستنتج من تسلسل الرسائل التي يتم طباعتها؟‬
‫‪ .2‬ما المقصود بالحافظة الخلفية ‪ Back stack‬في نظام أندرويد؟ وما وضع العمل للفعاليات المحفوظه بها؟‪.‬‬
‫‪ .2‬لماذا يفضل استخدام الدالة )(‪ onPause‬لحفظ حالة الفعالية )‪ (Activity‬على استخدام الدالة‬
‫)(‪onSaveInstanceState‬؟‪ .‬قم بالتحقق من الفرق بين الدالتين عملياً‪.‬‬

‫الوحدة الثانية‪:‬‬
‫بنية التطبيق )‪(Application Structure‬‬
‫‪ . ‬المكونات األساسية لتطبيق أندرويد والفرق بينها‪.‬‬
‫‪ . ‬ملف الوثيقة )‪ (Manifest File‬ومكوناته وتعديله لتهيئة التطبيق للعمل بشكل صحيح‪.‬‬
‫‪ . ‬أنواع المصادر )‪ (Resources‬الموجودة ضمن تطبيق أندرويد والوصول إليها‪.‬‬
‫‪. ‬التعامل بشكل صحيح مع تغير اإلعدادات مثل تغير جهة العرض (رأسي ‪ -‬أفقي) وشاشة العرض‪.‬‬
‫لدراسة هذه الوحدة البد من اإللمام بمفهوم الفعالية )‪ (Activity‬ودورة حياتها (إرجع إلى الوحدة األولى)‪ ,‬كذلك‬
‫البد من اإللمام بتصميم واجهات التطبيق )‪ (Layouts‬باستخدام ‪.XML‬‬
‫مكونات تطبيق أندرويد‬
‫يتكون تطبيق أندرويد من عدة مكونات تشمل بعض أو كل ما يلي‪:‬‬
‫الفعاليات (‪ :)Activities‬تستخدم الفعاليات لعمل الواجهات التفاعلية‪ .‬تم شرح الفعالية (‪ )Activity‬في الوحدة‬ ‫‪‬‬
‫السابقة‪ ,‬وسيتم استخدامها بكثرة في التطبيقات الموجودة في هذا الكتاب‪.‬‬
‫الخدمات )‪ :(Services‬الخدمة هي مكون يعمل في الخلفية لتنفيذ عمليات يحتاج تشغيلها لفترة طويلة‪.‬الخدمة‬ ‫‪‬‬
‫)‪ (Service‬التوفر واجهة للمستخدم حيث تعمل في الخلفية بدون تدخل من المستخدم‪ .‬على سبيل المثال‪ ,‬يمكن‬
‫تفعي ل خدمة تشغيل الملفات الصوتية في الخلفية بينما يقوم المستخدم بالتفاعل مع تطبيق مختلف‪ ,‬أوخدمة تزيل‬
‫بيانات عبرالشبكة دون عرقلة تفاعل المستخدم مع التطبيقات األخرى‪ .‬لن يتم التطرق لبرمجة الخدمات في هذا‬
‫الكتاب‪.‬‬
‫مزودات المحتوى )‪ :(Content Providers‬مزودالمحتوى يتحكم في مشاركة قواعد بيانات أو الملفات‪.‬‬ ‫‪‬‬
‫يمكنك تخزين البيانات في نظام الملفات أو في قاعدة بيانات ‪ ,SQLite‬والوصول إليها من خالل مزود‬
‫المحتوى )‪ .(Content Provider‬يمكن أيضا ً لتطبيقات أخرى االستعالم أوحتى تعديل البيانات (إذا كان مزود‬
‫المحتوى يسمح بذلك )‪ .‬على سبيل المثال‪ ,‬يوفر نظام أندرويد مزود المحتوى الذي يدير معلومات االتصال‬
‫الخاصة بالمستخدم )‪ .(Contacts Content Provider‬على هذا النحو‪,‬أي التطبيق مع األذونات المناسبة‬
‫يمكنه االستعالم عن جزء من المعلومات الخاصة بشخص معين‪ .‬سيتم التطرق لمزودات المحتوى ‪(Content‬‬
‫)‪ Providers‬في الوحدة السابعة من هذا الكتاب‪.‬‬
‫مستقبالت النشر )‪ :)Broadcast Receivers‬مستقبل النشر هو المكون الذي يستجيب للرسائل المرسلة من‬ ‫‪‬‬
‫النظام أو التطبيقات األخرى‪ .‬على سبيل المثال‪ ,‬عند إنخفاض مستوى شحن البطارية أو إعادة تشغيل الجهاز‪,‬‬
‫يقوم النظام ببث رسائل لإلبالغ عن هذا الحدث‪ .‬يمكن لمستقبل النشر (‪ )Broadcast Receiver‬االستجابة‬
‫لهذه الرسائل وتنفيذ إجراءات ما‪ .‬مستقبل النشر (‪ )Broadcast Receiver‬ال يشتمل على واجهة مستخدم‪,‬‬

‫ سيتم التطرق لمستقبالت النشر‬.‫) عند حدوث حدث ما‬Notification( ‫ولكنه قد يرسل تنبيها لمستخدم‬
.‫( في الوحدة الثامنة من هذا الكتاب‬Broadcast Receiver)
(Manifest File) ‫ملف الوثيقة‬
‫ في المجلد األساسي‬AndroidManifest.xml ‫كل تطبيق أندرويد يجب أن يحتوي على ملف الوثيقة باسم‬
‫ الكود‬.‫ يحتوي ملف الوثيقة على معلومات أساسية عن التطبيق حتى يتمكن النظام من تشغيله بشكل صحيح‬.‫للتطبيق‬
‫ يحتاج المطور في كثير من األحيان إلى إجراء تعديالت‬.‫( لتطبيق ما‬Manifest) ‫باألسفل يوضح مثال لملف وثيقة‬
.‫في هذا الملف ليعمل التطبيق بالشكل المناسب‬
<?xml version="1.0" encoding="utf-8"?>
<manifest
xmlns:android="http://schemas.android.com/apk/res/android"
package="ps.edu.ucas.FirstAndroidApp"
android:versionCode="1"
android:versionName="1.0" >
<!—‫الصالحيات‬-->
<uses-permission
android:name="android.permission.WRITE_INTERNAL_STORAGE" />
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-sdk
android:minSdkVersion="11"
android:targetSdkVersion="18" />
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >

<activity android:name="
ps.edu.ucas.FirstAndroidApp.MainActivity"
android:label="@string/main_activity_title"
android:screenOrientation="portrait" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER"
/>
</intent-filter>
</activity>
02 . ‫صفحــة‬
‫>‪</application‬‬
‫سنقوم فيما يلي بشرح أهم المعلومات التي يحويها هذا الملف‪:‬‬
‫وصف لمكونات التطبيق المختلفة من فعاليات (‪ )Activities‬وخدمات (‪ )Services‬وغيرها‪ :‬كما ذكرنا في‬ ‫‪‬‬
‫الوحدة السابقة ‪ ,‬عند إنشاء أي فعالية يجب اإلعالن عنها في ملف الوثيقة‪ .‬أنظر المثال أعاله حيث أن ملف‬
‫الوثيقة يشتمل على فعالية باسم )‪.)MainActivity‬‬
‫األذونات )‪ (Permission‬والتي يحتاجها التطبيق من أجل الوصول إلى األجزاء المحمية من النظام مثل‬ ‫‪‬‬
‫الذاكرة الخارجية أو االتصال باالنترنت‪.‬على سبيل المثال‪ ,‬هذه بعض الصالحيات التي يتم إضافتها إلى ملف‬
‫الوثيقة ‪ Manifest‬باستخدام الخاصية >‪:<uses-permission‬‬
‫‪<uses-permission‬‬
‫>‪android:name="android.permission.WRITE_INTERNAL_STORAGE" /‬‬
‫>‪android:name="android.permission.WRITE_EXTERNAL_STORAGE" /‬‬
‫>‪android:name="android.permission.INTERNET" /‬‬
‫حيث تمنح هذه األذونات التطبيق إمكانية الوصول للذاكرتين الداخلية والخارجية واإلنترنت على التوالي‪.‬‬
‫الحد األدنى و األعلى لمستوى الواجهة البرمجية )‪ (API Level‬التي يتطلبها التطبيق للعمل بشكل صحيح‪.‬‬ ‫‪‬‬
‫‪ API Level‬هو رقم يحدد إصدار الواجهة البرمجية التي توفرها منصة أندرويد (‪(Android Platform‬‬
‫ويتم تحديده في ملف الوثيقة )‪ (Manifest‬من خالل الخاصية >‪ .<uses-sdk‬من الهام تحديد قيم هذه‬
‫الخاصية ألنها تحدد أرقام اإلصدارات المتوافقة مع التطبيق‪ .‬هناك قيمتان ضمن الخاصية >‪ <uses-sdk‬يجب‬
‫تحديدهما وهما‪ android:minSdkVersion :‬و ‪ .android:targetSdkVersion‬القيمة األولى تحدد أدنى‬
‫واجهة برمجية يحتاجها التطبيق ليعمل بشكل صحيح‪ .‬يقوم نظام أندرويد تلقائياً برفض تنصيب التطبيق إذا‬
‫كانت الواجهة البرمجية المستخدمة من قبل النظام أقل من تلك المحددة في الخاصية‬
‫‪ .android:minSdkVersion‬عند تحديد هذه الخاصية يجب مراعاة طبيعة األجهزة المتوافقة مع التطبيق‬
‫وانتشارها في السوق‪ :‬فمثالً تحديد قيمة عالية للواجهة البرمجية يعني أن التطبيق الخاص بك لن يعمل على كل‬
‫األجهزة التي تعمل بال واجهات األقدم والتي قد يستخدمها عدد كبير من األجهزة‪ .‬في المقابل فإن استخدام قيمة‬
‫متدنية جدا يحرمك من استخدام الخصائص البرمجية الحديثة المضافة للواجهات البرمجية األحدث‪.‬‬
‫قيمة ‪ android:targetSdkVersion‬تحدد الواجهة البرمجية التي يستهدفها التطبيق ‪ ,‬وهي تعني أن التطبيق‬
‫تم اختباره على الواجهة البرمجية المحددة وأنه ليس هناك حاجة ألن يقوم النظام بأي عملية مواءة للتطبيق إذا‬
‫توافقت الواجهة البرمجية للنظام مع واجهة التطبيق‪ .‬ال يزال التطبيق قابل للعمل على األنظمة القديمة (حتى‬
‫الرقم المحدد في ‪ )android:minSdkVersion‬ولكن قد تقوم االنظمة القديمة بعمل مواءمة تلقائية للتطبيق‬
‫مما قد يؤثر على بعض اإلضافات الغيرمدعومة من قبل النظام‪.‬‬

‫) ورقم الواجهة البرمجية‬Version( ‫ رقم اإلصدار‬,(Code Name) ‫ يوضح اسم منصة أندرويد‬2-1 ‫الجدول‬
.(API Level)
‫) ورقم الواجهة البرمجية‬Version( ‫ رقم اإلصدار‬,(Code Name) ‫ اسم منصة أندرويد‬:2-1 ‫جدول‬
(API Level)1
API Level Version Code Name
API level 21 5.0 Lollipop
API level 19 4.4 - 4.4.4 KitKat
API level 18 4.3.x Jelly Bean
API level 15, NDK 8 4.0.3 - 4.0.4 Ice Cream Sandwich
API level 14, NDK 7 4.0.1 - 4.0.2 Ice Cream Sandwich
API level 13 3.2.x Honeycomb
API level 12, NDK 6 3.1 Honeycomb
API level 11 3.0 Honeycomb
API level 10 2.3.3 - 2.3.7 Gingerbread
API level 9, NDK 5 2.3 - 2.3.2 Gingerbread
API level 8, NDK 4 2.2.x Froyo
API level 7, NDK 3 2.1 Éclair
API level 6 2.0.1 Éclair
API level 5 2.0 Éclair
API level 4, NDK 2 1.6 Donut
API level 3, NDK 1 1.5 Cupcake
API level 2 1.1 (no code name)
API level 1 1.0 (no code name)
(portrait) ‫ الوضع الرأسي‬:‫) للفعالية والتي تكون في أحد وضعين‬screen orientation( ‫اتجاه الشاشة‬ 
‫) بحيث ال تستجيب‬Activity( ‫ إذا أردت تثبيث وضع العرض لفعالية ما‬.(landscape) ‫والوضع األفقي‬
‫ يمكن القيام ذلك باستخدام الخاصية‬,ً‫لتغير وضع الجهاز إن كان رأسيا ً أو أفقيا‬
:‫ كما هو موضح في المثال التالي‬activity ‫ من داخل الخاصية‬android:screenOrientation
android:screenOrientation="portrait"
‫ يمكن من ملف الوثيقة الوصول للنصوص المعرفة في ملف‬,‫ الخاص بالواجهات‬XML ‫كما هو الحال في ملف‬
‫ الموجودة ضمن العنصر‬label ‫ الخاصية‬:ً‫( الموضح مسبقا‬Manifest) ‫ في ملف الوثيقة‬,ً‫ فمثال‬.strings.xml
Android Developers, http://developer.android.com/guide/topics/manifest/uses -sdk-element.html 1
‫‪ application‬تستخدم قيمة المتغير ‪ app_name‬المعرف في ملف ‪ .strings.xml‬بالمثل‪ ,‬الخاصية ‪label‬‬

‫الموجودة ضمن الخاصية ‪ activity‬تستخدم قيمة المتغير ‪ main_activity_title‬المعرف أيضاً في ملف‬
‫‪.strings.xml‬‬
‫إنشاء المصادر )‪(Creating Resources‬‬
‫عند بناء تطبيق أندرويد‪ ,‬يوصى دائما ً بإبقاء المصادر التي يتعامل معها التطبيق)‪(Application Resources‬‬
‫منفصلة عن الكود‪ .‬من أنواع المصادر التي يتعامل معها التطبيق‪ :‬العبارات النصية ‪ ,strings‬الصور ‪,images‬‬
‫أنماط التصميم ‪ ,styles‬ملفات هيكلة الواجهات ‪ layout‬وغيرها‪ .‬هيكلية تطبيق األندرويد مشابهة لما هو موضح‬
‫في شكل ‪ ,2-1‬حيث أن المجلد ‪ src‬مخصص لحفظ ملفات الجافا‪ ,‬بينما مجلد ‪ res‬يستخدم لحفظ األنواع المختلفة‬
‫من المصادر‪ ,‬حيث يخصص لكل نوع من المصادر مجلد خاص داخل المجلد ‪ .res‬فمثالً الصور تحفظ في مجلد‬
‫‪ drawable‬بينما تحفظ العبارات النصية ‪ strings‬داخل الملف ‪ strings.xml‬داخل المجلد ‪.values‬‬
‫شكل ‪ :2-1‬هيكلية تطبيق أندرويد‬

‫جدول ‪ 3-3‬يوضح أهم مجلدات المصادر ونوعية البيانات التي تحفظ بها‪:‬‬
‫جدول ‪ :2-2‬مجلدات المصادر )‪ (Resources‬ضمن تطبيق أندرويد‬
‫االستخدام‬ ‫مجلد المصدر‬
‫يحتوي على ملفات الصور‬ ‫‪drawable/‬‬
‫يحتوي على ملفات ‪ XML‬التي تحدد تصميم هيكلية الواجهات ‪layout‬‬ ‫‪layout/‬‬
‫يحتوي على ملفات ‪ XML‬التي تحدد تركيب القوائم المستخدمة في‬ ‫‪menu/‬‬
‫التطبيق‬
‫يحتوي على ملفات ‪ XML‬تحدد قيم يتم استخدامها في التطبيق مثل‬ ‫‪values/‬‬
‫األلوان واألرقام والعبارات النصية‪.‬‬
‫يحتوي على ملفات الصور‬ ‫‪drawable/‬‬
‫يحتوي على ملفات ‪ XML‬التي تحدد تصميم هيكلية الواجهات ‪layout‬‬ ‫‪layout/‬‬

‫مالحظة‪ :‬المصادر التي يتم حفظها في المجلد ‪ res‬هي المصادر اإلفتراضية التي يتم استخدامها في التطبيق‪ .‬أحياناً‬
‫قد تح تاج إلى مصادر مختلفة لتتالئم من األوضاع المختلفة لعمل التطبيق‪ .‬على سبيل المثال‪ ,‬التطبيق قد يعمل على‬
‫أجهزة مختلفة الحجم‪ ,‬وبنا ًء على ذلك فإن تصميم الواجهات وأنواع الصور المستخدمة قد يختلف من جهاز آلخر‪.‬‬
‫لتصميم التطبيق بحيث يتالءم مع ظروف العرض المختلفة‪ ,‬ال بد من حفظ مصادر بديلة باإلضافة إلى تلك‬
‫اإلفتراضية ليتم استخدامها عند الحاجة لذلك‪ .‬عند تشغيل التطبيق‪ ,‬يقوم نظام أندرويد تلقائياً باختيار المصادر‬
‫المناسبة بما يتناسب مع إعدادات الجهاز‪.‬‬
‫لتحديد مصادر بديلة إلعدادات الجهاز المختلفة‪ ,‬يجب اضافة مجلد داخل المجلد ‪ res‬بالصيغة التالية‪:‬‬
‫>‪<resources_name>-<config_qualifier‬‬
‫حيث >‪ <resources_name‬هو اسم مجلد المصدر مثل ‪ <qualifier> .drawable ,values ,layout‬يمثل‬
‫اإلعدادات التي يستخدم فيها المصدر‪ .‬على سبيل المثال‪ ,‬في مجلد المصادر الموضح‪:‬‬
‫‪res/‬‬
‫‪drawable/‬‬
‫‪icon.png‬‬
‫‪background.png‬‬
‫‪drawable-hdpi/‬‬
‫‪icon.png‬‬
‫‪background.png‬‬
‫الحظ أن المجلد ‪ drawable-hdpi‬يحوي الصور التي يتم استخدامها للشاشات ذات الدقة العالية وهو ما يعنيه‬
‫المقطع ‪.hdpi‬عند تشغيل التطبيق‪ ,‬يقوم النظام تلقائيا ً باختيار مجلد الصور المناسب إلعدادات الجهاز‪ :‬حيث يتم‬
‫استخدام الصور من المجلد ‪ drawable-hdpi‬إذا كان الجهاز ذو شاشة عالية الدقة‪ ,‬بينما يتم استخدام الصور من‬
‫المجلد ‪ drawable‬لغير ذلك من األجهزة‪.‬‬
‫مثال آخر على ذلك هو تحديد تصميم مختلف للواجهة إذا اختلف اتجاه الشاشة )‪ (Orientation‬أو لغة الجهاز‪ .‬في‬
‫هذه الحالة يتم إنشاء مجلد باسم ‪ layout-port‬يحوي تصميم الواجهات للوضع الرأسي )‪ (portrait‬أو مجلد باسم‬
‫‪ layout-land‬يحوي تصميم الواجهات للوضع األفقي أو ‪ layout-ar‬ليحوي تصاميم واجهات متناسبة مع اللغة‬
‫العربية‪.‬‬
‫الوصول للمصادر )‪(Accessing Resources‬‬
‫بعد إنشاء المصادر‪ ,‬قد تحتاج للوصول إليها أثناء بناء التطبيق‪ .‬هناك طريقتين للوصول للمصادر‪ :‬الوصول من‬
‫خالل الكود أو من خالل ‪.XML‬‬

‫الوصول من خالل الكود‪:‬‬ ‫‪‬‬

‫كل المصادر التي يتم إنشاؤها يقوم النظام تلقائيا ً بإنشاء صيغ معرفة لها ‪ ID‬وحفظها في ملف خاص اسمه ‪.R‬‬
‫الصيغ المعرفة تأخذ الشكل التالي‪:‬‬
‫>‪R.<resource_type>.<resource_name‬‬
‫حيث >‪ <resource_type‬يمثل نوع المصدر مثل ‪ drawable ,layout ,string‬وغيره‪ ,‬بينما‬
‫>‪ <resource_name‬تعني اسم المصدر‪ .‬فمثالً‪ ,‬المعرف التالي‪ R.string.activity_title :‬يستخدم للوصول‬
‫للعبارة النصية ‪ string‬التي تحمل اسم ‪ .activity_title‬المعرف ‪ R.drawable.background‬يستخدم للوصول‬
‫لملف الصورة الذي يحمل اسم ‪ background‬داخل المجلد ‪ .drawable‬األمثلة التالية توضح كيفية الوصول إلى‬
‫المصادر برمجيا ً من خالل الكود‪:‬‬
‫مثال ‪:0‬الوصول إلى ملف صورة باسم ‪ myimage‬لعرضها في عنصر واجهة من نوع ‪ImageView‬‬
‫;)‪imageView.setImageResource(R.drawable.myimage‬‬
‫مثال ‪ :3‬تغيير عنوان الفعالية (‪ )Activity‬باستخدام العبارة النصية ‪title‬‬
‫;))‪getWindow().setTitle(getResources().getText(R.string.title‬‬
‫مثال ‪ :2‬تحديد ملف هيكلية الواجهة باسم ‪ main_screen‬عند إنشاء الفعالية‬

‫;)‪setContentView(R.layout.main_screen‬‬
‫الوصول من خالل ‪XML‬‬ ‫‪‬‬

‫عند إنشاء ملفات ‪ XML‬للواجهات وغيرها‪ ,‬يمكن اعطاء قيم لعناصر ‪ XML‬باستخدام قيم معرفة في ملفات‬
‫أخرى‪ .‬الصيغة العامة للوصول ألي مصدر من خالل ‪ XML‬تأخذ الشكل التالي‪:‬‬
‫>‪@<resource_type>/<resource_name‬‬
‫حيث >‪ <resource_type‬يمثل نوع المصدر مثل ‪ drawable ,layout ,string‬وغيره‪ ,‬بينما‬
‫>‪ <resource_name‬تعني اسم المصدر‪.‬‬
‫المثال التالي يوضح كيف يتم إعطاء قيمة للنص المعروض على الزر ‪ Button‬باستخدام عبارة نصية ‪string‬‬
‫معرفة باسم ‪( submit‬أنظر الخاصية ‪:)android:text‬‬
‫‪<Button‬‬
‫"‪android:layout_width="fill_parent‬‬
‫"‪android:layout_height="wrap_content‬‬
‫>‪android:text="@string/submit" /‬‬

:‫ باستخدام مصادر معرفة في أماكن أخرى (أنظر الخاصيتين‬EditText ‫المثال التالي يوضح إعطاء قيم للعنصر‬
:)android:text ‫ و‬android:textColor
<EditText
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:textColor="@color/opaque_red"
android:text="@string/title" />
(Assets Folder) ‫مجلد الممتلكات‬
.assets ‫ يسمى هذا المجلد‬.‫يوفر نظام أندرويد مجلد آخر ضمن مجلدات التطبيق حيث يمكن حفظ الملفات المختلفة‬
‫ للملف الموجودة في المجلد‬ID ‫ أن النظام ال يقوم بإنشاء أرقام معرفة‬res ‫ والمجلد‬assets ‫الفرق بين مجلد‬
‫ ملفات‬,txt ‫ مثل ملفات باالمتداد‬res ‫ لحفظ الملفات التي اليمكن حفظها في ملف‬assets ‫ يستخدم مجلد‬.assets
‫ عن طريق الكائن‬assets ‫ يتم الوصول إلى الملفات في مجلد‬.‫) وغيرها‬.wav, .mp3, .mid( ‫الصوت‬
‫ يوفر‬.)Activity( ‫ داخل الفعالية‬getAssets() ‫ والذي يمكن الوصول إليه بتطبيق الدالة‬AssetManager
‫ الكود‬.‫ لفتح ملف ما‬open() ‫ الستعراض الملفات و‬list() ‫ عدة دوال للتعامل مع الملفات مثل‬AssetManage
.‫ وطباعته كرسالة‬assets ‫ موجود في مجلد‬text.txt ‫التالي يوضح كيفية قراءة محتوى ملف‬
public class AssetsActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
try {
InputStream is =
getAssets().open("text.txt");
int size = is.available();
byte[] buffer = new byte[size];
is.read(buffer);
is.close();
String content = new String(buffer);
Toast.makeText(getApplicationContext(),
content, Toast.LENGTH_LONG).show();
} catch (IOException e) {
e.printStackTrace();
}
}
}
‫التعامل مع تغيير اإلعدادات )‪(Handling Configuration Changes‬‬

‫إعدادات الجهاز قد تتغير في أي وقت مثل تغير اتجاه العرض (أفقي – رأسي) أو تغير اللغة‪ .‬عندما تحصل مثل هذه‬
‫التغييرات‪ ,‬يقوم نظام أندرويد بإلغاء الفعالية الحالية (‪ )Activity‬وإنشاء واحدة جديدة عن طريق تنفيذ الدالة‬
‫)(‪ onDestroy‬ومن ثم )(‪ .onCreate‬إعادة تشغيل الفعالية يهدف إلى جعل التطبيق يتكيف مع التغيير الجديد‬
‫باستخدام المصادر والواجهات التي تتالءم مع اإلعدادات الجديدة‪ .‬عند إعادة تشغيل الفعالية يمكن استرجاع حالتها‬
‫وبياناتها عن طريق تطبيق الدالة )(‪ onSaveInstanceState‬أو )(‪ onPause‬لحفظ حالة الفعالية قبل إيقافها‪ ,‬ومن‬
‫ثم تطبيق الدالة )(‪ onRestoreInstanceState‬أو )(‪ onStart‬السترجاع البيانات‪.‬‬
‫يمكن تثبيت بعض اإلعدادات للتطبيق بحيث ال يتم إعادة تشغيل الفعالية (‪ )Activity‬تلقائياً عند تغيره‪ .‬فمثالً‪ ,‬يمكن‬
‫إضافة الخاصية ‪ android:screenOrientation‬ضمن خصائص الفعالية (‪ )Activity‬في ملف الوثيقة‬
‫‪ Manifest‬وذلك لتثبيت طريقة عرض التطبيق في وضع رأسي (أو أفقي) مهما تغير وضع الجهاز‪ .‬كذلك من‬
‫الممكن إيقاف إعادة تشغيل الفعالية عند حصول تغيير باإلعدادات بحيث يتم التعامل مع هذا التغيير برمجياً‪ .‬يتم ذلك‬
‫بإضافة الخاصية ‪ android:configChanges‬ضمن خصائص الفعالية (‪ )Activity‬في ملف‬
‫الوثيقة )‪ (Manifest‬كما هو موضح‪:‬‬
‫"‪<activity android:name=".MyActivity‬‬
‫"‪android:configChanges="orientation|keyboardHidden‬‬
‫>"‪android:label="@string/app_name‬‬
‫في هذه المثال يتم التصريح بأن الفعالية ستتولى التعامل برمجياً مع تغيير اتجاه العرض ‪ orientation‬أو في حالة‬
‫إخفاء لوحة المفاتيح‪ ,‬وذلك دون الحاجة إلعادة تشغيل الفعالية‪ .‬في هذه الحالة يجب تطبيق الدالة‬
‫)(‪ onConfigurationChanges‬داخل الفعالية والتي يتم تنفيذها تلقائيا ً عند حصول أي تغيير في اإلعدادات‪.‬‬
‫يمكن كتابة كود في هذه الدالة لتنفيذ اإلجراء المطلوب كما بالمثال التالي‪:‬‬
‫‪public void onConfigurationChanged(Configuration‬‬
‫{)‪newConfig‬‬
‫;)‪super.onConfigurationChanged(newConfig‬‬
‫‪// Checks the orientation of the screen‬‬

‫‪if(newConfig.orientation‬‬
‫{)‪==Configuration.ORIENTATION_LANDSCAPE‬‬
‫;)(‪Toast.makeText(this,"landscape",Toast.LENGTH_SHORT).show‬‬
‫‪}elseif(newConfig.orientation‬‬
‫{)‪==Configuration.ORIENTATION_PORTRAIT‬‬
‫;)(‪Toast.makeText(this,"portrait",Toast.LENGTH_SHORT).show‬‬
‫}‬
‫}‬

‫في هذا المثال أعاله يتم عرض رسالة تبين اتجاه عرض التطبيق وذلك عند حصول أي تغيير في اإلعدادات‪ .‬الحظ‬
‫أنه يتم تمرير اإلعدادات التي تغيرت إلى الدالة‪.‬‬
‫في الغالب لن تحتاج لتطبيق هذه الدالة حيث يفضل إعادة تشغيل الفعالية (‪ )Activity‬عن تغير اإلعدادات وذلك‬
‫حتى يتم استخدام المصادر المناسبة لالعدادات الجديدة تلقائياً‪ .‬على سبيل المثال‪ ,‬عن وجود تصميم واجهات خاص‬
‫في وضع العرض الرأسي ‪ portrait‬في مجلد ‪ ,layout-port‬يقوم النظام تلقائياً باستخدام هذه الواجهات إذا تم‬
‫تغيير اتجاه العرض للوضع الرأسي‪.‬‬
‫باستخدام الدالة‬ ‫كذلك يمكن فحص إعدادات الجهاز برمجياً من داخل الفعالية )‪(Activity‬‬
‫)(‪ .getResources().getConfiguration‬المثال التالي يوضح كيفية معرفة اتجاه العرض برمجيا ً عند بدء‬
‫تشغيل الفعالية (‪:)Activity‬‬
‫== ‪if(this.getResources().getConfiguration().orientation‬‬
‫{)‪Configuration.ORIENTATION_LANDSCAPE‬‬
‫‪Toast.makeText(this, "landscape",‬‬
‫‪}else‬‬
‫== ‪if(this.getResources().getConfiguration().orientation‬‬
‫{)‪Configuration.ORIENTATION_PORTRAIT‬‬
‫‪Toast.makeText(this, "portrait",‬‬
‫}‬
‫…‬
‫}‬
‫تمرين عملي )‪(2-1‬‬

‫يهدف هذا التطبيق البسيط إلى التمرن على بعض المفاهيم الواردة في هذا الفصل مثل تغيير إعدادات التطبيق من‬
‫خالل ملف الوثيقة )‪ ,(Manifest‬الوصول للمصادر وتحديد مصادر بديلة لتالئم اإلعدادات المختلفة للتطبيق‪.‬‬
‫التطبيق له واجهتين كما هو موشح بشكل ‪ : 2-2‬الواجهة األفقى تعمل في وضع العرض األفقي حيت تتكون من‬
‫مجموعة من األزرار المعروضة أفقيا ً وأسفلها صورة لمبنى الكلية الجامعية‪ .‬الواجهة الثانية تعمل في وضع العرض‬
‫الرأسي وفيها يتم عرض األزرار رأسياً‪ ,‬ويتم عرض صورة لشعار الكلية الجامعية‪ .‬يتم اختيار الواجهة وتغيير‬
‫الصورة تلقائيا ً بناء على وضع العرض‪.‬‬

‫شكل ‪ :2-2‬واجهتا التطبيق في الوضعين الرأسي (‪ )Portrait‬واألفقي )‪(Landscape‬‬

‫الخطوات التالية توضح مراحل بناء التطبيق‪:‬‬
‫أوالً‪ :‬إنشاء الواجهات‪ :‬بناء على أن التطبيق له واجهتين مختلفيتين‪ ,‬نقوم بإنشاء ملفي ‪ XML‬لتصميم الواجهة‪ :‬أحد‬
‫الملفين مخصص للواجهة بالوضع الرأسي ونضعه في المجلد ‪ ,layout‬والملف اآلخر يحمل نفس االسم ولكن في‬
‫مجلد آخر باالسم ‪ . layout-land‬الحظ أن اسم المجلد يحدد اإلعدادات التي يستخدم عندها ملف الواجهة‪ ,‬فالمجلد‬
‫الذي ينتهي اسمهه بـ ‪ land‬يستخدم في وضع العرض األفقي )‪ (Landscape‬بينما يستخدم المجلد اآلخر في غير‬
‫ذلك‪ .‬ملفات التصميم موضحة باألسفل‪:‬‬
‫أوال‪ :‬تصميم الواجهة الخاصة بالوضع الرأسي‬
‫‪// layout/activity_main.xml‬‬
‫‪<RelativeLayout‬‬
‫"‪xmlns:android="http://schemas.android.com/apk/res/android‬‬
‫"‪xmlns:tools="http://schemas.android.com/tools‬‬
‫"‪android:layout_width="match_parent‬‬
‫"‪android:layout_height="match_parent‬‬
‫"‪android:paddingBottom="@dimen/activity_vertical_margin‬‬
‫"‪android:paddingLeft="@dimen/activity_horizontal_margin‬‬
‫"‪android:paddingRight="@dimen/activity_horizontal_margin‬‬
‫"‪android:paddingTop="@dimen/activity_vertical_margin‬‬

tools:context="com.example.applicationstructure.MainActivit
y" >
<Button
android:id="@+id/buttonOne"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerHorizontal="true"
android:text="@string/buttonOne" />
<Button
android:id="@+id/buttonTwo"
android:layout_below="@+id/buttonOne"
android:text="@string/buttonTwo" />
<Button
android:id="@+id/buttonThree"
android:layout_below="@+id/buttonTwo"
android:text="@string/buttonThree" />
<Button
android:id="@+id/buttonFour"
android:layout_below="@+id/buttonThree"
android:text="@string/buttonFour" />
<Button
android:id="@+id/buttonFive"
android:layout_below="@+id/buttonFour"
android:text="@string/buttonFive" />
<ImageView
android:id="@+id/imageView"
android:layout_below="@+id/buttonFive"
android:layout_marginTop="24dp"/>
</RelativeLayout>
‫ تصميم الواجهة الخاصة بالوضع األفقي‬:‫ثانيا‬
// layout-land/activity_main.xml
<RelativeLayout
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context="com.example.applicationstructure.MainActivit
y" >
<Button
android:id="@+id/buttonOne"
android:layout_toLeftOf="@+id/buttonTwo"
android:text="@string/buttonOne" />
<Button
android:id="@+id/buttonTwo"
android:layout_alignBottom="@+id/buttonOne"
android:layout_toLeftOf="@+id/buttonThree"
android:text="@string/buttonTwo" />
<Button
android:id="@+id/buttonThree"
android:text="@string/buttonThree" />
<Button
android:id="@+id/buttonFour"
android:layout_toRightOf="@+id/buttonThree"
android:text="@string/buttonFour" />
<Button
android:id="@+id/buttonFive"
android:layout_toRightOf="@+id/buttonFour"
android:text="@string/buttonFive" />
<ImageView
android:layout_below="@+id/buttonTwo"
</RelativeLayout>
:‫) المستخدمة في التطبيق‬MainActivity( ‫ الكود باألسفل يوضح الفعالية‬:)Activity( ‫ إنشاء الفعالية‬:ً‫ثانيا‬
1: public class MainActivity extends Activity {
2:
3: @Override
4: protected void onCreate(Bundle savedInstanceState) {
5: super.onCreate(savedInstanceState);
6: setContentView(R.layout.activity_main);
7: ImageView image = (ImageView)
8: this.findViewById(R.id.imageView);
9: if(this.getResources().getConfiguration().orientation
10: == Configuration.ORIENTATION_LANDSCAPE)
11: image.setImageResource(R.drawable.ucas_building);
12: else if(this.getResources().getConfiguration().
13: orientation == Configuration.ORIENTATION_PORTRAIT)
14: image.setImageResource(R.drawable.ucas_logo);
15: }
16: }
‫الحظ أنه في الدالة )(‪( onCreate‬عند بداية تشغيل الفعالية) يتم إنشاء الواجهة عن طريق الدالة‬
‫)(‪ setContentView‬والتي يمرر لها المعرف الخاص بملف الواجهة وهو ‪( R.layout.activity_main‬أنظر‬
‫سطر رقم ‪ .)6‬الحظ أيضا ً أن هذا المعرف يمكن استخدامه للوصول لكال ملفي الواجهة‪ .‬يقوم النظام تلقائياً باختيار‬
‫الملف المناسب بنا ًء على وضع العرض‪ :‬فإذا كان وضع العرض أفقياً (‪ )Landscape‬يتم استخدام ملف الواجهة‬
‫‪ activity_main.xml‬الموجود في المجلد ‪ ,layout-land‬بينما إذا كان وضع العرض رأسياً (‪ )Portrait‬يتم‬
‫استخدام ملف الواجهة ‪ activity_main.xml‬الموجود في المجلد ‪.layout‬‬
‫بعد ذلك يتم فحص وضع العرض برمجياً عن طريق الدالة )(‪ getResources().getConfiguration‬وبنا ًء‬
‫عليه يتم تغيير الصورة (أنظر الكود من سطر ‪ 9‬إلى ‪ .)05‬الحظ أيضا ً أن الوصول للصورة تم من خالل‬
‫المعرف‪.R.drawable.<image_name>:‬‬
‫أسئلة على الوحدة الثانية‬

‫‪ .0‬ما الفرق بين الفعالية )‪ (Activity‬والخدمة (‪)Service‬؟ وفيم تستخدم كل منهما؟‬
‫‪ .3‬ما الفرق بين استخدام المجلد ‪ Assets‬والمجلد ‪ res‬لحفظ المصادر؟‬
‫‪ .2‬قم بإنشاء تطبيق أندرويد لعرض نص محدد باللغة العربية أو اإلنجليزية في عنصر من نوع ‪TextView‬‬
‫وذلك بنا ًء على اللغة المحددة في إعدادات الجهاز‪ .‬فمثالً‪ ,‬عند تشغيل التطبيق يتم عرض جملة " ‪The‬‬
‫‪ "University College of Applied Sciences‬إذا كانت اللغة المحددة في إعدادات الهاتف هي‬
‫اإلنجليزية‪ .‬وعند تغيير اللغة إلى العربية من إعدادات الجهاز‪ ,‬يتم عرض الجملة "الكلية الجامعية للعلوم‬
‫التطبيقة" تلقائيا ً‪.‬‬
‫تلميح‪ :‬استخدم مجلدين واحد باسم ‪ values-en‬واآلخر باسم ‪ values-ar‬وذلك لتحديد نص إنجليزي وآخر‬
‫عربي في ملف ‪ strings.xml‬الموجود في كال المجلدين‪.‬‬
‫‪ .2‬قم بالتعديل على التطبيق المنشأ في ‪ 3‬وذلك لتغيير حجم الخط للنص المعروض تلقائيا عند عرضه باستخدام‬
‫جهاز ذو شاشة كبيرة‪.‬‬

‫الوحدة الثالثة‪:‬‬
‫التعامل مع عناصر الواجهة برمجيا‬
‫)‪)Interacting with UI Components Programmatically‬‬
‫‪ ‬معالجة أحداث التفاعل مع واجهة المستخدم‪.‬‬
‫‪ ‬الوصول لعناصر واجهة المستخدم برمجيا ً والتعامل مع أنواع عناصر الواجهة المختلفة‪.‬‬
‫‪ ‬التعامل مع قائمة العرض )‪ (ListView‬وتعبئتها باستخدام أنواع المحوالت المختلفة )‪.(Adapter‬‬
‫لدراسة هذه الوحدة البد من اإللمام بمفهوم الفعالية )‪ (Activity‬ودورة حياتها (إرجع إلى الوحدة األولى)‪ ,‬التعامل‬
‫مع المصادر (إرجع إلى الوحدة الثانية)‪ ,‬كذلك البد من اإللمام بعناصر الواجهة األساسية وكذلك تصميم واجهات‬
‫التطبيق )‪ (Layouts‬باستخدام ‪.XML‬‬
‫درست في مساق سابق إنشاء عناصر الواجهة المختلفة مثل ‪ Button ,EditText ,TextView‬وغيرها من‬
‫العناصر‪ .‬كذلك تعلمت طرق الهيكلة المختلفة ‪ Layouts‬لتنظيم عرض عناصر الواجهة (لمراجعة هذه المفاهيم‬
‫يمكن الرجوع إلى الفصل الثالث في المرجع رقم ‪ 0‬أو الفصل الثالث في المرجع رقم ‪ .)7‬سنتعلم اآلن طريقة‬
‫الوصول لعناصر الواجهة برمجياً والتفاعل مع األحداث ‪ .UI Events‬كذلك سنتطرق للتعامل مع بعض عناصر‬
‫الواجعة شائعة اإلستخدام مثل القائمة (‪ )ListView‬وطريقة عرض البيانات المختلفة بها باستخدام المحوالت‬
‫‪.Adapters‬‬
‫معالجة أحداث الوجهة برمجيا )‪(Handling UI Events‬‬
‫يقصد بأحداث واجهة المستخدم ‪ UI Events‬هي األحداث الناتجة عن تفاعل المستخدم مع مكونات الواجهة مثل نقر‬
‫األزرار أو لمس الشاشة‪.‬‬
‫للتعامل مع أي حدث يحصل على أي عنصر في الواجهة يجب أوال الوصول لهذا العنصر من داخل الفعالية‪ ,‬وذلك‬
‫يتم باستخدام الدالة )(‪ findViewById‬والتي يمرر لها الرقم المعرف للعنصر (له صيغة‪:‬‬
‫>‪ . R.id.<element_name‬لكل عنصر في الواجهة رقم خاص يختلف عن أي معرف للعناصر األخرى‪ .‬يتم‬
‫إنشاء هذا المعرف تلقائياً بعد إدارج العنصر في ملف التصميم ‪ .layout.xml‬تقوم دالة )(‪findViewById‬‬
‫بإرجاع مؤشر لكائن من نوع ‪ View‬وهو نوع فئة األب )‪ (Superclass type‬لكل عناصر الواجهة‪ .‬نقوم بعمل‬
‫‪ casting‬للعنصر المرجع وذلك لتحويله للنوع المطلوب‪ .‬فمثالً‪ ,‬للوصول للزر ‪ button1‬يمكن استخدام األمر‬
‫التالي من داخل الفعالية (‪ .)Activity‬بعد الحصول على مؤشر للكائن الخاص بالزر‪ ,‬يمكن التعامل معه باستخدام‬
‫الدوال المختلفة التي توفرها الفئة ‪.Button Class‬‬
‫;)‪Button button = (Button) this.findViewById(R.id.button1‬‬
‫;)”‪button.setText(“Click here‬‬

‫بعد الوصول لعناصر الواجهة برمجياً‪ ,‬يمكن التقاط الحدث (تفاعل المستخدم مع العنصر) أول وقوعه عن طريق‬
‫تسجيل ما يسمى بالمستمع (‪ )Listener‬والذي يعلمك تلقائيا ً بحصول حدث ما بتنفيذ دالة راجعة ‪callback‬‬
‫‪ .method‬الفئة ‪ , View‬والتي تتفرع منها كل فئات عناصر واجهة المستخدم‪ ,‬تحتوي على مجموعة من الواجهات‬
‫البرمجية )‪. (Interface‬كل واجهة برمجية )‪ (Interface‬تحتوي على دوال مجردة والتي يمكن تطبيقها حسب‬
‫الحاجة لالستماع لألحداث المختلفة‪.‬‬
‫الواجهة البرمجية (‪ )Interface‬ت حتوي فقط على دوال مجردة دون أي تطبيق‪ ,‬وعلى المستخدم تطبيق هذه الدوال‬
‫بكتابة الكود المناسب‪ .‬للتفاعل مع حدث معين على عنصر واجهة‪ ,‬يجب تسجيل واجهة مستمع جديدة لدى عنصر‬
‫الواجهة وتطبيق الدوال الموجودة به لتنفيذ اإلجراء المطلوب‪ .‬فمثالً‪ ,‬لالستجابة لحدث على زر معين ‪,Button‬‬
‫يجب على تسجيل واجهة مستخدم من نوع ‪ View.OnClickListener‬لدى الكائن ‪( Button‬عن طريق تنفيذ‬
‫الدالة )( ‪ setOnClickListener‬ضمن الفئة ‪ ,Button‬ومن ثم كتابة الكود الخاص بالدالة المجردة )(‪onClick‬‬
‫لتحديد اإلجراء المطلوب تنفيذه عند الحدث)‪ .‬عند النقر على الزر يقول النظام تلقائيا ً بتنفيذ الدالة )(‪ onClick‬لينفذ‬
‫اإلجراء المطلوب‪.‬‬
‫(‪button.setOnClickListener‬‬
‫{ )(‪new Button.OnClickListener‬‬
‫{ )‪public void onClick(View v‬‬
‫‪// Action to be performed when button is clicked‬‬
‫}‬
‫}‬
‫;)‬

‫لتوضيح كيفية التعامل مع األحداث بمثال عملي‪ ,‬سنقوم بعرض الخطوات الكاملة لتطبيق بسيط واجهته موضحة‬
‫بالشكل‪ .‬تتكون الواجهة من زر مكتوب عليه ”‪ “Press Me‬وعنصر عرض من نوع ‪ .TextView‬الحدث الذي‬
‫نود تنفيذه هو تغيير محتوى النص المعروض في ‪ TextView‬عند النقر على الرز ‪.PressMe‬‬

3-1 ‫ واجهة التطبيق الخاص بالتمرين‬: 3-1‫شكل‬

‫ والمعرف باإلسم‬Button ‫ حيث أنه يحدد خصائص العنصر‬,‫ملف هيكلية الواجهة لهذا المثال موضح باألسفل‬
.myTextView ‫ والمعرف باالسم‬TextView ‫ والعنصر‬,myButton
<RelativeLayout
android:id="@+id/myLayout"
android:layout_height="fill_parent" >
<Button
android:id="@+id/myButton"
android:layout_centerVertical="true"
android:text="@string/mybutton_string" />
<TextView
android:id="@+id/myTextView"
android:layout_above="@+id/myButton"
android:layout_marginBottom="41dp"
android:text="@string/mytextview_string"
‫"‪android:textAppearance="?android:attr/textAppearanceLarge‬‬
‫>‪/‬‬
‫>‪</RelativeLayout‬‬
‫بعد تصميم الواجهة‪ ,‬يجب التعديل على كود الفعالية (‪ )Activity‬وذلك لتسجيل مستمع للحدث )‪ (Listener‬ليقوم‬
‫بتنفيذ اإلجراء المطلوب عن النقر على الرز‪ .‬كود الفعالية المعدل موضح باألسفل‪:‬‬
‫‪1:‬‬ ‫{ ‪public class MainActivity extends Activity‬‬
‫‪2:‬‬ ‫‪@Override‬‬
‫‪3:‬‬ ‫{ )‪protected void onCreate(Bundle savedInstanceState‬‬
‫‪4:‬‬ ‫;)‪super.onCreate(savedInstanceState‬‬
‫‪5:‬‬ ‫;)‪setContentView(R.layout.activity_main‬‬
‫‪6:‬‬ ‫}‬
‫‪8:‬‬ ‫{)(‪protected void onStart‬‬
‫‪9:‬‬ ‫;)(‪super.onStart‬‬
‫‪10:‬‬ ‫;)‪Button button = (Button)findViewById(R.id.myButton‬‬
‫‪11:‬‬ ‫(‪button.setOnClickListener‬‬
‫‪12:‬‬ ‫{ )(‪new Button.OnClickListener‬‬
‫‪13:‬‬ ‫{ )‪public void onClick(View v‬‬
‫‪14:‬‬ ‫)‪TextView myTextView = (TextView‬‬
‫‪15:‬‬ ‫;)‪findViewById(R.id.myTextView‬‬
‫‪16:‬‬ ‫;)"‪myTextView.setText("Button clicked‬‬
‫‪17:‬‬ ‫}‬
‫‪18:‬‬ ‫}‬
‫‪19:‬‬ ‫;)‬
‫‪20:‬‬ ‫}‬
‫‪21:‬‬ ‫}‬
‫الحظ أن الكود المسؤول عن التعامل مع الحدث تمت كتابته في الدالة )(‪ ( onStart‬أنظر سطر رقم ‪ .)9‬تم اختيار‬
‫الدالة )(‪ onStart‬ألنه عند تنفيذها يكون قد اكتمل إنشاء عناصر الواجهة ومن ثم أصبح في اإلمكان الوصول‬
‫للعناصر الموجودة بها عن طريق الدالة )(‪ (View.findViewById‬أنظر سطر رقم ‪ .)15‬إنشاء واجهة المستخدم‬
‫يتم في الدالة )(‪ ,onCreate‬وتصبح الفعالية (‪ (Activity‬مرئية عند تنفيذ الدالة )(‪( onStart‬راجع دورة حياة‬
‫الفعالية وتسلسل تنفيذ دوالة االتصال الراجع ‪ .)callback‬يمكن كتابة الكود أيضا ً في الدالة )(‪ onCreate‬ولكن بعد‬
‫تنفيذ الدالة )(‪ setContentView‬والمسؤولة عن إنشاء الواجهة‪.‬‬
‫بعد الوصول إلى الكائن ‪ myButton‬باستخدام الدالة )(‪ ,findViewById‬نضيف المستمع (‪ )Listener‬للكائن‬
‫‪ myButton‬بتنفيذ الدالة )( ‪ ,setOnClickListener‬ونضيف الكود الخاص باإلجراء المطلوب داخل الدالة‬
‫)(‪ .onClick‬اإلجراء المطلوب تنفيذه عند النقر على الزر هو تعديل النص المعروض في عنصر‬
‫الواجهة ‪ myTextView‬ليصبح "‪ ."Button Clicked‬لتنفيذ هذا اإلجراء يتم أوالً الوصول العنصر‬
‫‪ myTextView‬باستخدام الدالة )(‪ ,findViewById‬ثم نعدل النص المعروض بتنفيذ الدالة )(‪.setText‬‬
‫التعامل مع الحدث عن طريقة ملف ‪Layout‬‬
‫يمكن تنفيذ حدث معين عند النقر على الزر بطريقة أخرى وذلك بتعديل ملف هيكلية الواجهة ‪ layout‬بإضافة‬
‫الخاصية ‪ android:onClick‬وإعطائها قيمة تمثل اسم الدالة التي سيتم تنفيذها تلقائياً عن النقر على الزر كما هو‬
‫موضح في المثال التالي‪:‬‬
‫‪<Button‬‬
‫"‪android:id="@+id/myButton‬‬
‫"‪android:layout_width="wrap_content‬‬
‫"‪android:layout_centerHorizontal="true‬‬
‫"‪android:layout_centerVertical="true‬‬
‫"‪android:text="@string/mybutton_string‬‬
‫>‪android:onClick="myButtonClicked" /‬‬
‫بعد تعديل ملف الواجهة‪ ,‬يجب التعديل في ملف الفعالية (‪ )Activity‬بإضافة الدالة ‪ myButtonClicked‬كما هو‬
‫موضح بالمثال التالي‪( :‬يجب أن يكون اسم الدالة مطابق لإلسم المحدد في ملف ‪.)Layout‬‬
‫{)‪public void myButtonClicked(View view‬‬
‫)‪TextView myTextView = (TextView‬‬
‫;)‪findViewById(R.id.myTextView‬‬
‫;)"‪myTextView.setText("Button clicked‬‬
‫}‬
‫مالحظة ‪ :‬يفضل استخدام الطريقة األولى لالستماع ألحداث عناصر الواجهة وهي بإضافة المستمع (‪)Listener‬‬
‫برمجيا ً وذلك ألنها تسمح بالستماع ألحداث متنوعة عن طريقة دوال مختلفة مثل )( ‪,setOnClickListener‬‬
‫)( ‪ setOnTouchListener () ,setOnLongClickListener‬وغيرها‪ .‬كما أن هذه الطريقة تضمن فصل‬
‫كامل ما بين مرحلة تصميم الواجهة‪ ,‬وهو ما يتم من خالل ملف هيكلية الواجهة‪ ,‬وبين مرحلة التعامل مع األحداث‬
‫والذي يتم برمجياً من خالل الفعالية (‪.)Activity‬‬
‫في النهاية‪ ,‬نستعرض بعد مستمعات األحدات )‪ (Event Listeners‬التي توفرها عناصر الواجهة والتي يمكن‬
‫استخدامها لالستماع ألنواع مختلمة من األحداث‪ ,‬ومن ضمنها‪:‬‬

‫‪ :onClickListener‬ويستخدم لتنفيذ إجراء عند النقر ثم ترك عنصر الواجهة ‪ .View‬يتم كتابة كود اإلجراء‬ ‫‪‬‬
‫في الدالة )(‪.onClick‬‬
‫‪ :onLongClickListener‬ويستخدم لتنفيذ إجراء عند النقر لفترة على عنصر الواجهة‪ .‬يتم كتابة كود‬ ‫‪‬‬
‫اإلجراء في الدالة )(‪.onLongClick‬‬
‫‪ :onKeyListener‬ويستخدم لتنفيذ إجراء عند الضعط على أحد المفاتيح في الجهاز بينما عنصر الواجهة‬ ‫‪‬‬
‫‪ View‬مف َعل من قبل المستخدم (‪ .)has focus‬يتم كتابة كود اإلجراء في الدالة )(‪.onKey‬‬

‫يتطرق هذا التمرين إلى عناصر واجهة متنوعة مثل زر اإلنتقاء )‪ ,(RadioButton‬خانة اإلختيار‬
‫)‪ ,(CheckBox‬القائمة المنسدلة (ٍ‪ )Spinner‬والشريط المنزلق )‪ (SeekBar‬وكيفية معالجة األحداث لهذه‬
‫العناصر برمجيا ً وأنواع المستمعات (‪ )Listeners‬المختلفة لهذا الغرض‪ .‬الواجهة الخاصة بهذا التطبيق وأنواع‬
‫العناصر المضافة موضحة في شكل ‪.3-2‬‬
‫‪Radio Buttons‬‬
‫‪Check Boxes‬‬
‫‪Spinner‬‬
‫‪Seek Bar‬‬
‫شكل ‪ : 3-2‬واجهة التطبيق الخاص بالتمرين ‪3-2‬‬

‫ أضف المصفوفة‬,(Spinner) ‫( التي يجب تعبئتها في القائمة المنزلقة‬Stirng Array) ‫لتحديد مصفوفة النصوص‬
:‫ كما هو موضح باألسفل‬strings ‫ إلى ملف‬countries_array
<resources>
<string name="app_name">UI Events</string>
<string name="action_settings">Settings</string>
<string-array name="countries_array">
<item>Palestine</item>
<item>Egypt</item>
<item>Algeria</item>
<item>Syria</item>
<item>Jordan</item>
<item>Saudi Arabia</item>
<item>Iraq</item>
</string-array>
</resources>
:‫ الخاصة بهذا التمرين موضح باألسفل‬Layout ‫ملف تصميم الواجهة‬

<LinearLayout
android:id="@+id/LinearLayout1"
android:orientation="vertical"
tools:context="com.example.uievents.MainActivity" >
<TextView
android:id="@+id/studyTextView"
android:layout_marginTop="20dp"
android:text="Where do you study?" />
<RadioGroup
android:id="@+id/radioGroup"
android:layout_height="wrap_content" >
<RadioButton
android:id="@+id/ucasRadio"
android:text="UCAS" />
<RadioButton
android:id="@+id/iugRadio"
android:text="IUGAZA" />
</RadioGroup>
<TextView
android:id="@+id/languageTextView"
android:text="What languages can you speak?" />
<LinearLayout
android:orientation="vertical" >
<CheckBox
android:id="@+id/englishCheckBox"
android:text="English" />
<CheckBox
android:id="@+id/arabicCheckBox"
android:text="Arabic" />
</LinearLayout>
<TextView
android:id="@+id/CountryTextView"
android:text="Where are you from?" />

<Spinner
android:id="@+id/countiresSpinner"
android:entries="@array/countries_array"
/>
<TextView
android:id="@+id/happienessTextView"
android:text="Rate your level of happieness" />
<SeekBar
android:id="@+id/happienessSeekBar"
android:layout_height="wrap_content" />
<TextView
android:id="@+id/HappienessValue"
android:layout_gravity="center"
android:text="" />
</LinearLayout>
‫ وذلك حتى يتم اختيار‬RadioGroup ‫ تم جمعها في مجموعة واحدة‬Radio Buttons ‫الحظ أن أزراء االنتقاء‬
‫ وكيف تم تعبئتها بالمصفوفة المحددة مسبقاً في المصادر‬spinner ‫ الحظ أيضا ً القائمة‬.‫عنصر واحد منها فقط‬
‫ (يمكن‬android:entries="@array/countries_array" ‫ ( وذلك باستخدام الخاصية‬strings.xml ‫(ملف‬
‫ في‬.)‫ والذي سيتم الحديث عنه الحقاً في هذا الفصل‬Adapterِ ‫ برمجياً باستخدام المحول‬spinner ‫تعبئة القائمة‬
‫ بعد‬.SeekBar ‫ وذلك لعرض القيمة الراجعة من العنصر‬TextView ‫أسفل الواجهة تم استخدام عنصر عرض‬
:‫) كما هو موضح‬MainActivity( ‫ سيتم اآلن معالجة أحداثها برمجيا ً داخل الفعالية‬,‫تجهيز الواجهة‬
2:
3: @Override
7: }
8:
9: @Override
10: protected void onStart() {

11: super.onStart();
12: RadioGroup radioGroup = (RadioGroup)
13: this.findViewById(R.id.radioGroup);
14: radioGroup.setOnCheckedChangeListener(new
15: android.widget.RadioGroup.OnCheckedChangeListener(){
16:
17: @Override
18: public void onCheckedChanged(RadioGroup group, int
19: checkedId) {
20: if(checkedId == R.id.ucasRadio)
21: Toast.makeText(getApplicationContext(),
22: "Choice : UCAS", Toast.LENGTH_SHORT).show();
23: else if(checkedId == R.id.iugRadio)
25: "Choice : IUG", Toast.LENGTH_SHORT).show();
26: }
27: });
28: CheckBox englishCheckBox = (CheckBox)
29: this.findViewById(R.id.englishCheckBox);
30: englishCheckBox.setOnCheckedChangeListener(new
31: OnCheckedChangeListener(){
32: @Override
33: public void onCheckedChanged(CompoundButton
34: buttonView, boolean isChecked) {
36: buttonView.getText()+" is "+ isChecked,
37: Toast.LENGTH_SHORT).show();
38: }
39: });
40: CheckBox arabicCheckBox = (CheckBox)
41: this.findViewById(R.id.arabic(CheckBox));
42: arabicCheckBox.setOnCheckedChangeListener(new
44: @Override
45: public void onCheckedChanged(CompoundButton
46: buttonView, boolean isChecked) {
47:
49: buttonView.getText()+" is "+ isChecked,
51: }
52: });
53:
54: Spinner spinner = (Spinner)
55: this.findViewById(R.id.countiresSpinner);
56: spinner.setOnItemSelectedListener(new
57: OnItemSelectedListener(){
58:
59: @Override
60: public void onItemSelected(AdapterView<?> parent,
61: View view, int position, long id) {
63: parent.getItemAtPosition(position).toString(),
65: }
66: @Override
67: public void onNothingSelected(AdapterView<?>
68: parent){}
69: });
70: final TextView happienessValue = (TextView)
71: this.findViewById(R.id.HappienessValue);
72: SeekBar seekBar = (SeekBar)
73: this.findViewById(R.id.happienessSeekBar);
74: seekBar.setOnSeekBarChangeListener(new
75: OnSeekBarChangeListener(){
76: @Override
77: public void onProgressChanged(SeekBar seekBar, int
78: progress, boolean fromUser) {
79: happienessValue.setText(String.valueOf(progress));
80: }
81:
82: @Override
83: public void onStartTrackingTouch(SeekBar seekBar){}
84:
85: @Override
86: public void onStopTrackingTouch(SeekBar seekBar){}
87: });
88: }
89:}
‫يتم معالجة األحداث لكل عنصر كما يلي‪:‬‬

‫‪ :Radio Buttons‬لتحديد أي زر إنتقاء )‪ (Radio Button‬تم اختياره‪ ,‬نقوم باستخدام المستمع‬ ‫‪‬‬
‫‪ RadioGroup.OnCheckedChangeListener‬وإضافته إلى مجموعة األزرار ‪( RadioGroup‬أنظر‬
‫سطر رقم ‪.)14‬عند حصول الحدث يتم تنفيذ الدالة )(‪ onCheckedChanged‬والتي يمرر إليها رقم المعرف‬
‫‪ ID‬الخاص بالزر الذي تم اختياره حيث يتم طباعة رسالة تبين اإلختيار (أنظر الكود من سطر ‪ 08‬إلى ‪.)36‬‬
‫‪ :Check Boxes‬لالستماع لحدث اختيار مربع اإلختيار )‪ (CheckBox‬نستخدم المستمع‬ ‫‪‬‬
‫‪( CompoundButton.OnCheckedChangeListener‬أنظر سطور رقم ‪ 21‬و ‪ ,)42‬وعند حصول‬
‫الحدث يتم تنفيذ الدالة )(‪ onCheckedChanged‬والتي يمرر إليها الكائن الخاص بمربع اإلختيارباإلضافة‬
‫إلى قيمته (‪ )true-false‬حيث يتم طباعة اسم مربع االختيار وقيمته (أنظر الكود من سطر ‪ 22‬إلى ‪ ,28‬ومن‬
‫سطر ‪ 45‬إلى ‪.)51‬‬
‫‪ :Spinner‬نستخدم مستمع من نوع ‪ AdapterView.OnItemSelectedListener‬لمعالجة الحدث الخاص‬ ‫‪‬‬
‫بهذا العنصر (أنظر سطر رقم ‪ .)56‬عند حصول الحدث يتم تنفيذ الدالة )(‪ onItemSelected‬والتي من ضمن‬
‫ما يمرر لها موقع العنصر الذي تم اختياره من القائمة‪ .‬بمعرفة موقع العنصر يمكن الوصول له من القائمة عن‬
‫طريق الدالة )(‪( getItemAtPosition‬أنظر الكود من سطر ‪ 60‬إلى ‪.)65‬‬
‫‪ :Seek Bar‬يتم معالجة الغيرات على الشريط المنزلق )‪ (SeekBar‬عن طريق إضافة مستمع من نوع‬ ‫‪‬‬
‫‪( OnSeekBarChangeListener‬أنظر سطر رقم ‪ .)74‬عند حصول الحدث يتم تنفيذ الدالة‬
‫)(‪ onProgressChanged‬والتي يمرر لها القيمة الحالية للشريط (‪ 011-1‬مثالً) باإلضافة إلى القيمة المنطقية‬
‫‪ fromUser‬والتي تحدد ما إذا كان تغير الشريط تم من المستخدم (‪ )fromUser=true‬أو برمجياً‬
‫(‪ .)fromUser=false‬في المثال الموضح يتم طباعة قيمة الشريط الممررة في عنصر من نوع ‪TextView‬‬
‫(أنظر الكود من سطر ‪ 77‬إلى ‪.)81‬‬
‫قائمة العرض (‪)ListView‬‬
‫عرض العناصر في قائمة هو أحد التصاميم الشائعة بكثرة في تطبيقات الهواتف النقالة‪ .‬يشاهد المستخدم عدد من‬
‫العناصر ويستطيع االنتقال ألعلى القائمة وأسفلها ‪ scroll up/down‬كما هو موضح بشكل ‪ . 3-3‬عند إختيار أحد‬
‫عناصر القائمة يتم عادة تنفيذ إجراء مثل فتح فعالية جديدة‪.‬‬
‫إضافة بيانات للقائمة (‪)ListView‬‬
‫إلضافة بيانات للقائمة )‪ (ListView‬يتم عادةً استخدام المحول )‪ ,(Adapter‬وهو كائن وسيط بين عنصر العرض‬
‫وهو القائمة (‪( )ListView‬أو أي عنصر واجهة يتفرع من الفئة ‪ )AdaperView class‬وبين البيانات‬
‫المعروضة‪ .‬يتحكم المحول )‪ (Adapter‬في الوصول لبيانات القائمة‪ ,‬كما أنه مسؤول عن تحويل البيانات المدخلة‬
‫للقائمة إلى عنصر عرض )‪ (View‬يمكن تضمينه داخل القائمة‪ .‬فمثالً‪ ,‬عند إداخل مصفوفة من النصوص )‪Array‬‬
‫‪ (String‬لعرضها في القائمة‪ ,‬يقوم المحول )‪ (Adapter‬بتحويل كل عبارة نصية في المصفوفة إلى كائن من نوع‬
‫)‪ (TextView‬والذي يتم إدر اجه في القائمة‪ ,‬أي أن مصفوفة النصوص تتحول باستخدام المحول )‪ (Adapter‬إلى‬
‫مجموعة من عناصر العرض )‪ (TextView‬المجمعة في قائمة من نوع (‪.)ListView‬‬

‫‪1‬‬
‫شكل ‪ : 3-3‬قائمة العرض )‪(ListView‬‬
‫الحظ أن محتوى القائمة قد يكون أكثر تعقيداً من مجرد عرض عبارات نصية‪ .‬على سبيل المثال‪ ,‬قد يشتمل السطر‬
‫الواحد في القائمة على صورة ونص وزر‪ .‬في هذه الحالة يجب تصميم هيكلية الواجهة الخاصة بالسطر الواحد‬
‫كملف ‪ ,Layout‬ومن ثم نقوم بكتابة محول خاص )‪ (Custom Adapter‬والذي يقوم باستقبال البيانات‪ ,‬الصور‬
‫والنصوص‪ ,‬وإنشاء عنصر العرض )‪ (View‬لعرضها بنا ًء على ملف ‪ .layout‬سنقوم الحقاً في هذه الوحدة بتناول‬
‫موضوع المحوالت الخاصة )‪.(Custom Adapter‬‬
‫المحوالت االفتراضية )‪(Default Adapter‬‬

‫يوفر نظام أندرويد بعض المحوالت االفتراضية‪ ,‬من أهمها ‪ ArrayAdapter‬و ‪ .CursorAdapter‬يستخدم‬
‫‪ ArrayAdapter‬إلدراجات البيانات الموجودة في مصفوفة ‪ Array‬أو ‪.List‬المحول المخصص‬
‫)‪ (CursorAdapter‬يعالج البيانات المدخلة من قاعدة بيانات أو مزود المحتوى )‪ .(Content Provider‬كل هذه‬
‫المحوالت ‪ Adapters‬هي فئات فرعية )‪ (subclasses‬من الفئة األساسية ‪.BaseAdapter‬‬

‫يوضح هذا التمرين استخدام ‪ ArrayAdapter‬لتعبئة قائمة العرض )‪ (ListView‬بمصفوفة من العبارات النصية‪.‬‬
‫‪ ArrayAdapter‬يتعامل مع مصفوفة من الكائنات ‪ objects‬حيث أن كل كائن سيمثل كسطر في القائمة‬
‫(‪.)ListView‬‬
‫‪Using Lists in Android, atutorial by Lars Vogel, 1‬‬

‫‪http://www.vogella.com/tutorials/AndroidListView/article.html‬‬

‫ وعند النقر على‬,‫) باسماء مدن فلسطينية كما هو موضح في شكل‬ListView( ‫في هذا التمرين سنقوم بتعبئة قائمة‬
.‫أي اسم يتم معالجة الحدث بطباعة رسالة على الشاشة‬
3-3 ‫ واجهة التطبيق الخاصة بالتمرين‬: 3-4 ‫شكل‬

‫ حيث تحتوي الواجهة على عنصر واحد فقط‬,‫( الخاص بالبرنامج موضح باألسفل‬Layout) ‫ملف هيكلية الواجهة‬
:)ListView( ‫وهو القائمة‬
<LinearLayout
tools:context="com.example.simplelist.MainActivity" >
<ListView
android:id="@+id/listView"
android:layout_height="wrap_content" >
</ListView>
</LinearLayout>
:‫ موضح في األسفل‬MainActivity ‫الكود الخاص بالفعالية‬

2:
3: @Override
7: ListView listView = (ListView)
8: this.findViewById(R.id.listView);
9: String[] values = {"Jerusalem", "Gaza",
10: "Ramallah", "Jenin", "Nablus", "Tulkarm","Al-
11: khalil","Haifa","Yafa","Areeha"};
12: ArrayList<String> listValues = new
13: ArrayList<String>();
14: for(int i=0; i<values.length; i++)
15: listValues.add(values[i]);
16: ArrayAdapter<String> adapter = new
17: ArrayAdapter<String>(this,
18: android.R.layout.simple_list_item_1, listValues);
19: listView.setAdapter(adapter);
20: listView.setOnItemClickListener(new
21: OnItemClickListener(){
22:
23: @Override
24: public void onItemClick(AdapterView<?>
25: parent, View view, int position, long id) {
27: parent.getItemAtPosition(position).toString(),
29: }
30: });
31: }
32: }
‫ يتم أوالً الوصول للقائمة عن طريقة الدالة‬:‫) يتم تنفيذ الخطوات التالية‬ListView( ‫لتعبئة قائمة العرض‬
‫( تحتوي على أسماء المدن المراد‬List) ‫ ثم نقول بإنشاء مصفوفة‬,)8 ‫ و‬7 ‫ (أنظر سطر‬findViewById()
‫( في قائمة العرض‬List) ‫ إلدراج محتويات المصفوفة‬.)05 ‫ إلى‬9 ‫إضافتها للقائمة (أنظر السطور من‬
:‫ ويتم إنشاءه كالتالي‬ArrayAdapter ‫) نستخدم‬ListView(
‫‪ArrayAdapter<String> adapter = new‬‬

‫‪ArrayAdapter<String>(this,‬‬
‫;)‪android.R.layout.simple_list_item_1, listValues‬‬
‫حيث يمرر له ثالث قيم هي‪( context :‬الفعالية الحالية)‪ ,‬المعرف الخاص بتصميم هيكلية الواجهة‬
‫)‪ ,(android.R.layout.simple_list_item_1‬وقائمة البيانات )‪ .(listValues‬تحتاج قائمة العرض‬
‫(‪ )ListView‬إلى تصميم يحدد كيفية عرض كل سطر وخصائص العرض (التنسيق والهوامش والخطوط وغيره‬
‫من الخصائص)‪ .‬يمكن تصميم شكل السطر في القائمة في ملف ‪ Layout‬مستقل‪ ,‬ومن ثم تمريره للمحول‬
‫)‪ (Adapter‬عند إنشائه‪ .‬في هذا التمرين‪ ,‬تم تمرير أحد التصميمات االفتراضية التي توفرها بيئة أندرويد والتي‬
‫تحمل الصيغة ‪ . android.R.layout.<layout_name>:‬هناك المزيد من التصميمات والتي يمكن تجربتها‬
‫ومالحظة التغير في شكل القائمة (‪.)ListView‬‬
‫بعد إنشاء المحول )‪ (Adapter‬وإدخال البيانات إليه‪ ,‬نقوم بتمريره إلى القائمة (‪ )ListView‬عن طريق الدالة‬
‫)(‪ setAdapter‬من خالل (‪( )ListView‬أنظر سطر رقم ‪ .)19‬كما ذكرنا مسبقا ً فإنه المحول )‪ (Adapter‬يقوم‬
‫بتحويل البيانات المدخلة إلى عناصر ‪ Views‬ومن ثم تجميعها وعرضها في القائمة (‪.)ListView‬‬
‫لمعالجة حدث النقر على أي عنصر من القائمة‪ ,‬قمنا بإضافة مستمع (‪ )Listener‬من نوع‬
‫‪( OnItemClickListener‬أنظر سطر رقم ‪ .)20‬عند حصول الحدث يتم تنفيذ الدالة )(‪ onItemClicked‬والتي‬
‫يمرر إليها موقع العنصر الذي تم اختياره من القائمة (‪ .)ListView‬يتم بعد ذلك الوصول و طباعة اسم العنصر‬
‫الذي تم اختياره عن طريق الدالة )(‪( getItemAtPosition‬أنظر الكود من سطر ‪ 24‬إلى ‪.)31‬‬
‫الحظ أن البيانات التي يتم تمريرها إلى المحول )‪ (Adapter‬قد ال تكون بيانات نصية ‪ ,String‬بل قد تكون كائن‬
‫)‪ (object‬من أي نوع‪ .‬في حالة تمرير كائن غير نصي‪ ,‬يقوم المحول )‪ (Adapter‬ضمنياً بتنفيذ الدالة‬
‫)(‪ toString‬لتمثيل الكائن كنص‪ .‬لذلك احرص على تطبيق الدالة )(‪ onString‬ألي كائن تقوم بإنشائه حتى تعمل‬
‫القائمة (‪ )ListView‬بعرض البيانات بالشكل الصحيح‪.‬‬
‫القائمة (‪ )ListView‬في المثال السابق تسمح باختيار عنصر واحد من القائمة‪ .‬يمكن تفعيل اإلختيار المتعدد من‬
‫القائمة عن طريق الدالة )(‪ setChoiceModel‬بتنفيذ األمر التالي‪:‬‬
‫;)‪listView.setChoiceMode(ListView.CHOICE_MODE_MULTIPLE‬‬
‫مثل‬ ‫اإلختيار‬ ‫متعددة‬ ‫للقوائم‬ ‫افتراضية‬ ‫تصماميم‬ ‫أندرويد‬ ‫نظام‬ ‫يوفر‬ ‫كما‬
‫‪ android.R.layout.simple_list_item_multiple_choice‬والتي يمكن تمريرها للمحول كما فعلنا في‬
‫التمرين السابق‪ ,‬حيث تصبح واجهة التطبيق السابق عن تطبيق خاصية االختيار المتعدد كما بالشكل‬

‫شكل ‪ : 3-5‬االختيار المتعدد من القائمة )‪(ListView‬‬

‫الجدير بالذكر أن نظام أندرويد يوفر فئة ‪ class‬باسم ‪ ,ListActivity‬وهي فعالية ذو واجهة مستخدم إفتراضية‬
‫تحتوي على قائمة (‪ .)ListView‬في حالة استخدام ‪ ListActivity‬بدالً من ‪ ,Activity‬لن تحتاج إلى تصميم ملف‬
‫واجهة للتطبيق وإدراج قائمة جديدة (‪ , )ListView‬حيث يمكن الوصول إلى القائمة (‪ )ListView‬الموجودة‬
‫افتراضيا ً في الفعالية ‪ ListActivity‬عن طريقة الدالة )( ‪.ListActivity.getListView‬‬
‫المحول الخاص ‪Custom Adapter‬‬

‫المحول اإلفتراضي ‪ ArrayAdapter‬يوفر فقط إمكانية إضافة العناصر النصية من نوع ‪ ,String‬وأي بيانات من‬
‫نوع آخر يتم تمريرها للمحول ‪ ArrayAdapter‬يتم تحويلها تلقائياً لنص عن طريق الدالة )(‪ .toString‬في كثير‬
‫من األحيان تحتاج إلضافة أنواع أخرى من البيانات للقائمة (‪ )ListView‬مثل الصور‪ .‬كذلك قد يكون السطر‬
‫الواحد في القائمة مركبا ً حيث يتكون من أكثر من جزء كما هو موضح في الهيكلية الموضحة في شكل ‪.3-6‬‬

‫‪1‬‬
‫شكل ‪ : 3-6‬قائمة عرض )‪ (ListView‬حيث أن تصميم السطر يكون مركبا من مجموعة من العناصر‬
‫في مثل هذه الحاالت‪ ,‬نحتاج إلنشاء محول خاص )‪ (Custom Adapter‬نحدد فيه تصميم الواجهة الخاصة‬
‫بالسطر في قائمة العرض (‪ ,)ListView‬ونحدد كذلك كيف يتم معالجة البيانات المختلفة لعرضها في سطر القائمة‪.‬‬
‫للقيام بذلك نقوم بإنشاء فئة (‪ )class‬جديدة تمثل المحول الجديد بحيث تتفرع من الفئة ‪ BaseAdapter‬أو أي فئة‬
‫متفرعة من ‪ BaseAdapter‬مثل ‪ ,ArrayAdapter‬ثم نقوم بتطبيق الدالة )(‪ getView‬والتي يتم من خاللها‬
‫إنشاء الواجهة الخاصة بالسطر وعرض البيانات في عناصرها‪ .‬التمرين التالي يوضح خطوات بناء واستخدام‬
‫المحول الخاص )‪ (Custom Adapter‬ضمن تطبيق بسيط‪.‬‬

‫في هذا التمرين سيتم استخدام القائمة (‪ )ListView‬باإلضافة لمحول خاص )‪ (Custom Adapter‬إلنشاء واجهة‬
‫التطبيق الموضحة بالشكل ‪ : 3-7‬حيث تتكون الواجهة من قائمة (‪ )ListView‬كل سطر فيها من مكون اسم شخص‬
‫وصورته‪ ,‬وعند النقر على أي سطر يتم طباعة رسالة باسم الشخص‪.‬‬
‫‪Using lists in Android, A tutorial by Lars Vogel, 1‬‬

‫‪http://www.vogella.com/tutorials/AndroidListView/article.html‬‬
3-4 ‫ واجهة التطبيق الخاص بالتمرين‬:3-7 ‫شكل‬

‫ باإلضافة لعنصر‬ImageView ‫يتم في البداية تصميم واجهة السطر والتي تتكون من عنصر لعرض الصورة‬
.‫ يوضح تصميم هيكلية الواجهة‬my_listview_layout.xml ‫ الملف التالي‬.‫ لعرض اإلسم‬TextView ‫نصي‬
<LinearLayout
android:orientation="horizontal" >
<ImageView
android:layout_width="80dp"
android:layout_height="80dp"
android:src="@drawable/ic_launcher" />
<TextView
android:id="@+id/textView"
android:layout_height="44dp"
android:textSize="24sp"
android:textStyle="bold"
android:layout_marginLeft="10dp"
android:gravity="center_vertical"/>
</LinearLayout>
‫ تصميمها‬3-7 ‫( والذي سيستخدم في الواجهة في الشكل‬Custom Adapter) ‫بعد ذلك يتم إنشاء المحول الخاص‬
Custom) ‫) الخاصة بالمحول الخاص‬class( ‫ الكود الموضح باألسفل يوضح الفئة‬.)ListView( ‫لبناء القائمة‬
:(Adapter
1: public class MyCustomAdapter extends
2: ArrayAdapter<String>{
3: Context context;
4: List<String> names;
5: List<Integer> photos;
6:
7: public MyCustomAdapter(Context context, List<String>
8: names, List<Integer> photos) {
9: super(context, R.layout.my_listview_layout,
10: names);
11: this.names = names;
12: this.photos = photos;
13: this.context = context;
14: }
15:
16: public View getView(int position, View view, ViewGroup
17: parent){
18: if(view == null){
19: LayoutInflater inflater = (LayoutInflater)
20: context.getSystemService(
21: Context.LAYOUT_INFLATER_SERVICE);
22: view =
23: inflater.inflate(R.layout.my_listview_layout, parent,
24: false);
25: TextView tv = (TextView)
26: view.findViewById(R.id.textView1);
27: ImageView iv = (ImageView)
28: view.findViewById(R.id.imageView1);
29: tv.setText(names.get(position));
30: iv.setImageResource(photos.get(position));
‫‪31:‬‬
‫‪32:‬‬ ‫;)(‪ViewHolder vh = new ViewHolder‬‬
‫‪33:‬‬ ‫;‪vh.text = tv‬‬
‫‪34:‬‬ ‫;‪vh.image = iv‬‬
‫‪35:‬‬ ‫;)‪view.setTag(vh‬‬
‫‪36:‬‬ ‫{‪}else‬‬
‫‪37:‬‬ ‫;)(‪ViewHolder vh = (ViewHolder) view.getTag‬‬
‫‪38:‬‬ ‫;))‪vh.text.setText(names.get(position‬‬
‫‪39:‬‬
‫‪40:‬‬ ‫;))‪vh.image.setImageResource(photos.get(position‬‬
‫‪41:‬‬ ‫}‬
‫‪42:‬‬ ‫;‪return view‬‬
‫‪43:‬‬ ‫}‬
‫‪44:‬‬
‫‪45:‬‬ ‫{‪static class ViewHolder‬‬
‫‪46:‬‬ ‫;‪public TextView text‬‬
‫‪47:‬‬ ‫;‪public ImageView image‬‬
‫‪48:‬‬ ‫}‬
‫}‪49:‬‬
‫كما تالحظ فإن الفئة الجديدة ‪ MyCustomAdapter‬متفرعة من الفئة ‪ ArrayAdapter‬وتقوم بتطبيق الدالة‬
‫)(‪.getView‬‬
‫من خالل الباني )‪( (Constructor‬أنظر السطور من رقم ‪ 7‬إلى ‪ )02‬يتم تمرير الكائن ‪( context‬الفعالية مثالً)‪,‬‬
‫والمصفوفة الخاصة باألسماء المراد عرضها )‪ (names‬ثم مصفوفة الصور )‪ (photos‬ممثلة بأرقام المعرفات‬
‫‪ IDs‬الخاصة بالصور‪ .‬سيقوم المحول ‪ Adapter‬باستخدام هذه البيانات في بناء عناصر القائمة (‪.)ListView‬‬
‫الحظ أن المحول ‪ ArrayAdapter‬يتطلب تمرير تصميم واجهة القائمة المعرفة بـ‬
‫‪ R.layout.my_listview_layout‬باإلضافة إلى قائمة من الجمل النصية ‪ String‬إلى الفئة األم‬
‫)‪(superclass‬وهي ‪ ,ArrayAdaper‬وهو ما يتم من خالل األمر التالي في الباني ‪:Constructor‬‬
‫;)‪super(context, R.layout.my_listview_layout, names‬‬
‫الدالة األساسية في المحول )‪ (Adapter‬هي )(‪( getView‬أنظر سطر رقم ‪ )16‬والتي تحدد طريقة تحويل البيانات‬
‫لكل سطر إلى عنصر عرض ‪ View‬ليكون ضمن القائمة (‪ .)ListView‬الحظ أنه يتم استخدام كائن من نوع‬
‫‪ LayoutInflater‬لتحويل الواجهة الممثلة بملف ‪ XML‬إلى كائن نوع ‪ .View‬يمرر إلى الدالة )(‪inflate‬‬
‫المعرف الخاص بالواجهة المنشئة مسبقا ً (‪ )R.layout.my_listview_layout‬لتقوم بإرجاع كائن من نوع‬
‫‪( View‬أنظر الكود من سطر ‪ 18‬إلى ‪.)24‬‬

‫يشتمل الكائن ‪ View‬داخله على عناصر الواجهة وهي ‪ ImageView‬و ‪ .TextView‬يتم بعد ذلك الوصول لكل‬
‫من هذه العناصر عن طريق تنفيذ الدالة )(‪ findViewById‬على نطاق الكائن ‪( View‬أنظر الكود من سطر ‪25‬‬
‫إلى ‪.)28‬‬
‫;)‪TextView tv = (TextView) view.findViewById(R.id.textView1‬‬
‫)‪ImageView iv = (ImageView‬‬
‫;)‪view.findViewById(R.id.imageView1‬‬
‫بعد الوصول إلى عناصر السطر في القائمة (‪ ,)ListView‬يتم إضافة البيانات إليه (أنظر سطر رقم ‪ 29‬و‪.)30‬‬
‫الدالة )(‪ getView‬يتم تنفيذها لكل سطر في القائمة (‪ ,)ListView‬وعند تنفيذها ألي سطر يمرر إليها رقم هذا‬
‫السطر في المتغير‪ .position‬فمثالً‪ ,‬لعرض السطر األول في القائمة يتم تنفيذ الدالة )(‪ getView‬تلقائياً ويمرر‬
‫إليها ‪ .position =0‬إلضافة بيانات لسطر ما‪ ,‬نضيف البيانات الموجود في المصفوفات الخاصة باألسماء والصور‬
‫في المكان ‪ .position‬على سبيل المثال السطر الثالث في القائمة (‪ )ListView‬حيث قيمة ‪ position‬تساوي ‪3‬‬
‫يأخذ البيانات الموجودة في المصفوفات من المكان ‪ .3‬هذا يضمن أن يكون ترتيب العناصر في القائمة‬
‫(‪ )ListView‬مطابق لترتيبها في المصفوفات الخاصة بالبيانات‪ .‬يتم ذلك من خالل السطرين التاليين في الكود‪:‬‬
‫;))‪tv.setText(names.get(position‬‬
‫;))‪iv.setImageResource(photos.get(position‬‬
‫وأخيراً‪ ,‬الحظ أن الكود المرفق للمحول الخاص ‪ Cutom Adapter‬يستخدم ما يسمى بـ ‪ViewHolder Pattern‬‬
‫وذلك لتجنب تنفيذ الدالة )(‪ findViewById‬والتي تستنفذ وقت قد يؤثر على سرعة عرض (‪)ListView‬‬
‫وسالسة تحريكها‪ .‬تعتمد هذه الفكرة على تخزين مؤشرات لعناصر الواجهة ‪ View‬في كائن من نوع‬
‫‪( ViewHolder‬أنظر الكود من سطر ‪ 45‬إلى ‪ )48‬وذلك في أول مرة يتم فيها إن شاء الواجهة باستخدام‬
‫‪ .LayoutInflater‬ثم يتم إلحاق الكائن من نوع ‪ ViewHolder‬بعنصر العرض ‪ View‬الخاص بالواجهة عن‬
‫طريق الدالة )(‪ ,setTag‬وهو ما يتم من خالل الكود‪:‬‬
‫;)(‪ViewHolder vh = new ViewHolder‬‬
‫;‪vh.text = tv‬‬
‫;‪vh.image = iv‬‬
‫;)‪view.setTag(vh‬‬
‫عندما يتم تنفيذ الدالة )(‪ getView‬ثانيا ً (كما في حالة عمل ‪ scroll‬لعرض عنصر تم عرضه مسبقاً)‪ ,‬فإن الدالة‬
‫)(‪ getView‬لن تقوم بإنشاء عنصر الواجهة ثانيا ً باستخدام ‪ Layout Inflater‬ألنه قد تم إنشاؤه مسبقاً‪ ,‬حيث أن‬
‫قيمة الكائن ‪ View‬المدخل للدالة )(‪ getView‬ال يساوي ‪ null‬في حالة إعادة عرض العنصر‪ .‬في هذه الحالة لن‬
‫يتم إنشاء الواجهة ثانية‪ ,‬ويتم استخدام الكائن ‪ ViewHolder‬الملحق بعنصر الواجهة ‪ View‬للوصول للعناصر‬
‫‪ TextView‬و ‪ ImageView‬بدون الحاجة الستخدام الدالة )(‪( getViewById‬أنظر الكود من سطر ‪ 36‬إلى‬
‫‪ ,)41‬وهو ما يتم من خالل الكود التالي‪:‬‬

ViewHolder vh = (ViewHolder) view.getTag();

vh.text.setText(names.get(position));
vh.image.setImageResource(photos.get(position));
‫) والتي‬Activity( ‫ نقوم اآلن ببناء الفعالية‬, (MyCustomAdapter) ‫) الخاصة المحول‬class( ‫بعد إنشاء الفئة‬
‫ وتمرير البيانات المطلوب تعبئتها في القائمة‬MyCustomAdapter ‫سيتم من خاللها إنشاء كائن من المحول‬
:‫ الكود التالي خاص بهذه الفعالية‬.‫) وهي أسماء وصور األشخاص‬ListView(
1: public class MainActivity extends ListActivity {
2:
3: @Override
6: List<String> names = new ArrayList<String>();
7: names.add("Fadi");
8: names.add("Ibrahim");
9: names.add("Hani");
10: names.add("Wael");
11: names.add("Saleem");
12: names.add("Hatem");
13:
14: List<Integer> photos = new ArrayList<Integer>();
15: photos.add(R.drawable.face1);
21:
22: MyCustomAdapter adapter = new
23: MyCustomAdapter(this, names, photos);
24:
25: this.setListAdapter(adapter);
26: this.getListView().setOnItemClickListener(new
28:
29: @Override
‫{ )‪31: adapterView, View view, int position, long id‬‬

‫‪32:‬‬ ‫‪Toast.makeText(getApplicationContext(),‬‬
‫‪33: adapterView.getItemAtPosition(position).toString(),‬‬
‫;)(‪34: Toast.LENGTH_SHORT).show‬‬
‫‪35:‬‬ ‫}‬
‫‪36:‬‬ ‫;)}‬
‫} ‪37:‬‬
‫}‪38:‬‬
‫في الكود السابق‪ ,‬يتم في الدالة )(‪ onStart‬انشاء القوائم ‪ Lists‬الخاص باألسماء والصور (أنظر السطور من ‪6‬‬
‫بالصيغة‪:‬‬ ‫المعرفات‬ ‫باستخدام‬ ‫إليها‬ ‫الوصول‬ ‫يتم‬ ‫الصور‬ ‫أن‬ ‫(الحظ‬ ‫‪)20‬‬ ‫إلى‬
‫>‪ .)R.drawable.<image_file_name‬يجب أن تكون الصور محفوظة بنفس األسماء في مجلد ‪.drawable‬‬
‫الحظ أيضا ً أن الفعالية متفرعة من )‪ )ListActivity‬وهو ما يعني أننا لسنا بحاجة لتصميم واجهة خاصة بالفعالية‪,‬‬
‫حيث أن الواجهة االفتراضية تشتمل على قائمة (‪ .)ListView‬يتم الوصول لهذه القائمة عن طريق الدالة‬
‫)(‪ ListActivity.getListView‬من داخل الفعالية‪.‬‬
‫يتم إنشاء كائن من نوع المحول ‪ MyCustomAdapter‬وتمرير البيانات له‪ ,‬ومن ثم تمرير هذا الكائن إلى القائمة‬
‫(‪ )ListView‬عن طريق الدالة )(‪( setListAdapter‬أنظر الكود من سطر ‪ 22‬إلى ‪.)25‬‬
‫وفي النهاية يتم االستماع لحدث النقر على عناصر القائمة ‪ ListView‬عن طريق مستمع من نوع‬
‫‪ OnItemClickListener‬حيث يتم طباعة اإلسم الذي تم النقر عليه (أنظر الكود من سطر ‪ 26‬إلى ‪.)37‬‬

‫أسئلة على الوحدة الثالثة‬

‫‪ .0‬قم بإنشاء التطبيق الوضح في الشكل التالي‪ :‬يقوم المستخدم بإدخال اسم المستخدم ”‪ “User Name‬وكلمة‬
‫المرور "‪ ,"Password‬وعند النقر على زر اإلرسال ”‪ “Submit‬يتم قراءة القيم المدخلة وطباعتها على‬
‫الشاشة باستخدام ‪.Toast‬‬
‫‪ .3‬قم بإنشاء تطبيق باسم "‪ "Temparature Converter‬والذي يقوم بتحويل درجة الحرارة من سيليزيس‬
‫(‪ )Celisius‬إلى فهرنهايت (‪ )Fahrenheit‬والعكس‪ .‬واجهة التطبيق موضحة باألسفل‪ ,‬حيث يتم إدخال درجة‬
‫الحرارة في مربع اإلدخال ومن ثم إختيار طريقة التحويل‪ "to Celisius" :‬أو "‪ ."to Fahrenheit‬عند النقر‬
‫على زر ”‪ “Calculate‬يتم حساب النتيجة وطباعتها برسالة ‪ .Toast‬مع العلم أن التحويل يتم بنا ًء على‬
‫المعادالت التالية‪:‬‬
‫‪°F = °C x 9/5 + 32‬‬
‫‪°C = (°F - 32) x 5/9‬‬

‫‪ .2‬قم بالتعديل على تمرين ‪ 4-3‬كالتالي‪ :‬كل سطر في قائمة العرض )‪ (ListView‬يعرض صورة واسم الشخص‬
‫باإلضافة إلى وضع االتصال الخاص به‪ :‬متصل (‪ )Online‬أو غير متصل )‪ .(Offline‬يتم عرض األيقونات‬
‫الموضحة بالشكل بناء على وضع االتصال‪ .‬أوضاع االتصال الخاصة بالمستخدمين يتم تمريرها كمصفوفة‬
‫للمحول ‪.Adapter‬‬
‫‪ .2‬قم بالتعديل على المحول ‪ MyCustomAdapter‬المستخدم في تمرين ‪ 4-3‬وذلك بعمل فئة فرعية‬
‫)‪ (subclass‬من الفئة )‪ (BaseAdapter‬بدالً من الفئة )‪ (ArrayAdapter‬وقم بعمل التغييرات الالزمة‪ .‬تأكد‬
‫بأن تمرين ‪ 4-3‬يعمل بشكل صحيح بعد إجراء التغيير‪.‬‬

‫الوحدة الرابعة‪:‬‬
‫الربط بين الفعاليات باستخدام األهداف‬
‫)‪(Linking Activities Using Intents‬‬
‫‪. ‬مفهوم الهدف )‪ (Inent‬وأنواعة واستخداماته‪.‬‬
‫‪ ‬تشغيل فعالية )‪ (Activity‬من فعالية أخرى‪.‬‬
‫‪ ‬التواصل بين الفعاليات وتبادل البيانات بينها‪.‬‬
‫‪. ‬مفهوم مرشح الهدف )‪ (Intent Filter‬واستخداماته‪.‬‬
‫تطبيق أندرويد قد يتكون من أكثر من فعالية (‪ ,)Activity‬بحيث يتم اإلنتقال من فعالية إلى أخرى أثناء استخدام‬
‫التطبيق‪ .‬فمثالً‪ ,‬قد تكون هناك فعالية (‪ )Activity‬تعرض قائمة عرض (‪ ,)ListView‬وعند اختيار أي عنصر من‬
‫القائمة يتم تش غيل واجهة جديدة (فعالية) لعرض بيانات متعلقة بالعنصر الذي تم اختياره‪ .‬في مثل هذه الحاالت‪ ,‬يجب‬
‫تشغيل فعالية من فعالية أخرى‪ ,‬وكذلك قد يلزم نقل البيانات بين الفعاليات‪ .‬الربط بين الفعاليات في نظام أندرويد يتم‬
‫باستخدام ما يسمى بـ‪ Intent‬أو الهدف (ترجمة حرفية)‪ .‬يتناول هذا الفصل مفهوم الهدف (‪ )Intent‬وأنواعة‬
‫المختلفة وطريقة تشغيل الفعاليات باستخدام (‪ ,)Intent‬ويتم تدعيم كل هذه المفاهيم بتمارين عملية‪.‬‬
‫األهداف (‪)Intents‬‬
‫الـ (‪ )Intent‬أو الهدف هو كائن )‪ (Object‬يستخدم للتواصل بين مكونات التطبيقات لطلب إجراء معين أو لتبادل‬
‫المعلومات‪ .‬يمكن تخيل الهدف بأنه رسالة يتم إرسالها إلى التطبيقات لطلب إجراء ما أو لتبادل المعلومات‪ .‬هناك‬
‫ثالث استخدامات أساسية للهدف (‪ )Intent‬وهي كالتالي‪:‬‬
‫تشغيل فعالية (‪ )Activity‬واستقبال النتائج منها‪ :‬الفعالية تمثل واجهة من واجهات التطبيق‪ .‬يمكن تشغيل فعالية‬ ‫‪‬‬
‫ما عن طريق تمرير هدف (‪ (Intent‬إلى الدالة )(‪ .startActivity‬في هذه الحالة يحدد الهدف (‪)Intent‬‬
‫الفعالية المراد تشغيلها باإلضافة ألي بيانات أخرى تحتاجها الفعالية‪.‬‬
‫تشغيل خدمة (‪ :)Service‬الخدمة (‪ )Service‬هي مكون من مكونات تطبيق أندرويد يستخدم لتنفيذ مهام بدون‬ ‫‪‬‬
‫واجهة للمستخدم‪ ,‬وغالبا ً ما تعمل الخدمة في الخلفية بدون تفاعل من المستخدم‪ .‬يتم تشغيل خدمة معينة‬
‫(‪ )Service‬عن طريق الدالة )(‪ startService‬والتي يمرر لها كائن من نوع الهدف (‪ )Intent‬يحدد الخدمة‬
‫المراد تشغيلها‪.‬‬
‫إرسال منشور )‪ :(Deliver Broadcast‬المنشور )‪ (Broadcast‬هي رسالة يتم ارسالها إلى تطبيقات مختلفة‪.‬‬ ‫‪‬‬
‫على سبيل المثال‪ ,‬عن إعادة تشغيل الجهاز ‪ boot‬يقوم نظام أندرويد تلقائيا ً بارسال رسالة من نوع )‪(Intent‬‬
‫وذلك إلعالم كل البرامج المعنية بحدث ‪ boot‬حتى تنفذ بنا ًء عليه إجراءات أخرى‪ .‬أرسال المنشور‬
‫‪ Broadcast‬سيتم التطرق إليه في الوحدة الثامنة‪.‬‬

‫أنواع الهدف )‪(Intent Types‬‬

‫هناك نوعان للهدف (‪ ,)Intent‬وهما‪:‬‬
‫الهدف الصريح )‪: (Explicit Intent‬وفيه يتم تحديد المكون المراد تشغيله (فعالية ‪ Activity‬أو خدمة‬ ‫‪‬‬
‫‪ Service‬أو منشور ‪ .)Broadcast‬غالبا ً ما يتم استخدام الهدف الصريح لتشغيل مكون من مكون آخر في‬
‫نفس التطبيق ألن الفئة (‪ )class‬الخاصة بالمكون المراد تشغيله معروفة ويمكن الوصول إليها في نطاق‬
‫التطبيق الواحد‪.‬‬
‫الهدف المضمن )‪ :)Implicit Intent‬وفيه ال يتم تحديد المكون المراد تشغيله صراحةً‪ ,‬ويتم تحديد نوع‬ ‫‪‬‬
‫اإلجراء المراد تنفيذه بدالً من ذلك‪ .‬تحديد اإلجراء يُ َم ّكن أي مكون يتبع ألي تطبيق آخر أن ينفذ هذا اإلجراء إذا‬
‫كان مصمما ً لذلك‪ .‬على سبيل المثال‪ ,‬إذا اراد التطبيق عرض صفحة ويب معينة‪ ,‬يجب تشغيل فعالية‬
‫(‪ )Activity‬قادرة على عرض وتصفح اإلنترنت‪ ,‬ويتم ذلك بتنفيذ الدالة )(‪ startActivity‬ويممر للدالة هدف‬
‫مضمن يحدد فيه إجراء باسم ‪ ACTION_VIEW‬وصفحة الويب المراد فتحها (الحظ أنه لم يحدد اسم مكون‬
‫محدد لعرض صفحة الويب)‪ .‬يقوم النظام تلقائياً باختيار الفعالية المالئمة لتشغيل اإلجراء المطلوب‬
‫(‪ ,(ACTION_VIEW‬وقد تكون الفعالية المالئمة تابعة لتطبيق آخر في نفس الجهاز‪.‬‬
‫عند إنشاء هدف صريح )‪ (Explicit Intent‬بهدف تشغيل مكون ما فإن النظام يقوم مباشرة بتشغيل المكون‬
‫المحدد في الهدف الصريح‪ ,‬أما عند إنشاء هدف مضمن )‪ )Implicit Intent‬فإن النظام يبحث عن المكون المناسب‬
‫لتنفيذ اإلجراء المحدد في الهدف (‪ )Intent‬وذلك في كل التطبيقات الموجودة في الجهاز‪ .‬إذا توافق الهدف مع تطبيق‬
‫معين‪ ,‬يقوم النظام بتشغيل التطبيق الموافق ويرسل له الهدف (‪ )Intent‬والذي قد يحوي بيانات أخرى إلرسالها‬
‫للتطبيق المطلوب‪.‬عند وجود أكثر من فعالية يمكنها تنفيذ اإلجراء المطلوب يقوم النظام بعرض قائمة الفعاليات حتى‬
‫يختار المستخدم الفعالية التي يريدها‪ .‬شكل ‪ 4-1‬يوضح إجراءات تشغيل فعالية )‪ (Activity B‬من فعالية‬
‫)‪ (Activity A‬باستخدام هدف مضمن )‪.(Implicit Intent‬‬
‫شكل ‪ :4-1‬إنشاء فعالية باستخدام هدف مضمن‪ -1 :‬من داخل الفعالية ‪ A‬يتم تنفيذ التعليمة )(‪startActivity‬‬
‫ويمرر إليها هدف مضمن يوضح اإلجراء المراد تنفيذه‪ -2 .‬يتقبل النظام الهدف ويبحث في كل التطبيقات في‬

‫الجهاز عن أي فعالية يمكنها تشغيل اإلجراء المطلوب‪ .‬فمثال‪ ,‬الفعالية ‪ B‬تحقق الغرض‪ ,‬لذلك يقوم النظام‬
‫بتشغليها ويرسل لها الهدف‪ -3 .‬عند تشغيل الفعالية ‪ B‬يتم تنفيذ الدالة )(‪ onCreate‬حيث يمكن خاللها استقبال‬
‫‪1‬‬
‫الهدف الذي ارسله النظام والذي قد يحتوي على معلومات تلزم الفعالية ‪.B‬‬
‫مكونات الهدف (‪)Intent‬‬
‫الهدف (‪ )Intent‬يحوي المعلومات الالزمة لتشغيل مكون ما وتشمل أهم هذه المعلومات ما يلي‪:‬‬
‫المكون )‪ :(Component‬وهو يحدد المكون الذي يجب أن يستقبل الهدف (‪ .)Intent‬يجب تحديد اسم المكون‬ ‫‪‬‬
‫فقط عند استخدام هدف صريح )‪ ,)Explicit Intent‬وهو ما يعني أن الهدف يجب أن يرسل فقط للمكون‬
‫المحدد باإلسم‪ .‬بدون تحديد اسم مكون يصبح الهدف مضمناً )‪ ,)Implicit Intent‬وهو ما يعني أن النظام هو‬
‫من يحدد المكون الذي يمكنه استقبال الهدف بنا ًء على المعلومات األخرى المضمنة في الهدف‪ .‬لذلك إذا أردت‬
‫تشغيل مكون محدد في تطبيقك فيجب عليك تحديد المكون من خالل هدف صريح )‪ . (Explicit Intent‬يجب‬
‫المالحظة أن تحديد المكون يعني هنا الفئة (‪ )class‬الخاصة بهذا المكون مثل الفعالية (‪.)Activity‬‬
‫اإلجراء (‪ : )Action‬وهو جملة تحدد اإلجراء المراد تنفيذه مثل عرض صفحة ويب أو االتصال على رقم‬ ‫‪‬‬
‫جوال وغيره‪ .‬يتم تحديد اإلجراء (‪ )Action‬في حالة الهدف المضمن )‪ (Implicit Intent‬فقط‪ ,‬حيث يترك‬
‫للنظام مسؤولية إختيار المكون القادر على تنفيذ اإلجراء‪ .‬يمكن تحديد اإلجراء الذي يستخدمه الهدف برمجياً إما‬
‫بتمريره من خالل منشئ الباني ‪ constructor‬الخاص بالهدف أو بتنفيذ الدالة )()‪ .setAction‬هناك بعض‬
‫اإلجراءات العامة التي يتعرف عليها النظام والتي يمكن استخدامها ألعراض عامة‪ ,‬ومن أهم هذه اإلجراءات‪:‬‬
‫‪ :ACTION_VIEW o‬والذي يستخدم لعرض بيانات معينة للمستخدم‪ .‬قد تكون هذه البيانات عبارة عن‬
‫عنوان موقع ويب أو صورة يراد عرضها أو موقع على الخريطة وغيره‪.‬‬
‫‪ :ACTION_SEND o‬وهو يستخدم لمشاركة البيانات ارسالها كبريد إلكتروني أو تحميلها على شبكة‬
‫إجتماعية‪.‬‬
‫البيانات )‪ :(Data‬وهي عبارة عن كائن من نوع ‪ Uri‬يشير إلى البيانات المراد استخدامها‪ .‬نوع البيانات‬ ‫‪‬‬
‫المرسلة في الهدف (‪ )Intent‬يعتمد على اإلجراء المطلوب‪ ,‬فمثال في حالة اإلجراء (‪(ACTION_VIEW‬‬
‫تكون البيانات على شكل عنوان الصفحة أو الصورة المراد عرضها‪.‬‬
‫التصنيف )‪ :(Category‬وهو يحدد نوع المكون الذي يتلقى الهدف (‪ .)Intent‬في معظم الحاالت لن تحتاح‬ ‫‪‬‬
‫لتحديد التصنيف‪ .‬من أنواع التصنيفات ‪ CATEGORY_LAUNCHER‬وهو يحدد الفعالية الرئيسية التي‬
‫سيبدأ بها تشغيل التطبيق‪ ,‬حيث أن كل تطبيق له فعالية واحدة فقط من هذا التصنيف‪.‬‬
‫اإلضافات (‪ :)Extras‬وهو عبارة عن حافظة تستخدم إلرسال بيانات إضافية من خالل الهدف (‪,)Intent‬‬ ‫‪‬‬
‫وترسل البيانات على شكل مفاتيح وقيم مقابلة )‪ ,(key-value pairs‬حيث يمكن الوصول لكل قيمة من خالل‬
‫المفتاح المحدد لها‪ .‬يتم إضافة البيانات للحافظة عن طريق الدوال من نوع )(‪ .putExtra‬على سبيل المثال‪ ,‬اذا‬
‫‪Intents and Intent Filters, Android Developer, http://developer.android.com/guide/components/intents- 1‬‬

‫‪filters.html‬‬

‫اردت ارسال بريد إلكتروني من خالل التطبيق‪ ,‬يجب انشاء هدف وتحديد اإلجراء له من نوع‬
‫(‪ .(ACTION_SEND‬ثم يجب تحديد العنوان البريدي للمستقبل عن طريق الدالة ‪ putExtra‬وتستخدم‬
‫المفتاح ‪ EXTRA_EMAIL‬كمفتاح لبيانات المستقبل‪ ,‬ويمكن أيضا تحديد موضوع الرسالة البريدية‬
‫‪ subject‬من خالل اضافة الموضوع بالمفتاح ‪.EXTRA_SUBJECT‬‬
‫‪ : Flag‬وهو متغير يحدد كيفية إنشاء الفعالية وما المهمة التي ستتبع لها وكيف سيتم التعامل معها بعد اإلنشاء‪.‬‬ ‫‪‬‬
‫في الغالب لن تحتاج إلى تحديد قيم لهذا المتغير‪.‬‬
‫تشغيل الفعالية (‪ )Activity‬باستخدام الهدف (‪)Intent‬‬
‫يمكن تشغيل فعالية عن طريق فعالية أخرى ما عن طريق تنفيذ الدالة )(‪ startActivity‬وتمرير هدف صريح‬
‫)‪ )Explicit Intent‬يحدد الفعالية المراد تشغيلها‪ .‬الهدف (‪ )Intent‬قد يحوي باالضافة إلى الفعالية المراد تشغيلها‬
‫بيانات أخرى مراد تمريرها للفعالية الجديدة‪.‬‬
‫الكود التالي يوضح تشغيل الفعالية ‪ SignInActivity‬باستخدام هدف صريح )‪ )Explicit Intent‬وتمرير بيانات‬
‫لها عن طريق حافظة اإلضافات )‪ (Extras‬الموجودة ضمن الهدف (‪:)Intent‬‬
‫‪Intent intent =new Intent(getApplicationContext(),‬‬
‫;)‪SignInActivity.class‬‬
‫;)”‪intent.putExtras(“username”,”Ahmed‬‬
‫;)‪startActivity(intent‬‬
‫الحظ أن إضافة البيانات يتم في الحافظة ‪ Extras‬بطريقة المفتاح والقيمة )‪ ,(key-value‬حيث يستخدم المفتاح‬
‫)‪ (key‬الحقاً السترجاع البيانات من الهدف (‪ .)Intent‬الفعالية التي تم تشغيلها باستطاعتها قراءة الهدف (‪)Intent‬‬
‫عن طريق تنفيذ الدالة )(‪ getIntent‬ومن ثم استخراج البيانات المرسلة من خالل الهدف لمعالجتها‪.‬‬
‫في حاالت أخرى قد تحتاج إلى تنفيذ إجراء معين (‪ )Action‬مثل إرسال بريد إلكتروني أو رسالة نصية‪ .‬في هذه‬
‫الحالة قد ال يملك البرنامج أي فعالية محددة لتنفيذ اإلجراء المطلوب‪ ,‬ويمكن استخدام فعاليات توفرها تطبيقات‬
‫أخرى موجودة على الجهاز‪ .‬يمكن تنفيذ ذلك باستخدام هدف مضمن )‪ )Implicit Intent‬يحدد نوع اإلجراء المراد‬
‫تنفيذه حيث سيقوم النظام تلقائيا ً باختيار الفعالية المناسبة لإلجراء المطلوب من أي تطبيق آخر على الجهاز‪ .‬في حالة‬
‫وجود أكثر من فعالية تدعم اإلجراء المطلوب (مثل وجود أكثر من مستعرض لصفحات االنترنت)‪ ,‬يقوم النظام‬
‫بطلب تدخل المستخدم الختيار الفعالية التي يريدها لتنفيذ اإلجراء المطلوب‪ .‬على سبيل المثال‪ ,‬اذا أردت السماح‬
‫لمستخدم بإرسال بريد إلكتروني من خالل تطبيق معين‪ ,‬يمكن تنفيذ ذلك بالكود التالي‪:‬‬
‫;)‪Intent intent =new Intent(Intent.ACTION_SEND‬‬
‫;)‪intent.putExtra(Intent.EXTRA_EMAIL, recipientArray‬‬
‫;)‪startActivity(intent‬‬

‫الحظ أنه تم إنشاء الهدف (‪ )Intent‬باستخدام اإلجراء المطلوب (‪ (ACTION_SEND‬ولم يتم تحديد فعالية‬
‫محددة لتشغيلها‪ .‬الثابت ‪ EXTRA_EMAIL‬المضاف للهدف (‪ )Intent‬يحدد المصفوفة ‪recipientArray‬‬
‫والتي تحو ي العناوين البريدية المراد إرسال البريد إليها‪ .‬هذه العناوين البريدية يتم إدارجها في خانة "إلى" )‪(to‬‬
‫ضمن نموذج إرسال البريد‪.‬‬
‫مالحظة هامة‪ :‬عند إنشاء الفئة (‪ )class‬الخاصة بالفعالية الجديدة تأكد أن الفعالية تم تعريفها في ملف الوثيقة‬
‫)‪ (Manifest‬وذلك بإضافة الخاصية ‪ activity‬داخل الخاصية ‪ application‬في ملف الوثيقة ‪ Manifest‬كما هو‬
‫موضح‪:‬‬
‫>‪<application‬‬
‫…‬
‫‪<activity‬‬
‫"‪android:name="ps.edu.ucas.example.NewActivity‬‬
‫> "‪android:label="@string/title_activity_details‬‬
‫>‪</activity‬‬
‫…‬
‫حيث أن قيمة الخاصية ‪ android:name‬تشير إلى مسار الفئة (‪ (classpath‬الخاص بالفعالية الجديدة‪.‬‬

‫في هذا التمرين سنقوم بالتعديل على تمرين (‪ )3-3‬والذي يقوم بعرض قائمة (‪ )ListView‬بأسماء المدن‬
‫الفلسطينية‪ .‬التعديل المطلوب إجراؤه هو تشغيل فعالية جديدة (‪ )Activity‬عند النقر على اسم أي مدينة وذلك‬
‫لعرض معلومات عن هذه المدينة في الفعالية الجديدة كما بالشكل‪:‬‬
‫شكل ‪ :4-2‬واجهة التطبيق الخاص بتمرين ‪.4-1‬‬

‫ لعرض‬ImageView ‫ و‬TextView ‫ والذي يتكون من عناصر‬,‫باألسفل ملف الواجهة الخاص بالفعالية الجديدة‬
.(ListView) ‫التفاصيل النصية والصور الخاصة بالمدينة التي يتم اختيارها من القائمة‬
<LinearLayout
tools:context="com.example.simplelist.DetailsActivity" >
<TextView
android:id="@+id/tvArea"
android:text="TextView" />
<TextView
android:id="@+id/tvPopulation"
<TextView
android:id="@+id/tvLargestCity"
<ImageView
android:id="@+id/ivMap"
</LinearLayout>
‫) والتي يتم فيها عرض تفاصيل المدينة التي يتم اختيارها‬DetailsActivity) ‫الكود باألسفل يوضح الفعالية الجديدة‬
.)ListView( ‫من القائمة‬
1: public class DetailsActivity extends Activity {
2:
3: @Override
6: setContentView(R.layout.activity_details);
7: TextView tvArea = (TextView)
8: this.findViewById(R.id.tvArea);
9: TextView tvPopulation = (TextView)
10: this.findViewById(R.id.tvPopulation);
11: TextView tvLargestCity = (TextView)
12: this.findViewById(R.id.tvLargestCity);
13: ImageView ivMap = (ImageView)
14: this.findViewById(R.id.ivMap);
15: Intent intent = this.getIntent();
16: String cityName =
17: intent.getExtras().getString("city");
18: this.setTitle(cityName);
19: if(cityName.equals("Gaza")){
20: tvArea.setText("Area: 360 km2");
21: tvPopulation.setText("Population: 1,816,379");
22: tvLargestCity.setText("Largest City: Gaza");
23: ivMap.setImageResource(R.drawable.gaza);
24: }
25: }
26: }
‫) يتغير بتغير اسم المدينة الذي يتم إرسالة من الفعالية االولى من خالل‬DetailsActivity) ‫محتوى واجهة الفعالية‬
‫) المرسل من فعالية البداية باستخدام الدالة‬Intent( ‫ الجزء األساسي في الكود هو قراءة الهدف‬.)Intent( ‫هدف‬
‫) يتم بقراءة الحافظة الموجودة‬Intent( ‫ قراءة البيانات المرسلة في الهدف‬.)15 ‫ (أنظر سطر رقم‬getIntent ()
‫ ومن ثم تنفيذ أحد دوال القراءة حسب نوع البيانات المرسلة مثل‬getExtras() ‫ضمن الهدف باستخدام الدالة‬
‫)(‪ getInt‬و )(‪( getString‬أنظر سطر رقم ‪ .)17‬بنا ًء على اسم المدينة الذي تم ارساله من فعالية البداية يتم تعبئة‬
‫محتوى الفعالية )‪.)DetailsActivity‬‬
‫مالحظة‪ :‬تأكد من إضافة تعريف الفعالية )‪ )DetailsActivity‬في ملف الوثيقة )‪.(Manifest‬‬
‫بعد إنشاء الفعالية المراد تشغيلها‪ ,‬نقوم بالتعديل على فعالية البداية )‪ (MainActivity‬والتي تحتوي على القائمة‬
‫(‪ )ListView‬وذلك بإضافة الكود التالي داخل الدالة )(‪ onItemClick‬الخاصة بالمستمع‬
‫‪:OnItemClickListener‬‬
‫…‬
‫‪1:‬‬ ‫‪listView.setOnItemClickListener(new‬‬
‫‪2:‬‬ ‫{)(‪OnItemClickListener‬‬
‫‪3:‬‬
‫‪5:‬‬ ‫‪public void onItemClick(AdapterView<?> parent, View‬‬
‫‪6:‬‬ ‫{ )‪view, int position, long id‬‬
‫‪7:‬‬ ‫= ‪String cityName‬‬
‫‪8:‬‬ ‫;)(‪parent.getItemAtPosition(position).toString‬‬
‫‪9:‬‬ ‫‪Intent intent = new Intent(getApplicationContext(),‬‬
‫‪10:‬‬ ‫;)‪DetailsActivity.class‬‬
‫‪11:‬‬ ‫;)‪intent.putExtra("city", cityName‬‬
‫‪12:‬‬ ‫;)‪startActivity(intent‬‬
‫‪13:‬‬ ‫}‬
‫‪14:‬‬ ‫;)}‬
‫…‬
‫الحظ أنه تم إنشاء هدف صريح )‪ )Explicit Intent‬يحتوى فئة (‪ )class‬الفعالية المراد تشغيلها وهي‬
‫‪( DetailsActivity‬أنظر السطرين رقم ‪ 9‬و‪ .)10‬تم بعد ذلك حفظ اسم المدينة الذي تم النقر عليه في الحافظة‬
‫)‪ (Extras‬باستخدام المفتاح ‪( city‬أنظر سطر رقم ‪ .)11‬وفي النهاية تم تشغيل الفعالية باستخدام الدالة‬
‫)(‪( startActivity‬أنظر سطر رقم ‪.)12‬‬
‫إنشاء فعالية من أجل نتيجة )‪)Starting an activity for a result‬‬
‫في بعض األحيان قد تحتاج إلى استرجاع نتيجة من الفعالية (‪ )Activity‬التي قمت بتشغيلها‪ :‬فمثالً قد تنشئ فعالية‬
‫لتطلب من المستخدم االختيار من قائمة ما و ترجع النتيجة إلى الفعالية األساسية‪ .‬في هذه الحالة يمكن استخدام األمر‬
‫)(‪ startActivityForResult‬بدالً من )(‪ .startActivity‬الستقبال النتيجة من الفعالية الجديدة‪.‬‬
‫لتوضيح آلية التواصل بين الفعاليات ‪ Activitites‬في هذه الحالة‪ ,‬افترض أن هناك فعاليتين ‪ A‬و ‪ B‬بحاجة‬
‫للتواصل بحيث تقوم ‪ A‬بتشغيل ‪ B‬وانتظار نتائج منها‪ .‬شكل ‪ 4-3‬يوضح آلية التواصل بين الفعاليتين‪ :‬تقوم الفعالية‬
‫‪ A‬بتشغيل الفعالية ‪ B‬باستخدام الدالة )(‪ .startActivityForResult‬الفعالية ‪ B‬بدورها تنفذ إجراء معين‬

‫)(‪ DoSomeThing‬ثم تقوم بتجهيز النتائج على شكل هدف (‪ )Intent‬وترجعها بتنفيذ الدالة )(‪ .setResult‬عند‬
‫إغالق الفعالية ‪ ,B‬بالنقر على زر ‪ Back‬مثالً‪ ,‬تعمل الفعالية ‪ A‬ويتم تلقائيا ً تنفيذ الدالة )(‪onActivityResult‬‬
‫والتي يمكن من خاللها قراءة البيانات المرجعة من الفعالية ‪.B‬‬
‫شكل ‪ :4-3‬التواصل بين الفعاليات )‪ (Activities‬في حالة تنفيذ الدالة )(‪startActivityForResult‬‬

‫لتوضيح هذه الخطوات عمليا ً سنقوم ببناء تطبيق بسيط يوضح هذه اآللية‪.‬‬

‫في هذا التمرين سنطبق مفهوم تشغيل فعالية (‪ )Activity‬من أجل إرجاع نتيجة‪ .‬واجهات التطبيق موضحة في‬
‫الشكل‪ ,‬وهو مكون من فعاليتين (‪ :)Activities‬الفعالية الرئيسية تظهر زر عند النقر عليه يتم تشغيل فعالية جديدة‬
‫تظهر قائمة من أسماء أصدقاء حيث يجب اختيار قائمة األصدقاء المفضلة منها‪ .‬بعد إنهاء الفعالية الثانية بالنقر على‬
‫زر ‪ ,Back‬يتم تشغيل الفعالية الرئيسية ويتم طباعة قائمة األصدقاء التي تم اختيارها على الشاشة‪.‬‬

.‫ والتواصل بينها‬4-2 ‫ واجهات التطبيق الخاص بتمرين‬:4-4 ‫شكل‬

:(MainActivity) ‫الكود التالي يوضح الفعالية الرئيسية‬
1: public class MainActivity extends Activity{
2:
3: public static int REQUEST_CODE = 50; // Any ID number
4: @Override
8: Button btn = (Button)
9: this.findViewById(R.id.button);
10: btn.setOnClickListener(new OnClickListener(){
11:
12: @Override
13: public void onClick(View v) {
14: Intent intent = new
15: Intent(getApplicationContext(),
16: FriendsListActivity.class);
17: startActivityForResult(intent, REQUEST_CODE);
18: }
19: });
20: }
21:
22: @Override
23: protected void onActivityResult(int requestCode, int
24: resultCode, Intent data) {
25: super.onActivityResult(requestCode, resultCode,
26: data);
27: if(requestCode == REQUEST_CODE && resultCode ==
28: FriendsListActivity.RESULT_CODE){
29: ArrayList<String> selectedFriends =
30: data.getStringArrayListExtra("selectedFriends");
31: String msg = "Selected Friends :\n";
32: for(String friend:selectedFriends)
33: msg+=friend+"\n";
34: Toast.makeText(getApplicationContext(), msg,
35: Toast.LENGTH_LONG).show();
36: }
37: }
38: }
)Explicit Intent) ‫“ يتم إنشاء هدف صريح‬Choose Your Best Friends” ‫الحظ أنه عن النقر على الزر‬
‫ ثم يتم تشغيل‬, )06 ‫ إلى‬02 ‫) (أنظر الكود من سطر‬FreindsListActivity) ‫بالفعالية المراد تشغيلها وهي‬
‫) بالإلضافة إلى قيمة‬Intent( ‫ والتي يمرر لها الهدف‬startActivityForResult() ‫الفعالية عن طريقة الدالة‬
‫ (أنظر سطر رقم‬integer ‫ حيث يمكن استخدام أي قيمة رقمية من نوع‬,request ‫رقمية تستخدم كمعرف للطلب‬
.)17
‫ (أنظر سطر رقم‬onActivityResult() ‫ يتم استقبال النتيجة في الدالة‬,‫بعد االنتهاء من العمل في الفعالية الجديدة‬
:‫ يتم تلقي ثالث نتائج هي‬onActivityResult() ‫ من خالل الدالة‬.‫) والتي تنفذ تلقائيا ً عند تلقي النتيجة‬23
‫ تحدد معرف الطلب األساسي ويفترض أن‬request_code ‫ القيمة‬.data ‫ و‬result_code ,request_code
‫يطابق نفس القيمة التي تم إرسالها عن تشغيل الفعالية (فحص هذه القيمة يفيد في تحديد الطلب الذي تم الرد عليه في‬
‫ يتم إرسالها من الفعالية الثانية وتفيد كمعرف‬result_code ‫ القيمة الثانية‬.)‫حالة تنفيذ أكثر من طلب الرجاع نتيجة‬
‫ الحظ أن النتيجة‬.‫) يحتوي بداخله على النتائج المرجعة‬Intent( ‫ هي هدف‬data ‫ القيمة الثالثة‬.‫لمصدر النتيجة‬
‫ وقد تم استرجاعها من الهدف‬,‫ تمثل األسماء التي تم إختيارها‬ArrayLisy<String> ‫المرجعة عبارة عن قائمة‬
‫ بعد ذلك يتم‬.)21‫ و‬39 ‫ (أنظر سطر رقم‬getStringArrayListExtra() ‫) عن طريق تنفيذ الدالة‬Intent(
.‫تحويل النتائج إلى رسالة وتطبع على الشاشة‬
:ListActivity ‫ وتكون من نوع‬FriendsListActivity ‫الكود التالي يوضح الفعالية الثانية‬
1:public class FriendsListActivity extends ListActivity {
2:
3: public static int RESULT_CODE = 60; //Any ID number
4:
5: @Override
8: ArrayList<String> friendNames = new
10: friendNames.add("Ahmed");
11: friendNames.add("Fadi");
12: friendNames.add("Iyad");
13: friendNames.add("Ibrahem");
14: friendNames.add("Rami");
15: friendNames.add("Osama");
16: friendNames.add("Omar");
17: friendNames.add("Amjad");
18: ArrayAdapter<String> adapter= new
19: ArrayAdapter<String>(this,android.R.
20: layout.simple_list_item_multiple_choice, friendNames);
22: getListView().setChoiceMode(ListView.
23: CHOICE_MODE_MULTIPLE);
24: getListView().setOnItemClickListener(new
26:
27: @Override
‫‪28:‬‬ ‫‪public void onItemClick(AdapterView<?> parent, View‬‬

‫{ )‪29: view, int position, long id‬‬
‫‪30:‬‬ ‫;)(‪ListView listView = getListView‬‬
‫‪31:‬‬ ‫= ‪SparseBooleanArray checked‬‬
‫;)(‪32: listView.getCheckedItemPositions‬‬
‫‪33: ArrayList<String> selectedItems = new‬‬
‫;)(>‪34: ArrayList<String‬‬
‫{ )‪35: for (int i = 0; i < listView.getCount(); i++‬‬
‫‪36:‬‬ ‫))‪if(checked.get(i‬‬
‫‪37:‬‬ ‫‪selectedItems.add(listView.getItemAtPosition(i).‬‬
‫;))(‪38: toString‬‬
‫} ‪39:‬‬
‫;)(‪40: Intent intent = new Intent‬‬
‫‪41: intent.putStringArrayListExtra("selectedFriends",‬‬
‫;)‪42: selectedItems‬‬
‫;)‪43: setResult(RESULT_CODE, intent‬‬
‫‪44:‬‬ ‫}‬
‫‪45:‬‬ ‫;)}‬
‫} ‪46:‬‬
‫}‪47:‬‬
‫الحظ أنه تم تعبئة قائمة العرض (‪ )ListView‬بمصفوفة األسماء باستخدام ‪ ArrayAdapter‬كما هو موضح في‬
‫الكود (أنظر الكود من سطر ‪ 8‬إلى ‪ .)31‬الحظ أيضا ً أن القائمة (‪ )ListView‬تسمح باالختيار المتعدد من خالل‬
‫تنفيذ الدالة )‪( setChoiceMode(ListView.CHOICE_MODE_MULTIPLE‬أنظر سطر رقم ‪.)33‬‬
‫الحظ أيضا ً اإلجراء الذي يتم تنفيذه عند اختيار عناصر من القائمة (‪ )ListView‬حيث يتم حفظ العناصر التي تم‬
‫اختيارها في قائمة >‪( ArrayList<String‬أنظر الكود من سطر ‪ 38‬إلى ‪ .)29‬الرجاع هذه القائمة للفعالية‬
‫الرئيسية‪ ,‬يتم إنشاء هدف (‪ )Intent‬وحفظ القائمة به عن طريقة تنفيذ الدالة )(‪putStringArrayListExtra‬‬
‫(أنظر سطر رقم ‪ .)41‬وأخيراً‪ ,‬يتم إرجاع النتيجة عن طريقة تنفيذ الدالة )(‪ setResult‬حيث ترسل النتائج‬
‫باإلضافة إلى رقم ‪ result_code‬ليستخدم كمعرف لمصدر النتائج (أنظر سطر رقم ‪.)22‬‬
‫مرشح الهدف (‪(Intent Filter‬‬
‫مرشح الهدف )‪ (Intent Filter‬هي خصائص يتم كتابتها في ملف الوثيقة )‪ (Manifest File‬التابع لتطبيق ما‬
‫وذلك بهدف تحديد نوع األهداف (‪ (Intents‬التي يمكن للمكون (الفعالية ‪,‬الخدمة أو المنشور) استقبالها‪ .‬على سبيل‬
‫المثال‪ ,‬باإلعالن عن مرشح هدف (‪ (Intent Filter‬لفعالية معينة داخل ملف الوثيقة‪ ,‬فإن التطبيقات األخرى‬
‫المحملة على الجهاز قد تتمكن من تشغيل هذه الفعالية إذا تم إرسال هدف (‪ )Intent‬يوافق مرشح الهدف )‪Intent‬‬
‫‪ . (Filter‬إذا لم يتم تحديد مرشح هدف للفعالية فال يمكن تشغيل هذه الفعالية إال باستخدام هدف صريح )‪Explicit‬‬
‫‪.)Intent‬‬

‫يمكن أن تعد تطبيقك الستقبال أنواع محددة من األهداف )‪ (Intents‬عن طريق اإلعالن عن مرشحات األهداف‬
‫‪ (Intent) Filters‬في ملف الوثيقة )‪ (Manifest File‬باستخدام الخاصية >‪.<intent-filter‬‬
‫كل مرشح هدف )‪ (Intent Filter‬يحدد نوع الهدف (‪ )Intent‬الذي يمكن لمكون التطبيق استقباله بنا ًء على نوع‬
‫اإلجراء المحدد في المرشح ونوع البيانات ‪ data‬والتصنيف ‪ .category‬يقوم النظام بإيصال الهدف (‪ )Intent‬إلى‬
‫مكون تطبيقك فقط إذا توافقت محتويات الهدف مع تفاصيل مرشح الهدف (‪ .(Intent Filter‬على سبيل المثال‪,‬‬
‫يوضح الكود باألسفل جزء من ملف الوثيقة )‪ (Manifest‬والذي يبين مرشح الهدف لفعالية باسم ‪:ShareActivity‬‬
‫>"‪<activity android:name="ShareActivity‬‬
‫>‪<intent-filter‬‬
‫>‪<action android:name="android.intent.action.SEND"/‬‬
‫‪<action‬‬
‫>‪android:name="android.intent.action.SEND_MULTIPLE"/‬‬
‫‪<category‬‬
‫>‪android:name="android.intent.category.DEFAULT"/‬‬
‫>‪<data android:mimeType="text/plain"/‬‬
‫>‪</intent-filter‬‬
‫كما هو موضح‪ ,‬فإن مرشح الهدف في هذا المثال يحتوي على ثالث عناصر‪:‬‬
‫أو‬ ‫‪ACTION_SEND‬‬ ‫اإلجراء الذي تنفذه الفعالية (‪ ,)Action‬وهو في هذا المثال من نوع‬ ‫‪‬‬
‫‪.ACTION_SEND_MULTIPLE‬‬
‫التصنيف ‪ category‬وهو في هذا المثال من نوع ‪ ,default‬وهو التصنيف التلقائي ألي فعالية غير فعالية‬ ‫‪‬‬
‫ابتداء البرنامج والتي تأخذ تصنيف ‪.LAUNCHER‬‬
‫نوع البيانات التي تتلقاها الفعالية من خالل الخاصية ‪( data‬مثال‪.)text/plain :‬‬ ‫‪‬‬
‫ذكرنا مسبقا ً أنه عند تشغيل فعالية باستهدف هدف مضمن )‪ ,)Implicit Intent‬يقوم النظام تلقائيا ً بالبحث عن‬
‫الفعالية المناسبة لتشغيل اإلجراء (‪ )Action‬المحدد في الهدف المضمن )‪ )Implicit Intent‬ضمن كل التطبيقات‬
‫المحملة على النظام‪ .‬إذا توافق محتوى الهدف المرسل (‪ )Intent‬مع تفاصيل مرشح الهدف )‪(Intent Filter‬‬
‫الخاص بأي فعالية‪ ,‬يقوم النظام تلقائيا ً بتشغيلها‪ ,‬أو عرض خيارات في حالة وجود أكثر من فعالية يمكنها استقبال‬
‫الهدف‪.‬‬
‫مالحظة‪ :‬يمكن تحديد أكثر من إجراء داخل مرشح الهدف‪ ,‬مما يعني أن الفعالية يمكن أن تعمل اذا توافق إي إجراء‬
‫معرف في المرشح )‪ (Intent Filter‬مع اإلجراء المحدد في الهدف المرسل )‪.(Intent‬‬
‫يوضح الكود التالي كيفية تشغيل فعالية إرسال رسالة باستخدام هدف مضمن )‪ .(Implicit Intent‬عند إنشاء كائن‬
‫من نوع (‪ ,)Intent‬تم تمرير اإلجراء المطلوب وهو إجراء العرض (‪ ,(ACTION_SEND‬ومن ثم تم تضمين‬
‫البيانات المطلوب عرضها ‪,‬وهي الرسالة المطلوب إرسالها‪ ,‬من خالل الدالة )(‪ .putExtra‬يقوم النظام تلقائياً بتحديد‬

‫الفعالية المناسبة للتشغيل عن طريق مطابقة نوع اإلجراء ونوع البيانات المرسلة مع مرشح الهدف ( ‪Intent‬‬
‫‪ )Filter‬للفعاليات األخرى ‪ .‬في هذه الحالة سيقوم النظام باختيار فعالية يمكنها عرض إرسال الرسائل‪.‬‬
‫;)(‪Intent sendIntent =new Intent‬‬
‫;)‪sendIntent.setAction(Intent.ACTION_SEND‬‬
‫;)‪sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage‬‬
‫;)‪sendIntent.setType(HTTP.PLAIN_TEXT_TYPE‬‬
‫;)‪startActivity(sendIntent‬‬
‫في حالة وجود أكثر من فعالية يمكنها تنفيذ نفس اإلجراء‪ ,‬يقوم النظام بعرض خيارات للمستخدم ليختار منها‬
‫الفعالية التي يريدها‪ ,‬كما هو موضح في الشكل‪:‬‬
‫‪1‬‬
‫شكل ‪ :4-5‬خيارات تشغيل متعددة لإلجراء ‪.ACTION_SEND‬‬

‫في هذا التمرين سيتم تشغيل عدة من الفعاليات )‪ (Activities‬لتنفيذ بعض اإلجراءات )‪ (Actions‬شائعة االستخدام‬
‫مثل تشغيل متصفح االنترنت‪ ,‬االتصال الهاتفي و عرض جهات االتصال ‪ .contacts‬كل ذلك يتم باستخدام هدف‬
‫مضمن )‪ )Implicit Intent‬يحدد فيه اإلجراء (‪ )Action‬المراد تنفيذه‪ .‬سنجرب أيضاً إمكانية تعريف مرشح‬
‫هدف (‪ (Intent Filter‬لفعالية (‪ )Activity‬ضمن تطبيق تم إنشاؤه مسبقاً‪.‬‬
‫شكل ‪ 4-6‬يوضح واجهة التطبيق وهي مكونة من مجموعة من األزرار‪ ,‬حيث أن كل زر مسئول عن تنفيذ إجراء‬
‫معين‪.‬‬
‫‪Intents and Intent Filters, Android Developer, http://developer.android.com/guide/components/intents- 1‬‬

‫‪filters.html‬‬

.4-3 ‫ واجهة التطبيق الخاص بتمرين‬:4-6 ‫شكل‬

:‫تصميم الواجهة الخاصة بهذا التصميم موضح باألسفل‬
<RelativeLayout
tools:context=".MainActivity" >
<Button
android:id="@+id/openWebpageButton"
android:layout_alignParentTop="true"
android:text="Open UCAS Website"
android:onClick="openUCAS" />
<Button
android:id="@+id/callButton"
android:layout_below="@+id/openWebpageButton"
android:text="Call Friend"
android:onClick="callFriend"
/>
<Button
android:id="@+id/contactsButton"
android:layout_below="@+id/callButton"
android:text="Open Contacts"
android:onClick="openContacts"
/>
<Button
android:id="@+id/openActivityButton"
android:layout_below="@+id/contactsButton"
android:text="Open User Activity"
android:onClick="openActivity" />
<Button
android:id="@+id/lauchAppButton"
android:layout_below="@+id/openActivityButton"
android:text="Launch App"
android:onClick="lauchApp" />
</RelativeLayout>
‫أحد اإلجراءات التي يشتمل عليها التطبيق يتضمن فتح قائمة جهات االتصال )‪ (Contancts‬من خالل النقر على‬
‫"‪ ,"Open Contacts‬وهو ما يتطلب إذن ‪ .permission‬لذلك‪ ,‬يتم إضافة اإلذن التالي إلى ملف الوثيقة‬
‫‪:Manifest‬‬
‫>‪<manifest ...‬‬
‫>‪android:name="android.permission.CALL_PHONE" /‬‬
‫‪...‬‬
‫أحد اإلجراءات التي يتم تنفيذها (عند النقر على الزر ”‪ )“Open User Activity‬هو تشغيل فعالية (‪)Activity‬‬
‫موجودة ضمن تمرين ‪ 4-2‬في الوحدة الثالثة (أنظر الشكل ‪ .)2-2‬حتى نتمكن من تشغيل فعالية ضمن تطبيق آخر‬
‫(الفعالية ‪ ,)FreindsListActivity‬يجب أن يتم ذلك باستخدام هدف مضمن )‪( )Implicit Intent‬ال يمكن‬
‫استخدام هدف صريح ‪ )Explicit Intent‬وذلك ألن الفئة (‪ )class‬الخاصة بالفعالية الهدف ليست في نطاق التطبيق‬
‫الحالي)‪ .‬إلنشاء هدف مضمن )‪ ,)Implicit Intent‬البد من تعريف إجراء (‪ )Action‬للفعالية المراد تشغيلها‪.‬‬
‫لعمل ذلك‪ ,‬يجب إضافة (‪ (Intent Filter‬للفعالية المراد تشغيلها ضمن ملف الوثيقة )‪ (Manifest‬الخاص‬
‫بالتمرين ‪ 4-2‬كما هو موضح‪:‬‬
‫…‬
‫"‪<activity android:name=".FriendsListActivity‬‬
‫> "‪android:label="@string/title_activity_friends_list‬‬
‫‪<action‬‬
‫>‪android:name="ps.edu.ucas.example.FriendsListActivity" /‬‬
‫"‪<category android:name="android.intent.category.DEFAULT‬‬
‫>‪/‬‬
‫…‬
‫الحظ أن اسم اإلجراء المستخدم ضمن الخاصية ‪ android:name‬هو مسار الفعالية (‪ .)Activity‬يمكن استخدام‬
‫أي اسم بديل بشرط عدم تطابقه مع اسماء اإلجراءات المستخدمة في فعاليات أخرى‪.‬‬
‫الكود التالي يوضح الفعالية (‪ )MainActivity‬والتي من خاللها يتم تنفيذ كل اإلجراءات المطلوبة‪.‬‬
‫‪1:‬‬ ‫{ ‪public class MainActivity extends Activity‬‬
‫‪2:‬‬
‫‪4:‬‬ ‫{ )‪protected void onCreate(Bundle savedInstanceState‬‬

7: }
8:
9: public void openUCAS(View view){
10: Intent intent = new Intent(Intent.ACTION_VIEW);
11: intent.setData(Uri.parse("http://www.ucas.edu.ps"));
12: this.startActivity(intent);
13: }
14:
15: public void callFriend(View view){
16: Intent intent = new Intent(Intent.ACTION_CALL);
17: intent.setData(Uri.parse("tel:0591234567"));
19: }
20:
21: public void openContacts(View view){
23: intent.setData(Uri.parse("content://contacts
24: /people/"));
26: }
27:
28: public void openActivity(View view){
30: Intent("ps.edu.ucas.example.FriendsListActivity");
32: }
33: public void lauchApp(View view){
34: Intent intent = new Intent(Intent.ACTION_MAIN);
35: intent.setComponent(new
36: ComponentName("ps.edu.ucas.example","ps.edu.ucas.
37: example.MainActivity");
38: intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
40: }
41:}
:‫في ما يلي يتم توضيح طريقة تنفيذ كل إجراء‬
‫الدالة )(‪( openUCAS‬أنظر الكود من سطر ‪ 9‬إلى ‪ )02‬يتم تشغيل متصفح إنترنت ‪ Web browser‬لفتح‬ ‫‪‬‬
‫موقع االنترنت الخاص بالكلية الجامعية‪ .‬يتم إنشاء هدف (‪ )Intent‬و تحديد اإلجراء (‪(ACTION_VIEW‬‬
‫وتمرير عنوان موقع الكلية عن طريق الدالة )(‪ .setData‬في حالة وجود أكثر من متصفح تظهر قائمة لتمكين‬
‫المستخدم من اختيار المتصفح المطلوب‪.‬‬
‫الدالة )(‪( callFriend‬أنظر الكود من سطر ‪ 05‬إلى ‪ )09‬يتم فيها إجراء اتصال هاتفي برقم محدد‪ .‬يتم إنشاء‬ ‫‪‬‬
‫هدف (‪ )Intent‬وتحديد اإلجراء (‪ (ACTION_CALL‬وتمرير الرقم المطلوب االتصال به عن طريق الدالة‬
‫)(‪ .setData‬الحظ أن هذا اإلجراء يتطلب إضافة إذن اتصال في ملف الوثيقة )‪.(Manifest‬‬
‫الدالة )(‪( openContacts‬أنظر الكود من سطر ‪ 21‬إلى ‪ )26‬يتم فيها فتح قائمة جهات االتصال ‪.Contacts‬‬ ‫‪‬‬
‫يتم إنشاء هدف (‪ )Intent‬و تحديد اإلجراء (‪ (ACTION_VIEW‬وتحديد القائمة المراد فتحها (مثل‪:‬‬
‫‪ )content://contacts/people/‬عن طريق الدالة )(‪ .setData‬الحظ أن اإلجراء (‪(ACTION_VIEW‬‬
‫يتطابق مع اإلجراء المستخدم لفتح متصفح اإلنترنت‪ .‬تذكر أنه في حالة تطابق اإلجراء بين فعاليات مختلفة‪,‬‬
‫فإن النظام يستخدم البيانات األخرى ضمن الهدف (‪ )Intent‬لتحديد الفعالية المطلوب تشغيلها‪ .‬في هذه الحالة‬
‫‪,‬الفعالية الخاصة بفتح المتصفح لها نفس الهدف (‪ (ACTION_VIEW‬الخاص بفتح قائمة جهات االتصال‬
‫‪ , Contacts‬ولكن نوع البيانات المرسلة ضمن الهدف مختلف (في الحالة األولي يستخدم البروتوكول ‪http://‬‬
‫بينما في الحالة الثانية يستخدم البروتوكول ‪ .)content://‬لذلك‪ ,‬يستخدم النظام نوع البيانات للتحديد اإلجراء‬
‫الصحيح‪.‬‬
‫الدالة )(‪( openActivity‬أنظر الكود من سطر ‪ 38‬إلى ‪ )23‬يتم من خاللها تشغيل الفعالية‬ ‫‪‬‬
‫‪ FriendsListActivity‬الموجودة ضمن تطبيق سابق تم إنشاؤه‪ .‬الحظ أن اإلجراء المستخدم يطابق اإلجراء‬
‫المحدد في مرشح الهدف (‪ )Intent Filter‬الذي تم تعريفه مسبقا ضمن ملف الوثيقة )‪ (Manifest‬الخاص‬
‫بالتطبيق اآلخر‪.‬‬
‫الدالة )(‪( launchApp‬أنظر الكود من سطر ‪ 22‬إلى ‪ )21‬توضح طريقة تشغيل تطبيق آخر‪ .‬في هذه الحالة‬ ‫‪‬‬
‫فإن اإلجراء المستخدم يكون من نوع (‪ (ACTION_MAIN‬وهو يعني تشغيل فعالية رئيسية (تذكر أن كل‬
‫تطبيق له فعالية رئيسية واحدة فقط)‪ .‬الدالة ‪ setComponent‬تحديد المجلد ‪ package‬الخاص بالتطبيق‬
‫المطلوب تشغيله وكذلك مسار الفئة (‪ (classpath‬الخاصة بالفعالية الرئيسية للتطبيق‪ .‬األمر‬
‫)‪ setFlags(Intent.FLAG_ACTIVITY_NEW_TASK‬يعني أن الفعالية سيتم تشغيلها كتطبيق‬
‫مستقل غير مرتبط بالتطبيق الحالي‪.‬‬

‫أسئلة على الوحدة الرابعة‬

‫‪ .0‬ما الفرق بين الهدف الصريح )‪ (Explicit Intent‬والمضمن )‪(Implicit Intent‬؟ ومتى يستخدم كل منهما‪.‬‬
‫‪ .3‬ما هي المكونات األساسية التي يتم تعريفها داخل مرشح الهدف )‪(Intent Filter‬؟‬
‫‪ .2‬ماذا يحدث إذا كان هناك فعاليتان )‪ (Activities‬لهما نفس نوع الحدث )‪ (Action‬داخل مرشح الهدف‬
‫)‪(Intent Filter‬؟‬
‫‪ .2‬قم ببناء تطبيق مكون من فعاليتين )‪ (Activities‬كما هو موضح بالشكل‪ .‬الفعالية الرئيسية على اليسار تحتوي‬
‫على زر "‪ "Choices‬عند النقر عليه يتم تشغيل الفعالية على اليمين‪ .‬يقوم المستخدم من خالل الفعالية الجديدة‬
‫باختيار هوايته المفضلة من ضمن مجموعة من الخيارات األخرى (يسمح باختيار واحد فقط)‪ .‬عند النقر على‬
‫زر "‪ " OK‬ضمن الفعالية الجديدة يتم إرجاع اإلختيار إلى الفعالية الرئيسية وعرضه ضمن عنصر عرض‬
‫)‪ .(TextView‬عند النقر على زر ”‪ “Reset‬يتم حذف النص المكتوب ضمن عنصر العرض‬
‫(‪.)TextView‬‬

‫الوحدة الخامسة‪:‬‬
‫القوائم وشريط العمل‬
‫)‪(Menus and Action Bar‬‬
‫‪ ‬أنواع القوائم المختلفة في تطبيق األندرويد (قائمة الخيارات ‪ ,Options Menu‬قائمة السياق‬
‫‪ ,Content Menu‬والقائمة المنبقثة) واستخداماتها‪.‬‬
‫‪ ‬إنشاء القوائم المختلفة برمجياً وربطها بالتطبيق‬
‫‪ ‬تهيئة شريط العمل (‪ )Action Bar‬والتحكم به برمجياً‪.‬‬
‫‪ ‬إنشاء درج التصفح (‪ )Navigation Drawer‬وربطه بالتطبيق‬
‫القوائم ‪ Menus‬من المكونات شائعة االستخدام في تصميم واجهات التطبيقات‪ .‬تتطرق هذه الوحدة إلى األنواع‬
‫المختلفة للقوائم وطريقة إنشائها‪.‬‬
‫قائمة الخيارات )‪ (Options Menu‬وشريط المهام )‪(Action Bar‬‬
‫تستخدم قائمة الخيارات ‪ Options Menu‬عادةً للوصول إلى اإلجراءات العامة التي يتطلب الوصول إليها كثيراً‬
‫أثناء استخدام التطبيق مثل إجراء البحث ‪ Search‬واإلعدادات ‪( .Settings‬ابتدا ًء من اصدار أندرويد ‪API 3.0‬‬
‫)‪ level 11‬يتم تضمين قائمة الخيارات ضمن شريط العمل )‪ .((Action Bar‬يقوم النظام تلقائياً بإضافة عناصر‬
‫القائمة الخيارات )‪ (Options Menu‬إلى ملحق شريط العمل المسمى )‪( (Action Overflow‬أنظر شكل ‪.)5.1‬‬
‫ال تظهر عناصر القائمة تلقائياً‪ ,‬حيث يمكن عرضها بالنقر على الإليقونة على يمين شريط العمل‪ .‬يمكن أيضاً إظهار‬
‫قائمة الخيارات بالنقر على زر "‪ "Menu‬إذا كان الجهاز يوفر مثل هذا الزر‪.‬‬
‫إلنشاء قائمة اختيارات ‪ Options Menu‬لفعالية معينة )‪ ,)Activity‬يمكن في البداية تصميم محتويات القائمة‬
‫خارجيا ً باستخدام ‪ .XML‬على الرغم من إمكانية بناء محتويات القائمة برمجياً‪ ,‬إال أنه يفضل تصميم القائمة‬
‫باستخدام ‪ XML‬وحفظها في مجلد المصادر‪ .‬يمكن بعد ذلك إنشاء القائمة عند تشغيل الفعالية عن طريق الدالة‬
‫)(‪ .Inflater.inflate‬إنشاء القائمة في ملف ‪ XML‬يتيح إمكانية فصل تصميم القائمة عن عمل التطبيق‪ .‬كما يتيح‬
‫عمل إعدادات أو تصميمات مختلفة للقائمة بنا ًء على إعدادات الجهاز المختلفة مثل حجم شاشة العرض‪ .‬كما ذكرنا‬
‫في الوحدة الثالثة يمكن مواءمة التطبيق مع اإلعدادات المختلفة عن طريق حفظ وترتيب الملفات الموجودة في‬
‫مجلدات المصادر‪.‬‬
‫لتصميم قائمة خيارات جديدة‪ ,‬قم بإنشاء ملف ‪ XML‬جديد في المجلد ‪ res/menu/‬وقم ببناء القائمة داخله‪ .‬الملف‬
‫التالي ‪ my_menu.xml‬يوضح مثال لتصميم قائمة خيارات‪:‬‬


<menu
xmlns:android="http://schemas.android.com/apk/res/android">
<item android:id="@+id/ucas_homepage"
android:icon="@drawable/ucas_logo"
android:title="@string/ucas_homepage"
android:showAsAction="ifRoom"/>
<item android:id="@+id/help"
android:icon="@drawable/ic_help"
android:title="@string/help" />
</menu>
Action Overflow
(OptionsMenu) ‫ قائمة الخيارات‬:5-1 ‫شكل‬

‫< والتي تحتوي على عنصر أو أكثر‬menu> ‫ تصميم القائمة كاملةً يكون ضمن الخاصية‬,‫كما هو موضح في المثال‬
‫< تستخدم لبناء عنصر القائمة‬item> ‫ الخاصية‬.‫< والتي تمثل عناصر القائمة‬item> ‫من الخصائص‬
.)MenuItem(
:‫( باستخدام الخصائص التالية‬MenuItem) ‫< يتم تعريف شكل عنصر القائمة‬item> ‫من داخل الخاصية‬
‫‪ : android:id‬وهو يحدد رقم معرف )‪ (ID‬خاص بعنصر القائمة )‪ .(MenuItem‬الرقم المعرف )‪ (ID‬يم ّكن‬ ‫‪‬‬
‫التطبيق من معرفة عنصر القائمة (‪ )MenuItem‬الذي تم النقر عليه‪ ,‬حيث كل عنصر قائمة له معرف خاص‬
‫به‪.‬‬
‫‪ : android:icon‬وهو يضاف إختياريا لتحديد صورة األيقونة الخاصة بعنصر القائمة‪ .‬يجب أن تكون هذه‬ ‫‪‬‬
‫الصورة ضمن مجلدات ‪.drawable‬‬
‫‪ :android:title‬وهو يحدد النص المعروض في العنصر‪.‬‬ ‫‪‬‬
‫‪ :android:showAsAction‬وهو يحدد كيف ومتى يظهر عنصر القائمة ضمن شريط العمل ‪(Action‬‬ ‫‪‬‬
‫)‪ .Bar‬هناك قيم مختلفة يمكن تحديدها لهذه الخاصية مثل القيمة "‪ "ifRoom‬وذلك إلظهار عنصر القائمة‬
‫ضمن شريط العمل إذا كان هناك متسع به‪ ,‬وكذلك القيمة "‪ "never‬لعدم إظهاره ضمن شريط العمل‪ ,‬والقيمة‬
‫"‪ "always‬إلظهاره دائما ً ضمن شريط العمل‬
‫تمثل هذه أهم الخصائص التي ينصح باستخدامها‪ ,‬ولكن هناك العديد من الخصائص األخرى التي لن نتطرق لها في‬
‫هذا الكتاب‪.‬‬
‫يمكن أيضا ً إضافة قائمة فرعية (‪ )submenu‬داخل أي عنصر في القائمة )‪ (Menu‬وذلك بإضافة الخاصية‬
‫>‪ <menu‬ضمن الخاصية >‪ .<item‬القوائم الفرعية )‪ (submenus‬مفيدة في حالة تعدد وتفرع اإلجراءات التي‬
‫تنفذ من خالل القائمة أو لترتيب عناصر القائمة ضمن مجموعات‪ .‬المثال التالي يوضح إضافة قائمة فرعية إلى‬
‫عنصر قائمة‪:‬‬
‫>?"‪<?xml version="1.0" encoding="utf-8‬‬
‫‪<menu‬‬
‫>"‪xmlns:android="http://schemas.android.com/apk/res/android‬‬
‫"‪<item android:id="@+id/file‬‬
‫> "‪android:title="@string/file‬‬
‫>‪
</RelativeLayout>
Navigation Drawer, Android Developers, https://developer.android.com/design/patterns/navigation - 1

drawer.html
‫‪<ListView‬‬
‫"‪android:id="@+id/left_drawer‬‬
‫"‪android:layout_gravity="start‬‬
‫"‪android:layout_width="250dp‬‬
‫"‪android:choiceMode="singleChoice‬‬
‫"‪android:divider="@android:color/transparent‬‬
‫"‪android:dividerHeight="0dp‬‬
‫>‪android:background="#111"/‬‬
‫>‪</android.support.v4.widget.DrawerLayout‬‬
‫مالحظة‪ :‬يمكن إدراج المحتوى الرئيسي )‪ (Main Content View‬ضمن تصميم خارجي يسمى بالقطعة‬
‫)‪ (Fragment‬ومن ثم إدراج القطعة )‪ (Fragment‬داخل التصميم ‪ .DrawerLayout‬سيتم التطرق للقطع‬
‫)‪ (Fragments‬في الوحدة التاسعة‪.‬‬

‫في هذا التمرين سنقوم ببناء تطبيق معلوماتي عن المساجد الشهيرة في فلسطين وواجهته موضحة في شكل ‪.5-6‬‬
‫يستخدم التطبيق درج التصفح )‪ (Navigation Drawer‬لعرض قائمة بالمساجد‪ ,‬وعند النقر على اسم مسجد تظهر‬
‫تفاصيله ضمن الواجهة الرئيسية‪ .‬درج التصفح يكون مخفياً‪ ,‬ويتم عرضه عن طريق السحب من اليمين لليسار‪.‬‬
‫شكل ‪ :5-6‬واجهة التطبيق الخاص بتمرين ‪.5-2‬‬

‫ ضمن المصادر تحتوي أسماء‬mosques_array ‫ باسم‬string-array ‫نقوم في البداية بإنشاء مصفوفة نصوص‬
‫ سيتم الحقاً الوصول‬.(Navigation Drawer) ‫( داخل درج التصفح‬ListView) ‫المساجد لعرضها ضمن قائمة‬
.(ListView) ‫لهذه المصفوفة برمجيا ً لتعبئة القائمة‬
<resources>
<string name="app_name">Navigation Drawer
Example</string>
<string-array name="mosques_array">
<item>‫<المكي الحرم‬/item>
<item>‫<النبوي المسجد‬/item>
<item>‫<األقصى المسجد‬/item>
<item>‫<الصخرة قبة‬/item>
<item>‫<اإلبراهيمي المسجد‬/item>
<item>‫<قباء مسجد‬/item>
<item>‫<العمري الجامع‬/item>
</string-array>
</resources>
‫فيما يلي نعرض تصميم الواجهة الرئيسية والتي تتكون من المحتوى الرئيسيي (تفاصيل المسجد) و درج التصفح‬
:(Navigation Drawer
//activity_main.xml
<android.support.v4.widget.DrawerLayout
android:id="@+id/drawer_layout"
android:theme="@android:style/Theme.WithActionBar"
>
<ScrollView android:layout_width="fill_parent"
android:layout_height="fill_parent">
<RelativeLayout
android:paddingTop="@dimen/activity_vertical_margin">
<ImageView
android:id="@+id/imageView1"
android:src="@drawable/ic_launcher" />
<TextView
android:id="@+id/textView1"
android:layout_alignRight="@+id/imageView1"
android:layout_below="@+id/imageView1"
android:layout_gravity="center_vertical|right"
</RelativeLayout>
</ScrollView>
<ListView
android:id="@+id/right_drawer"
android:layout_gravity="end"
android:choiceMode="singleChoice"
android:divider="@android:color/transparent"
android:dividerHeight="0dp"
android:background="#111"/>
</android.support.v4.widget.DrawerLayout>
ScrollView ‫ الجزء األول هو التصميم‬:‫( مكون من جزئين‬DrawerLayout) ‫الحظ أن التصميم السابق‬
‫ العنصر‬.TextView ‫ و‬ImageView ‫ يضم عناصر العرض‬RelativeView ‫ويحتوي داخله على تصميم‬
‫ الجزء‬.‫ يعرض معلومات عن المسجد‬TextView ‫ يستخدم لعرض صورة المسجد بينما العنصر‬ImageView
‫ وذلك حتى‬android:layout_gravity=”end” ‫( والتي تستخدم الخاصية‬ListView) ‫الثاني هو قائمة العرض‬
.‫يتم اخفاؤها في يمين الشاشة‬
‫ والتي يتم من خاللها إنشاء الواجهة ودرج التصفح ومعالجة األحداث‬MainActivity ‫الكود التالي خاص بالفعالية‬
:‫المختلفة‬
2: private DrawerLayout mDrawerLayout;
3: private ListView mDrawerList;
4: private ImageView mosqueImage;
5: private TextView mosqueDetails;
6: private String[] mosqueNames;
7:
8: @Override
9: protected void onCreate(Bundle savedInstanceState)
10: {
13:
14: mosqueNames =
15: getResources().getStringArray(R.array.mosques_array);
16: mDrawerLayout = (DrawerLayout)
17: findViewById(R.id.drawer_layout);
18: mosqueImage = (ImageView)
19: findViewById(R.id.imageView1);
20: mosqueDetails = (TextView)
21: findViewById(R.id.textView1);
22: mDrawerList = (ListView)
23: findViewById(R.id.right_drawer);
24: mDrawerList.setAdapter(new
25: ArrayAdapter<String>(this, R.layout.drawer_list_item,
26: mosqueNames));
27: mDrawerList.setOnItemClickListener(new
28: ListView.OnItemClickListener() {
29: @Override
31: parent, View view, int position, long id) {
32: mDrawerList.setItemChecked(position, true);
33: String mosqueName = mosqueNames[position];
34: setTitle(mosqueName);
35: if(mosqueName.equalsIgnoreCase("‫{))"المسجد األقصى‬
36: mosqueImage.setImageResource(R.drawable.aqsa);
37: mosqueDetails.setText("...");
‫‪38:‬‬ ‫{))"قبة الصخرة"(‪}else if(mosqueName.equalsIgnoreCase‬‬

‫‪39:‬‬ ‫;)‪mosqueImage.setImageResource(R.drawable.dome‬‬
‫‪40:‬‬ ‫;)"‪mosqueDetails.setText("...‬‬
‫‪41:‬‬ ‫}‬
‫‪42:‬‬ ‫;)‪mDrawerLayout.closeDrawer(mDrawerList‬‬
‫} ‪43:‬‬
‫;)}‪44:‬‬
‫‪45:‬‬ ‫‪ActionBarDrawerToggle mDrawerToggle = new‬‬
‫(‪46: ActionBarDrawerToggle‬‬
‫‪47:‬‬ ‫‪this,‬‬
‫‪48:‬‬ ‫‪mDrawerLayout,‬‬
‫‪49:‬‬ ‫‪R.drawable.ic_drawer,‬‬
‫‪50:‬‬ ‫‪R.string.drawer_open‬‬
‫‪51:‬‬ ‫{ )‬
‫‪52:‬‬ ‫}{ )‪public void onDrawerClosed(View view‬‬
‫‪53:‬‬
‫‪54:‬‬ ‫}{)‪public void onDrawerOpened(View drawerView‬‬
‫‪55:‬‬ ‫;}‬
‫;)‪56: mDrawerLayout.setDrawerListener(mDrawerToggle‬‬
‫‪57:‬‬ ‫}‬
‫}‪58:‬‬
‫في الدالة )(‪ onCreate‬يتم الوصول لمصفوفة األسماء ‪ mosques_array‬عن طريق الكود التالي‪:‬‬
‫;)‪( mosqueNames = getResources().getStringArray(R.array.mosques_array‬أنظر سطر رقم‬
‫‪ .)02‬ومن ثم يتم تعبئة القائمة ‪ mDrawerList‬عن طريق استخدام ‪( ArrayAdapter‬أنظر سطر رقم ‪ .)32‬بعد‬
‫ذلك يتم االستماع لحدث النقر على عناصر القائمة باستخدام الدالة )(‪ setOnItemClickListener‬وكتابة الدالة‬
‫)(‪( onItemClicked‬أنظر الكود من سطر ‪ 37‬إلى ‪ .)21‬اإلجراء الذي يتم تنفيذه عند النقر على القائمة هو تغيير‬
‫عنوان الفعالية بتنفيذ الدالة )(‪ setTitle‬وتغيير محتوى ‪ ImageView‬و ‪ TextView‬لعرض معلومات عن‬
‫المسجد الذي تم اختياره (أنظر الكود من سطر ‪ 23‬إلى ‪ .)41‬كذلك يتم إخفاء درج التصفح ‪(Navigation‬‬
‫)‪ Drawer‬عن طريق الدالة ;)(‪( DrawerLayout.closeDrawer‬سطر رقم ‪.)23‬‬
‫يمكن كذلك االستماع ألحداث فتح وإغالق درج التصفح )‪ (Navigation Drawer‬عن طريق الدالة‬
‫)(‪ DrawerLayout.setDrawerListener‬والتي يمرر لها كائن من نوع ‪.ActionBarDrawerToggle‬‬
‫اإلجراء المراد تنفيذه عن إغالق أو فتح درج التصفح يتم كتابته في الدالتين )(‪ onDrawerClose‬و‬
‫)(‪ onDrawerOpened‬على الترتيب‪ .‬الكود في األعلى (من سطر رقم ‪ 25‬إلى ‪ )56‬يوضح هذه الخطوة بالرغم‬
‫من أنه لم يتم استخدامها لتنفيذ أي إجراء في هذا التطبيق‪.‬‬

‫أسئلة على الوحدة الخامسة‬

‫‪ .0‬ما الفرق بين قائمة السياق )‪ (Context Menu‬والقائمة المنبثقة )‪(Popup Menu‬؟ ومتى تستخدم كل منهما؟‬
‫‪ .3‬قم بتعديل تمرين ‪ 3-4‬والذي يعرض قائمة )‪ (ListView‬تضم أسماء وصور مجموعة من األصدقاء‪ .‬عند‬
‫الضغط لفترة على اسم صديق في القائمة يتم عرض قائمة سياق )‪ (Context Menu‬تضمن زر حذف‬
‫"‪ ."Delete‬عند النقر على زر الحذف يتم حذف السطر الخاص بالصديق من القائمة )‪.(ListView‬‬
‫‪ .2‬قم ببناء التطبيق الموضح بالشكل والذي يستخدم عنصر عرض من نوع ‪ WebView‬كمحتوى رئيسي ثابت‬
‫باإلضافة إلى درج تصفح )‪ (Navigation Drawer‬يضم قائمة بأسماء بعض المواقع االلكترونية الشهيرة‬
‫مثل ‪ Facebook, Google, Apple‬وغيرها‪ .‬درج التصفح يظهر عند السحب من اليسار لليمين‪ ,‬و عند النقر‬
‫على أي منها‪ ,‬يتم إخفاء درج التصفح ومن ثم فتح الموقع في عنصر العرض ‪.WebView‬‬

‫الوحدة السادسة‪:‬‬
‫استدامة البيانات في نظام أندرويد‬
‫)‪(Data Persistence in Android‬‬
‫‪ ‬الطرق المختلفة لحفظ البيانات الخاصة بتطبيقات أندرويد ومتى يجب استخدام كل منها‪.‬‬
‫‪ ‬إنشاء تطبيقات ترتبط بقواعد البيانات‪.‬‬
‫‪ ‬تنفيذ إجراءات مختلفة على قواعد البيانات وعرض النتائج في واجهة المستخدم‪.‬‬
‫لدراسة هذه الوحدة البد من اإللمام بمبادئ التعامل مع قواعد البيانات تعليمات ‪ SQL‬المختلفة‪ .‬كذلك البد من اإللمام‬
‫بأساسيات القراءة والكتابة للملفات بلغة جافا‪.‬‬
‫يوفر نظام أندرويد أكثر من طريقة لحفظ البيانات الخاصة بالتطبيقات‪ .‬أهم هذه الطرق تشمل ما يلي‪:‬‬
‫التفضيالت المشتركة )‪ :(Shared Preferences‬وتشمل حفظ بيانات أساسية بمفاتيح محددة ‪(key-‬‬ ‫‪‬‬
‫)‪.value pairs‬‬
‫الذاكرة الداخلية )‪ (Internal Storage‬وفيها يتم تخزين البيانات في الذاكرة الداخلية للجهاز‪.‬‬ ‫‪‬‬
‫الذاكرة الخارجية )‪ (External Storage‬وفيها يتم تخزين البيانات في ذاكرة خارجية مشتركة بين‬ ‫‪‬‬
‫التطبيقات‪.‬‬
‫قواعد البيانات )‪ :(SQLite Databases‬وفيها يتم تخزين البيانات في قواعد بيانات خاصة بالتطبيق‪.‬‬ ‫‪‬‬
‫استخدام أي من هذه الطرق يعتمد على احتياجات التطبيق مثل ما إذا كانت البيانات المراد حفظها خاصة بالتطبيق أو‬
‫يمكن الوصول إليها من تطبيقات أخ رى‪ ,‬وكذلك المساحة المطلوبة لتخزين البيانات‪ .‬سيتم فيما يلي تفصيل كل من‬
‫هذه الطرق‪:‬‬
‫التفضيالت المشتركة )‪(Shared Preferences‬‬
‫التفضيالت المشتركة )‪ (SharedPreferences‬هي مكون يوفر حفظ واسترجاع بيانات أساسية بسيطة‪ .‬كل‬
‫معلومة يتم حفظها يجب أن تكون على شكل مفتاح وقيمة )‪ (key-value‬بحيث يحدد المفتاح )‪ (key‬اسم مميز ليتم‬
‫استعادة القيمة )‪ (value‬فيما بعد عن طريقه‪ .‬يمكن استخدام التفضيالت المشتركة لحفظ بيانات من األنواع البدائية‬
‫)‪ (primitive types‬وتشمل‪ .booleans, floats, ints, longs, and Strings :‬يتم االحتفاظ بالبيانات المخزنة‬
‫من تطبيق ما في التفضيالت المشتركة حتى بعد إغالق هذا التطبيق‪.‬‬
‫للوصول إلى الكائن الخاص بالتفضيالت المشتركة واستخدامه‪ ,‬يمكن استخدام واحدة من إحدى دالتين‪:‬‬

‫ إلنشاء ملف‬.‫ استخدم هذه الدالة إذا أردت انشاء أكثر من ملف لحفظ البيانات‬: getSharedPreferences() 
.getSharedPreferences() ‫تفضيالت جديد يتم تمرير اسم جديد من خالل الدالة‬
‫ وال يتم تمرير أي‬,‫ في هذه الحالة يتم استخدام ملف واحد لكل فعالية لحفظ التفضيالت‬: getPreferences() 
.‫اسم لهذه الدالة‬
:‫ولكتابة بيانات إلى التفضيالت المشتركة يجب القيام بالخطوات التالية‬
‫ والذي يتم من خالله‬SharedPreferences.Editor ‫ والتي تقوم بإرجاع كائن من نوع‬edit() ‫ تنفيذ الدالة‬.0
.‫الكتابة‬
.putBoolean(), putString(), putInt() :‫ أضف البيانات عن طريق تنفيذ مهام مثل‬.3
.commit() ‫ إعتماد تنفيذ عملية حفظ البيات المدخلة عن طريق تنفيذ الدالة‬.2
‫ في التفضيالت المشتركة قبل‬boolean ‫ من نوع‬mSilentMode ‫المثال التالي يوضح كيفية حفظ متغير باسم‬
:‫ ثم يتم استرجاع هذه القيمة عند تشغيل الفعالية مرة أخرى‬,‫إنهاء الفعالية مباشرة‬
public class Example extends Activity{
public static final String PREFS_NAME ="MyPrefsFile";
private Boolean mSilentMode;
@Override
protectedvoid onCreate(Bundle state){
super.onCreate(state);
...
// Restore preferences
SharedPreferences settings =
getSharedPreferences(PREFS_NAME,0);
mSilentMode =
settings.getBoolean("silentMode",false);
setSilent(mSilentMode); // Do something with silent
}
@Override
protectedvoid onStop(){
super.onStop();
// We need an Editor object to make preference

changes.
SharedPreferences settings =
‫;)‪getSharedPreferences(PREFS_NAME,0‬‬
‫;)(‪SharedPreferences.Editor editor = settings.edit‬‬
‫;)‪editor.putBoolean("silentMode", mSilentMode‬‬
‫!‪// Commit the edits‬‬

‫;)(‪editor.commit‬‬
‫}‬
‫}‬
‫‪ .‬أنظر الدالة )(‪ onStop‬والحظ كيف تم تطبيق الخطوات في األعلى لحفظ قيمة المتغير ‪ mSilentMode‬حيث تم‬
‫استخدام المفتاح "‪ "silentMode‬كمعرف‪ .‬الحظ أن ملف التفضيالت محدد باسم ‪ MyPrefsFile‬والذي تم تمريره‬
‫للدالة )(‪ . getSharedPreferences‬عند تشغيل الفعالية مرة أخرى‪ ,‬يتم استرجاع البيانات من التفضيالت‬
‫المشتركة أثناء تنفيذ الدالة )(‪ .onCreate‬الحظ أنه تم الرجوع إلى نفس الملف والذي اسمه ‪.MyPrefsFile‬‬
‫مالحظة‪ :‬عند تشغيل الفعالية ألول مرة لن يكون هناك بيانات مخزنة خاصة بالفعالية‪ .‬في هذه الحالة سيأخذ‬
‫المتغيرالقيمة االفتراضية وهي ‪ false‬والتي تم تحديدها في المدخل الثاني للدالة ‪getBoolean("silentMode",‬‬
‫)‪.false‬‬
‫الذاكرة الداخلية )‪(Internal Storage‬‬
‫يمكن تخزين البيانات مباشرةً في الذاكرة الداخلية للجهاز‪ ,‬وتكون البيانات المخزنة خاصة بالتطبيق الذي تم التخزين‬
‫من خالله وال يمكن للتطبيقات األخرى الوصول لهذه البيانات‪ .‬عند حذف التطبيق تحذف البيانات المتعلقة به تلقائياً‪.‬‬
‫إلنشاء وتخزين ملف في الذاكرة الداخلية يمكن استعمال الخطوات التالية‪:‬‬
‫‪ .0‬نفذ الدالة )(‪ openFileOutput‬ومرر لها اسم الملف المراد انشاؤه وتخزينه ووضع الوصول ‪Operating‬‬
‫‪ .mode‬تقوم هذه الدالة بإنشاء الملف وإرجاع كائن من نوع ‪ FileOutputStream‬والذي من خالله يتم‬
‫الكتابة إلى الملف‪.‬‬
‫‪ .3‬نظراً ألن ‪ FileOutputStream‬يستخدم لكتابة البيانات بالصيغة األولية ‪ ,Bytes‬و حتى تتمكن من كتابة أي‬
‫نص‪ ,‬أنشي كائن من نوع ‪ PrintWriter‬ومرر له الكائن من نوع ‪.FileOutputStream‬‬
‫‪ .2‬اكتب إلى الملف باستخدام الدالة )(‪.print‬‬
‫‪ .2‬أغلق الكائنات من نوع‪ FileOutputStream‬و ‪ PrintWriter‬ذلك حتى ال يبقى الملف مفتوحاً بعد االنتهاء‬
‫منه‪.‬‬
‫هذه الخطوات موضحة في الكود التالي‪:‬‬

‫;"‪String fileName ="hello_file‬‬

‫;"!‪String string="hello world‬‬
‫= ‪FileOutputStream fos‬‬
‫;)‪openFileOutput(fileName,Context.MODE_PRIVATE‬‬
‫;)‪PrintWriter pr = new PrintWriter(fos‬‬
‫;)‪pr.print(string‬‬
‫;)(‪pr.close‬‬
‫;)(‪fos.close‬‬
‫الحظ أن وضع الوصول ‪ MODE_PRIVATE‬يعني أن الوصول للملف خاص بالتطبيق الحالي فقط‪.‬‬
‫لقراءة ملف سبق تخزينه في الذاكرة الداخلية يمكن اتباع الخطوات التالية‪:‬‬
‫‪ .0‬نفذ الدالة )(‪ openFileInput‬ومرر لها اسم الملف المراد فتحه‪ .‬هذه الدالة تقوم بإرجاع كائن من نوع‬
‫‪.FileInputStream‬‬
‫‪ .3‬حتى تتمكن من قراءة محتويات الملف سطراً سطراً‪ ,‬أنشئ كائن من نوع ‪ BufferedReader‬ومرر له الكائن‬
‫‪FileInputStream‬‬
‫‪ .2‬اقرأ محتويات الملف سطراً سطراً باستخدام الدالة ‪ readLine‬حتى تصل إلى نهاية الملف (عندها ترجع الدالة‬
‫‪ readLine‬قيمة ‪.)null‬‬
‫‪ .2‬أغلق الكائنات من نوع ‪ BufferedReader‬و ‪.FileInputStream‬‬
‫هذه الخطوات موضحة بالكود التالي‪:‬‬
‫;)"‪FileInputStream in = openFileInput("hello_file‬‬
‫‪BufferedReader br = new BufferedReader(new‬‬
‫;))‪InputStreamReader(in‬‬
‫;‪String strLine‬‬
‫{)‪while((strLine = br.readLine())!= null‬‬
‫;)‪System.out.println(strLine‬‬
‫}‬
‫;)(‪br.close‬‬
‫;)(‪in.close‬‬
‫الذاكرة الخارجية )‪(External Storage‬‬

‫يدعم نظام أندرويد حفظ الملفات في الذاكرة الخارجية والتي قد تكون ذاكرة يمكن إزالتها وتركيبها ‪removable‬‬
‫مثل ‪ , SD Card‬أو ذاكرة ثابتة ال يمكن إزالتها‪ .‬الملفات المخزنة في الذاكرة الخارجية يمكن الوصول إليها من أي‬
‫تطبيق آخر وذلك بعكس الملفات المخزنة بالذاكرة الداخلية والتي تكون خاصة بالتطبيق‪.‬‬

‫( الخاص‬Manifest) ‫( في ملف الوثيقة‬permission) ‫قبل القراءة أو الكتابة للذاكرة الخارجية يجب إضافة إذن‬
‫( و إذن بالكتابة‬READ_EXTERNAL_STORAGE) ‫ حيث أن هناك إذن بالقراءة‬,‫بالتطبيق‬
:‫( كما هو موضح باألسفل‬WRITE_EXTERNAL_STORAGE)
<manifest ...>
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
android:name="android.permission.READ_EXTERNAL_STORAGE"/>
...
</manifest>
‫ إذا أردت كتابة أو قراءة ملفات خاصة بالتطبيق‬permission ‫ ال تحتاج إلذن‬Android 4.4 ‫ ابتداء من‬:‫مالحظة‬
.‫فقط‬
‫كما يجب قبل محاولة الوصول للذاكرة الخارجية التأكد من أن الذاكرة متوفرة عن طريق تنفيذ الدالة‬
missing "‫ "مفقودة‬,Mounted "‫ الذاكرة الخارجية قد تكون في حالة "مركبة‬.getExternalStorageState()
:‫المثال التالي يوضح دالتين لفحص حالة الذاكرة الخارجية‬.‫ باإلضافة لحاالت أخرى‬read only "‫"القراءة فقط‬,
.‫األولى تفحص إذا كانت الذاكرة متوفرة للكتابة والقراءة بينما تفحص الثانية إذا كانت الذاكرة متوفرة للقراءة فقط‬
/* Checks if external storage is available for read and
write */
public boolean isExternalStorageWritable(){
String state =Environment.getExternalStorageState();
if(Environment.MEDIA_MOUNTED.equals(state)){
return true;
}
return false;
}
/* Checks if external storage is available to at least read

*/
public boolean isExternalStorageReadable(){
String state =Environment.getExternalStorageState();
if(Environment.MEDIA_MOUNTED.equals(state)||
Environment.MEDIA_MOUNTED_READ_ONLY.equals(state)){
return true;
}
return false;
}
‫الدالة‬ ‫الخارجية‪.‬‬ ‫الذاكرة‬ ‫في‬ ‫ملف‬ ‫تخزين‬ ‫كيفية‬ ‫يوضح‬ ‫التالي‬ ‫المثال‬
‫)(‪ Environment.getExternalStorageDirectory‬تقوم بإرجاع مسار المجلد الذي يمثل الذاكرة الخارجية‬
‫حيث يمكن حفظ الملفات‪.‬‬
‫;)(‪File directory = Environment.getExternalStorageDirectory‬‬
‫;)"‪File file = new File(directory, "externalFile.txt‬‬
‫))(‪if(!file.exists‬‬
‫;)(‪file.createNewFile‬‬
‫;)‪FileOutputStream fos = new FileOutputStream(file‬‬
‫;)‪OutputStreamWriter osr = new OutputStreamWriter(fos‬‬
‫;)‪PrintWriter pr = new PrintWriter(osr‬‬
‫;)(‪pr.write‬‬
‫;)(‪osr.close‬‬
‫;)(‪fos.close‬‬

‫يهدف هذا التمرين إلى التدرب على حفظ بيانات تطبيق ما باستخدام الطرق الموضحة مسبقاً وهي التفضيالت‬
‫المشتركة )‪ ,)SharedPreferences‬الذاكرة الداخلية )‪ (Intenral Storage‬والذاكرة الخارجية ‪(External‬‬
‫)‪ .Storage‬واجهة التطبيق موضحة في شكل ‪ ,6-1‬وتتكون من مربع إدخال )‪ (EditText‬يتم من خالله إدخال‬
‫نص ليتم حفظه و استرجاعه بالطرق المختلفة (حفظ في الذاكرة الداخلية‪ ,‬استرجاع من الذاكرة الداخلية‪ ,‬حفظ في‬
‫الذاكرة الخارجية‪ ,‬استرجاع من الذاكرة الخارجية)‪ .‬لنتأكد من حفظ البيانات واسترجاعها بشكل سليم‪ ,‬نقوم بحفظ‬
‫البيان ات وإغالق التطبيق ثم تشغيله مرة أخرى واسترجاع البيانات بنفس الطريقة التي حفظت بها‪ ,‬ونكرر هذه‬
‫التجربة لكل طريقة‬
‫تحتوي واجهة التطبيق أيضا ً على زري انتقاء (‪ (RadioButtons‬لتحديد لون الخلفية )‪ ,(background‬حيث أن‬
‫اختيار أي لون يؤدي إلى تغيير لون الخلفية‪ .‬سنقوم باستخدام المفضالت المشتركة )‪ (SharedPreferences‬لحفظ‬
‫اللون واسترجاعه عند إعادة تشغيل البرنامج وذلك باستخدام الدالتين )(‪ onPause‬و )(‪ onResume‬على التوالي‪.‬‬
‫صفحــة ‪010 .‬‬

6-1 ‫ واجهة التطبيق الخاص بتمرين‬:6-1 ‫شكل‬

:‫ملف تصميم الواجهة موضح في ما يلي‬
<RelativeLayout
android:id="@+id/container"
<EditText
android:id="@+id/editText"
android:ems="10" >
<requestFocus />
</EditText>
<Button
android:id="@+id/loadInBtn"
android:layout_alignLeft="@+id/saveInBtn"
android:layout_below="@+id/saveInBtn"
android:onClick="loadInternal"
android:text="Load Internal" />
<Button
android:id="@+id/saveExBtn"
android:layout_alignLeft="@+id/loadInBtn"
android:layout_below="@+id/loadInBtn"
android:onClick="saveExternal"
android:text="Save External" />
<Button
android:id="@+id/loadExBtn"
android:layout_alignLeft="@+id/saveExBtn"
android:layout_below="@+id/saveExBtn"
android:onClick="loadExternal"
android:text="Load External" />
<Button
android:id="@+id/saveInBtn"
android:layout_below="@+id/editText"
android:onClick="saveInternal"
android:text="Save Internal" />
<TextView
android:id="@+id/tvBgColor"
android:layout_alignRight="@+id/radioGroup"
android:layout_below="@+id/loadExBtn"
android:text="Background Color:"
android:textSize="20sp" />
<RadioGroup
android:id="@+id/radioGroup"
android:layout_below="@+id/tvBgColor"
android:layout_centerHorizontal="true" >
<RadioButton
android:id="@+id/rdRed"
android:text="Red" />
<RadioButton
android:id="@+id/rdGreen"
android:layout_alignLeft="@+id/rdRed"
android:layout_below="@+id/rdRed"
android:text="Green" />
</RadioGroup>
</RelativeLayout>
‫( برمجياً لتغيير‬Layout) ‫ مما يستلزم الوصول للهيكلية‬,‫تذكر أننا سنحتاج إلى تغيير لون الخلفية أثناء عمل التطبيق‬
‫ يجب أن يكون لها رقم‬,(Layout) ‫ للوصول للهيكلية‬.‫لونها بنا ًء على اختيار المستخدم من قائمة األلوان‬
‫ لذلك تم إضافة الخاصية‬.findViewById() ‫ حتى نتمكن من تنفيذ الدالة‬R ‫( في ملف‬ID) ‫معرف‬
.‫ لها‬Id ‫ لملف التصميم حتى يتم إنشاء معرف‬android:id="@+id/container"
‫اإلذن‬ ‫إضافة‬ ‫يجب‬ ‫البيانات‬ ‫وحفظ‬ ‫تذكر أيضا ً أنه للوصول للذاكرة الخارجية‬
.‫ للقيام بذلك‬WRITE_EXTERNAL_STORAGE
.‫) الخاصة بالتطبيق‬MainActivity( ‫الكود التالي يوضح الفعالية‬

2:
3: public static final String PREFS = "myprefs";
4: public String bgColor;
5:
6: EditText editText;
7: @Override
11: editText = (EditText)
12: this.findViewById(R.id.editText);
13: RadioGroup rdGroup = (RadioGroup)
14: this.findViewById(R.id.radioGroup);
15: rdGroup.setOnCheckedChangeListener(new
17:
18: @Override
19: public void onCheckedChanged(RadioGroup
20: group, int checkedId) {
21: RadioButton selected = (RadioButton)
22: findViewById(checkedId);
23: bgColor =
24: selected.getText().toString();
25: setBackgroundColor(bgColor);
26: }
27: });
28: }
29:
30: public void saveInternal(View view){
31: try {
32: FileOutputStream fos =
33: this.openFileOutput("myfile.txt",
34: Context.MODE_PRIVATE);
35: PrintWriter pr = new PrintWriter(fos);
36: pr.write(editText.getText().toString());
37: pr.close();
38: fos.close();
39: editText.setText("");
40: } catch (FileNotFoundException e) {
41: e.printStackTrace();
42: } catch (IOException e) {
44: }
45: }
46:
47: public void loadInternal(View view){
48: try {
49: FileInputStream fis =
50: this.openFileInput("myfile.txt");
51: BufferedReader br = new BufferedReader(new
52: InputStreamReader(fis));
53: String txt="", tmp=null;
54: while((tmp=br.readLine()) != null){
55: txt+=tmp;
56: }
57: br.close();
58: fis.close();
59: editText.setText(txt);
60: } catch (FileNotFoundException e) {
64: }
65: }
66:
67: public void saveExternal(View view){
68: try {
69: if(isExternalStorageWritable()){
70: File directory =
71: Environment.getExternalStorageDirectory();
72: File file = new File(directory,
73: "externalFile.txt");
74: if(!file.exists())
75: file.createNewFile();
76: FileOutputStream fos = new
77: FileOutputStream(file);
78: OutputStreamWriter osr = new
79: OutputStreamWriter(fos);
80: PrintWriter pr = new PrintWriter(osr);
81:
82: pr.write(editText.getText().toString());
83: pr.close();
84: osr.close();
85: fos.close();
86: editText.setText("");
87: }
90: }
91: }
92:
93: public void loadExternal(View view){
94: try {
95: if(isExternalStorageReadable()){
96: File directory =
97: Environment.getExternalStorageDirectory();
98: File file = new File(directory,
99: "externalFile.txt");
100: if(file.exists()){
101: FileInputStream fis = new
102: FileInputStream(file);
103: InputStreamReader isr = new
104: InputStreamReader(fis);
105: BufferedReader br = new
106: BufferedReader(isr);
107: String txt="", tmp=null;
108: while((tmp=br.readLine()) !=
109: null){
110: txt+=tmp;
111: }
112: br.close();
113: editText.setText(txt);
114: }
115: }
118: }
119: }
120:
121: @Override
122: protected void onResume() {
123: super.onResume();
124: SharedPreferences sp =
125: this.getSharedPreferences(PREFS,
127: bgColor = sp.getString("bgColor", null);
128: if(bgColor != null)
129: this.setBackgroundColor(bgColor);
130: }
131:
132: @Override
133: protected void onPause() {
134: super.onPause();
135: if(bgColor != null){
136: SharedPreferences sp =
137: this.getSharedPreferences(PREFS,
139: Editor editor = sp.edit();
140: editor.putString("bgColor", bgColor);
141: editor.commit();
142: }
143: }
144:
145: protected void setBackgroundColor(String bgColor) {
146: RelativeLayout bgElement = (RelativeLayout)
147: findViewById(R.id.container);
148: if(bgColor.equals("Red"))
149: bgElement.setBackgroundColor(Color.RED);
150: else if(bgColor.equals("Green"))
151: bgElement.setBackgroundColor(Color.GREEN);
152: }
153:...
154: }
:‫ وهي كما يلي‬,‫يحتوي الكود على أربعة دوال رئيسية كل منها مسؤول عن تنفيذ إجراء محدد‬
‫الدالة )(‪( saveInternal‬أنظر الكود من سطر رقم ‪ 21‬إلى ‪ :)25‬وفيها يتم قراءة النص من العنصر‬ ‫‪‬‬
‫‪ EditText‬وحفظه في الذاكرة الداخلية في ملف اسمه ‪.myfile.txt‬‬
‫الدالة )(‪( loadInternal‬أنظر الكود من سطر رقم ‪ 27‬إلى ‪ :)65‬وفيها يتم قراءة الملف ‪ myfile.txt‬والذي تم‬ ‫‪‬‬
‫حفظه مسبقا ً في الذاكرة الداخلية‪ ,‬ومن ثم عرض محتويات الملف في العنصر ‪.EditText‬‬
‫الدالة )(‪( saveExternal‬أنظر الكود من سطر رقم ‪ 67‬إلى ‪ :)90‬ويتم تنفيذها عند النقر على زر " ‪Save‬‬ ‫‪‬‬
‫‪ "External‬ليتم حفظ النص المكتوب في العنصر ‪ EditText‬إلى الملف ‪ myfile.txt‬والذي يتم تخزينه في‬
‫الذاكرة الخارجية‪ .‬الحظ أنه يتم فحص حالة الذاكرة الخارجية للتأكد من إمكانية الكتابة إليها قبل عملية الحفظ‬
‫عن طريق تنفيذ الدالة )(‪.isExternalStorageWritable‬‬
‫الدالة )(‪(:loadExternal‬أنظر الكود من سطر رقم ‪ 92‬إلى ‪ )009‬ويتم تنفيذها عند النقر على زر " ‪Load‬‬ ‫‪‬‬
‫‪ "External‬ليتم استرجاع محتوى الملف ‪ myfile.txt‬وعرضه في العنصر ‪ .EditText‬الحظ أنه يتم فحص‬
‫حالة الذاكرة الخارجية للتأكد من إمكانية القراءة منها قبل عملية الحفظ عن طريق تنفيذ الدالة‬
‫)(‪.isExternalStorageReadable‬‬
‫في الدالة )(‪ onCreate‬تم إنشاء مستمع من نوع ‪ OnCheckedChangeListener‬لالستماع لحدث النقر على‬
‫أحد أزرار االنتقاء (‪ ,)RadioButton‬حيث يتم بنا ًء على ذلك تغيير لون الخلفية عن طريق تنفيذ الدالة‬
‫)(‪( setBackgroundColor‬أنظر الكود من سطر رقم ‪ 145‬إلى ‪ ,)152‬وكذلك حفظ لون الخلفية الحالي في‬
‫المتغير ‪( bgColor‬أنظر الكود من سطر رقم ‪ 8‬إلى ‪.)38‬‬
‫تم أيضا ً تطبيق الدالتين )(‪( onPause‬من سطر رقم ‪ 022‬إلى ‪ )022‬و )(‪( onResume‬من سطر رقم ‪ 033‬إلى‬
‫‪ )021‬وذلك حتى يتم حفظ واسترجاع لون الخلفية الحالي تلقائيا ً عند إغالق التطبيق وإعادة تشغيله‪ ,‬حيث يتم‬
‫استخداع التفضيالت المشتركة ‪ ShardPreferences‬لهذا الغرض‪.‬‬
‫قواعد البيانات )‪(SQLite Databases‬‬
‫‪ SQLite‬هي مكتبة برمجية مفتوحة المصدر )‪ (Open Source‬تستخدم محرك قواعد بيانات ‪(Database‬‬
‫)‪ Engine‬يدعم قواعد البيانات العالقية )‪ (Relational Databases‬وما يتعلق بها من خصائص مثل ‪,SQL‬‬
‫والتعامالت )‪ (Transactions‬و التصريحات المعدة مسبقا ً )‪.(Prepared statements‬‬
‫يدعم ‪ SQLite‬ثالثة أنواع من البيانات هي النص ‪ TEXT‬وهو يقابل ‪ String‬في لغة الجافا‪ INTEGER ,‬وهو‬
‫يشابة ‪ long‬أو ‪ int‬في الجافا‪ ,‬و ‪ REAL‬وهو يقابل ‪ double‬في الجافا‪ .‬أي أنواع أخرى من البيانات يجب‬
‫تحويلها إلى أحد هذه األنواع الثالثة حتى يمكن تخزينها في قاعدة البيانات‪ .‬كما أن ‪ SQLite‬ال يتحقق من نوعية‬
‫البيانات قبل تخزينها‪ ,‬بمعنى أنه يمكن تخزين بيانات رقمية في عمود يقبل بيانات نصية والعكس صحيح‪.‬‬
‫مكتبة ‪ SQLite‬مضمنة في كل جهاز يعمل بنظام أندرويد‪ ,‬وبذلك ال يحتاج إلى إي إعدادات أو تحميل ملفات‬
‫لتشغيله‪ .‬قاعدة البيانات الخاصة بأي تطبيق يتم تخزينها في المسار‪:‬‬
‫‪DATA/data/APP_NAME/databases/DATABASE_NAME‬‬
‫صفحــة ‪019 .‬‬

.Environment.getDataDirectory() ‫ في المسار السابق ترمز إلى المسار الذي ترجعه الدالة‬DATA ‫حيث‬
‫ يرمز إلى اسم قاعدة‬DATABASE_NAME ,‫ في المسار السابق يرمز إلى اسم التطبيق‬APP_NAME
.‫البيانات‬
,‫( الالزمة للتعامل مع قواعد البيانات‬classes) ‫ تحتوي على كل الفئات‬android.database package ‫الرزمة‬
‫( الخاصة بالتعامل مع‬classes) ‫ تحتوي على الفئات‬android.database.sqlite package ‫بينما الرزمة‬
.SQLite
‫إنشاء قواعد البيانات‬
‫) متفرعة من الفئة‬class( ‫إلنشاء قاعدة بيانات جديدة لتطبيق أندرويد ما يجب إنشاء فئة جديد‬
‫ المتفرعة من‬MySQLiteHelper ‫ كما هوموضح في المثال التالي حيث تم إنشاء الفئة‬SQLiteOpenHelper
:SQLiteOpenHelper
public class MySQLiteHelper extends SQLiteOpenHelper{
public MySQLiteHelper(Context context, String name,

int version) {
super(context, name, null, version);
}
@Override
public void onCreate(SQLiteDatabase db) {
db.execSQL("create table student(id integer
primary key autoincrement not null, name text not null, age
integer);");
}
@Override
public void onUpgrade(SQLiteDatabase db, int
oldVersion, int newVersion) {
db.execSQL("drop table student");
this.onCreate(db);
}
}
‫( الخاص بالفئة األم‬Constructor) ‫( يتم استدعاء الباني‬Constructor) ‫الحظ أنه من الباني‬

:‫ حيث يمرر لها ثالث متغيرات أساسية وهي‬SQLiteOpenHelper
‫المتغير ‪ context‬يشير إلى مكون التطبيق إلذي يستخدم قاعدة البيانات مثل مؤشر لكائن الفعالية‬ ‫‪‬‬
‫المضيفة )‪ (Activity‬أو الكائن الذي يمكن الحصول عليه من الدالة )(‪.getApplicationContext‬‬
‫المتغير ‪ name‬يشير إلى اسم قاعدة البيانات المراد إنشاؤها أو تعديلها‪.‬‬ ‫‪‬‬
‫المتغير ‪ version‬يشير إلى رقم إصدار قاعدة البيانات‪,‬وهو رقم يبدأ من ‪,0‬ويجب زيادته في كل مرة يحدث‬ ‫‪‬‬
‫فيها تغيير في هيكلية قاعدة البيانات‪.‬‬
‫في الفئة الجديدة )‪ (MySQLiteHelper Class‬يجب إعادة كتابة الدوال التالية‪:‬‬
‫)(‪ :onCreate‬ويتم استدعاؤها تلقائياً من النظام (ال تنفذ من التطبيق) عند إنشاء قاعدة البيانات ألول مرة‪ .‬في‬ ‫‪‬‬
‫الكود الموضح في األعلى يتم إنشاء جدول باسم ‪ student‬مكون ثالثة أعمدة وهي ‪.id, name, age‬‬
‫)(‪ :onUpgrade‬ويتم استدعاؤها تلقائيا ً اذا تغير رقم اإلصدار ‪ version‬وذلك في حالة تغيير هيكلية قاعدة‬ ‫‪‬‬
‫البيانات مثل حدوث تعديل على جدول معين‪.‬‬
‫على سبيل المثال‪ ,‬عند إنشاء قاعدة البيانات ألول مرة يتم تنفيذ الدالة )(‪ onCreate‬والتي يتم فيها إنشاء الجداول‬
‫والربط بينها‪ .‬عند حدوث أي تغيير في قاعدة البيانات مثل تعديل جدول ما ‪,‬يجب زيادة رقم اإلصدار عند إنشاء‬
‫كائن من نوع ‪ .MySQLiteHelper‬يقوم ‪ SQLite‬تلقائيا بمقارنة هذا الرقم مع رقم آخر اصدار مسبق لقاعدة‬
‫البيانات‪ ,‬وإذا كان مختلفا ً يقوم بتنفيذ الدالة )(‪ onUpgrade‬حيث يتم فيها إجراء التعديل الالزمة على هيكلية قاعدة‬
‫البيانات‪ .‬في المثال السابق تقوم الدالة )(‪ onUpgrade‬بحذف الجدول وإنشائه مرةً أخرى‪.‬‬
‫الوصول والتعامل مع قواعد البيانات‬
‫الفئة ‪ SQLiteOpenHelper‬توفر دالتين تمكن الوصول لقاعدة البيانات هما‪ getReadableDatabase() :‬و‬
‫)(‪ getWriteableDatabase‬حيث تسمح األولى بالقراءة فقط بينما توفر الثانية إمكانية القراءة والكتابة من قاعدة‬
‫البيانات‪ .‬كلتا الدالتين ترجعان مؤشر إلى الكائن ‪ SQLiteDatabase‬وهي المكون األساسي الذي يتم من خالله يتم‬
‫تنفيذ أي تعليمات ‪.SQL‬‬
‫يوفر ‪ SQLiteDatabase‬الدوال )(‪ insert(), update(), delete‬وذلك لإلضافة والحذف والتعديل على محتوى‬
‫قواعد البيانات‪ .‬على سبيل المثال‪ ,‬الكود التالي يوضح كيفية اضافة بيانات إلى الجدول ‪ student‬الذي تم إنشاؤه‬
‫مسبقاً‪ .‬يتم تجهيز البيانات المراد إضافتها ككائن من نوع ‪ ContentValues‬وفيه يتم إدخال البيانات على شكل‬
‫مفتاح‪-‬قيمة )‪ ,(key-value‬حيث يحدد المفتاح )‪ (key‬اسم العمود في الجدول بينما القيمة )‪ (value‬تمثل محتوى‬
‫السجل في العمود‪ .‬الكائن ‪ ContentValues‬يمكن استخدامه إلضافة أو تعديل البيانات في الجدول‪.‬‬
‫"‪// Create or access a database with the name "studentdb‬‬
‫‪MySQLiteHelper sqlHelper = new‬‬
‫;)‪MySQLiteHelper(getApplicationContext(),"studentdb",1‬‬
‫;)(‪SQLiteDatabase db = sqlHelper.getWritableDatabase‬‬
‫;)(‪ContentValues values = new ContentValues‬‬
‫;)‪values.put("name", name‬‬
‫;)‪values.put("age", age‬‬
‫صفحــة ‪000 .‬‬

‫;)‪db.insert("student", null, values‬‬

‫;)(‪db.close‬‬
‫;)(‪sqlHelper.close‬‬
‫تنفيذ اإلستعالمات )‪(Queries‬‬

‫تنفيذ االستعالمات يتم باستخدام إحدى دالتين من الكائن ‪ .SQLiteDatabase‬هاتين الدالتين هما‪:‬‬
‫الدالة )(‪ rawQuery‬وهذه الدالة يمرر إليها اإلستعالم والقيم المستعلم عنها كما في المثال التالي‪:‬‬ ‫‪‬‬
‫‪Cursor cursor = database.query("SELECT * from student where‬‬
‫;)}"‪name = ? and age > ?",new String[]{"Ahmed","20‬‬
‫حيث ‪ database‬هو كائن من نوع ‪.SQLiteDatabase‬‬
‫الدالة )(‪ query‬وهي توفر واجهة تمكن من إدخال االستعالم وتفاصيله بشكل مرتب‪ ,‬وهي تأخذ الصيغة‬ ‫‪‬‬
‫‪public Cursor query (String table, String[] columns, String‬‬
‫‪selection, String[] selectionArgs, String groupBy, String‬‬
‫;)‪having, StringorderBy, String limit‬‬
‫حيث تفاصيل هذه المتغيرات موضحة بجدول ‪ 6-1‬التالي‪:‬‬
‫جدول ‪ :6-1‬تفاصيل المتغيرات المدخلة للدالة )(‪SQLiteDatabase.query‬‬
‫وصف المتغير‬ ‫اسم المتغير‬
‫اسم الجدول الذي ينفذ عليه االستعالم‬ ‫‪Table‬‬
‫اسماء األعمدة المطلوب إرجاع قيمها‪ .‬في حال االستعالم عن كل األعمدة تعطى‬ ‫‪Columns‬‬
‫القيمة ‪null‬‬
‫هذا الجزء يمثل جملة ‪ WHERE‬والتي تحدد طريقة تصفية البيانات المستعلم‬ ‫‪Selection‬‬
‫عنها‪.‬‬
‫هذا الجزء يعطي قيم ألي عالمات استفهام ? قد تكون ضمن المتغير السابق‬ ‫‪selectionArgs‬‬
‫‪Selection‬‬
‫تكافئ ‪ group by‬في استعالم ‪SQL‬‬ ‫‪groupBy‬‬
‫تكافئ ‪ having‬في استعالم ‪SQL‬‬ ‫‪Having‬‬
‫تكافئ ‪ order by‬في استعالم ‪SQL‬‬ ‫‪orderBy‬‬
‫قيمته تحدد عدد النتائج التي يتم إرجاعها‪.‬‬ ‫‪Limit‬‬
‫مثال الستخدام الدالة )(‪ query‬لالستعالم عن بيانات من الجدول ‪ student‬موضح باألسفل‪:‬‬
‫;}"‪String[] allColumns = {"id","name","age‬‬
‫صفحــة ‪003 .‬‬
‫" ‪Cursor cursor = database.query("student", allColumns,‬‬

‫‪WHERE name =? and age >?", new String[]{"Ahmed","20"},‬‬
‫;)‪null, null, "name", null‬‬
‫حيث ‪ database‬هو كائن من نوع ‪ ,SQLiteDatabase‬وهذا االستعالم يكافئ استعالء ‪SQL‬التالي‪:‬‬

‫‪SELECT id,name, age FROM student WHERE name="Ahmed" and‬‬
‫‪age>20 order by name‬‬
‫كال الدالتين السابقتين )(‪ rawQuery‬و )(‪ query‬ترجعان كائن من نوع ‪ Cursor‬وهو مؤشر يؤشر على جدول‬
‫النتائج الناتج عن تنفيذ االستعالم‪ .‬يمكن قراءة البيانات عن طريق تحريك المؤشر من سطر آلخر وقراءة النتائج من‬
‫كل سطر كما هو موضح في المثال التالي‪:‬‬
‫;)(‪cursor.moveToFirst‬‬
‫{))(‪while(!cursor.isAfterLast‬‬
‫;)‪int id = cursor.getInt(0‬‬
‫;)‪String name = cursor.getString(1‬‬
‫;)‪int age = cursor.getInt(2‬‬
‫…‬
‫;)(‪cursor.moveToNext‬‬
‫}‬
‫;)(‪cursor.close‬‬
‫الدالة )(‪ moveToFirst‬تنقل المؤشر ألول سطر في النتائج‪ .‬الدالة )(‪ moveToNext‬تحرك المؤشر خطوةً لألمام‬
‫بعد قراءة السطر‪ .‬الدالة )(‪ isAfterLast‬تفحص انتهاء عملية القراءة وهو ما يتحقق عند وصول المؤشر ‪cursor‬‬
‫لما بعد السطر األخير‪.‬‬
‫يتم قراءة قيم األعمدة لكل سطر باستخدام الدوال )(‪ getInt‬أو )(‪ getString‬وغيرها من دوال قراءة القيم‪ ,‬وهذه‬
‫الدو ال تأخذ رقم العمود المراد قراءته كمدخل‪ .‬من المهم بعد االنتهاء من قراءة النتائج إغالق المؤشر ‪ cursor‬عن‬
‫طريق الدالة )(‪.close‬‬
‫اإلنشاء المسبق لقواعد البيانات‬
‫في كثير من األحيان‪ ,‬يفضل إنشاء قاعدة البيانات في مرحلة تصميم التطبيق بدالً من إنشاءها أثناء وقت التنفيذ كما‬
‫هو الحال عند استخدام الكائن من نوع ‪ .SQLiteOpenHelper‬إلنشاء قواعد بيانات من نوع ‪ ,SQLite‬يمكن‬
‫استخدام بعض األدوات المجانية التي تدعم ذلك مثل ‪( SQLite Database Browser‬أنظر شكل ‪ )6-2‬والمتوفر‬
‫مجانا ً من خالل الرابط ‪.sourceforge.net/projects/sqlitebrowser/‬‬
‫صفحــة ‪002 .‬‬

‫شكل ‪ :6-2‬واجهة األداة البرمجية )‪ (SQLite Database Browser‬المستخدمة في إنشاء قواعد البيانات‬
‫قاعدة البيانات المنشأة يتم حفظها كملف‪ .‬لربط ملف قاعدة البيانات بتطبيق الألندرويد‪ ,‬يجب وضع الملف في مجلد‬
‫‪ ,assets‬ثم يجب كتابة الكود التالي في الدالة )(‪ onCreate‬عن بداية تشغيل الفعالية حتى يتم نسخ الملف إلى‬
‫الجهاز‪ .‬المثال التالي يوضح الكود الالزم لنسخ ملف قاعدة البيانات ‪ stddb‬إلى الجهاز ومن ثم إنشاء كائن من نوع‬
‫‪.SQLiteDatabase‬‬
‫…‬
‫…‬
‫‪String destPath = "/data/data/" + getPackageName() +‬‬
‫;"‪"/databases‬‬
‫{ ‪try‬‬
‫;)‪File f = new File(destPath‬‬
‫{ ))(‪if (!f.exists‬‬
‫;)(‪f.mkdirs‬‬
‫;)(‪f.createNewFile‬‬
‫‪//---‬نسخ ملف قاعدة البيانات من مجلد ‪ assets‬إلى الجهاز‪---‬‬
‫‪CopyDB(getBaseContext().getAssets().open("stddb"),‬‬
‫;))"‪new FileOutputStream(destPath + "/stddb‬‬
‫}‬
‫{ )‪} catch (FileNotFoundException e‬‬
‫صفحــة ‪002 .‬‬

‫;)(‪e.printStackTrace‬‬
‫{ )‪} catch (IOException e‬‬
‫;)(‪e.printStackTrace‬‬
‫}‬
‫= ‪SQLiteDatabase database‬‬
‫‪SQLiteDatabase.openDatabase(destPath + "/stddb", null,‬‬
‫;)‪SQLiteDatabase.OPEN_READWRITE‬‬
‫…‬
‫}‬
‫‪public void CopyDB(InputStream inputStream, OutputStream‬‬

‫{ ‪outputStream) throws IOException‬‬
‫‪//---copy 1K bytes at a time---‬‬
‫;]‪byte[] buffer = new byte[1024‬‬
‫;‪int length‬‬
‫{ )‪while ((length = inputStream.read(buffer)) > 0‬‬
‫;)‪outputStream.write(buffer, 0, length‬‬
‫}‬
‫;)(‪inputStream.close‬‬
‫;)(‪outputStream.close‬‬
‫}‬

‫في هذا التمرين سنقوم ببناء تطبيق أندرويد متكامل للربط مع قاعدة بيانات وتنفيذ إجراءات مختلفة عليها مثل تنفيذ‬
‫االستعالمات واإلضافة والخذف‪ .‬قاعدة البيانات باسم ‪ studentdb‬وتحتوي جدول واحد باسم ‪ student‬يتكون من‬
‫ثالثة أعمدة ‪ .id,name, age‬الواجهة الرئيسية للتطبيق موضحة في شكل ‪ 6-3‬وتحتوي على ثالثة أزرار‪:‬‬
‫"‪ "View All‬لعرض كل أسماء الطالب من قاعدة البيانات‪ "Insert" ,‬إلضافة بيانات طالب جديد‪ ,‬و "‪"Delete‬‬
‫لحذف طالب من قاعدة البيانات‪.‬‬
‫عرض أسماء الطالب يتم من خالل قائمة (‪ )ListView‬في فعالية (‪ )Activity‬منفصلة‪ .‬إضافة بيانات طالب جديد‬
‫يتم من خالل نموذج إدخال يظهر عند النقر على زر "‪ "Insert‬حيث يطلب من المستخدم إدخال اسم الطالب وعمره‬
‫ومن ثم النقر على زر "‪ "Insert‬للحفظ‪ .‬حذف البيانات يتم عن طريقة عرض قائمة الطالب في (‪)ListView‬‬
‫حيث أن النقر على أي سطر في القائمة يظهر قائمة جانبية فيها أمر الحذف "‪ , "Delete‬وعند النقر عليه يتم إزالة‬
‫بيانات الطالب من القائمة (‪ )ListView‬ومن قاعدة البيانات‪.‬‬
‫صفحــة ‪005 .‬‬

‫‪MainActivity‬‬
‫‪ViewActivity‬‬ ‫‪InsertActivity‬‬ ‫‪DeleteActivity‬‬
‫شكل ‪ :6-3‬واجهات التطبيق الخاص بتمرين ‪.6-2‬‬
‫صفحــة ‪006 .‬‬

‫ كما‬,‫ سنعرض كود األجزاء المتعلقة بقواعد البيانات‬,‫قبل الحديث عن تصميم الواجهات والكود الخاص بالفعاليات‬
‫) متفرعة من‬class( ‫ الخطوة األولى للوصول إلى أو إنشاء قاعدة البيانات هو بإنشاء فئة‬,ً‫ذكرنا مسبقا‬
:‫ والتي تؤدي هذا الغرض‬MySQLiteHelper ‫) باسم‬class( ‫ الكود التالي يوضح الفئة‬.SQLiteOpenHelper
1: public class) MySQLiteHelper extends SQLiteOpenHelper{
2:
3: public static final String DATABASE_NAME =
4: "studentdb";
5: public static final int DATABASE_VERSION = 1;
6: public static final String STUDENT_TABLE = "student";
7: public static final String[] allColumns =
8: {"_id","name","age"};
9:
10: public MySQLiteHelper(Context context, String name,
11: int version) {
12: super(context, name, null, version);
13: }
14:
15: @Override
16: public void onCreate(SQLiteDatabase db) {
17: db.execSQL("create table student(_id integer
18: primary key autoincrement not null, name text not
19: null, age integer);");
20: }
21:
22: @Override
23: public void onUpgrade(SQLiteDatabase db, int
24: oldVersion, int newVersion) {
25: db.execSQL("drop table student");
26: this.onCreate(db);
27: }
28:}
‫) والتي تحدد اسم قاعدة البيانات‬8 ‫ إلى‬2 ‫) (أنظر الكود من سطر رقم‬class( ‫الحظ الثوابت المعرفة في بداية الفئة‬
‫ واسماء‬student ‫ واسم الجدول الذي سيتم الوصول إليه في قاعدة البيانات وهو‬1 ‫ ورقم إصدارها‬studentdb
‫ تم تعريف هذه الثوابت ألن سيتم استخدامها بكثرة في التطبيق‬.allColumns ‫األعمدة في الجدول في مصفوفة باسم‬
.‫في كل مرة يتم الوصول إلى قاعدة البيانات‬
)class( ‫ تم إنشاء الفئة‬,‫لتسهيل التعامل مع البيانات الخاصة لكل طالب والتعامل مع كل بيانات طالب كوحدة واحدة‬
:‫ كالتالي‬Student ‫باسم‬
1: public class Student {

2:
3: private int id;
4: private String name;
5: private int age;
6:
7: public Student(){}
8:
9: public Student(int id, String name, int age) {
10: this.id = id;
11: this.name = name;
12: this.age = age;
13: }
14: public int getId() {
15: return id;
16: }
17: public void setId(int id) {
18: this.id = id;
19: }
20: public String getName() {
21: return name;
22: }
23: public void setName(String name) {
24: this.name = name;
25: }
26: public int getAge() {
27: return age;
28: }
29: public void setAge(int age) {
30: this.age = age;
31: }
32:}
‫ والتي يتم‬StudentDBUtility ‫) باسم‬class( ‫لتسهيل تنفيذ اإلجراءات المختلفة على قاعدة البيانات تم إنشاء فئة‬
‫ المنشأة مسبقا ً لتنفيذ اإلجراءات المختلفة على قاعدة‬MySQLiteHelper ‫من خاللها استخدام كائن من الفئة‬
:‫ موضح باألسفل‬StudentDBUtility ‫ كود الفئة‬.‫البيانات‬
1: public class StudentDBUtility {
2:
3: MySQLiteHelper myHelper;
4: SQLiteDatabase db;
5:
6: public StudentDBUtility(Context context, String
7: databaseName, int version){
8: myHelper = new MySQLiteHelper(context,
9: databaseName, version);
10: }
11:
12: public void open(){
13: db = myHelper.getWritableDatabase();
14: }
15:
16: public void close(){
17: if(db != null && db.isOpen())
18: db.close();
19: myHelper.close();
20: }
21:
22: public List<Student> getAllStudents(){
23: List<Student> students = new
24: ArrayList<Student>();
25: Cursor cursor =
26: db.query(MySQLiteHelper.STUDENT_TABLE,
27: MySQLiteHelper.allColumns, null, null, null, null,
28: "name");
29: cursor.moveToFirst();
30: while(!cursor.isAfterLast()){
31: int id = cursor.getInt(0);
32: String name = cursor.getString(1);
33: int age = cursor.getInt(2);
34: Student s = new Student(id, name, age);
35: students.add(s);
36: cursor.moveToNext();
37: }
38: cursor.close();
39: return students;
40: }
41:
42: public long insertStudent(String name, int age){
43: ContentValues values = new ContentValues();
‫‪44:‬‬ ‫;)‪values.put("name", name‬‬

‫‪45:‬‬ ‫;)‪values.put("age", age‬‬
‫‪46:‬‬ ‫‪return db.insert(MySQLiteHelper.STUDENT_TABLE,‬‬
‫;)‪47: null, values‬‬
‫} ‪48:‬‬
‫‪49:‬‬
‫{)‪50: public long deleteStudent(int id‬‬
‫‪51:‬‬ ‫‪return db.delete(MySQLiteHelper.STUDENT_TABLE,‬‬
‫;)})‪52: "_id = ?", new String[]{String.valueOf(id‬‬
‫} ‪53:‬‬
‫} ‪54:‬‬
‫الحظ أن الفئة ‪ StudentDBUtility‬تحتوي على ثالثة دوال رئيسية تمثل اإلجراءات المطلوب تنفيذها على‬
‫الجدول ‪ student‬في قاعدة البيانات‪ .‬هذه الدوال هي‪:‬‬
‫الدالة )(‪( getAllStudents‬أنظر الكود من سطر رقم ‪ 33‬إلى ‪ :)21‬وتستخدم لالستعالم عن كل الطالب‬ ‫‪‬‬
‫الموجودين في الجدول ‪ student‬ومن ثم إرجاع قائمة ‪ List‬تحتوي على بيانات جميع الطلبة ممثلةً بكائنات من‬
‫نوع ‪ .Student‬الحظ أن هذه الدالة تخفي تفاصيل االستعالم والوصول لقاعدة البيانات حيث تقوم بإرجاع قائمة‬
‫‪ List‬ببيانات الطلبة مخزنة في كائنات من نوع ‪ .Student‬الحظ أيضا ً صيغة االستعالم وهي‪:‬‬
‫‪db.query(MySQLiteHelper.STUDENT_TABLE,‬‬
‫;)"‪MySQLiteHelper.allColumns, null, null, null, null, "name‬‬
‫حيث تكافئ استعالء ‪ SQL‬التالي‪:‬‬
‫‪SELECT _id, name, age from student ORDER BY name‬‬
‫مالحظة‪ :‬في حالة االستعالمات عن كل األعمدة في الجدول يمكن تمرير ‪ null‬بدالً من المصفوفة‬
‫‪ .allColumns‬كما أنه عند الحاجة لبيانات محددة‪ ,‬يفضل تمرير أسماء األعمدة التي تحتوي البيانات المطلوبة‬
‫فقط وذلك ألن االستعالم عن كل األعمدة يتطلب مزيد من الوقت‪.‬‬
‫الدالة )(‪( insertStudent‬أنظر الكود من سطر رقم ‪ 23‬إلى ‪ :)28‬وفيها يتم إدخال بيانات طالب جديد بتمرير‬ ‫‪‬‬
‫قيم اإلسم ‪ name‬والعمر ‪ .age‬قيمة ‪_id‬الخاصة بالطالب يتم إنشاؤها تلقائيا ً في الجدول عن إضافة سطر جديد‪.‬‬
‫الدالة )(‪( deleteStudent‬أنظر الكود من سطر رقم ‪ 51‬إلى ‪ :)52‬وهي لحذف بيانات الطالب حسب قيمة ‪id‬‬ ‫‪‬‬
‫التي يتم تمريرها للدالة‪.‬‬
‫الدوال )(‪ open‬و )(‪ close‬لفتح االتصال بقاعدة البيانات وإغالقه (أنظر الكود من سطر رقم ‪ 03‬إلى ‪.)31‬‬ ‫‪‬‬
‫صفحــة ‪031 .‬‬

‫) للوصول‬Activities( ‫ من داخل الفعاليات المختلفة‬StudentDBUtility ‫الحظ أنه سيتم استخدام كائن من الفئة‬
.‫إلى قاعدة البيانات‬
‫) في كال‬ListView( ‫( ولذلك لعرض بيانات الطالب في القائمة‬Custom Adapter) ‫تم أيضا ً إنشاء محول خاص‬
‫ السبب في انشاء محول خاص‬.)6-3 ‫) (أنظر شكل‬DeleteActivity) ‫) و‬ViewActivity) :‫الفعاليتين‬
‫ لعرض‬Student ‫( هو أننا نريد تمرير مصفوفة الطالب المكونة من مجموعة من الكائن‬Custom Adapter)
‫ هو أن القائمة‬ArrayAdapter ‫) بدالً من استخدام المحول االفتراضي‬ListView( ‫أسماء الطلبة في القائمة‬
‫ الخاص‬Student ‫ الهدف هو حفظ واسترجاع الكائن‬.String ‫ وليس‬Student ‫ستعرض وتتعامل مع كائن من نوع‬
‫ سيمكن الحقا من‬Student ‫ استرجاع الكائن‬.(ListView) ‫بكل طالب عن النقر على أي سطر في قائمة العرض‬
.ً‫ حتى نتمكن من حذفه مثال‬id ‫معرفة المعرف الخاص به‬
‫) لذلك يمكن استخدامه‬ListView( ‫ يدعم عرض جمل نصية فقط في القائمة‬ArrayAdapter ‫المحول االفتراضي‬
‫لعرض أسماء الطالب ولكن لن نستطيع عند استخدامه من استرجاع معلومات الطالب األخرى من القائمة‬
‫ موضح باألسفل (الحظ أنه متفرع من‬StudentCustomAdapter ‫ الكود الخاص بالمحول‬.)ListView(
.)BaseAdapter ‫الفعالية‬
1: public class StudentCustomAdapter extends BaseAdapter{
2:
3: Context context;
4: List<Student> students;
5:
6: public StudentCustomAdapter(Context context,
7: List<Student> students) {
8: this.students = students;
9: this.context = context;
10: }
11:
12: public View getView(int position, View view, ViewGroup
13: parent){
14: if(view == null){
16: context.getSystemService(Context.LAYOUT_INFLATER_
17: SERVICE);
18: view =
19: inflater.inflate(R.layout.student_list_layout, parent,
20: false);
21: TextView tv = (TextView)
22: view.findViewById(R.id.viewName);
23:
24: tv.setText(students.get(position).getName());
25: ViewHolder vh = new ViewHolder();

26: vh.text = tv;
27: view.setTag(vh);
28: }else{
29: ViewHolder vh = (ViewHolder) view.getTag();
30:
31: vh.text.setText(students.get(position).getName());
32: }
33: return view;
34: }
35:
36: static class ViewHolder{
37: public TextView text;
38: }
39:
40: @Override
41: public int getCount() {
42: return students.size();
43: }
44:
45: @Override
46: public Object getItem(int position) {
47: return students.get(position);
48: }
49:
50: @Override
51: public long getItemId(int position) {
52: return position;
53: }
54:
55: public void remove(Student student){
56: students.remove(student);
57: this.notifyDataSetChanged();
58: }
59:}
‫ بنا ًء على‬Student ‫) تقوم بإرجاع كائن من نوع‬28 ‫ إلى‬26 ‫ (أنظر الكود من سطر رقم‬getItem() ‫الحظ أن الدالة‬
‫ وهو ما يمكن من االستماع لحدث النقر على القائمة‬,)ListView( ‫ التي يتم اختياره في القائمة‬position ‫المكان‬
.‫ حسب المكان الذي تم النقر عليه‬Student ‫) واسترجاع الكائن الخاص بالطالب‬ListView(
‫) حيث يمرر لها كائن من‬58 ‫ إلى‬55 ‫ (أنظر الكود من سطر رقم‬remove() ‫الحظ أيضا ً أنه تم إضافة دالة باسم‬
.notifyDataSetChanged() ‫) بتنفيذ الدالة‬ListView( ‫ ومن ثم تحديث محتوات القائمة‬,‫ لحذفه‬Student ‫نوع‬
‫) يتم انشاء الواجهة الخاصة بكل‬22 ‫ إلى‬03 ‫ (أنظر الكود من سطر رقم‬getView() ‫الحظ أيضا ً أنه في الدالة‬
‫ حيث يتم تمرير المعرف الخاص بملف تصميم الهيكلية وهو‬inflate() ‫سطر باستخدام الدالة‬
:‫ حيث يستخدم التصميم التالي‬R.layout.student_list_layout
<LinearLayout
>
<TextView
android:id="@+id/viewName"
android:textSize="16dp"
</LinearLayout>
:‫ التالية‬Layout ‫تصميم الواجهات الخاصة بالتطبيق يتم باستخدام ملفات التصميم‬

:‫( موضح فيما يلي‬MainActivity) ‫ تصميم الواجهة الرئيسية‬:ً‫أوال‬
<RelativeLayout
android:id="@+id/RelativeLayout1"
<TextView
android:id="@+id/tvStudentDB"
android:text="Student Database"
android:textStyle="bold" />
<Button
android:id="@+id/viewAllBtn"
android:layout_below="@+id/tvStudentDB"
android:text="View All" />
<Button
android:id="@+id/insertBtn"
android:layout_below="@+id/viewAllBtn"
android:text="Insert" />
<Button
android:id="@+id/deleteBtn"
android:layout_below="@+id/insertBtn"
android:text="Delete" />
</RelativeLayout>
:‫( موضح فيما يلي‬InsertActivity) ‫ تصميم واجهة اإلدخال‬:ً‫ثانيا‬

<LinearLayout
tools:context="com.example.sqlite.InsertActivity" >
<TextView
android:id="@+id/tvTitle"
android:text="Insert Student" />
<LinearLayout
>
<TextView
android:id="@+id/tvStdName"
android:text="Name" />
<EditText
android:id="@+id/insertName"
android:layout_weight="1"
android:ems="10" >
<requestFocus />
</EditText>
</LinearLayout>
<LinearLayout
android:layout_marginTop="2dp" >
<TextView
android:id="@+id/tvStdAge"
android:text="Age"/>
<EditText
android:id="@+id/insertAge"
android:ems="10" />
</LinearLayout>
<Button
android:id="@+id/confirmInsertBtn"
android:text="OK" />
</LinearLayout>
‫( تستخدمان التصميم االفتراضي للفعالية‬DeleteActivity) ‫( و الحذف‬ViewActivity) ‫واجهتا العرض‬

.‫ أي أنه ليس لهما ملفي تصميم للهيكلية‬,)ListActivity)
‫) يجب التأكد من إضافة إذن الكتابة للذاكرة الخارجية لملف‬Activities( ‫قبل كتابة الكود الخاص في الفعاليات‬
.Manifest ‫ كذلك يجب التأكد من اإلعالن عن كل الفعاليات التي يتم إنشاؤها في ملف الوثيقة‬.Manifest ‫الوثيقة‬
:)Activity( ‫سنقوم اآلن بتفصيل الكود الخاص بكل فعالية‬
‫ تعرض هذه الفعالية أزرار تنفيذ اإلجراءات‬.‫ والكود الخاص بها موضح باألسفل‬MainActivity ‫ الفعالية‬:ً‫أوال‬
‫ عند النقر على الزر‬,ً‫ فمثال‬.‫ عند النقر على كل زر يتم تشغيل فعالية جديدة لتنفيذ اإلجراء المطلوب‬.‫المختلفة‬
‫) يحدد الفعالية‬Explicit Intent) ‫) يتم إنشاء هدف صريح‬08 ‫ إلى‬9 ‫" (أنظر الكود من سطر رقم‬viewAllBtn"
‫) بتنفيذ الدالة‬ViewActivity) ‫ بعد ذلك يتم تشغيل الفعالية‬.‫( والتي سيتم فيها عرض األسماء‬ViewActivity)
.)06 ‫) كمدخل للدالة (سطر رقم‬Intent( ‫ حيث يمرر الهدف‬startActivity()
2:
3: @Override
7: Button viewAllBtn = (Button)
8: this.findViewById(R.id.viewAllBtn);
9: viewAllBtn.setOnClickListener(new
10: OnClickListener(){
11:
12: @Override
15: Intent(MainActivity.this, ViewActivity.class);
16: startActivity(intent);
17: }
18: });
19: Button insertBtn = (Button)
20: this.findViewById(R.id.insertBtn);
21: insertBtn.setOnClickListener(new
23:
24: @Override
28: InsertActivity.class));
30: }
31: });
32: Button deleteBtn = (Button)
33: this.findViewById(R.id.deleteBtn);
34: deleteBtn.setOnClickListener(new
36:
37: @Override
40: Intent(getApplicationContext(), DeleteActivity.class);
42: }
43: });
44: }
45:}
.‫ وهي المسؤولة عن عرض أسماء الطالب والكود الخاص بها موضح باألسفل‬ViewActivity ‫ الفعالية‬:ً‫ثانيا‬
‫ للربط مع قاعدة البيانات (أنظر سطر رقم‬StudentDBUtility ‫الحظ أن هذه الفعالية تقوم بإنشاء كائن من نوع‬
‫ قائمة‬.)00‫ و‬01 ‫ (أنظر األسطر‬getAllStudents() ‫ ومن ثم االستعالم عن كل الطالب من خالل الدالة‬,)6
‫ يتم تمريرها إلى محول من نوع‬List<Student> students ‫بيانات الطلبة المرجعة‬
.)03 ‫ (أنظر سطر رقم‬ListView ‫ لتعبئة القائمة‬StudentCustomAdapter
1: public class ViewActivity extends ListActivity {
2:
3: @Override
6: StudentDBUtility dbUtility = new
7: StudentDBUtility(this, MySQLiteHelper.DATABASE_NAME,
8: MySQLiteHelper.DATABASE_VERSION);
9: dbUtility.open();
10: List<Student> students =
11: dbUtility.getAllStudents();
12: StudentCustomAdapter adapter = new
13: StudentCustomAdapter(this, students);
15: dbUtility.close();
16: }
17:}
‫ الحظ أنه في هذه‬.‫ والموضحة باألسفل ومن خاللها تتم عملية إدخال بيانات الطالب‬InsetActivity ‫ الفعالية‬:ً‫ثالثا‬
‫) إلدخال بيانات الطالب من‬00 ‫ (أنظر سطر رقم‬StudentDBUtility ‫الدالة يتم أيضاً استخدام كائن من نوع‬
‫“ يتم تنفيذ إجراء الموضح في األسطر من‬Insert” ‫ عند النقر على زر اإلضافة‬.insertStudent() ‫خالل الدالة‬
‫ (أنظر سطر رقم‬insertStudent() ‫ حيث يتم قراءة العناصر المدخلة (االسم والعمر) ثم تنفيذ الدالة‬22 ‫ إلى‬36
‫ فهذا يعني أن عملية اإلضافة لم تتم بنجاح حيث يتم طباعة رسالة‬0- ‫ المرجعة تساوي‬result ‫ اذا كانت قيمة‬.)22
‫ الحظ أيضا ً أن االتصال مع قاعدة البيانات يبدأ في الدالة‬.)22 ‫ إلى‬22 ‫ تبين ذلك (أنظر األسطر من‬Toast
‫ يبقى االتصال مفتوحا ً حتى يتم إغالق أو ايقاف الفعالية عند تنفيذ الدالة‬.)8 ‫ (أنظر سطر رقم‬onCreate()
.‫) والتي يتم فيها إغالق االتصال مع قاعدة البيانات‬50 ‫ (أنظر سطر رقم‬onPause()
1: public class InsertActivity extends Activity {
2:
3: EditText nameTxt;
4: EditText ageTxt;
5: StudentDBUtility dbUtility;
6:
7: @Override
10: setContentView(R.layout.activity_insert);
11: dbUtility = new StudentDBUtility(this,
12: MySQLiteHelper.DATABASE_NAME,
15: nameTxt = (EditText)
16: this.findViewById(R.id.insertName);
17: ageTxt = (EditText)
18: this.findViewById(R.id.insertAge);
19: Button confirmInsertBtn = (Button)
20: this.findViewById(R.id.confirmInsertBtn);
21: confirmInsertBtn.setOnClickListener(new
23:
24: @Override
26: if(nameTxt.getText() !=null &&
27: ageTxt.getText() !=null){
28: String name =
29: nameTxt.getText().toString();
30: int age =
31: Integer.parseInt(ageTxt.getText().toString());
32: long result =
33: dbUtility.insertStudent(name, age);
34: if(result == -1){
35:
36: Toast.makeText(getApplicationContext(), "Error occured
37: while inserting data", Toast.LENGTH_SHORT).show();
38: }else{
39:
40: Toast.makeText(getApplicationContext(), "Item inserted
41: successfully", Toast.LENGTH_SHORT).show();
42: nameTxt.setText("");
43: ageTxt.setText("");
44: }
45: }
46: }
47: });
48: }
49:
50: @Override
54: }
55:}
‫ والتي يتم من خاللها الحذف عن طريق اختيار العنصر المراد حذفه من قائمة‬DeleteActivity ‫ الفعالية‬:ً‫رابعا‬
:‫ الكود الخاص بهذه الفعالية موضح فيما يلي‬.‫ في القائمة الجانبية‬Delete ‫) ومن ثم النقر على زر‬ListView(
1: public class DeleteActivity extends ListActivity {
2:
3: StudentDBUtility dbUtility;
4: StudentCustomAdapter adapter;
5:
6: @Override
9: dbUtility = new StudentDBUtility(this,
13: List<Student> students =
14: dbUtility.getAllStudents();
15: adapter = new StudentCustomAdapter(this,
16: students);
18: this.getListView().setOnItemClickListener(new
20:
21: @Override
23: parent, View view,
24: int position, long id) {
25: Student student =
26: (Student)parent.getItemAtPosition(position);
27: showPopup(view, student);
28: }
29: });
30: }
31:
32: public void showPopup(View view, final Student
33: student){
34: PopupMenu popUpMenu = new PopupMenu(this, view);
35: popUpMenu.getMenuInflater().inflate(R.menu.
36: contextmenu, popUpMenu.getMenu());
37: popUpMenu.setOnMenuItemClickListener(new
38: OnMenuItemClickListener(){
39:
40: @Override
41: public boolean onMenuItemClick(MenuItem
42: menuItem) {
43:
44: dbUtility.deleteStudent(student.getId());
45: adapter.remove(student);
46: return false;
47: }
48: });
49: popUpMenu.show();
50: }
51: @Override
55: }
56:}
‫الحظ أن الفعالية تستخدم أيضا ً كائن من نوع ‪ StudentDBUtility‬للوصول لقاعدة البيانات (أنظر سطر رقم ‪,)9‬‬
‫حيث يتم في البداية االستعالم عن كل الطالب من خالل الدالة )(‪getAllStudents‬وعرضها في القائمة‬
‫(‪ )ListView‬باستخدام محول من نوع ‪( StudentCustomAdapter‬أنظر األسطر من ‪ 02‬إلى ‪ .)07‬تم أيضاً‬
‫إضافة مستمع (‪ )Listener‬من نوع )‪ )OnItemClickListener‬لالستماع لحدث النقر على أي سطر في القائمة‬
‫(‪( )ListView‬أنظر سطر رقم ‪ .)08‬عند اختيار أي طالب من القائمة يتم استرجاع الكائن ‪ Student‬الذي تم‬
‫اختياره ومن ثم يتم عرض قائمة سياق ‪ Context Menu‬تظهر زر الحذف ‪ .Delete‬يتم إنشاء قائمة السياق بتنفيذ‬
‫الدالة )(‪ showPopup‬والتي يمرر لها كائن ‪ Student‬المراد حذفه (أنظر األسطر من ‪ 35‬إلى ‪ .)37‬من خالل‬
‫الدالة )(‪( onMenuItemClick‬أنظر األسطر ‪ 22‬و‪ )25‬يتم تنفيذ أمر الخذف عند النقر على زر ‪ Delete‬حيث‬
‫يتم تنفيذ الدالة )(‪ deleteStudent‬الموجودة في ‪ StudentDBUtility‬ويمرر لها رقم المعرف الخاص بالطالب‪.‬‬
‫صفحــة ‪023 .‬‬

‫أسئلة على الوحدة السادسة‬

‫‪ .0‬ما الفرق بين تخزين البيانات في الذاكرة الداخلية وتخزينها في الذاكرة الخارجية؟‬
‫‪ .3‬قم ببناء التطبيق الموضح باألسفل‪ :‬يقوم المستخدم بإدخال كلمات وحفظها بالنفر على الزر "‪."Save‬‬
‫الكلمات المدخلة يتم حفظها في قائمة من نوع >‪ .ArrayList<String‬عند النقر على زر "‪ "Show‬يتم‬
‫طباعة الكلمات المحفوظة باستخدام ‪.Toast‬‬
‫أحد مشاكل هذا التطبيق أنه عند حفظ بعض الكلمات وتدوير الجهاز‪ ,‬يتم فقدان كل الكلمات المحفوظة‪.‬‬
‫السبب في ذلك أن النظام يقوم تلقائيا ً بإنهاء الفعالية )‪ (Activity‬وإعادة تشغيلها عند تغيير إعدادات‬
‫العرض‪ .‬قم بعالج هذه المشكلة باستخدام التفضيالت المشتركة (‪ )SharedPreferences‬لحفظ الكلمات‬
‫واسترجاعها عند إعادة تشغيل الفعالية‪.‬‬
‫‪ .2‬قم بالتعديل على تمرين ‪ 6-2‬وذلك بإضافة فعالية جديدة باسم ‪ SearchActivity‬يمكن من خاللها البحث‬
‫عن طالب باستخدام األسم (أو جزء من األسم)‪.‬‬
‫‪ .2‬في تمرين ‪ ,6-2‬يتم تنفيذ إجراءات االستعالم واإلضافة والحذف على قاعدة البيانات‪ .‬قم بتعديل التطبيق‬
‫لينفذ إجراء التعديل (‪ )Update‬على بيانات طالب محدد‪ .‬قم أوالً بتعديل الفئة ‪StudentDBUtility‬‬
‫وذلك بإضافة دالة باسم )(‪ updateStudentDetails‬والتي يمرر لها ثالث قيم هي‪ :‬رقم المعرف ‪ID‬‬
‫الخاص بالطالب المراد التعديل على بيانات‪ ,‬اسم الطالب المعدل وعمره المعدل‪ .‬قم بعد ذلك بالتعديل على‬
‫القائمة المنبثقة التي تظهر في الفعالية )‪ (DeleteActivity‬وذلك ليتم إظهار زر باسم ”‪ “Update‬عند‬
‫النقر على اسم أي طالب‪ .‬عند النقر على زر "‪ "Update‬يتم إظهار فعالية لتعديل على البيانات القديمة‬
‫التي تظهر في عناصر اإلدخال من نوع ‪.EditText‬‬
‫‪ .5‬في تمرين ‪ 6-2‬تم إنشاء قاعدة البيانات باستخدام فئة متفرعة )‪ (subclass‬من الفئة‬
‫‪ . SQLiteOpenHelper‬قم بإنشاء قاعدة بيانات مطابقة لتلك المستخدمة في التمرين باستخدام األداة‬
‫البرمجية ‪ ,SQLite Database Browser‬ثم قم بعمل التعديالت الالزمة الستخدامها بدالً من الفئة‬
‫‪.SQLiteOpenHelper‬‬
‫صفحــة ‪022 .‬‬

‫الوحدة السابعة‪:‬‬
‫مزودات المحتوى‬
‫)‪(Content Providers‬‬
‫‪ ‬مفهوم مزود المحتوى )‪ (Content Provider‬واستخداماته‪.‬‬
‫‪ ‬مكونات مزود المحتوى وطريقة الوصول إليه للتواصل مع قواعد البيانات الموجودة ضمن تطبيقات‬
‫أخرى‪.‬‬
‫‪ ‬التدريب العملي على إنشاء و استخدام مزود محتوى يتيح الوصول إلى قاعدة بيانات‪.‬‬
‫لدراسة هذه الوحدة البد من اإللمام بإنشاء تطبيقات أندرويد المعتمدة على قواعد البيانات كما تم تفصيله في الوحدة‬
‫السادسة‪.‬‬
‫توفر مزودات المحتوى )‪ (Content Providers‬اإلمكانية للوصول للبيانات (قواعد البيانات أو الملفات) من‬
‫تطبيقات مختلفة‪ .‬فمثالً‪ ,‬اذا أردت مشاركة قاعدة البيانات المستخدمة في تطبيق ما‪ ,‬يجب إنشاء مزود محتوى‬
‫)‪ (Content Provider‬حول قاعدة البيانات ليوفر الوصول إليها من تطبيقات أخرى‪ .‬فكرة مزود المحتوى‬
‫)‪ (Content Provider‬تشبه إلى حد كبير هيكلية العميل‪/‬المزود )‪ (Client-Server Architecture‬حيث يمثل‬
‫التطبيق الذي الذي يسعى للوصول للبيانات دور العميل )‪ (Client‬بينما يمثل مزود المحتوى دور المزود‬
‫)‪ .(Server‬شكل ‪ 7-1‬يوضح فكرة عمل مزود المحتوى )‪ :(Content Provider‬التطبيق ‪ App1‬يستخدم قاعدة‬
‫بيانات حيث ال يمكن الوصول إليها إال من خالله‪ .‬لتمكين تطبيق آخر ‪ App2‬مثالً من الوصول لقاعدة البيانات‬
‫الخاصة بـ ‪ App1‬واستخدامها‪ ,‬يجب إنشاء مزود محتوى )‪ (Content Provider‬يوفر عدد من الدوال ( ‪query,‬‬
‫‪ )insert, update and delete‬التي يمكن تنفيذها من أي تطبيق بعيد للوصول لقاعدة البيانات‪.‬‬
‫يوفر نظام أندرويد عدد من مزودات المحتوى )‪ (Built-in Content Providers‬للوصول إلي بعض قواعد‬
‫البيانات الخاصة بالنظام مثل جهات االتصال )‪ ,(Contacts‬مخزن الوسائط )‪ ,(MediaStore‬المفضالت‬
‫)‪ ,(Bookmarks‬واإلعدادات )‪ (settings‬وغيرها‪ .‬على سبيل المثال‪ ,‬يستطيع أي تطبيق طبقا ً للصالحيات‬
‫الممنوحة له من الوصول لجهات االتصال الموجودة في الجهاز وذلك لقراءتها‪ ,‬التعديل عليها أو استعمالها ألي أمر‬
‫آخر‪.‬‬
‫في هذا الفصل سنطرق إلى إنشاء مزود المحتوى )‪ (Content Provider‬للوصول إلى قاعدة البيانات الخاصة‬
‫بتطبيق ما‪.‬‬
‫صفحــة ‪022 .‬‬

‫الفعالية‬
‫مزود المحتوى‬
‫قاعدة بيانات التطبيق‬
‫‪1‬‬
‫شكل ‪ :7-1‬االتصال بين الفعالية )‪ (Activity‬ومزود المحتوى (‪)Content Provider‬‬
‫إنشاء مزود المحتوى )‪(Content Provider‬‬
‫يتم إنشاء مزود المحتوى )‪ (Content Provider‬عن طريق إنشاء فئة فرعية )‪ )subclass‬من الفئة‬
‫‪, android.content.ContentProvider‬ومن ثم كتابة كود في بعض الدوال التي تتحكم بالوصول للبيانات‬
‫وهي‪:‬‬
‫الدالة )(‪ :onCreate‬وهذه الدالة يتم تنفيذها تلقائيا ً من قبل النظام عند إنشاء مزود المحتوى ألول مرة ويتم فيها‬ ‫‪‬‬
‫تنفيذ اإلعدادات الضرورية لتشغيل مزود المحتوى‪.‬‬
‫الدالة )(‪ :query‬يتم تنفيذ هذه الدالة من قبل الزبون ‪ Client‬السترجاع بيانات من مزود المحتوى‪ .‬الكود الذي‬ ‫‪‬‬
‫يجب كتابته في هذه الدالة يحدد نوعية البيانات وطريقة استخراجها ومن ثم إرجاعها للزبون مغلفة بكائن من‬
‫نوع ‪.Cursor‬‬
‫الدالة )(‪ :insert‬هذه الدالة يتم استدعاؤها عند إضافة سطر ‪ row‬إلى في قاعدة البيانات‪ .‬يجب كتابة الكود‬ ‫‪‬‬
‫الالزم في هذه الدالة ليتم اإلضافة إلى قاعدة البيانات ومن ثم إرجاع معرف ‪ URI‬للسطر الجديد‪.‬‬
‫‪CompileTimeError, http://www.compiletimeerror.com/2013/12/content -provider-in-android.html 1‬‬
‫صفحــة ‪025 .‬‬

‫الدالة )(‪ :update‬يتم تنفيذ هذه الدالة عند الحاجة لتعديل بعض البيانات من قبل المستخدم‪ .‬يمرر لهذه الدالة‬ ‫‪‬‬
‫القيم المعدلة لسطور معينة ومن ثم يتم إرجاع عدد السطور التي تم تعديلها‪.‬‬
‫الدالة )(‪ : delete‬وتستخدم في حالة حذف سطور محددة في قاعدة البيانات حيث ترجع هذه الدالة عدد السطور‬ ‫‪‬‬
‫التي تم حذفها‪.‬‬
‫)(‪ :getType‬وترجع نوعالبيانات ‪( MIME Type‬مثل ‪ HTML ,text‬وغيره)‪.‬‬ ‫‪‬‬
‫قبل شرح طريقة إنشاء مزود المحتوى عملياً‪ ,‬ال بد من شرح بعض المفاهيم األساسية المتعلقة باستخدام مزود‬
‫المحتوى )‪ (Content Provider‬والوصول إليها‪.‬‬
‫معرف الوصول للمحتوى )‪(The Content URI‬‬
‫قد يحتوي الجهاز على أكثر من مزود محتوى )‪ (Content Provider‬يتم الوصول إليها من تطبيقات مختلفة‪.‬‬
‫لذلك‪ ,‬ال بد من طريقة لتمييز كل مزود محتوى‪ .‬باإلضافة إلى ذلك‪ ,‬فإن مزود المحتوى قد يوفر الوصول لمحتويات‬
‫متعددة (أكثر من جدول في قاعدة البيانات)‪ ,‬لذلك البد أن تقوم التطبيقات التي تريد الوصول لمزود المحتوى من‬
‫تحديد المحتوى المحدد المراد الوصول إليه (جدول أو سطر داخل الجدول)‪ ,‬وهو ما يتم باستخدام معرف الوصول‬
‫للمحتوى )‪.(Content URI‬‬
‫معرف الوصول للمحتوى )‪ (Content URI‬مشابه لروابط الصحفات على شبكة اإلنترنت‪ ,‬وهو عبارة عن جملة‬
‫معرفة تبدأ بالمقطع ‪ content://‬وتتكون من أكثر من جزء‪ :‬الجزء األول يسمى ‪ Authority‬ويحدد مزود‬
‫المحتوى‪ .‬عادةً يستخدم اسم الرزمة ‪ package‬للفئة الخاصة بمزود المحتوى‪ .‬مثال‪:‬‬
‫‪content://ps.edu.ucas.mycontentprovider‬‬
‫الجزء الثاني يتم إضافته للجزء األول ليحدد الوصول إلى جدول معين في قاعدة البيانات‪ .‬فمثالً‪ ,‬للوصول إلى‬
‫الجدول ‪ student‬الموجود في قاعدة البيانات لمزود المحتوى ‪ ,ps.edu.ucas.mycontentprovider‬يتم إضافة‬
‫اسم الجدول ‪ student‬بعد ‪ Authority‬ليصبح‪:‬‬
‫‪content://ps.edu.ucas.mycontentprovider/student‬‬
‫للوصول إلى سطر محدد في قاعدة البيانات‪ ,‬مثل تعديل أو حذف سطر محدد‪ ,‬يتم إضافة معرف السطر‪ ,‬وهو عادةً‬
‫رقم يزداد تلقائيا ً وممثل بعمود في الجدول‪ ,‬إلى نهاية معرف الوصول ‪ Content URI‬ليصبح‪:‬‬
‫‪ps.edu.ucas.mycontentprovider.StudentProvider/student/3‬‬
‫حيث الرقم األخير يحدد معرف السطر المراد الوصول إليه‪.‬‬
‫عند القيام بأي إجراء على قاعدة البيانات مثل اإلضافة‪ ,‬الحذف‪ ,‬التعديل أو االستعالم‪ ,‬يتم تمرير معرف الوصول‬
‫للمحتوى ‪ Content URI‬للدالة المطلوبة لتحديد المحتوى المطلوب تنفيذ اإلجراء عليه‪ .‬فمثالً‪ ,‬لحذف السطر ذي‬
‫المعرف ‪ ,id=3‬يمكن تنفيذ الدالة )(‪ delete‬وتمرير معرف الوصول الموضح باألعلى‪.‬‬
‫صفحــة ‪026 .‬‬

‫اإلعالن عن مزود المحتوى في ملف الوثيقة )‪(Manifest‬‬

‫حتى يتعرف النظام على مزود المحتوى‪ ,‬يجب اإلعالن عنه في ملف الوثيقة )‪ (Manifest‬الخاص بالتطبيق الذي‬
‫أنشئ به مزود المحتوى‪ .‬على سبيل المثال‪ ,‬الكود التالي يتم إضافته إلى ملف )‪:(Manifest‬‬
‫"=‪<provider android:name‬‬
‫"‪ps.edu.ucas.mycontentprovider.StudentProvider‬‬
‫"=‪android:authorities‬‬
‫"‪ps.edu.ucas.mycontentprovider.StudentProvider‬‬
‫>‪android:exported="true"/‬‬
‫حيث أن الخاصية ‪ android:authorities‬تحدد معرف مزود المحتوى‪ ,‬بينما الخاصية ‪ android:name‬تحدد‬
‫اسم الفئة (‪ )class‬التي يتم فيها تطبيق دوال مزود المحتوى‪ ,‬وفي الغالب تستخدم نفس القيمة المحددة لـ‬
‫‪ .android:authorities‬الخاصية ‪ android:exported‬تحدد ما إذا كان مزود المحتوى )‪(Content Provider‬‬
‫متاح للتطبيقات األخرى ("‪ )android:exported="true‬أم ال ("‪.)android:exported="false‬‬
‫مستخرج المحتوى )‪(Content Resolver‬‬
‫الوصول لمزود المحتوى )‪ (Content Provider‬واستخدامه يتم باستخدام محلل المحتوى ‪(Content‬‬
‫)‪ ,Resolver‬وهو كائن )‪ (Object‬يمكن الوصول إليه بتنفيذ الدالة )(‪ getContentResolver‬الموجودة ضمن‬
‫‪ .Application Context‬باستخدام مستخرج المحتوى )‪ ,(ContentResolver‬يمكن تنفيذ كل الدوال التي‬
‫يوفرها مزود المحتوى مثل ‪ delete ,query ,insert‬وغيره‪ .‬أي أن مستخرج المحتوى )‪(ContentResolver‬‬
‫يتواصل مع مزود المحتوى )‪ (Content Provider‬لتنفيذ اإلجراءات التي يطلبها التطبيق الزبون ‪(Client‬‬
‫)‪( Application‬أنظر شكل ‪.)7-2‬‬
‫شكل ‪ :7-2‬الوصول لمزود المحتوى )‪ (Content Provider‬باستخدام مستخرج المحتوى ‪(Content‬‬

‫‪1‬‬
‫)‪Resolver‬‬
‫‪Pact Publishing, https://www.packtpub.com/books/content/what-content-provider 1‬‬
‫صفحــة ‪027 .‬‬

(7-1) ‫تمرين عملي‬

‫والتي تم تفصيله في الوحدة‬, )6-2 ‫سنقوم في هذا التمرين العملي باستكمال التمرين الخاص بقواعد البيانات (تمرين‬
‫( لتمكين التطبيقات األخرى للوصول إلى قاعدة‬Content Provider) ‫وذلك بإنشاء مزود محتوى‬, ‫السادسة‬
.studentdb ‫البيانات المنشأه مسبقا ً باسم‬
‫) متفرعة من الـفئة‬class( ‫( هي إنشاء فئة‬Content Provider) ‫الخطوة األولى في إنشاء مزود المحتوى‬
.‫ بعد ذلك نق وم بكتابة الكود في الدوال الموجودة بها للتواصل مع قاعدة البيانات واستخدامها‬.ContentProvider
‫ الشكل‬.‫) يتم إنشاؤها ضمن تطبيق قواعد البيانات السابق وليس ضمن تطبيق جديد‬class( ‫انتبه أن الفئة الجديد‬
.‫يوضح الكود الخاص بالفئة الجديدة‬
1: public class StudentProvider extends ContentProvider{
2:
3: MySQLiteHelper helper;
4: public static final String AUTHORITY =
5: "ps.edu.ucas.sqlite.contentprovider.StudentProvider";
6:
7: UriMatcher uriMatcher = new
8: UriMatcher(UriMatcher.NO_MATCH);
9:
10: public static final int CHOICE_STUDENT_TABLE = 1;
11: public static final int CHOICE_STUDENT_RECORD = 2;
12:
13: @Override
14: public boolean onCreate() {
15: helper = new MySQLiteHelper(this.getContext(),
18: uriMatcher.addURI(AUTHORITY,
19: MySQLiteHelper.STUDENT_TABLE, CHOICE_STUDENT_TABLE);
20: uriMatcher.addURI(AUTHORITY,
21: MySQLiteHelper.STUDENT_TABLE+"/#",
22: CHOICE_STUDENT_RECORD);
23:
24: return false;
25: }
26:
27: @Override
28: public Uri insert(Uri uri, ContentValues values) {
29: int result = uriMatcher.match(uri);
30: long id = -1;

31: if(result == CHOICE_STUDENT_TABLE){
32: SQLiteDatabase db =
33: helper.getWritableDatabase();
34: id = db.insert(MySQLiteHelper.STUDENT_TABLE,
35: null, values);
36:
37: this.getContext().getContentResolver().notifyChange(
38: uri, null);
39: }else{
40: throw new IllegalArgumentException("Invalid
41: Uri");
42: }
43: return Uri.parse("content://"+AUTHORITY +
44: MySQLiteHelper.STUDENT_TABLE+"/"+id);
45: }
46:
47: @Override
48: public int delete(Uri uri, String selection, String[]
49: selectionArgs) {
51: int deleteRecord = -1;
55: deleteRecord =
56: db.delete(MySQLiteHelper.STUDENT_TABLE, selection,
57: selectionArgs);
58:
60: uri, null);
61: }else if(result == CHOICE_STUDENT_RECORD){
64: String id = uri.getLastPathSegment();
65: deleteRecord =
66: db.delete(MySQLiteHelper.STUDENT_TABLE, "_id = "+id+"
67: and "+selection, selectionArgs);
68:
70: uri, null);

71: }else{
72: throw new IllegalArgumentException("Invalid
73: uri");
74: }
75: return deleteRecord;
76: }
77:
78: @Override
79: public String getType(Uri uri) {
80: return null;
81: }
82:
83: @Override
84: public Cursor query(Uri uri, String[] projection,
85: String selection,
86: String[] selectionArgs, String sortOrder) {
90: helper.getReadableDatabase();
91: return
92: db.query(MySQLiteHelper.STUDENT_TABLE, projection,
93: selection, selectionArgs, null, null, sortOrder);
94: }
95: return null;
96: }
97:
98: @Override
99: public int update(Uri uri, ContentValues values,
100: String selection,
101: String[] selectionArgs) {
103: int updatedRecord = -1;
107: updatedRecord =
108: db.update(MySQLiteHelper.STUDENT_TABLE, values,
109: selection, selectionArgs);
‫‪110:‬‬
‫(‪111: this.getContext().getContentResolver().notifyChange‬‬
‫;)‪112: uri, null‬‬
‫‪113:‬‬ ‫{)‪}else if(result == CHOICE_STUDENT_RECORD‬‬
‫‪114:‬‬ ‫= ‪SQLiteDatabase db‬‬
‫;)(‪115: helper.getWritableDatabase‬‬
‫‪116:‬‬ ‫;)(‪String id = uri.getLastPathSegment‬‬
‫‪117:‬‬ ‫= ‪updatedRecord‬‬
‫‪118: db.update(MySQLiteHelper.STUDENT_TABLE, values, "_id‬‬
‫;)‪119: = "+id+" and "+selection, selectionArgs‬‬
‫‪120:‬‬
‫(‪121: this.getContext().getContentResolver().notifyChange‬‬
‫;)‪122: uri, null‬‬
‫‪123:‬‬ ‫{‪}else‬‬
‫‪124:‬‬ ‫‪throw new IllegalArgumentException("Invalid‬‬
‫;)"‪125: uri‬‬
‫‪126:‬‬ ‫}‬
‫‪127:‬‬ ‫;‪return updatedRecord‬‬
‫} ‪128:‬‬
‫}‪129:‬‬
‫الثابت ‪( AUTHORITY‬أنظر سطر رقم ‪ 2‬و‪ )5‬يحدد المعرف الرئيس لمزود المحتوى ‪(Content‬‬
‫)‪ Provider‬وهو‪ ." ps.edu.ucas.sqlite.contentprovider.StudentProvider" :‬الحظ أن مزود المحتوى‬
‫)‪ (Content Provider‬يستخدم كائن من الفئة ‪( MySQLiteHelper‬أنظر سطر رقم ‪ 2‬و‪ )05‬والتي تم إنشاؤها‬
‫في تمرين ‪ 6-2‬للوصول إلى قاعدة البيانات من خالله‪ .‬الحظ أنه من خالل الدالة )(‪( onCreate‬أنظر األسطر من‬
‫‪ 02‬إلى ‪ )35‬تم إنشاء الكائن من نوع ‪ MySQLiteHelper‬وتمرير اسم قاعدة البيانات‪ ,studentdb ,‬ورقم‬
‫إصدارها ‪.1‬‬
‫قبل شرح الكود الذي يجب كتابته في دوال مزود المحتوى )‪ ,(Content Provider‬يجب التوضيح أن التطبيق‬
‫الزبون ‪ Client‬يقوم بإرسال المعرف ‪ URI‬الخاص بالمحتوى الذي يريد الوصول إليه للتعديل أو الحذف أو‬
‫اإلضافة‪ .‬لذلك فإن الدوال ‪ query, delete, update, insert‬كلها تحتاج إلى مدخل ‪ URI‬يحدد المحتوى المراد‬
‫تنفيذ اإلجراء عليه‪ .‬الحظ أن المحتوى المراد الوصول إليه قد يكون الجدول كامالً أو سطر معين في الجدول‪ .‬لذلك‬
‫يجب أن يقوم مزود المحتوى بترجمة وتحليل معرف المحتوى ‪ Content URI‬لمعرفة ما إذا كان يشير إلى جدول‬
‫أو سطر محدد في الجدول‪ ,‬وللقيام بذلك نستعين بكائن من نوع ‪( UriMatcher‬أنظر سطر رقم ‪ 7‬و‪ )8‬والذي نقوم‬
‫من خالله بتحديد الصيغ المختلفة لمعرف المحتوى ‪ URI‬والقيم التي يتم إرجاعها مع كل صياغة (أنظر األسطر من‬
‫‪ 08‬إلى ‪ .)33‬مزود المحتوى الخاص بنا يتعامل مع صيغتين لمعرف المحتوى ‪ Content URI‬هما‪:‬‬
‫>‪( content://<AUTHORITY><TABLE_NAME‬معرف مزود المحتوى متبوعاً باسم الجدول)‬ ‫‪‬‬
‫صفحــة ‪020 .‬‬

‫‪( content://<AUTHORITY><TABLE_NAME>/#‬معرف مزود المحتوى متبوعا باسم الجدول‬ ‫‪‬‬

‫متبوعا ً برقم السطر)‬
‫عند تمرير أي قيمة معرف محتوى ‪ Content URI‬من خالل الدالة ‪ query‬مثالً‪ ,‬يتم مطابقة القيمة الواردة‬
‫بالصيغ الموجودة في ‪ UriMatcher‬وعند تطابقها مع أي صيغة تقوم بإرجاع رقم يدل على الصيغة المطابقة‪.‬‬
‫فمثالً اذا تم تمرير المعرف التالي ‪:Content URI‬‬
‫‪content://ps.edu.ucas.sqlite.contentprovider.studentprovider/Student‬‬
‫يقوم ‪ UriMatcher‬بإرجاع القيمة ‪CHOICE_STUDENT_TABLE‬‬
‫بينما إذا تم تمرير المعرف التالي ‪:Content URI‬‬
‫‪content://ps.edu.ucas.sqlite.contentprovider.studentprovider/Student/5‬‬
‫يقوم ‪ UriMatcher‬بإرجاع القيمة ‪CHOICE_STUDENT_RECORD‬‬
‫حيث أن طريقة تنفيذ اإلجراء المطلوب على قاعدة البيانات يعتمد على قيمة المطابقة المرجعة من ‪.UriMatcher‬‬
‫سنتطرق اآلن إلى الكود الذي سيتم كتابته في بعض دوال مزود المحتوى‪:‬‬
‫في الدالة )(‪( insert‬أنظر األسطر من ‪ 38‬إلى ‪ )25‬نقوم بكتابة الكود لتنفيذ الخطوات التالية‪:‬‬
‫‪ .0‬استخدام ‪ UriMatcher‬لتحديد نوع ‪ URI‬ما إذا كان يشير إلى الجدول أو إلى سطر في الجدول‪.‬في المثال‬
‫الحالي سنتعامل مع ‪ URI‬الخاص بالجدول فقط (األسطر من ‪ 39‬إلى ‪.)20‬‬
‫‪ .3‬رمي استثناء‪ Exception‬إذا كان ‪ URI‬غير صالح (األسطر من ‪ 29‬إلى ‪.)23‬‬
‫‪ .2‬الحصول على مؤشر من نوع ‪ SQLiteDatabase‬قابل للكتابة عن طريق الدالة‬
‫)(‪( getWritableDatabase‬سطر ‪ 23‬و‪.)22‬‬
‫‪ .2‬إجراء عملية ‪ insertSQL‬إلدراج البيانات الموجودة ضمن ‪ ContentValues‬في جدول قاعدة البيانات‬
‫(األسطر ‪ 22‬و‪.)25‬‬
‫‪ .5‬إخطار مستخرج المحتوى ‪ ContentResolver‬بالتعديل الذي تم عن طريق تنفيذ الدالة‬
‫)(‪( notifyChange‬سطر ‪ 27‬و‪.)28‬‬
‫‪ .6‬إعادة معرف محتوى ‪ Content URI‬يمثل سطر الجدول المضاف حديثا ً (سطر رقم ‪ 22‬و‪.)22‬‬
‫في الدالة )(‪( query‬أنظر األسطر من ‪ 82‬إلى ‪ )96‬نقوم بكتابة كود لتنفيذ الخطوات التالية‪:‬‬
‫‪ .0‬استخدام ‪ UriMatcher‬لتحديد نوع ‪ URI‬ما إذا كان يشير إلى الجدول أو إلى سطر في الجدول‪.‬في المثال‬
‫الحالي سنتعامل مع ‪ URI‬الخاص بالجدول فقط (األسطر ‪ 87‬و‪.)88‬‬
‫صفحــة ‪023 .‬‬

‫‪ .3‬الحصول على مؤشر من نوع ‪ SQLiteDatabase‬قابل للقراءة فقط عن طريق الدالة‬

‫)(‪( getReadableDatabase‬سطر رقم ‪ 89‬و‪.)91‬‬
‫‪ .2‬تنفيذ االستعالء باستخدام المدخالت األخرى للدالة )(‪ query‬ومن ثم إرجاع الناتج مغلفاً بكائن من نوع‬
‫‪( Cursor‬سطر رقم ‪ 93‬و‪.)92‬‬
‫الحظ في الدالة )(‪( update‬أنظر األسطر من ‪ 99‬إلى ‪ )039‬يتم تحديد نوع ‪ URI‬والتعامل مع كل نوع بتنفيذ‬
‫التعليمة ‪ SQL Update‬المناسبة‪ .‬فإذا كان معرف المحتوى )‪ (Content URI‬يشير إلى الجدول في قاعدة‬
‫البيانات (يتم فحص هذا الشرط في سطر رقم ‪ ,)012‬فمن المفترض أن شرط التعديل (جملة ‪, )WHERE‬والذي‬
‫يحدد األسطر التي يتم التعديل عليها ‪,‬موجود في المتغير ‪ ,selection‬أما إذا كان معرف المحتوى يشير إلى سطر‬
‫معين‪ ,‬فيتم اضافة رقم الصف ‪ id‬إلى الجملة ‪ selection‬لتكون ضمن جملة ‪( WHERE‬أنظر األسطر من ‪006‬‬
‫إلى ‪ .)009‬الدالة )(‪( delete‬أنظر األسطر من ‪ 28‬إلى ‪ )76‬تقوم بنفس اإلجراء وتنفذ تعليمة ‪ SQL Delete‬بناء‬
‫على نوع معرف المحتوى‪.‬‬
‫بعد إنشاء الفئة ‪ StudentProvider‬الخاصة بمزود المحتوى‪ ,‬يجب اإلعالن عن مزود المحتوى في ملف‬
‫‪ Manifest‬كالتالي‪:‬‬
‫"=‪<provider android:name‬‬
‫"‪ps.edu.ucas.sqlite.contentprovider.StudentProvider‬‬
‫"=‪android:authorities‬‬
‫"‪ps.edu.ucas.sqlite.contentprovider.StudentProvider‬‬
‫>‪android:exported="true"/‬‬
‫بعد ذلك يصبح مزود المحتوى ‪ StudentProvider‬جاهزاً لالستخدام من أي تطبيق آخر‪ ,‬حيث يمكن الوصول إليه‬
‫من خالل المعرف ‪ URI‬التالي‪:‬‬
‫‪content:// ps.edu.ucas.sqlite.contentprovider.StudentProvider‬‬
‫ومن ثم إلحاق اسم الجدول والسطر المراد الوصول إليه‪.‬‬
‫بعد توضيح خطوات إنشاء مزود المحتوى )‪ (Content Provider‬سنقوم بإنشاء تطبيق جديد للوصول لمزود‬
‫المحتوى واستخدامه‪ .‬التطبيق الجديد سيكون له نفس واجهات تطبيق قواعد البيانات الموضح بالشكل‪ ,‬ويقوم بنفس‬
‫الوظائف‪ ,‬وهي عرض بيانات الطالب واإلضافة والحذف‪ ,‬مع اختالف واحد وهو الوصول إلى قاعدة البيانات عن‬
‫بعد من خالل مزود المحتوى ‪ StudentProvider‬الذي تم إنشاؤه‪.‬‬
‫التطبيق الجديد لن يقوم باستخدام كائن من نوع ‪ SQLiteOpenHelper‬بل فقط كائن نوع ‪ContentResolver‬‬
‫للوصول لقاعدة بيانات التطبيق البعيد من خالل مزود المحتوى ‪ .Content Provider‬التطبيق الجديد يستخدم الفئة‬
‫‪ StudentDBUtility‬لتنظيم الوصول لمزود المحتوى وإخفاء تفاصيل االتصال واالستعالم‪ .‬الفئة‬
‫‪ StudentDBUtility‬مشابهة بتلك المستخدمة في تطبيق قواعد البيانات – تمرين ‪ ,6-2‬باستثناء أنها هنا تستخدم‬
‫صفحــة ‪022 .‬‬

StudentDBUtility ‫ الكود الخاص بالفئة‬.SQLiteOpenHelper ‫ بدالً من‬ContentResolver ‫كائن من نوع‬

:‫الجديدة موضح فيما يلي‬
1: public class StudentDBUtility {
2:
3: ContentResolver resolver;
4: public static final String AUTHORITY =
5: "content://ps.edu.ucas.sqlite.studentprovider.
6: StudentProvider";
7: public static final Uri STUDENT_PROVIDER_URI =
8: Uri.parse(AUTHORITY+"/student");
9: public static final String[] allColumns =
10: {"_id","name","age"};
11:
12: public StudentDBUtility(Context context){
13: resolver = context.getContentResolver();
14: }
15:
16: public Uri insertStudent(String name, int age){
17: ContentValues values = new ContentValues();
18: values.put("name", name);
19: values.put("age", age);
20: return resolver.insert(STUDENT_PROVIDER_URI,
21: values);
22: }
23:
24: public List<Student> getAllStudents(){
25: List<Student> students = new
26: ArrayList<Student>();
27: Cursor cursor =
28: resolver.query(STUDENT_PROVIDER_URI, allColumns, null,
29: null, "name");
30: cursor.moveToFirst();
31: while(!cursor.isAfterLast()){
32: int id = cursor.getInt(0);
33: String name = cursor.getString(1);
34: int age = cursor.getInt(2);
35: Student s = new Student(id, name, age);
36: students.add(s);
37: cursor.moveToNext();
‫‪38:‬‬ ‫}‬
‫‪39:‬‬ ‫;)(‪cursor.close‬‬
‫‪40:‬‬ ‫;‪return students‬‬
‫‪41:‬‬ ‫}‬
‫‪42:‬‬
‫‪43:‬‬ ‫{)‪public long deleteStudent(int id‬‬
‫‪44:‬‬ ‫‪return resolver.delete(STUDENT_PROVIDER_URI, "_id‬‬
‫‪45:‬‬ ‫;)})‪= ?", new String[]{String.valueOf(id‬‬
‫‪46:‬‬ ‫}‬
‫‪47:‬‬ ‫‪// Not used for contentprovider‬‬
‫‪48:‬‬ ‫}{)(‪public void open‬‬
‫‪49:‬‬ ‫‪// Not used for contentprovider‬‬
‫‪50:‬‬ ‫}{)(‪public void close‬‬
‫}‪51:‬‬
‫الحظ أنه في الباني ‪ Constructor‬الخاصة بالفئة ‪( StudentDBUtility‬أنظر سطر رقم ‪ ,)03‬يتم الوصول‬
‫للكائن من نوع ‪ ContentResolver‬والمتوفر في ‪ context‬من خالل تنفيذ األمر التالي‪:‬‬
‫;)(‪resolver = context.getContentResolver‬‬
‫الدوال األخرى مثل )(‪ insertStudent() ,getAllStudents‬و )(‪ deleteStudent‬مطابقة لتلك الموجودة في‬
‫التطبيق السابق‪ ,‬باستثناء استخدام مستخرج المحتوى )‪ (Content Resolver‬لتنفيذ اإلجراء المطلوب على قاعدة‬
‫البيانات من خالل مزود المحتوى‪.‬‬
‫بعد إنشاء ‪ StudentDBUtility‬يمكن استخدام نفس كود الفعاليات (‪ )Activities‬وتصميماتها الموجودة في‬
‫التطبيق السابق دون أي تغيير‪ ,‬ومن المفترض أن يعمل التطبيق تماما ً مثل التطبيق السابق باستثاء أن قاعدة البيانات‬
‫موجودة في تطبيق آخر‪.‬‬
‫أسئلة على الوحدة السابعة‬

‫‪ .0‬ما الفائدة من إنشاء واستخدام مزود المحتوى )‪(Content Provider‬؟‬
‫‪ .3‬أذكر الدوال التي يجب كتابتها عند إنشاء مزود محتوى جديد؟‬
‫‪ .2‬كيف يتم تسجيل مزود المحتوى في ملف الوثيقة )‪(Manifest‬؟‬
‫‪ .2‬قم بالتعديل على تمرين ‪ 7-1‬وذلك بإضافة فعالية جديدة للبحث عن بيانات طالب من خالل مزود‬
‫المحتوى )‪ (Content Provider‬ومن ثم عرض النتائج على الشاشة‪.‬‬
‫صفحــة ‪025 .‬‬

‫الوحدة الثامنة‪:‬‬
‫مستقبالت النشر‬
‫)‪(Broadcast Receivers‬‬
‫‪ ‬مفهوم مستقبل النشر )‪ (Broadcast Receiver‬واستخداماته‪.‬‬
‫‪ ‬إنشاء مستقبالت نشر )‪ (Broadcast‬لالستماع واالستجابة ألحدات النظام المختلفة‬
‫‪ ‬تهيئة التطبيقات لنشر )‪ (Broadcast‬رسائل إلى مستقبالت النشر الموجودة ضمن تطبيقات أخرى‪.‬‬
‫‪ ‬مفهوم اإلشعارات )‪ (Notifications‬واستخداماتها‪.‬‬
‫لدراسة هذه الوحدة البد من اإللمام بمفهوم الهدف )‪ (Intent‬وأنواعه‪ ,‬واستخدامه للتواصل بين الفعاليات (إرجع إلى‬
‫الوحدة الرابعة)‪.‬‬
‫‪ Broadcast Receiver‬أو مستقبل النشر هو مكون من مكونات تطبيق أندرويد يستخدم لالستماع لألحداث‬
‫)‪ (Events‬الصادرة من النظام أو من تطبيقات أخرى‪ .‬عندما يحصل حدث معين‪ ,‬يقوم النظام‪ ,‬أو تطبيق آخر‪,‬‬
‫بارسال رسائل من نوع (‪ )Intent‬وذلك إلشعار كل مستقبالت النشر (‪ (Broadcast Receivers‬التي تستمع لهذا‬
‫الحدث‪.‬‬
‫تقوم مستقبالت النشر بدورها بتنفيذ إجراء معين عند حصول الحدث المستمع له‪ .‬على سبيل المثال‪ ,‬يمكن إنشاء‬
‫مستقبل نشر (‪ )Broadcast Receiver‬لالستماع لحدث إعادة تشغيل الجهاز )‪ (Boot‬أو الحصول على إشارة‬
‫االتصال باالنترنت‪ .‬عند حصول أي من هذه األحداث يقوم النظام تلقائيا ً بنشر (‪ (broadcast‬رسالة من نوع‬
‫(‪ )Intent‬وذلك إلشعار مستقبل النشر (‪ )Broadcast Receiver‬بذلك والذي يقوم بدوره بتنفيذ إجراء معين مثل‬
‫تشغيل تطبيق ما أو استئناف تحميل ملف من االنترنت أو إرسال إشعار )‪ (Notification‬بالحدث للمستخدم‪.‬‬
‫مستقبل النشر )‪ (Broadcast Receiver‬هومجرد "بوابة" للمكونات األخرى ويهدف إلى القيام بكمية ضئيلة جدا‬
‫من العمل‪ .‬على سبيل المثال ‪ ,‬بدء خدمة )‪ (Service‬ألداء بعض األعمال على أساس هذاالحدث‪.‬‬
‫هناك خطوتان لتفعيل مستقبل النشر (‪ )Broadcast Receiver‬الستماع للرسائل الصادرة من النظام وهما‪:‬‬
‫‪ .0‬إنشاء مستقبل النشر‪ :‬وهذا يتم بإنشاء فئة متفرعة )‪ (subclass‬من الفئة ‪ ,BroadcastReceiver‬وكتابة الدالة‬
‫)(‪ onReceive‬وفيها يحدد اإلجراء الذي يتم تنفيذه عند استقبال رسالة من نوع (‪ )Intent‬والتي تفيد بحصول‬
‫حدث معين‪ .‬المثال التالي يوضح طريقة إنشاء مستقبل نشر يقوم تلقائياً بتشغيل فعالية )‪ (Activity‬معينة‪ ,‬مثل‬
‫متصفح اإلنترنت‪ ,‬عند استقبال رسالة )‪ (Intent‬من النظام‪.‬‬
‫صفحــة ‪026 .‬‬

‫{ ‪public class MyReceiver extends BroadcastReceiver‬‬

‫{ )‪public void onReceive(Context context, Intent intent‬‬
‫;)‪Intent newIntent = new Intent(Intent.ACTION_VIEW‬‬
‫;))"‪newIntent.setData(Uri.parse("http://www.ucas.edu.ps‬‬
‫;))‪context.startActivity(newIntent‬‬
‫}‬
‫}‬
‫الحظ أن المتغير (‪ )Intent‬يمثل الرسالة التي تم نشرها من النظام‪ ,‬حيث يتم استقباله كمدخل للدالة‬
‫)(‪ ,onReceive‬بينما المتغير )‪ )newIntent‬يتم إنشاؤه لتنفيذ اإلجراء المطلوب بعد استقبال رسالة النظام‬
‫وهو في المثال السابق تشغيل فعالية‪.‬‬
‫‪ .3‬تسجيل مستقبل النشر‪ :‬بعد إنشاء مستقبل النشر كمكون لتطبيق أندرويد‪ ,‬ال بد من تسجليه في ملف الوثيقة‬
‫)‪ (Manifest‬التابع للتطبيق وتحديد نوع الحدث الذي يستمع لها‪ .‬فمثالً‪ ,‬اذا اردنا لمستقبل النشر المنشأ في‬
‫المثال السابق االستماع لحدث تشغيل الجهاز والمسمى (‪ (ACTION_BOOT_COMPLETED‬بحيث‬
‫يتم إشعاره تلقائيا ً من قبل النظام عند حصول هذا الحدث‪ ,‬يجب إضافة الخاصية ‪ receiver‬داخل الخاصية‬
‫‪ application‬من ملف الوثيقة ‪ Manifest‬كما هو موضح‪:‬‬
‫‪<application‬‬
‫…‬
‫>"‪<receiver android:name="MyReceiver‬‬
‫‪<action‬‬
‫>"‪android:name="android.intent.action.BOOT_COMPLETED‬‬
‫>‪</action‬‬
‫>‪</receiver‬‬
‫…‬
‫عند اكتمال تشغيل الجهاز‪ ,‬سيتم تلقائيا ً اشعار مستقبل النشر ‪ MyReceiver‬ومن ثم تنفيذ الدالة )(‪.onReceive‬‬
‫الحظ أن تسجيل مستقبل النشر يتضمن تحديد مرشح الهدف )‪ (Intent Filter‬والذي يحدد نوع الرسائل التي يستمع‬
‫لها مستقبل النشر‪ .‬في المثال الموضح‪ ,‬تم إعداد مستقبل النشر لالستماع لحدث إعادة التشغيل المحدد بالقيمة‬
‫"‪ ."android.intent.action.BOOT_COMPLETED‬عند إعادة التشغيل يقوم النظام تلقائياً ببث رسائل تفيد‬
‫بحصول حدث التشغيل‪ ,‬حيث يتم استقبال هذه الرسائل من قبل مستقبالت النشر المسجلة الستماع لهذا الحدث فقط‪.‬‬
‫مالحظة‪ :‬بعض األحداث يتطلب االستماع لها إضافة إذن )‪ (Permision‬إلى ملف الوثيقة )‪ .(Manifest‬فمثالً‪,‬‬
‫لالستماع لحدث اكتمال تشغيل الجهاز البد من إضافة اإلذن التالي‪:‬‬
‫صفحــة ‪027 .‬‬

‫>‪android:name="android.permission.RECEIVE_BOOT_COMPLETED"/‬‬
‫هناك عدد من األحداث )‪ (Event‬الصادرة من قبل نظام أندرويد ويمكن االستماع لها من خالل تسجيل مستقبالت‬
‫النشر‪ .‬يوضح الجدول التالي بعض أحداث النظام وأسمائها الثابته‪.‬‬
‫جدول ‪ :8-1‬بعض األحداث )‪ (Events‬الخاصة بنظام أندرويد والتي يمكن االستماع لها باستخدام مستقبالت‬
‫النشر )‪(Broadcast Receivers‬‬
‫وصف الحدث‬ ‫اسم الحدث‬
‫‪ android.intent.action.BOOT_COMPLETED‬اكتمال إعادة تشغيل الجهاز‬
‫‪ android.net.conn.CONNECTIVITY_CHANGE‬تغيير في حالة االتصال‬
‫باإلنترنت‬
‫‪ android.intent.action.ACTION_POWER_CONNECTED‬توصيل الشاحن بالجهاز‬
‫‪ android.intent.action.ACTION_POWER_DISCONNECTED‬فك توصيل الشاحن بالجهاز‬
‫‪ android.intent.action.CALL‬االتصال بجهة اتصال‬
‫‪ android.intent.action.BATTERY_LOW‬انخفاض سعة البطارية‬
‫‪ android.intent.action.DATE_CHANGED‬تغيير في تاريخ ووقت الجهاز‬
‫الجدير ذكره أنه يمكن تسجيل‪ ,‬وإلغاء تسجيل‪ ,‬مستقبل النشر برمجيا ً بدالً من التعديل على ملف الوثيقة‬
‫)‪ .(Manifest‬يتم ذلك من خالل الدوال )(‪ registerReceiver‬و )(‪ .unregisterReceiver‬يفضل عادة تسجيل‬
‫مستقبل النشر من خالل ملف )‪.(Manifest‬‬

‫يهدف هذا التمرين إلى إنشاء وتسجيل مستقبل نشر (‪ )Broadcast Receiver‬لالستماع لحدث من أحداث النظام‬
‫ومن ثم تنفيذ إجراء محدد عند حصول هذا الحدث‪ .‬الحدث الذي سيتم االستماع له هو تغير حالة االتصال بالشبكة‬
‫الالسلكية )‪ ,(WIFI‬حين يصبح الجهاز متصالً بشبكة )‪ (WIFI‬يقوم الجهاز باالهتزاز )‪ (Vibrate‬وعرض رسالة‬
‫تبين أن الجهاز أصبح متصالً‪.‬‬
‫الخطوة األولي لتنفيذ هذا التمرين هي إنشاء الفئة (‪ )MyConnectivityReceiver‬الخاصة بمستقبل النشر‬
‫(‪ )Broadcast Receiver‬وهي موضحة باألسفل‪:‬‬
‫‪1:‬‬ ‫‪public class MyConnectivityReceiver extends‬‬
‫‪2:‬‬ ‫{‪BroadcastReceiver‬‬
‫‪3:‬‬
‫صفحــة ‪028 .‬‬

4: @Override
5: public void onReceive(Context context, Intent intent)
6: {
7: ConnectivityManager conMngr =
8: (ConnectivityManager)
9: context.getSystemService(Context.CONNECTIVITY_SERVICE);
10: NetworkInfo wifi =
11: conMngr.getNetworkInfo(ConnectivityManager.TYPE_WIFI);
12: if(wifi.isConnected()){
13: Vibrator vibrator = (Vibrator)
14: context.getSystemService(Context.VIBRATOR_SERVICE);
15: vibrator.vibrate(500);
16: Toast.makeText(context, "Connected to WIFI",
18: }
19: }
20: }
‫ والتي يتم تنفيذها تلقائياً عندما يستقبل‬,)31 ‫ إلى‬5 ‫ (أنظر الكود من سطر رقم‬onReceive() ‫الحظ أنه في الدالة‬
‫ يتم‬,‫) من النظام تفيد بتغير حالة االتصال بالشبكة‬Intent( ‫) رسالة هدف‬BroadcastReceiver( ‫مستقبل النشر‬
‫ إلى‬7 ‫) لفحص حالة الشبكة (أنظر األسطر من‬Connectivity Service) ‫استخدام أحد خدمات نظام أندرويد وهي‬
‫) لتقوم بعمل‬Vibrator Service) ‫ إذا أصبح الجهاز متصالً يتم استخدام خدمة أخرى من خدمات النظام وهي‬.)9
.)08 ‫ إلى‬03 ‫ يتم طباعة رسالة لتبين أن الجهاز أصبح متصالً (أنظر األسطر من‬,ً‫ أخيرا‬.‫اهتزاز لنصف ثانية‬
‫ الشكل يوضح‬.‫( وتحديد األحداث التي يستجيب لها‬Manifest) ‫الخطوة التالية هي تسجيل مستقبل النشر في ملف‬
:‫( الخاص بالتطبيق‬Manifest) ‫ملف الوثيقة‬
<manifest
package="ps.edu.ucas.broadcastreceiver"
android:versionName="1.0" >
<uses-permission
android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission
android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission
android:name="android.permission.VIBRATE" />
<uses-sdk
‫>‪android:targetSdkVersion="21" /‬‬
‫"‪android:allowBackup="true‬‬
‫"‪android:icon="@drawable/ic_launcher‬‬
‫"‪android:label="@string/app_name‬‬
‫> "‪android:theme="@style/AppTheme‬‬
‫…‬
‫"‪<receiver android:name=".MyConnectivityReceiver‬‬
‫>"‪android:enabled="true‬‬
‫‪<action‬‬
‫>‪android:name="android.net.conn.CONNECTIVITY_CHANGE" /‬‬
‫‪….‬‬
‫الحظ الجزء األخير الخاص بتسجيل مستقبل النشر (‪ )Broadcast Receiver‬حيث تم تحديد حدث النظام‬
‫‪ android.net.conn.CONNECTIVITY_CHANGE‬لالستماع له‪ .‬الحظ أيضاً اضافة أذونات خاصة‬
‫لالستماع لحالة الشبكة والستخدام الهزاز )‪.(Vibrator‬‬
‫قم بتشغيل التطبيق وتجربته وذلك بتغيير حالة الشبكة )‪ (WIFI‬من إعدادات الجهاز ومالحظة ما يحدث‪.‬‬
‫بث رسائل خاصة )‪(Broadcasting Custom Intents‬‬
‫يمكن تهيأت التطبيق الخاص بك لبث رسائل (‪ )Intent‬إلى تطبيقات أخرى أو إلى مكونات أخرى في نفس التطبيق‪.‬‬
‫في هذه الحالة يتم بث رسالة (‪ )Intent‬عن طريق تنفيذ أحدى الدوال الخاصة بذلك مثل الدالة )(‪.sendBroadcast‬‬
‫الرسالة المرسلة يتم استقابلها من قبل مستقبالت النشر )‪ (Broadcast Receivers‬المعدة الستقبال نفس نوع‬
‫(‪ )Intent‬والمسجلة من قبل تطبيقات أخرى أو في نفس التطبيق‪ .‬فمثالً‪ ,‬قد ترغب في إنشاء تواصل بين تطبيق ما‬
‫وأحد التطبيقات األخرى على الجهاز‪ .‬في هذه الحالة ما عليك إال إنشاء وتسجيل مستقبل بث ‪(Broadcast‬‬
‫)‪ Receiver‬في البرنامج المستقبل‪ ,‬ثم تقوم بنشر رسالة (‪ )Intent‬عن طريق البرنامج المرسل بحيث يوافق نوع‬
‫الرسالة (‪ )Intent‬النوع المحدد في مرشح الهدف )‪ (Intent Filter‬لمستقبل النشر‪ .‬يمكن استخدام هذه الطريقة‬
‫للتواصل بين أجزاء التطبيق الواحد من الواجهة (‪ )Activity‬وخدمة (‪ )Service‬تعمل في الخلفية مثالً‪ .‬يوضح‬
‫الكود التالي كيفية نشر رسالة عن طريق الدالة )(‪ broadcastIntent‬تنفذ عن النقر على زر‪:‬‬
‫{)‪public void broadcastIntent(View view‬‬
‫;)(‪Intent intent =new Intent‬‬
‫‪Intent.setAction("ps.edu.ucas.broadcastreceiver.CUSTOM_INTE‬‬
‫;)")‪NT‬‬
‫;)‪sendBroadcast(intent‬‬
‫صفحــة ‪051 .‬‬

‫الستقبال هذه الرسالة من تطبيق آخر‪ ,‬ال بد من تسجيل مستقبل نشر في التطبيق المستقبل بحيث يوافق مرشح الهدف‬
‫(‪ (Intent Filter‬نوع رسالة الهدف‪ .‬الشكل يوضح تسجيل مستقبل النشر ‪ MyReceiver‬المنشأ في المثال السابق‬
‫الستقبال الرسائل المرسلة من التطبيق في المثال السابق‬
‫…‬
‫>"‪<receiver android:name="MyReceiver‬‬
‫‪<action‬‬
‫>"‪android:name="ps.edu.ucas.broadcastreceiver.CUSTOM_INTENT‬‬
‫>‪</action‬‬
‫…‬
‫مالحظة‪ :‬لبث رسائل (‪ )Intent‬يمكن استخدام الدالة )( ‪ broadcastIntent‬أو )( ‪ .broadcastStickyIntent‬في‬

‫الدالة الثانية‪ ,‬الرسالة التي يتم نشرها تبقى في النظام لفترة‪ ,‬مما يمكن التطبيقات التي تسجل مستقبل النشر برمجياً‬
‫من استقبال الرسالة عندما تصبح جاهزةً لذلك‪ .‬أي أن الدالة الثانية تستهدف التطبيقات التي تستمع متأخراً للرسائل‬
‫التي يتم نشرها‪.‬‬

‫سنقوم بتنفيذ تطبيق بسيط نقوم فيه بإنشاء مستقبل نشر العتراض رسالة هدف مرسلة من أحد التطبيقات‪ .‬واجهة‬
‫التطبيق موضحة بشكل ‪ ,8-1‬حيث تتكون من زر واحد )‪ ,)Broadcast Intent‬عند النقر عليه يتم نشر رسالة‬
‫بحدث )‪ (Action‬محدد‪ .‬عند استقبال الرسالة من قبل أحد مستقبالت النشر (‪ (Broadcast Receivers‬يتم طباعة‬
‫رسالة على الشاشة‪ .‬إذا كان باستطاعتك تنفيذ استقبال الرسائل الخاصة باستخدام مستقبالت النشر‪ ,‬يمكنك بنفس‬
‫الكيفية استقبال رسائل النظام‪.‬‬
‫صفحــة ‪050 .‬‬

8-21 ‫ واجهة التطبيق الخاص بتمرين‬:8-1 ‫شكل‬

:‫كود الفعالية الخاص بالتطبيق موضح في األسفل‬
1: public class MainActivity extends Activity{
2:
3: @Override
4: public cvoid onCreate(Bundle savedInstanceState){
7: }
8: // broadcast a custom (Intent).
9: public void broadcastIntent(View view){
10: Intent intent =new Intent();
11: intent.setAction("ps.edu.ucas.broadcastreceiver.CUSTOM_
12: INTENT");
13: sendBroadcast(intent);
14: }
15:}
‫) ويتم تحديد‬Implicit Intent) ‫" يتم إنشاء هدف مضمن‬Broadcast Intent" ‫الحظ أنه عند النقر على زر‬
‫" (يمكن اختيار أي اسم‬ps.edu.ucas.broadcastreceiver.CUSTOM_INTENT" ‫حدث خاص باسم‬
Tutorialspoint, http://www.tutorialspoint.com/android/android_broadcast_receivers.htm 1
‫( هذا الهدف باستخدام الدالة‬Broadcast) ‫ يتم نشر‬.)‫للحدث بشرط أن ال يتكرر مع اسم حدث آخر‬
)02 ‫ إلى‬01 ‫ (أنظر األسطر من‬setBroadcast()
‫) الذي من المفترض أن يستمع للحدث الخاص‬Broadcast Receiver( ‫نقوم بعد ذلك بانشاء مستقبل النشر‬
‫) الخاصة‬MyCustomActionReceiver( ‫ الكود التالي يوضح الفئة‬.‫ويستجيب له بطباعة رسالة على الشاشة‬
:‫بذلك‬
1: public class MyCustomActionReceiver extends
2: BroadcastReceiver{
3: @Override
4: public void onReceive(Context context,Intent
5: intent){
6: Toast.makeText(context,"Intent
7: Detected.",Toast.LENGTH_LONG).show();
8: }
9:}
‫ الحظ أن‬.(Manifest) ‫) في ملف الوثيقة‬Broadcast Receiver( ‫وفي الخطوة األخيرة يتم تسجيل مستقبل النشر‬
ً‫( يطابق اسم الحدث الذي تم ارساله مسبقا‬Intent Filter( ‫) المستخدم في مرشح الهدف‬Action( ‫اسم الحدث‬
.setBroadcast() ‫) باستخدام الدالة‬Intent( ‫ضمن الهدف‬
<manifest
package="ps.edu.ucas.customaction"
android:versionName="1.0">
<uses-sdk
android:targetSdkVersion="15"/>
<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme">
…
<receiver android:name="MyCustomActionReceiver">
<intent-filter>
<action
android:name="ps.edu.ucas.broadcastreceiver.CUSTOM_INTENT">
</action>
</intent-filter>
</receiver>
‫اإلشعارات )‪(Notifications‬‬
‫اإلشعار (‪ )Notification‬هي رسالة يمكن إظهارها للمستخدم خارج إطار واجهة التطبيق‪ ,‬بمعنى أنه يمكن للنظام‬
‫إرسال إشعارات (‪ (Notifications‬للمستخدم دون الحاجة إلى تشغيل تطبيق معين‪ .‬عندما يقوم النظام بارسال‬
‫اشعار (‪ )Notification‬للمستخدم‪ ,‬مثل إعالم المستخدم بوصول رسالة ما ‪ SMS‬أو اكتمال تحميل ملف من شبكة‬
‫اإلنترنت‪ ,‬يتم إظهار اإلشعار (‪ )Notification‬كأيقونة في منطقة اإلشعارات (‪( (Notification Area‬أنظر‬
‫شكل ‪ ,) 8-2‬وعند النقر على أيقونة اإلشعار يتم إظهار التفاصيل في درج اإلشعارات (‪(Notification Drawer‬‬
‫(أنظر شكل ‪.)8-3‬‬
‫شكل ‪ :8-2‬منطقة األشعارات )‪(Notification Area‬‬
‫شكل ‪ :8-3‬درج األشعارات )‪(Notification Drawer‬‬
‫صفحــة ‪052 .‬‬

‫إنشاء اإلشعار (‪)Notification‬‬

‫إلنشاء إشعار (‪ )Notification‬يجب في البداية إنشاء كائن من نوع ‪ Notification.Builder‬ومن خالله يتم‬
‫تحديد خصائص اإلشعار وواجهته واإلجراء الذي ينفذ عند النقر على اإلشعار‪ .‬بعد تحديد هذه الخصائص‪ ,‬يتم إنشاء‬
‫الكائن الخاص باإلشعار ‪ Notification‬عن طريق تنفيذ الدالة )(‪ .Notification.Builder.build‬إلرسال‬
‫اإلشعار‪ ,‬يتم تنفيذ الدالة )(‪.NotificationManager.notify‬‬
‫اإلشعار (‪ )Notification‬يجب أن يشتمل على األقل على ما يلي‪ ,‬والتي يتم تحديدها من خالل الكائن‬
‫‪:Notification.Builder‬‬
‫أيقونة صغيرة ‪ small icon‬يتم تحديدها عن طريق الدالة )(‪.setSmallIcon‬‬ ‫‪‬‬
‫عنوان ‪ Title‬يتم تحديده عن طريق الدالة )(‪.setContentTitle‬‬ ‫‪‬‬
‫التفاصيل ‪ ,detail text‬يتم تحديده عن طريق الدالة )(‪.setContentText‬‬ ‫‪‬‬
‫كل اإلعدادات والخصائص األخرى لإلشعار (‪ )Notification‬هي إختيارية ويمكن التعرف على تفاصيلها‬
‫باالطالع على تفاصيل الفئة ‪ .Notification.Builder‬المثال التالي يوضح طريقة إنشاء إشعار )‪(Notification‬‬
‫وإرساله‪:‬‬
‫‪1:‬‬ ‫‪Notification.Builder builder = new‬‬
‫‪2:‬‬ ‫;))(‪Notification.Builder(getApplicationContext‬‬
‫‪3:‬‬ ‫;)"‪builder.setContentTitle("News from UCAS‬‬
‫‪4:‬‬ ‫‪builder.setContentText("Graduation ceremonies started‬‬
‫‪5:‬‬ ‫;)"‪for UCAS‬‬
‫‪6:‬‬ ‫;)‪builder.setSmallIcon(R.drawable.ic_launcher‬‬
‫‪7:‬‬ ‫;)(‪Notification notification = builder.build‬‬
‫‪8:‬‬ ‫= ‪NotificationManager manager‬‬
‫‪9:‬‬ ‫(‪(NotificationManager)getSystemService‬‬
‫‪10:‬‬ ‫;)‪Context.NOTIFICATION_SERVICE‬‬
‫‪11:‬‬ ‫;)‪manager.notify(id, notification‬‬
‫الحظ أنه في البداية يتم إنشاء كائن من نوع (‪( (Notification.Builder‬أنظر سطر رقم ‪ 0‬و‪ )3‬ومن ثم تحديد‬
‫الخصائص األساسية لإلشعار بتنفيذ الدوال )(‪setSmallIcon() ,setContentText() ,setContentTitle‬‬
‫(أنظر األسطر من ‪ 2‬إلى ‪.)6‬‬
‫بعد تحديد خصائص اإلشعار (‪ )Notification‬من خالل ‪ ,Notification.Builder‬يتم إنشاء كائن من نوع‬
‫‪ Notification‬بتنفيذ الدالة ((‪( Notification.Builder.build‬سطر رقم ‪.)7‬‬
‫إلرسال اإلشعار (‪ ,)Notification‬يجب في البداية الوصول للكائن (‪ (NotificationManager‬وهو أحد‬
‫خدمات نظام أندرويد المتوفرة في الخلفية (األسطر من ‪ 8‬إلى ‪ ,)01‬ثم يتم إرسال اإلشعار بتنفيذ الدالة‬
‫صفحــة ‪055 .‬‬

‫ يمرر لها باإلضافة للكائن من‬notify() ‫ الحظ أن الدالة‬.)00 ‫ (سطر رقم‬NotificationManager.notify()

‫ يمكن من خالل هذا المعرف الوصول‬.‫ يتم اختياره من قبل المستخدم‬id ‫) رقم معرف‬Notification( ‫نوع‬
.‫لإلشعار الحقا ً لتعديله أوحذفه‬
)Notification Action( ‫اإلجراء المرتبط باإلشعار‬
‫ عند النقر على‬,ً‫ فمثال‬.)Notification( ‫ يمكن إضافة إجراء واحد أو أكثر لإلشعار‬,ً‫على الرغم من كونه اختياريا‬
.‫) إلظهار تفاصيل إضافية عن اإلشعار‬Activity( ‫ يمكن تشغيل فعالية‬,‫اإلشعار المستلم‬
‫( المراد تنفيذه عن طريق تعريف كائن من‬Action) ‫ يتم تعريف اإلجراء‬,)Notification( ‫داخل الكائن من نوع‬
‫ بعد ذلك يتم تمرير‬.‫) يحدد اإلجراء المراد تنفيذه‬Intent( ‫) والذي يحتوي داخله على هدف‬Pending (Intent ‫نوع‬
‫ من خالل‬setContentIntent() ‫( عند طريق الدالة‬PendingIntent) ‫الكائن من نوع الهدف المعلق‬
.Notification.Builder
)Activity( ‫( لإلشعار حيث يتم تشغيل الفعالية‬Action) ‫المثال التالي يستكمل المثال السابق وذلك بإضافة حدث‬
:‫الخاصة بمتصفح اإلنترنت لفتح صفحة الكلية الجامعية‬
1: Notification.Builder builder = new
2: Notification.Builder(getApplicationContext());
3: builder.setContentTitle("News from UCAS");
4: builder.setContentText("Graduation ceremonies started
5: for UCAS");
6: builder.setSmallIcon(R.drawable.ic_launcher);
7: builder.setContentInfo("Click for more info");
9: intent.setData(Uri.parse("http://www.ucas.edu.ps"));
10: PendingIntent pIntent =
11: PendingIntent.getActivity(getApplicationContext(), 0,
12: intent,0);
13: builder.setContentIntent(pIntent);
14: Notification notification = builder.build();
15: NotificationManager manager =
16: (NotificationManager)getSystemService(
17: Context.NOTIFICATION_SERVICE);
18: manager.notify(id, notification);
‫) لتحديد الحدث‬Intent( ‫يتم إنشاء كائن من نوع‬, (Notification) ‫( وربطه باإلشعار‬Action) ‫إلنشاء حدث‬
ً‫) ويتم أيضا‬8 ‫( (أنظر سطر رقم‬ACTION_VIEW( ‫) المراد تنفيذه وهو في المثال الموضح من نوع‬Action(
.)9 ‫ (أنظر سطر رقم‬setData() ‫تحديد عنوان موقع الويب المراد فتحه من خالل الدالة‬
‫بعد ذلك يتم إنشاء هدف معلق )‪ )PendingIntent‬والذي يمرر له كائن الهدف (‪ )Intent‬الخاص باإلجراء المراد‬
‫تنفيذه (أنظر األسطر من ‪ 01‬إلى ‪ .)03‬بعد ذلك يتم تمرير الكائن من نوع )‪ )PendingIntent‬للكائن‬
‫)‪ (Notification.Builder‬من خالل الدالة )(‪( setContentIntent‬أنظر سطر رقم ‪)02‬‬
‫يمكن فهم الهدف المعلق )‪ (PendingIntent‬على أنه رسالة موجهة للنظام لنطلب منه تشغيل إجراء محدد عند‬
‫النقر على اإلشعار ‪ Notification‬عند وصوله‪ .‬اإلجراء الذي يتم تنفيذه محدد عن طريق الكائن ‪ ,Intent‬الذي‬
‫ممرناه لكائن الهدف المعلق )‪ (PendingIntent‬أثناء إنشائه‪ .‬أي أن اإلجراء المحدد في الهدف المعلق‬
‫)‪ (PendingIntent‬ينفذ من قبل النظام ويكون معلقا ً لحين النقر على اإلشعار )‪ (Notification‬المستلم‪.‬‬

‫في هذا التمرين سنقوم ببناء تطبيق منبه بسيط يقوم بتنبيه المستخدم بعد وقت محدد ليقوم بتنفيذ بمتابعة آخر األخبار‬
‫على مو قع الكلية الجامعية للعلوم التطبيقية‪ .‬التنبيه يتم بإرسال إشعار )‪ (Notification‬عندما يحين الوقت المحدد‪,‬‬
‫وعند النقر على هذا اإلشعار يتم فتح الموقع اإللكتروني للكلية الجامعية‪.‬‬
‫واجهة التطبيق موضحة بشكل ‪ 8-4‬حيث يقوم المستخدم بتحديد وقت االنتظار والذي بعد انقضائه يتم إرسال‬
‫اإلشعار )‪ . (Notification‬كما هو موضح يقوم المستخدم بإدخال وقت االنتظار بالدقائق والثواني‪ ,‬ثم يضغط على‬
‫زر "‪ "Set Alart‬وذلك لتفعيل خدمة التنبيه‪.‬‬
‫شكل ‪ :8-4‬واجهة التطبيق الخاص بتمرين ‪8-3‬‬
‫صفحــة ‪057 .‬‬

:(MainActivity) ‫ نبدأ أوالً بعرض ملف التصميم الخاص بالفعالية‬,‫لبناء هذا التطبيق‬
<RelativeLayout
android:id="@+id/RelativeLayout1"
<TextView
android:id="@+id/tvAlarmTitle"
android:text="Simple Alarm" />
<TextView
android:id="@+id/tvMinutes"
android:layout_marginRight="26dp"
android:layout_marginLeft="20dp"
android:text="Minutes:" />
<TextView
android:id="@+id/tvSeconds"
android:layout_alignLeft="@+id/tvMinutes"
android:layout_below="@+id/tvMinutes"
android:text="Seconds:" />
<EditText
android:id="@+id/edMinutes"
android:layout_alignBaseline="@+id/tvMinutes"
android:layout_alignBottom="@+id/tvMinutes"
android:layout_toRightOf="@+id/tvMinutes"
android:inputType="number"
android:ems="10" >
<requestFocus />
</EditText>
<EditText
android:id="@+id/edSeconds"
android:layout_alignBaseline="@+id/tvSeconds"
android:layout_alignBottom="@+id/tvSeconds"
android:layout_alignLeft="@+id/edMinutes"
android:inputType="number"
android:ems="10" />
<Button
android:id="@+id/setAlarmBtn"
android:layout_below="@+id/edSeconds"
android:text="Set Alarm" />
</RelativeLayout>
:‫( موضح باألسفل‬MainActivity) ‫ملف الكود الخاص بالفعالية‬
2:
3: @Override
7: final EditText minutesTxt = (EditText)

8: this.findViewById(R.id.edMinutes);
9: final EditText secondsTxt = (EditText)
10: this.findViewById(R.id.edSeconds);
11: Button setAlarmBtn = (Button)
12: this.findViewById(R.id.setAlarmBtn);
13: setAlarmBtn.setOnClickListener(new
15:
16: @Override
18: int minutes =
19: Integer.parseInt(minutesTxt.getText().toString());
20: int seconds =
21: Integer.parseInt(secondsTxt.getText().toString());
22: scheduleAlarm(minutes, seconds);
23: }
24: });
25: }
26:
27: public void scheduleAlarm(int minutes,int seconds){
28: long currentTime = new
29: GregorianCalendar().getTimeInMillis();
30: long scheduleTime = currentTime +
31: minutes*60*1000 + seconds * 1000;
32: Intent intentAlarm = new
33: Intent("ps.edu.ucas.alarmnotify.ALARM_ACTION");
34: AlarmManager alarmManager = (AlarmManager)
35: getSystemService(Context.ALARM_SERVICE);
36:
37: alarmManager.set(AlarmManager.RTC_WAKEUP,scheduleTime,
38: PendingIntent.getBroadcast(this,1, intentAlarm,
39: PendingIntent.FLAG_UPDATE_CURRENT));
40: Toast.makeText(this, "Alarm scheduled for "+
41: minutes +" minutes and "+ seconds +" seconds" ,
43: }
44: }
‫" يتم قراءة القيم المدخلة في عناصر اإلدخال وتحويلها إلى قيم رقمية‬Set Alarm" ‫الحظ أنه عند النقر على زر‬
:‫كما هو موضح‬
‫= ‪int minutes‬‬
‫;))(‪Integer.parseInt(minutesTxt.getText().toString‬‬
‫= ‪int seconds‬‬
‫;))(‪Integer.parseInt(secondsTxt.getText().toString‬‬
‫يتم بعد ذلك تنفيذ الدالة )(‪ scheduleAlarm‬والتي يمرر لها قيمة الدقائق والثواني‪ .‬في هذه الدالة يتم في البداية‬
‫تحديد وقت التنبيه ويساوي الوقت الحالي مضافا ً إليه مجموع الدقائق والثواني الدمخلة‪ ,‬وهو ما يتم من خالل هذين‬
‫السطرين‪:‬‬
‫;)(‪Long currentTime=new GregorianCalendar().getTimeInMillis‬‬
‫‪long scheduleTime = currentTime + minutes*60*1000 + seconds‬‬
‫;‪* 1000‬‬
‫لتفعيل خدمة التنبيه يتم استخدام أحد الخدمات المتوفرة في نظام أندرويد وهي خدمة مدير التنبيه ‪(Alarm‬‬
‫)‪ Manager‬والذي يمكن إعداده ليقوم بنشر هدف معين )‪ (broadcast Intent‬عندما يحين وقت التنبيه‪ .‬لتهيئة‬
‫مدير التنبيه يتم إنشاء هدف مضمن )‪ (Implicit Intent‬باسم )‪ (intentAlarm‬وذلك ليتم نشره تلقائياً من قبل‬
‫مدير التنبيه عندما يحين الوقت المحدد كالتالي‪:‬‬
‫‪Intent intentAlarm = new‬‬
‫;)"‪Intent("ps.edu.ucas.alarmnotify.ALARM_ACTION‬‬
‫اسم الحدث )‪ (Action‬المستخدم هو اسم افتراضي خاص بالتطبيق‪ .‬الحقا ً سيتم بناء مستقبل نشر ‪(Broadcast‬‬
‫)‪ Receiver‬ليقوم باستقبال الهدف )‪ (Intent‬المرسل بنفس الهدف المحدد‪.‬‬
‫يتم بعد ذلك إعداد مدير التنبيه (‪ )Alarm Manager‬بإنشاء هدف معلق )‪ (PendingIntent‬وذلك لنطلب منه‬
‫نشر الهدف )‪ (intentAlarm‬عندما يحين الوقت المحدد وذلك من خالل الكود التالي‪:‬‬
‫‪alarmManager.set(AlarmManager.RTC_WAKEUP,scheduleTime,‬‬
‫‪PendingIntent.getBroadcast(this,1, intentAlarm,‬‬
‫;))‪PendingIntent.FLAG_UPDATE_CURRENT‬‬
‫الخطوة التالية تتضمن إنشاء مستقبل نشر )‪ (Broadcast Receiver‬ليقوم تلقائيا ً باستقبال الهدف المرسل من مدير‬
‫التنبية ومن ثم إرسال اإلشعار )‪ (Notification‬إلى المستخدم‪ .‬الكود التالي خاص بمستقبل نشر باسم‬
‫‪:MyAlarmReceiver‬‬
‫‪1:‬‬ ‫{‪public class MyAlarmReceiver extends BroadcastReceiver‬‬
‫‪2:‬‬
‫‪3:‬‬ ‫;‪public static final int NOTIFICAION_ID = 1‬‬
‫‪4:‬‬
‫‪6:‬‬ ‫)‪public void onReceive(Context context, Intent intent‬‬
‫‪7:‬‬ ‫{‬
‫‪8:‬‬ ‫‪Notification.Builder builder = new‬‬
‫صفحــة ‪060 .‬‬

9: Notification.Builder(context);
10: builder.setContentTitle("Alarm sent off");
11: builder.setContentText("Time to check latest news
12: from UCAS");
13: builder.setSmallIcon(R.drawable.ic_launcher);
14: builder.setContentInfo("Click for more info");
15: Intent ucasIntent = new
16: Intent(Intent.ACTION_VIEW);
17: ucasIntent.setData(Uri.parse("http://www.ucas
18: .edu.ps"));
19: PendingIntent pIntent =
20: PendingIntent.getActivity(context, 0, ucasIntent,0);
21: builder.setContentIntent(pIntent);
22: Notification notification = builder.build();
23: NotificationManager manager =
24: (NotificationManager) context.getSystemService(
25: Context.NOTIFICATION_SERVICE);
26: manager.notify(NOTIFICAION_ID, notification);
27: }
28: }
:‫( كما هو موضح‬Manifest) ‫( في ملف الوثيقة‬MyAlarmReceiver) ‫ ال ننسى تسجيل مستقبل النشر‬,ً‫وأخيرا‬
<receiver android:name=".MyAlarmReceiver"
android:enabled="true">
<intent-filter>
<action
android:name="ps.edu.ucas.alarmnotify.ALARM_ACTION" />
</intent-filter>
</receiver>
‫( يطابق اسم الحدث الخاص بالهدف‬Intent Filter) ‫( المحدد في مرشح الهدف‬Action) ‫الحظ أن اسم الحدث‬
.(Alarm Manager) ‫( الذي يرسله مدير التنبيه‬Intent)
.(Notification) ‫قم بتشغيل التطبيق وتجربته بإدخال وقت االنتظار ثم انتظار وصول اإلشعار‬
‫أسئلة على الوحدة الثامنة‬

‫‪ .0‬ما فائدة مستقبل النشر (‪)Broadcast Receiver‬؟ وما الفرق بينه وبين الفعالية )‪(Activity‬؟‬
‫‪ .3‬قم ببناء تطبيق يقوم تلقائيا ً بإرسال إشعار )‪ (Notification‬للمستخدم عند تغيير الوقت من إعدادات الهاتف‪.‬‬
‫‪ .2‬قم بالتعديل على تمرين ‪ 6-2‬الخاص بقواعد البيانات وذلك بنشر رسالة )‪ (sendBroadcasr‬عند إضافة أو‬
‫حذف بيانات أي طالب‪ .‬قم بعد ذلك بإنشاء مستقبل نشر )‪ (Broadcast Receiver‬الستقبال هذه الرسائل‬
‫وإرسال إشعار )‪ (Notification‬للمستخدم لإلعالمه باإلجراء الذي تم تنفيذه على قاعدة بيانات الطالب‪.‬‬
‫‪ .2‬ما الفرق بين الرسالة التي يتم طباعتها باستخدام ‪ Toast‬واإلشعار ‪Notification‬؟‬
‫‪ .5‬ما الفرق بين ‪ Intent‬و ‪PendingIntent‬؟‬
‫صفحــة ‪062 .‬‬

‫الوحدة التاسعة‪:‬‬
‫تصميم الوجهات باستخدام القطع‬
‫)‪(User Interface Design by Using Fragments‬‬
‫‪ ‬مفهوم القطع (‪ )Fragments‬واستخداماتها‪.‬‬
‫‪ ‬استخدام القطع )‪ (Fragments‬إلنشاء تطبيقات موائمة تتكيف مع حجوم األجهزة المختلفة وأوضاع‬
‫العرض‪.‬‬
‫‪ ‬دورة حياة القطعة (‪ )Fragment‬وعالقتها بالفعالية المضيفة )‪.(Activity‬‬
‫‪ ‬طريقة إنشاء القطع (‪ )Fragments‬وربطها بالفعاليات )‪.(Activities‬‬
‫‪ ‬التواصل وتبادل البيانات بين القطع (‪.)Fragments‬‬
‫‪ ‬إنشاء مربعات الحوار )‪ (Dialogs‬المختلفة وتخصيصها‪.‬‬
‫القطعة )‪ (Fragment‬واستخداماتها‬
‫القطعة )‪ (Fragment‬تمثل جزء من واجهة المستخدم المعروضة ضمن الفعالية (‪ ,)Activity‬حيث يمكن تجميع‬
‫عدة قطع )‪ (Fragments‬لتكوين واجهة واحدة تعرض في الفعالية‪ .‬باإلضافة إلى ذلك‪ ,‬يمكن استخدام القطعة‬
‫)‪ (Fragment‬في أكثر من واجهة‪.‬‬
‫يمكن استخدام القطع )‪ (Fragments‬وإعادة هيكلتها للتالءم من أحجام الشاشات المختلفة ‪.‬فمثالً‪ ,‬شاشات الهواتف‬
‫الصغيرة ال تتسع لعرض الكثير من المكونات‪ ,‬لذلك يتم عرض مكون واحد‪ ,‬على هيئة قطعة واحدة ‪,Fragment‬‬
‫داخل واجهة الفعالية (‪ ,)Activity‬حيث من الممكن أن يشتمل التطبيق على عدة فعاليات (‪ )Activities‬تعرض‬
‫كل منها قطعة واحدة )‪ (Fragment‬نظراً لعدم إمكانية عرض أكثر من قطعة لصغر مساحة الشاشة‪ .‬أما في حالة‬
‫األجهزة اللوحية‪ ,‬فمن الممكن تجميع أكثر من قطعة )‪ (Fragment‬في نفس الواجهة التي تتسع لعرض عدد أكبر‬
‫من المكونات‪ .‬في كال الحالتين‪ ,‬يتم إعادة استخدام نفس القطع ولكن بترتيب وهيكلية مختلفة‪ .‬القدرة على إعادة‬
‫استخدام قطع الواجهة ‪ Fragments‬توفر الجهد والوقت الالزم في حالة إنشاء واجهة جديدة لكل جهاز مختلف‪.‬‬
‫كمثال عملي على استخدام القطع ‪ Fragments‬في تصميم الواجهات لألجهزة المختلفة‪ ,‬افترض ان هناك تطبيق‬
‫يعرض قائمة من العناصر‪ ,‬وعند اختيار أي عنصر يتم عرض تفاصيله (مشابه لفكرة تطبيق إخباري)‪ .‬واجهة هذا‬
‫البرنامج يمكن تقسيمها إلى قطعتين‪ :‬قطعة ‪ 0‬خاصة بعرض القائمة الرئيسية‪ ,‬وقطعة ‪ 3‬لعرض تفاصيل أي عنصر‬
‫يتم اختياره من القائمة‪ .‬في حالة الجهاز اللوحي‪ ,‬يمكن عرض كال القطعتين في نفس الواجهة حيث تتسع المساحة‬
‫لذلك‪ .‬أما في حالة الهاتف ذي الشاشة األصغر‪ ,‬فيتم عرض كل قطعة )‪ (Fragment‬في فعالية (‪ :)Activity‬حيث‬
‫تحتوي الفعالية األولى على قائمة العناصر (أنظر شكل ‪ .)9-1‬وعند النقر على أي عنصر في القائمة يتم عرض‬
‫التفاصيل في فعالية جديدة تحل محل القائمة‪ .‬الحظ أن نفس القطع )‪ (Fragments‬تم استخدامها ولكن بترتيب‬
‫مختلف في كل حالة‪.‬‬
‫صفحــة ‪062 .‬‬
‫يمكن اعتبار أن القطعة )‪ (Fragment‬هي وحدة مستقلة بذاتها ولها دورة حياتها ويمكن إضافتها إلى أو حذفها من‬
‫الفعالية(‪ )Activity‬أثناء تنفيذ التطبيق‪ .‬القطعة )‪ (Fragment‬يجب أن تكون مضمنة داخل فعالية (‪,)Activity‬‬
‫أي أنه ال يمكن عرضها بدون (‪ .)Activity‬كذلك دورة حياة القطعة )‪ (Fragment‬تتأثر بشكل مباشر بدورة حياة‬
‫الفعالية (‪ .)Activity‬عن إيقاف أو تدمير الفعالية يتم إيقاف أو تدمير القطع المضمنة داخلها‪.‬‬
‫‪1‬‬
‫شكل ‪ :9-1‬استخدام القطع )‪ (Fragments‬لمواءمة التطبيق مع حجوم الشاشات المختلفة‬
‫استخدام القطع )‪ (Fragments‬ال يفيد فقط في مواءمة واجهة المستخدم مع األجهزة ذات المساحات المختلفة‪ ,‬ولكن‬
‫أيضا في مواءمة الواجهة مع اتجاه العرض لنفس الجهاز‪ .‬فمثالً يمكن تركيب الواجهة في الوضع الرأسي ‪Portrait‬‬
‫بشكل مختلف عن تركيبها في الوضع األفقي ‪ ,Landscape‬حيث يتم استخدام نفس القطع ولكن بتركيب مختلف‪.‬‬
‫إنشاء القطع )‪(Fragments‬‬
‫إلنشاء قطعة )‪ (Fragment‬يجب إنشاء فئة جديدة متفرعة )‪ )subclass‬من الفئة ‪ Fragment‬أو أي فئة أخرى‬
‫متفرعة منها مثل ‪ DiaglogFragment ,ListFragment‬وغيرها‪ .‬الفئة الجديدة (‪ )class‬الخاصة بالقطعة‬
‫‪ Fragment‬تحتوي على عدد من دوال االتصال الراجع (‪ )Callback Methods‬شبيهة بتلك الموجودة في‬
‫الفعالية (‪ )Activity‬مثل )(‪ onStop() ,onPause() ,onStart() ,onCreate‬وغيرها من الدوال‪ .‬عادةً‪ ,‬يتم‬
‫كتابة بعض هذه الدوال لتحديد اإلجراء المراد تنفيذه في كل مرحلة من دورة حياة القطعة )‪ .(Fragment‬شكل ‪9-2‬‬
‫‪Tutorial on Fragments by Lars Vogel, http://www.vogella.com/tutorials/AndroidFragments/article.html 1‬‬
‫صفحــة ‪065 .‬‬

‫يوضح الدوال التي يتم تنفيذها خالل دورة حياة القطعة )‪ ,(Fragment‬وحالة الفعالية المضيفة‪ .‬ونوضح فيما يلي‬
‫أهم الدوال التي يحتاج المطور إلى كتابتها لتنفيذ بعض اإلجراءات‪.‬‬
‫‪1‬‬
‫شكل ‪ :9-2‬دورة حياة القطعة )‪ (Fragment Life Cycle‬وعالقتها بالفعالية‬
‫‪Fragments, Android Developer, http://developer.android.com/guide/components/fragments.html 1‬‬

‫صفحــة ‪066 .‬‬
‫)(‪ :onCreate‬يتم تنفيذ هذه الدالة تلقائيا ً من قبل النظام عن إنشاء القطعة )‪ (Fragment‬وقبل عرضها‪ .‬يتم‬ ‫‪‬‬
‫عادةً استخدام هذه الدالة السترجاع البيانات التي تم حفظها عند توقف الـقطعة )‪ .(Fragment‬يمرر إلى هذه‬
‫الدالة حزمة )‪ (Bundle‬والتي يتم منها استرجاع البيانات‪ .‬الحظ أنه في حالة استخدام القطع )‪(Fragments‬‬
‫لبناء الواجهة‪ ,‬فإن كل قطعة مسؤولة عن حفظ واسترجاع البيانات الخاصة بها‪ .‬يجب أيضاً االنتباه أن دورة‬
‫حياة القطعة مرتبطة بحياة الفعالية‪ :‬بمعنى توقف الفعالية يترتب عليه توقف القطعة مثالً‪.‬‬
‫)(‪ :onCreateView‬يتم تنفيذ الدالة تلقائيا ً عندما يحين وقت إنشاء الواجهة الخاصة بالقطعة‪ .‬عادةً‪ ,‬كل قطعة‬ ‫‪‬‬
‫يكون لها ملف تصميم خاص )‪ ,(Layout.xml‬ومن خالل الدالة )(‪ onCreateView‬يجب إنشاء واجهة‬
‫القطعة عن طريق تنفيذ الدالة )(‪ ,Inflater.inflate‬حيث يتم تحويل ملف الواجهة إلى كائن من نوع ‪View‬‬
‫يحوي كل عناصر الواجهة الخاصة بالقطعة‪ .‬الكود التالي يوضح مثال لتنفيذ الدالة )(‪ onCreateView‬حيث‬
‫يتم إنشاء واجهة القطعة والوصول برمجيا ً لعناصر الواجهة الموجودة داخله‪.‬‬
‫‪public View onCreateView(LayoutInflater inflater,‬‬
‫{ )‪ViewGroup container, Bundle savedInstanceState‬‬
‫‪View‬‬ ‫‪view‬‬ ‫=‬
‫‪inflater.inflate(R.layout.fragment_rsslist_overview,‬‬
‫;)‪container, false‬‬
‫‪Button‬‬ ‫‪button‬‬ ‫=‬ ‫)‪(Button‬‬
‫;)‪view.findViewById(R.id.button1‬‬
‫{ )(‪button.setOnClickListener(new View.OnClickListener‬‬
‫{ )‪publicvoid onClick(View v‬‬
‫‪// Do something‬‬
‫}‬
‫;)}‬
‫;‪return view‬‬
‫}‬
‫الحظ أنه يتم تمرير متغير من نوع ‪ ViewGroup‬للدالة )(‪ .inflate‬هذا المتغير يمثل الحاوية ‪container‬‬
‫الخاصة بالفعالية المضيفة (‪ )Activity‬والتي سيتم فيها تجميع كل القطع )‪ (Fragments‬لتكوين واجهة‬
‫النهائية للفعالية‪ .‬الدالة )(‪ inflate‬تقوم بإنشاء واجهة القطعة )‪ (Fragment‬للتتالءم مع إعدادات الحاوية‬
‫‪.container‬‬
‫الحظ أن الدالة )(‪ inflate‬تقوم بإعادة الكائن ‪ View‬والذي يمثل الواجهة الخاصة بالقطعة كاملةً‪ .‬بعد ذلك‬
‫يمكن البحث عن أي عنصر داخل الكائن ‪ View‬لعمل إجراء معين‪ .‬فمثالً‪ ,‬يوضح الكود السابق كيف تم‬
‫الوصول للزر الذي اسمه ‪ button1‬الموجود داخل واجهة القطعة ‪ Fragment‬باستخدام الدالة‬
‫)(‪ findViewById‬ومن ثم إضافة مستمع )‪ (Listener‬لتنفيذ إجراء ما عن النقر على الزر‪.‬‬
‫يجب االنتباه أنه من خالل الدالة )(‪ onCreateView‬ال يمكن الوصول والتعامل مع الفعالية (‪)Activity‬‬
‫حيث أن إنشاءها لم يكتمل بعد‪.‬‬
‫صفحــة ‪067 .‬‬

‫)(‪ :onActivityCreated‬يتم تنفيذ هذه الدالة بعد )(‪ onCreateView‬وذلك عندما يكتمل إنشاء الفعالية‬ ‫‪‬‬
‫(‪ . )Activity‬تكمن أهمية هذه أنه يمكن استخدامها لتنفيذ إي إجراءات تحتاج للكائن ‪ ,context‬أو الفعالية‬
‫(‪ .)Activity‬على سبيل المثال‪ ,‬إذا أردت تنفيذ الدالة )(‪ findViewById‬للوصول ألي عنصر واجهة في‬
‫الفعالية (‪ ,)Activity‬طباعة رسالة ‪ Toast‬أو إنشاء ‪ Adapter‬خاض بقائمة العرض (‪ ,)ListView‬يجب‬
‫تنفيذ كل ذلك باستخدام الكائن ‪ context‬أو الكائن ‪ .acitivty‬عند تنفيذ هذه الدالة‪ ,‬يمكن الوصول للفعالية من‬
‫خالل الدالة )(‪ ,getActivity‬ومن ثم يمكن تنفيذ كل اإلجراءات السابقة‪.‬الكود التالي يوضح تطبيق الدالة‬
‫)(‪ onActivityCreated‬حيث يتم فيها تعبئة قائمة (‪ )ListView‬باستخدام المحول ‪.ArrayAdapter‬‬
‫{ )‪public void onActivityCreated(Bundle savedInstanceState‬‬
‫;)‪super.onActivityCreated(savedInstanceState‬‬
‫‪String[] values = newString[] { "Android", "iPhone",‬‬
‫‪"WindowsMobile", "Blackberry", "WebOS", "Ubuntu",‬‬
‫;} "‪"Windows7", "Max OS X", "Linux", "OS/2‬‬
‫‪ArrayAdapter<String> adapter = new‬‬
‫‪ArrayAdapter<String>(getActivity(),‬‬
‫;)‪android.R.layout.simple_list_item_1, values‬‬
‫;)‪setListAdapter(adapter‬‬
‫}‬
‫)(‪ :onPause‬يتم تنفيذ هذه الدالة عند اإليقاف المؤقت للقطعة )‪ (Fragment‬حيث تكون القطعة مرئية ولكن‬ ‫‪‬‬
‫تم حجبها جزئيا ً من قبل فعالية )‪ (Activity‬أخرى‪ .‬تستخدم هذه الدالة في حفظ حالة القطعة أو بيانات أخرى‬
‫قبل إيقاف أو إغالق القطعة‪ .‬كما ذكرنا مسبقا ً في حالة الفعالية‪ ,‬يفضل تنفيذ كود حفظ الحالة في هذه الدالة بدالً‬
‫عن الدالة )(‪ , onStop‬حيث أن الدالة األخيرة قد ال يتم تنفيذها من قبل النظام في بعد األحيان‪ ,‬أما الدالة‬
‫)(‪ onPause‬فيتم تنفيذها دائماً من عند ايقاف أو تدمير القطعة )‪.(Fragment‬‬
‫)(‪ :onAttach‬يتم تنفيذ هذه الدالة عند ربط القطعة )‪ (Fragment‬بالفعالية (‪ .)Activity‬من المهم المالحظة‬ ‫‪‬‬
‫أنه عند تنفيذ هذه الدالة اليكون إنشاء عناصر الواجهة الخاصة القطعة والفعالية قد اكتمل وبذلك ال يمكن‬
‫الوصول إلى محتواهما من عناصر الواجهة‪ .‬يتم استخدام هذه الدالة للحصول على مؤشر لكائن الفعالية‬
‫(‪ ,)Activity‬وهو ما يلزم في حالة التواصل بين القطعة و الفعالية‪ .‬سيتم الحديث الحقاً عن استخدام هذه‬
‫للتواصل بين القطع )‪.(Fragments‬‬
‫إضافة القطع إلى الفعالية‬
‫في الخطوات السابقة تم شرح كيفية إنشاء الفعالية )‪ (Fragment‬والدوال التي نحتاج لتطبيقها عن اإلنشاء أو أثناء‬
‫عمل القطعة‪ .‬الخطوة التالية هو إضافة القطعة داخل الواجهة الخاصة بالفعالية (‪ )Activity‬والذي يتم بإحدى‬
‫طريقتين‪:‬‬
‫‪ .0‬إضافة القطع إلى الفعالية بطريقة ثابتة‪ :‬يتم ذلك بإضافة خاصية من نوع ‪ fragment‬داخل ملف ‪layout‬‬
‫الخاص بالفعالية‪ .‬يتم إضافة القطعة ‪ fragment‬تماما ً كما يتم إضافة أي عنصر واجهة آخر كما هو موضح‬
‫بالمثال التالي‪ .‬الحظ أن الخاصية ‪ android:name‬تشير إلى المسار الكامل للفئة (‪ )class‬الخاصة بالقطعة‬
‫صفحــة ‪068 .‬‬

‫ مما‬,android:id ‫( رقم معرف من خالل الخاصية‬Fragment) ‫ الحظ أيضا ً أنه تم إعطاء كل قطعة‬.‫المضافة‬
.‫يتيح الوصول للقطعة برمجياً فيما بعد‬
<LinearLayoutxmlns:android="http://schemas.android.com/apk/
res/android"
android:layout_height="fill_parent"
android:baselineAligned="false"
android:orientation="horizontal">
<fragment
android:id="@+id/listFragment"
android:name="ps.edu.ucas.fragmentApp.MyListFragment"></fra
gment>
<fragment
android:id="@+id/detailFragment"
android:name=" ps.edu.ucas.fragmentApp.MyDetailFragment">
</fragment>
</LinearLayout>
‫ يمكن‬,‫ أثناء تشغيل البرنامج‬Fragments ‫ إذا اردت التغيير في القطع‬:‫ إضافة القطع برمجيا ً أثناء التشغيل‬.3
‫ والذي يمكن الوصول إليه من خالل الفعالية‬Fragment Manager ‫استخدام الدوال التي يوفرها‬
‫ دوال إلضافة وحذف‬Fragment Manager ‫ يوفر‬.getFragmentManager() ‫) بتنفيذ الدالة‬Activity(
.)Fragments)‫واستبدال القطع‬
(Fragment) ‫ ال بد من تحديد مكان أو قالب فارغ في واجهة الفعالية ليتم إضافة القطعة‬,ً‫قبل تنفيذ ذلك برمجيا‬
‫ الخاص بالفعالية حيث تم إضافة عنصرين‬Layout ‫ المثال باألسفل يبين ملف الواجهة‬.‫إليه أو حذفه منها‬
‫ سيتم الحقا ً تعديل محتوى هذين العنصرين‬.android:id ‫ وكل منهما له معرف‬,‫ فارغين‬FrameLayout
.FragmentManager ‫( وذلك باستخدام‬Fragments) ‫بإضافة وحذف قطع‬
res/android"
android:orientation="horizontal">
<FrameLayout
android:id="@+id/listcontainer"
android:layout_height="match_parent" />
<FrameLayout
android:id="@+id/detailscontainer"
android:visibility="gone" />
</LinearLayout>
‫ مثالً) والذي يوضح كيفية إضافة‬onCreate() ‫بعد ذلك يتم تنفيذ الكود التالي من داخل الفعالية (من داخل الدالة‬
‫ الحظ مثالً أن الدالة‬.FrameLayout ‫( داخل القوالب من نوع‬Fragments) ‫قطع‬
‫) باإلضافة إلى الكائن‬R.id.listcontainer( ‫ يمرر لها المعرف الخاص بالقالب‬FragmentTransaction.add()
.)MyListFragment( ‫الخاص بالقطعة‬
FragmentManager fm = getFragmentManager();
// ‫اإلضافة‬
FragmentTransaction ft = fm.beginTransaction();
ft.add(R.id.listcontainer, new MyListFragment());
ft.commit();
// ‫استبدال‬
FragmentTransaction ft = fm.beginTransaction)();
ft.replace(R.id.listcontainer, new MyListFragment());
ft.commit();
// ‫حذف‬
Fragment fragment =
fm.findFragmentById(R.id.listcontainer);
FragmentTransaction ft = fm.beginTransaction();
ft.remove(fragment);
ft.commit();
‫يمكن أيضا ً أن نفحص برمجياً ما إذا كان الفعالية )‪ (Activity‬تحتوي على قطعة معينة )‪ (Fragment‬أم ال أثناء‬
‫عمل التطبيق‪ .‬يتم ذلك بالوصول للقطعة ‪ Fragment‬من خالل الدالة )(‪ findFragmentById‬ضمن مدير القطع‬
‫‪ .Fragment Manager‬ومن ثم ننفذ الدالة )(‪ isInLayout‬والتي تتحقق ما إذا كانت القطعة ‪Fragment‬‬
‫معروضة أم ال‪ .‬الكود التالي يوضح هذه العملية‪:‬‬
‫)‪DetailFragment fragment = (DetailFragment‬‬
‫‪getFragmentManager().findFragmentById(R.id.detailscontainer‬‬
‫;)‬
‫{ ))(‪if (fragment==null || ! fragment.isInLayout‬‬
‫‪// Do something‬‬
‫}‬
‫التواصل بين القطع )‪(Fragments‬‬
‫قد تحتاج القطع )‪ (Fragments‬للتواصل فيما بينها لتبادل البيانات أو األوامر‪ .‬على سبيل المثال‪ ,‬عند اختيار خبر‬
‫موجود في قائمة األخبار ضمن قطعة ما‪ ,‬يتم عرض تفاصيل الخبر في قطعة أخرى‪ .‬لتحقيق التواصل بين القطع‪,‬‬
‫يفضل أن ال يتم التواصل بين القطع )‪ (Fragments‬مباشرةً بل عن طريق الفعالية المضيفة (‪ .)Activity‬أي أن‬
‫القطعة تقوم بتمرير أمر ما أو بيانات إلى الفعالية المضيفة (‪ ,)Activity‬ومن ثم تقوم الفعالية بتمرير ما وصل إليها‬
‫إلى القطعة الهدف‪ .‬شكل يوضح كيفية التواصل بين قطعتين )‪ (Fragments‬من خالل الفعالية المضيفة‬
‫)‪ (Activity‬حيث تستقبل الفعالية أمر أو بيانات من القطعة األولى‪ ,‬وتقوم من خالل ما يسمى بمدير القطع‬
‫)‪ (Fragment Manager‬بالوصول إلى القطعة الثانية‪ .‬مدير القطع (‪ )Fragment Manager‬يمكن عن طريقه‬
‫الوصول ألي قطعة )‪ ,(Fragment‬كما يستخدم إلضافة أو حذف القطع برمجيا ً أثناء عمل التطبيق‪.‬‬
‫شكل ‪ :9-3‬التواصل بين القطع )‪ (Fragments‬من خالل الفعالية المضيفة ‪(Activity)1‬‬
‫‪Simple Developer, http://simpledeveloper.com/how-to-communicate-between-fragments-and-activities 1‬‬
‫صفحــة ‪070 .‬‬

:‫( للتواصل مع الفعالية المضيفة‬Fragment) ‫الكود التالي يوضح كيفية تهيئة القطعة‬
1: public class MyFragment extends Fragment {
2:
3: private MyFragmentListener listener;
4:
5: @Override
6: public View onCreateView(LayoutInflater inflater,
7: ViewGroup container,
8: Bundle savedInstanceState) {
9: View view =
10: inflater.inflate(R.layout.fragment_layout,
11: container, false);
12: Button button = (Button)
13: view.findViewById(R.id.button1);
14: button.setOnClickListener(new View.OnClickListener()
15: {
16: @Override
18: // Inform the Listener
19: listener.buttonClicked();
20: }
21: });
22: return view;
23: }
24: //Any class that needs to listen to the fragment
25: //changes should implement this listener
26: public interface MyFragmentListener {
27: public void buttonClicked();
28: }
29:
30: @Override
31: public void onAttach(Activity activity) {
32: super.onAttach(activity);
33: if(activity instanceof MyFragmentListener) {
34: listener = (MyFragmentListener) activity;
35: } else {
36: throw new ClassCastException(activity.toString()
37: + " Activity must implemenet
38: MyFragmentListener");
‫‪39:‬‬ ‫}‬
‫} ‪40:‬‬
‫‪41:‬‬
‫‪42: @Override‬‬
‫{ )(‪43: public void onDetach‬‬
‫‪44:‬‬ ‫;)(‪super.onDetach‬‬
‫‪45:‬‬ ‫;‪listener = null‬‬
‫} ‪46:‬‬
‫} ‪47:‬‬
‫فيما يلي سنقوم بشرح األجزاء الرئيسية من الكود السابق‪ :‬لتنفيذ التواصل بين الواجهة (‪ )Activity‬والقطعة‬
‫)‪ (Fragment‬يجب أن يتم تعريف واجهة برمجية (‪ )Interface‬تمثل المستمع (‪ )Listener‬الذي سوف يستمع‬
‫ألي تغيير يحصل في القطعة ‪( Fragment‬أنظر األسطر من ‪ 36‬إلى ‪ ,)38‬وهو ما يتم في الجزء التالي من الكود‪:‬‬
‫{ ‪public interface MyFragmentListener‬‬
‫;)(‪public void buttonClicked‬‬
‫}‬
‫ومن ثم تقوم الفعالية بعمل ‪ implement‬للواجهة البرمجية (‪ .)MyFragmentListener‬يمكن ألي مكون من‬
‫مكونات التطبيق االستماع للتغييرات التي تحصل في القطعة )‪ (Fragment‬من خالل تطبيق )‪(Implement‬‬
‫للواجهة البرمجية )‪ .)MyFragmentListener‬فائدة إنشاء الواجهة )‪ )MyFragmentListener‬هو إبقاء‬
‫القطعة قابلة لالستخدام دون أو تكون معتمدة على فعالية محددة‪.‬‬
‫بعد ذلك يتم تمرير الفعالية (‪ )Activity‬إلى القطعة )‪ (Fragment‬من خالل الدالة )(‪ onAttach‬وهو ما يتم أثناء‬
‫إنشاء القطعة كما هو موضح بالكود السابق (أنظر األسطر من ‪ 20‬إلى ‪ .)21‬في الدالة )(‪ onAttach‬يتم الفحص ما‬
‫إذا كانت الفعالية تطبق الواجهة البرمجية )‪ )MyFragmentListener‬عن طريق ‪( instanceof‬تفحص ما إذا‬
‫كانت الفعالية لها نفس نوع )‪( )MyFragmentListener‬أنظر سطر ‪ .)22‬اذا تحقق ذلك‪ ,‬يتم حفظ موشر للفعالية‬
‫في متغير باسم ‪ listener‬من نوع ‪:MyFragmentListener‬‬
‫{ )‪if(activity instanceof MyFragmentListener‬‬
‫;‪listener = MyFragmentListener) activity‬‬
‫}‬
‫عن طريق الكائن ‪ ,listener‬والذي يمثل الفعالية المضيفة في هذه الحالة‪ ,‬يمكن تمرير األوامر أو البيانات بتنفيذ أي‬
‫من الدوال المعرفة في الواجهة البرمجية (‪ .)MyFragmentListener‬فمثالً‪ ,‬في الكود السابق يتم إعالم الفعالية‬
‫)‪ )Activity‬عند النقر على الزر وذلك بتنفيذ الدالة )(‪( buttonClicked‬أنظر األسطر من ‪ 02‬إلى ‪.)32‬‬
‫صفحــة ‪072 .‬‬


‫هذا التطبيق هو مثال متكامل يوضح استخدام القطع )‪ (Fragments‬لبناء تطبيق معلوماتي عن المدن الفلسطينية‪.‬‬
‫المخرج النهائي للتطبيق موضح في شكل ‪ :9-4‬في الوضع األفقي ‪ ,Landscape‬يتم عرض قائمة بأسماء المدن‬
‫الفلسطينية على يسار الشاشة‪ ,‬وعند النقر على أي عنوان تظهر معلومات عن المدينة في يمين الشاشة‪ .‬في الوضع‬
‫الرأسي ‪ Portrait‬يتم عرض أسماء المدن في فعالية (‪ ,)Activity‬ومعلومات المدينة في فعالية جديدة‪.‬‬
‫لتصميم هذا التطبيق باستخدام القطع ‪ ,Fragments‬سنقوم بانشاء قطعتين‪ :‬واحدة لعرض أسماء المدن والثانية‬
‫لعرض معلومات كل مدينة‪ .‬واجهتا التطبيق في الوضع الرأسي ‪ Portait‬واألفقي ‪ Landscape‬تستخدمان نفس‬
‫القطع ولكن بترتيب مختلف‪ :‬حيث أنه في الوضع الرأسي يتم استخدام كل قطعة ‪ Fragment‬في فعالية منفصلة‪,‬‬
‫بينما في الوضع األفقي يتم جمع القطعتين ‪ Fragments‬في نفس واجهة الفعالية (‪.)Activity‬‬
‫الحظ أن التطبيق يتطلب تواصل بين القطع ‪ :Fragments‬حيث أن اختيار اسم مدينة من خالل القطعة األولى‬
‫‪ Fragment‬يتطلب تعبئة القطعة الثانية ‪ Fragment‬بمعلومات المدينة التي تم اختيارها‪.‬‬
‫لبناء هذا التطبيق ننفذ الخطوات التالية‪:‬‬
‫أوالً‪ :‬انشاء ملفات الواجهة الخاصة بالقطع )‪(Fragments‬‬
‫في المجلد ‪ layout‬ننشئ الملفات التالية‪:‬‬
‫‪ :Listfragment_layout.xml‬وهو يمثل تصميم الواجهة الخاصة بالقائمة (‪ )ListView‬التي تعرض‬ ‫‪‬‬
‫أسماء المدن‪ .‬هذا التصميم سيكون ضمن قطعة واحدة )‪:(Fragment‬‬
‫>?"‪<?xml version="1.0" encoding="utf-8‬‬
‫‪<LinearLayout‬‬
‫"‪xmlns:android="http://schemas.android.com/apk/res/android‬‬
‫"‪android:id="@+id/LinearLayout1‬‬
‫> "‪android:orientation="vertical‬‬
‫‪<ListView‬‬
‫"‪android:id="@+id/cityListView‬‬
‫> "‪android:layout_height="wrap_content‬‬
‫>‪</ListView‬‬
‫>‪</LinearLayout‬‬
‫صفحــة ‪072 .‬‬

‫واجهات التطبيق الخاص بتمرين ‪ 9-1‬في وضع العمل الرأسي )‪ :(Portrait‬التطبيق مكون من قطعتين وكل‬
‫قطعة تعرض في واجهة منفصلة‬
‫واجهة التطبيق الخاص بتمرين ‪ 9-1‬في وضع العمل األفقي )‪ :(Landscape‬التطبيق مكون من قطعتين يتم‬
‫عرضهما معا في نفس الواجهة‬
‫شكل ‪ :9-4‬واجهات وأوضاع العمل للتطبيق الخاص بتمرين ‪9-1‬‬
‫‪ :Detailsfragment_layout.xml‬وهو يمثل الواجهة الخاصة بعرض معلومات المدينة التي يتم اختيارها‬ ‫‪‬‬
‫من القائمة‪ ,‬وسيمثل أيضا ً قطعة واحدة (‪ .)Fragment‬يتكون التصميم من عناصر عرض )‪(TextView‬‬
‫صفحــة ‪075 .‬‬

‫( لعرض‬ImageView) ‫ باإلضافة لعنصر عرض‬,‫لعرض مساحة المدينة وعدد سكانها وأكبر تجمعاتها‬
.‫خارطة المدينة‬
<LinearLayout
<TextView
android:id="@+id/tvArea"
<TextView
android:id="@+id/tvPopulation"
<TextView
android:id="@+id/tvLargestCity"
<ImageView
android:id="@+id/ivMap"
android:src="@drawable/ic_launcher"
/>
</LinearLayout>
:‫ كالتالي‬Fragments ‫( الخاصة بالقطع‬classes) ‫ إنشاء الفئات‬:ً‫ثانيا‬
‫( التي تعرض معلومات‬Fragment( ‫) الخاصة بالقطعة‬class( ‫ وتمثل الفئة‬:MyDetailsFragment 
.‫المدينة التي يتم اختيارها من القائمة‬
1: public class MyDetailsFragment extends Fragment{

2:
3: TextView tvArea;
4: TextView tvPopulation;
5: TextView tvLargestCity;
6: ImageView ivMap;
7:
8: @Override
12: View view =
13: inflater.inflate(R.layout.detailsfragment_layout,
15: tvArea = (TextView)
16: view.findViewById(R.id.tvArea);
17: tvPopulation = (TextView)
18: view.findViewById(R.id.tvPopulation);
19: tvLargestCity = (TextView)
20: view.findViewById(R.id.tvLargestCity);
21: ivMap = (ImageView)
22: view.findViewById(R.id.ivMap);
23: return view;
24: }
25:
26: public void itemSelected(String cityName){
27: getActivity().setTitle(cityName);
28: if(cityName.equals("Gaza")){
29: tvArea.setText("Area: 360 km2");
30: tvPopulation.setText("Population:
31: 1,816,379");
32: tvLargestCity.setText("Largest City: Gaza");
33: ivMap.setImageResource(R.drawable.gaza);
34: }else if(…){
35: // If another city do something else …
36: }
37: }
38:}
onCreateView() ‫) التي يتم تنفيذها داخل الدالة‬02 ‫ إلى‬03 ‫ (أنظر األسطر من‬inflate() ‫الحظ أن الدالة‬
‫ إلنشاء واجهة القطعة أثناء تنفيذ الدالة‬detailsfragment_layout.xml ً‫تستخدم ملف الواجهة المنشأ مسبقا‬
.onCreateView()
‫) يتم من خاللها تعبئة عناصر الواجهة بناء على اسم‬27 ‫ إلى‬36 ‫ (أنظر األسطر من‬itemSelected() ‫الدالة‬
‫ من المفترض أن يتم استدعاء هذه الدالة عند النقر على اسم المدينة من القائمة‬.‫المدينة المدخل إلى هذه الدالة‬
.‫ أخرى‬Fragment ‫) الموجودة ضمن قطعة‬ListView(
‫( التي تعرض قائمة بأسماء المدن‬Fragment) ‫) الخاصة بالقطعة‬class( ‫ وتمثل الفئة‬:MyListFragment 
.MyDetailsFragment ‫بحيث يتم عرض معلومات عن المدينة التي يتم اختيارها ضمن القطعة‬
1: public class MyListFragment extends Fragment{
2:
3: MyListFragmentListener listener;
4:
5: @Override
9: return
10: inflater.inflate(R.layout.listfragment_layout,
12: }
13:
14: @Override
15: public void onActivityCreated(Bundle
16: savedInstanceState) {
17: super.onActivityCreated(savedInstanceState);
18: String[] values =
19: {"Jerusalem","Gaza","Ramallah","Jenin","Nablus",
20: "Tulkarm","Al-khalil","Haifa","Yafa","Areeha"};
21: ArrayList<String> listValues = new
23: for(int i=0; i<values.length; i++)
24: listValues.add(values[i]);
25: ArrayAdapter<String> adapter = new
26: ArrayAdapter<String>(getActivity(),
27: android.R.layout.simple_list_item_1, listValues);
28: final ListView list = (ListView)
29: this.getView().findViewById(R.id.cityListView);
30: list.setAdapter(adapter);
31: list.setOnItemClickListener(new
33:
34: @Override
36: adapterView, View view, int position,long id) {
38: list.getItemAtPosition(position).toString();
39: if(listener != null)
40: listener.itemSelected(cityName);
41: }
42: });
43: }
44:
45: public interface MyListFragmentListener{
46: public void itemSelected(String selectedItem);
47: }
48:
49: @Override
50: public void onAttach(Activity activity) {
51: super.onAttach(activity);
52: if(activity instanceof MyListFragmentListener){
53: listener = (MyListFragmentListener)
54: activity;
55: }else{
56: throw new
57: ClassCastException(activity.toString()
58: + " Activity must implemenet
59: MyListFragmentListener");
60: }
61: }
62:}
‫ تستخدم ملف‬onCreateView() ‫) التي يتم تنفيذها داخل الدالة‬00 ‫ إلى‬9 ‫ (أنظر األسطر من‬inflate() ‫الدالة‬
.onCreateView() ‫ إلنشاء واجهة القطعة أثناء تنفيذ الدالة‬listfragment_layout.xml ً‫الواجهة المنشأ مسبقا‬
‫ حيث تم كتابة هذه الدالة ليتم حفظ مؤشر‬onAttach() ‫الحظ أنه عند ربط القطعة بالفعالية األم يتم تلقائيا ً تنفيذ الدالة‬
‫ القطعة‬.)60 ‫ إلى‬51 ‫) وذلك لتمرر إليها األوامر الحقاً (أنظر األسطر من‬Activity( ‫للفعالية األم‬
‫ من المفترض أن تمرر اسم المدينة التي يتم اختيارها إلى القطعة األخرى‬MyListFragment
.‫ وهو ما يجب أن يتم عن طريق الفعالية األم‬MyDetailsFragment
‫) يتم إنشاء قائمة بأسماء المدن ومن ثم تمريرها‬22 ‫ إلى‬05 ‫ (أنظر األسطر من‬onActivityCreated() ‫في الدالة‬
‫ يتم بعد ذلك الوصول لقائمة العرض‬.)37 ‫ إلى‬35 ‫ (أنظر األسطر من‬ArrayAdapter ‫إلى محول من نوع‬
‫ إلى قائمة العرض‬ArrayAdapter ‫ ومن ثم تمرير المحول‬findViewById() ‫( عن طريق الدالة‬ListView)
ً‫ تحديدا‬onActivityCreated() ‫ الحظ أنه تم اختيار الدالة‬.)21 ‫ إلى‬38 ‫( لتعبئها (أنظر األسطر من‬ListView)
‫( تكون قد اكتمل إنشاؤها عند تنفيذها وبالتالي يمكن تنفيذ الدالة‬Activity) ‫ألن الفعالية‬
.ArrayAdapter ‫ والتي تلزم عن إنشاء المحول‬Fragment.getActivity()
)Activites( ‫ إنشاء واجهات الفعاليات‬:ً‫ثالثا‬
‫( التي ستستخدم القطع إلنشاء واجهة‬activites) ‫ سنقوم اآلن بإنشاء الفعاليات‬,(Fragments) ‫بعد انشاء القطع‬
‫) يتم‬Landscape( ً ‫ اذا كان الجهاز أفقيا‬:‫ الحظ أن التطبيق يعمل بطريقتين بنا ًء على اتجاه شاشة الجهاز‬.‫التطبيق‬
ً‫ أما إذا كان الجهاز رأسيا‬.MyDetailsFragment ‫ و‬MyListFragment ‫عرض واجهة واحدة تشمل كالً من‬
.‫ في فعالية أخرى‬MyDetailsFragment‫ و‬,‫ في فعالية‬MyListFragment ‫ يتم عرض‬,(Portrait)
‫والخاص بالواجهة الرئيسية في الوضع األفقي‬, activity_main.xml ‫لتنفيذ ذلك ننشئ ملف التصميم التالي‬
:layout ‫ ونضعه في المجلد‬,(Landscape)
res/android"
tools:context=".MainActivity">
<fragment
android:id="@+id/listFragment"
android:name="ps.edu.ucas.fragments.MyListFragment"
android:layout_height="match_parent"/>
<fragment
android:id="@+id/detailsFragment"
android:name="ps.edu.ucas.fragments.MyDetailsFragment"
android:layout_height="match_parent"/>
</LinearLayout>
‫ وكل منهما يشير إلى الفئة‬MyDetailsFragment ‫ و‬MyListFragment ‫الحظ أن الواجهة تضم القطعتين‬
.android:name ‫) الخاصة بالقطعة من خالل‬class(
,ً‫ كما ذكرنا مسبقا‬.(Portrait) ‫بعد ذلك نقوم بإنشاء ملف الواجهات الخاصة بعرض التطبيق في الوضع الرأسي‬
‫ الملف التالي‬.‫( واجهتين تستخدم كل منهما قطعة مختلفة‬Portrait) ‫يستخدم التطبيق في الوضع الرأسي‬
‫ حيث يتم وضع الملف في‬,(MyListFragment) ‫ يوضح تصميم الفعالية التي تتضمن‬activity_main.xml
.(Portrait) ‫ حتى يتم استخدامه تلقائياً في الوضع الرأسي‬layout-port ‫مجلد باسم‬
‫ ولكنه موجود في مجلد‬,‫ يطابق اسم ملف الواجهة المنشأ مسبقا‬activity_main.xml ‫الحظ أن اسم ملف الواجهة‬
‫ فإذا كان العرض رأسياً يتم‬:‫ عند تشغيل التطبيق يتم اختيار الملف من المجلد الصحيح بناء على وضع العرض‬.‫آخر‬
‫ وإذا كان العرض أفقياً يتم إنشاء الواجهة من الملف‬layout_port ‫إنشاء الواجهة من الملف الموجود في المجلد‬
.layout ‫الموجود في المجلد‬
<LinearLayout
<fragment
android:id="@+id/cityFragment"
android:name="ps.edu.ucas.fragments.MyListFragment"
android:layout_height="match_parent" />
</LinearLayout>
‫ ويحتوي‬Portrait ‫ونقوم أيضا ً بانشاء ملف واجهة آخر خاص بالفعالية التي تعرض معلومات المدينة في وضع‬
:MyDetailsFragment ‫على‬
<LinearLayout
android:tag="portrait"
tools:context=".DetailsActivity" >
<fragment
android:id="@+id/detailsFragment"
android:name="
ps.edu.ucas.fragments.MyDetailsFragment"
android:layout_height="wrap_content" />
</LinearLayout>
‫( ضمن ملفات التطبيق‬Fragments) ‫) و القطع‬Activities( ‫الترتيب النهائي لملفات تصميم الهيكلية للفعاليات‬
:9-5 ‫يظهر كما بشكل‬
9-1 ‫ ترتيب ملفات الواجهة الخاصة بتمرين‬:9-5 ‫شكل‬

‫ يتم إنشاء الفئات‬,Activites ‫ بعد إنشاء الواجهات الخاصة بالفعاليات‬:(Activites) ‫ إنشاء الفعاليات‬:ً‫رابعا‬
:‫( الخاصة بها‬classes)
:‫ وتمثل الواجهة الرئيسية للتطبيق‬:MainActivity ‫الفعالية‬ 

1: public class MainActivity extends Activity implements
2: MyListFragmentListener{
3:
4: @Override
8: }
9:
10: @Override
11: public void itemSelected(String cityName){
12: MyDetailsFragment fragment = (MyDetailsFragment)
13: this.getFragmentManager().findFragmentById(
14: R.id.detailsFragment);
15: if(fragment != null && fragment.isInLayout()){
16: fragment.itemSelected(cityName);
17: }else{
20: DetailsActivity.class);
21: intent.putExtra("cityName", cityName);
23: }
24: }
25:}
‫) المسؤولة عن ربط كود الفعالية بملف الواجهة يستخدم‬7 ‫ (أنظر سطر رقم‬setContentView() ‫الحظ أن الدالة‬
‫ أحدها في المجلد‬,(activity_main( ‫ نظراً لوجود ملفي واجهة بنفس االسم‬.(activity_main( ‫الملف المعرف بـ‬
:‫ يقوم النظام تلقائياً باستخدام الملف المناسب بناء على وضع الجهاز‬,layout-port ‫ واآلخر في المجلد‬layout
‫ و‬MyListFragment ‫( الذي يتضمن‬activity_main( ‫ففي وضع الشاشة األفقي يتم استخدام ملف الواجهة‬
‫ الموجود في المجلد‬activity_main ‫ في الوضع الرأسي يتم استخدام ملف الواجهة‬.MyDetailsFragment
implement ‫ الحظ أيضاً أن الفعالية تقوم بعمل‬.‫ فقط‬MyListFragment ‫ والذي يحوي‬layout-portait
‫ وذلك حتى تتمكن من االستماع للحدث الصادر من‬MyFragmentListListener ‫للواجهة البرمجية‬
.MyListFragment
‫ يتم تنفيذ الدالة‬,)ListView( ‫ (عند النقر على اسم مدينة من القائمة‬MyListFragment ‫عند استقبال حدث ما من‬
.)00 ‫) (أنظر سطر رقم‬ListView( ‫ والتي يمرر لها اسم المدينة التي تم اختيارها من القائمة‬itemSelected()
‫ فإذا كانت الشاشة أفقية فإن القطعة‬:‫اإلجراء المتبع بعد ذلك يعتمد على وضع شاشة الجهاز‬
‫ من المفترض أن يكون ضمن الواجهة الرئيسية وهو ما يتم التحقق منه من خالل تنفيذ‬MyDetailsFragment
‫ موجود ضمن الواجهة يتم إرسال‬MyDetailsFragment ‫ إذا كان‬.)05 ‫ (أنظر سطر رقم‬isInLayout() ‫الدالة‬
‫ أما‬.)06 ‫ (أنظر سطر رقم‬MyDetailsFragment ‫ الموجودة ضمن‬itemSelected() ‫النص له من خالل الدالة‬
‫ ومن ثم يتم إنشاء فعالية من‬,‫ موجوداً فهذا يعني أن الجهاز في الوضع الرأسي‬MyDetailsFragment ‫إذا لم يكن‬
.)32 ‫ إلى‬08 ‫) (أنظر الكود من سطر‬Intent( ‫ وإرسال نص الخبر لها من خالل هدف‬DetailsActivity ‫نوع‬
:‫ هذه الفعالية يتم عرضها فقط في الوضع الرأسي إلظهار تفاصيل الخبر‬:DetailsActivity ‫الفعالية‬ 
1: public class DetailsActivity extends Activity {
2:
3: @Override
6:
7: if(this.getResources().getConfiguration().
8: orientation == Configuration.ORIENTATION_LANDSCAPE){
9: this.finish();
10: return;
11: }
12: setContentView(R.layout.activity_details);
13: Intent intent = this.getIntent();
14: Bundle extras = intent.getExtras();
15: if(extras != null){
17: intent.getExtras().getString("cityName");
18: MyDetailsFragment fragment =
19: (MyDetailsFragment)
20: this.getFragmentManager().findFragmentById(
21: R.id.detailsFragment);
22: fragment.itemSelected(cityName);
23: }
24: }
25:}
:‫ وهما‬onCreate() ‫الحظ أنه عند إنشاء هذه الفعالية يتم تنفيذ إجراءين أساسيين في الدالة‬
‫ فإذا كان الجهاز أفقيا ً ال يتم عرض الفعالية ويتم إنهاؤها بتنفيذ الدالة‬,‫ التحقق من وضع شاشة الجهاز‬:ً‫أوال‬
.)00 ‫ إلى‬7 ‫ (أنظر الكود من سطر‬Activity.finish()
‫ثانياً‪ :‬استقبال الهدف (‪ (Intent‬المرسل من ‪ MyListFragment‬من خالل الفعالية المضيفة ‪,MainActivity‬‬

‫ومن ثم استخراج البيانات المرسلة وتتضمن أسم المدينة التي تم اختيارها (أنظر األسطر من ‪ 02‬إلى ‪ .)07‬من‬
‫المفترض بعد ذلك إرسال اسم المدينة إلى القطعة ‪ MyDetailsFragment‬والمسئولة عن عرض التفاصيل‪ .‬لذلك‬
‫يتم الوصول للقطعة ‪ MyDetailsFragment‬عن طريق مدير القطع ومن ثم تمرير اسم المدينة من خالل الدالة‬
‫)(‪( itemSelected‬أنظر األسطر من ‪ 08‬إلى ‪.)33‬‬
‫مربعات الحوار )‪(Dialogs‬‬
‫مربع الحوار )‪ (Dialog‬هو نافذة صغيرة تطلب عادةً من المستخدم اتخاذ قرار أو إدخال معلومات إضافية‪ .‬مربع‬
‫الحوار ال يمأل الشاشة كما هو الحال في واجهة الفعالية (‪ ,)Activity‬ويستخدم عادة في الحاالت التي تتطلب من‬
‫المستخدمين اتخاذ إجراء ما قبل أن يتمكنوا من المضي قدما‪ .‬شكل ‪ 9-6‬يوضح أمثلة على مربعات الحوار‬
‫‪:Dialogs‬‬
‫شكل ‪ :9-6‬نماذج لمربعات الحوار )‪(Dialogs‬‬

‫الفئة )‪ )Dialog class‬هي الفئة األساسية التي تتفرع منها األنواع المختلفة لمربعات الحوار‪ .‬ينصح بتجنب‬
‫استخدام الفئة )‪ )Dialog class‬إلنشاء مربع الحوار ‪ ,Dialog‬وبدالً منه ينصح باستخدام أي من الفئات الفرعية‬
‫)‪ (subclasses‬التالية‪:‬‬
‫‪ :AlertDialog‬وهو مربع حوار يمكنه افتراضيا ً عرض عنوان‪ ,‬ثالثة أزرار بحد أقصى‪ ,‬قائمة من عناصر‬ ‫‪‬‬
‫االختيار أو تصميم مخصص ‪.Custom layout‬‬
‫‪ DatePickerDialog‬و ‪ :TimePickerDialog‬وهي مربعات حوار تستخدم لتحديد الوقت والتاريخ‪,‬‬ ‫‪‬‬
‫وتظهر في شكل ‪:9-7‬‬
‫صفحــة ‪085 .‬‬

‫شكل ‪ :9-7‬مربعات حوار من نوع ‪ DatePickerDialog‬و ‪TimePickerDialog‬‬

‫هذه الفئات )‪ (classes‬تحدد شكل وبناء مربع الحوار ‪ ,Dialog‬ولكن يجب استخدام كائن من نوع‬
‫‪ DialogFragment‬كحاوية ‪ Container‬يتم من خالله إنشاء وعرض مربع الحوار )‪ .(Dialog‬استخدام‬
‫‪ DialogFragment‬كحاوية لمربع الحوار يضمن معالجة األحداث النائجة عن دورة حياة مربع الحوار بشكل‬
‫صحيح‪ ,‬حيث ترتبط دورة حياة مربع الحوار بدورة حياة القطعة ‪ .DialogFragment‬يمكن مثالً تنفيذ إجراء عند‬
‫النقر على زر ‪ Back‬بإضافة كود في الدالة )(‪ .DialogFragment.onPause‬باإلضافة إلى ذلك‪ ,‬استخدام‬
‫‪ DialogFragment‬كحاوية لمربع الحواية يوفر إمكانية إعادة استخدام مربع الحوار في تطبيقات أخرى تماماً كما‬
‫يحدث في حالة القطعة )‪.(Fragment‬‬

‫يهدف هذا التمرين إلى التدرب على إنشاء مربعات حوار )‪ (Dialogs‬من أنواع مختلفة‪ .‬الواجهة الرئيسية للتطبيق‬
‫تظهر في شكل ‪ , 9-8‬وتتكون من مجموعة من األزرار عند النقر على أي منها يظهر مربع حوار ‪Dialog‬‬
‫بخصائص محددة‪.‬‬
‫صفحــة ‪086 .‬‬

‫شكل ‪ :9-8‬واجهة التطبيق الرئيسية الخاصة بالتمرين ‪9-2‬‬

‫في ما يلي نستغرض مربعات الحوار ‪ Dialogs‬المختلفة وطريقة إنشائها‪:‬‬
‫أوالً‪ :‬مربع الحوار ‪ :Alert Dialog‬وهو يظهر عند النقر على الزر "‪ "Simple Alert‬كما بالشكل ‪:9-9‬‬
‫شكل ‪ :9-9‬مربع الحوار )‪ (AlertDialog‬الخاص بالتمرين ‪9-2‬‬
‫صفحــة ‪087 .‬‬

‫ والتي تتفرع من الفئة‬MySimpleAlertDialog ‫) باسم‬class( ‫ قم بإنشاء فئة‬,(Dialog) ‫إلنشاء هذا المربع‬

:‫ وتحتوي الكود التالي‬DialogFragment
1: public class MySimpleAlertDialog extends
2: DialogFragment{
3: @Override
4: public Dialog onCreateDialog(Bundle
6: AlertDialog.Builder builder = new
7: AlertDialog.Builder(getActivity());
8: builder.setMessage("Do you study at UCAS?");
9: this.setCancelable(false);
10: builder.setTitle("Question");
11: builder.setIcon(R.drawable.ucaslogo);
12: builder.setPositiveButton("Yes", new
14:
15: @Override
16: public void onClick(DialogInterface dialog,
17: int which) {
18: Toast.makeText(getActivity(), "You are
19: a UCAS student", Toast.LENGTH_LONG).show();
20: }
21: });
22: builder.setNegativeButton("No", new
24:
25: @Override
27: int which) {
28: Toast.makeText(getActivity(), "You are
29: not a UCAS student", Toast.LENGTH_LONG).show();
30: }
31:
32: });
33: AlertDialog dialog = builder.create();
34: dialog.setCanceledOnTouchOutside(false);
35: return dialog;
36: }
37:}
‫إلنشاء مربع الحوار ‪ AlertDialog‬المطلوب يتم كتابة الكود في الدالة )(‪ onCreateDialog‬والتي ترجع كائن‬
‫من نوع ‪ .Dialog‬كما تالحظ‪ ,‬يتم في البداية إنشاء كائن من نوع ‪( AlertDialog.Builder‬أنظر سطر رقم ‪6‬‬
‫و‪ )7‬والذي يتم من خالله تحديد خصائص مربع الحوار‪ .‬الحظ أنه تم تحديد الرسالة المعروضة في مربع الحوار‬
‫باستخدام الدالة )(‪ ,setMessage‬وتم تحديد العنوان باستخدام الدالة )(‪ setTitle‬واإليقونة الظاهرة في مربع‬
‫الحوار باستخدام الدالة )(‪( setIcon‬أنظر األسطر من ‪ 8‬إلى ‪.)00‬‬
‫يمكن أيضا من خالل الكائن من نوع ‪ Builder‬تحديد األزرار والنصوص المعروضة بها واإلجراءات التي تنفذ‬
‫عند النقر علي أي من هذه األزرار‪ .‬يمكن إفتراضيا ً إضافة ثالثة أزرار بحص أقصى داخل ‪ AletDialog‬وذلك‬
‫باستخدام الدوال )(‪ setNegativeButton() ,setPositiveButton‬و )(‪( setNeutralButton‬أنظر األسطر‬
‫من ‪ 03‬إلى ‪ .)23‬كل دالة من الدوال السابقة يمرر لها النص الذي يكتب على الزر (مثل ‪ OK‬أو ‪ )Yes‬باإلضافة‬
‫إلى كائن من نوع )‪ )OnClickListener‬يحدد اإلجراء المراد تنفيذه عند النقر على الزر‪ .‬كود اإلجراء المطلوب‬
‫يتم كتابته في الدالة ‪.OnClickListener.onClick‬‬
‫بعد تحديد خصائص مربع الحوار ‪, AlertDialog‬يتم إنشاؤه بتنفيذ الدالة )(‪ Builder.create‬والتي ترجع كائن‬
‫من نوع ‪ .Dialog‬في النهاية يتم إرجاع الكائن ‪ Dialog‬كمخرج من الدالة )(‪( onCreateDialog‬أنظر األسطر‬
‫من ‪ 22‬إلى ‪.)25‬‬
‫الحظ أننا استخدمنا األمر )‪( Dialog.setCanceledOnTouchOutside(false‬أنظر سطر رقم ‪ )22‬لتجنب‬
‫إغالق مربع الحوار عند النقر خارجه كما يحدث إفتراضياً‪ .‬في هذه الحالة لن يتم اإلغالق إلى من خالل األزرار‬
‫الموجودة داخل مربع الحوار‪.‬‬
‫ثانياً‪ :‬مربع الحوار المخصص ‪( Custom Dialog‬أنظر شكل ‪ )9-10‬ويظهر عند النقر على الزر ‪“Custom‬‬
‫”‪ Dialog‬الظاهر في شكل ‪. 9-8‬‬
‫صفحــة ‪089 .‬‬

9-2 ‫( الخاص بالتمرين‬Custom Dialog) ‫ مربع الحوار المخصص‬:9-10 ‫شكل‬

‫ لبناء واجهة مربع‬XML ‫مربع الحوار المخصص يوفر إمكانية استخدام تصميم معد مسبقا ً في ملف هيكلية من نوع‬
‫ الكود التالي‬.‫ اإلفتراضي‬AlertDialog ‫ وهو ما يعطي مرونة أكبر في تصميم الواجهة من مربع الحوار‬,‫الحوار‬
:‫) الخاصة بمربع الحوار المخصص‬class( ‫يمثل الفئة‬
1: public class MyCustomDialog extends DialogFragment{
2:
3: @Override
8: builder.setTitle("Enter username and password");
10: this.getActivity().getLayoutInflater();
11: View view =
12: inflater.inflate(R.layout.dialog_layout, null);
13: builder.setView(view);
14: Button btnOK =
15: (Button)view.findViewById(R.id.btnOK);
16: btnOK.setOnClickListener(new OnClickListener(){
17: @Override
18: public void onClick(View arg0) {
‫‪19:‬‬ ‫‪Toast.makeText(getActivity(), "Thank‬‬

‫;)(‪20: you", Toast.LENGTH_SHORT).show‬‬
‫‪21:‬‬ ‫;)(‪MyCustomDialog.this.dismiss‬‬
‫‪22:‬‬ ‫}‬
‫‪23:‬‬ ‫;)}‬
‫‪24:‬‬ ‫;)(‪return builder.create‬‬
‫} ‪25:‬‬
‫}‪26:‬‬
‫الحظ أن إنشاء مربع الحوار المخصص مشاب ه إلى حد كبير لطريقة إنشاء مربع الحوار اإلفتراضي المنشأ في‬
‫الخطوة السابقة‪ ,‬فهو من نوع ‪ AlertDialog‬ومضمن في ‪ .DialogFragment‬االختالف الوحيد أنه تم استخدام‬
‫كائن من نوع ‪ LayoutInflater‬إلنشاء الواجهة باستخدام ملف واجهة بالمعرف ‪R.layout.dialog_layout‬‬
‫(أنظر سطر رقم ‪ 00‬و‪ .)03‬الواجهة المنشأة تكون مضمنة في كائن من نوع ‪ View‬يتم إضافته لمربع الحوار‬
‫باستخدام الدالة )(‪( Builder.setView‬أنظر سطر رقم ‪ .)02‬بعد إنشاء الواجهة‪ ,‬يمكن الوصول برمجياً ألي‬
‫عنصر داخلها بتنفيذ الدالة )(‪ findViewById‬وذلك إلضافة مستمع (‪ )Listener‬لحدث معين‪ .‬في المثال‬
‫الموضح يتم الوصول إلى الزر المعرف بـ ‪ R.id.btnOK‬ومن تسجيل مستمع (‪ )Listener‬لمعالجة إجراء النقر‬
‫عليه (أنظر الكود من سطر ‪ 02‬إلى ‪.)32‬‬
‫ثالثاً‪ :‬مربع حوار يعرض قائمة من عناصر اإلختيار كما يظهر في شكل ‪ , 9-11‬ويتم إنشاؤه عند النقر على زر‬
‫”‪ “List Dialog‬الموجود ضمن الواجهة في شكل ‪.9-8‬‬
‫شكل ‪ :9-11‬مربع الحوار يعرض قائمة من العناصر‪ ,‬الخاص بالتمرين ‪9-2‬‬

‫إلنشاء القائمة المضمنة في مربع الحوار‪ ,‬نقوم بإنشاء مصفوفة من النصوص في ملف المصادر ‪ string‬باستخدام‬
‫الخاصية ‪ string-array‬كما هو موضح‪:‬‬
‫صفحــة ‪090 .‬‬


<resources>
<string name="app_name">dialogtest</string>
<string name="action_settings">Settings</string>
<string name="hello_world">Hello world!</string>
<string-array name="color_array">
<item >Blue</item>
<item >Red</item>
<item >Green</item>
<item >Black</item>
<item >White</item>
</string-array>
</resources>
: ‫) التالية توضح طريقة إنشاء مربع الحوار‬MyListDialog class) ‫الفئة‬

1: public class MyListDialog extends DialogFragment{
2:
3: Boolean[] selections = {false, false, false, false,
4: false};
5:
6: @Override
11: builder.setTitle("Choose your favorite colors:");
12: builder.setMultiChoiceItems(R.array.color_array,
13: null, new OnMultiChoiceClickListener(){
14:
15: @Override
17: int which, boolean isChecked) {
18: selections[which] = isChecked;
19: }
20: });
21: builder.setPositiveButton("OK", new
23:
24: @Override
‫‪25:‬‬ ‫‪public void onClick(DialogInterface dialog,‬‬

‫{ )‪26: int which‬‬
‫‪27:‬‬ ‫;"" = ‪String result‬‬
‫‪28:‬‬ ‫)‪for(Boolean selection: selections‬‬
‫‪29:‬‬ ‫;" ‪result+=selection+" ,‬‬
‫‪30:‬‬ ‫‪Toast.makeText(getActivity(), result,‬‬
‫;)(‪31: Toast.LENGTH_LONG).show‬‬
‫‪32:‬‬ ‫}‬
‫‪33:‬‬ ‫;)}‬
‫‪34:‬‬ ‫;)(‪return builder.create‬‬
‫} ‪35:‬‬
‫}‪36:‬‬
‫الحظ أن مربع الحوار تم أنشاؤه بطريقة مشابهة لمربعات الحوار السابقة باستثناء استخدام الدالة‬
‫)(‪ Builder.setMultiChoiceItems‬والتي يمرر لها معرف المصفوفة التي تم إنشاؤها وهو‬
‫‪ R.array.color_array‬وكائن من نوع )‪ )OnMultiChoiceClickListener‬والذي يستخدم لالستماع لحدث‬
‫اختيار عنصر من القائمة حيث يتم تلقائيا ً تنفيذ الدالة )(‪ onClick‬عن النقر على أي عنصر (أنظر الكود من سطر‬
‫‪ 03‬إلى ‪.)31‬‬
‫الحظ أن الدالة )(‪ Builder.setMultiChoiceItems‬تستخدم لتفعيل خاصية االختيار المتعدد من قائمة العرض‪.‬‬
‫يمكن استخدام الدالة )(‪ Builder.setSingleChoiceItems‬لدعم اختيار عنصر منفرد من القائمة‪.‬‬
‫رابعاً‪ :‬واجهة تحديد الوقت ‪( TimePickerDialog‬أنظر شكل ‪ )9-12‬وهو أحد مربعات الحوار جاهزة التصميم‬
‫والذي يمكن استخدامه في التطبيقات التي تتطلب تحديد الوقت‪ ,‬ويظهر عند النقر على الزر "‪ "Time Picker‬في‬
‫شكل ‪:9-8‬‬
‫صفحــة ‪092 .‬‬

9-2 ‫ خاص بالتمرين‬TimePickerDialog ‫ مربع حوار من نوع‬:9-12 ‫شكل‬

‫ إنشاء مربع حوار من نوع‬.‫ وهو يستخدم لتحديد التاريخ‬DatePickerDialog ‫هناك أيضا ً مربع حوار مشابه باسم‬
:‫ يتم باستخدام الكود التالي‬TimePickerDialog
1: public class TimerPickerFragment extends
2: DialogFragment{
3:
4: @Override
7: Calendar c = Calendar.getInstance();
8: int hour = c.get(Calendar.HOUR_OF_DAY);
9: int minute = c.get(Calendar.MINUTE);
10: TimePickerDialog dialog = new
11: TimePickerDialog(this.getActivity(), new
12: OnTimeSetListener(){
13: @Override
14: public void onTimeSet(TimePicker view, int
15: hour, int minute) {
16: Toast.makeText(getActivity(), "You set:
17: "+hour+" hour, "+minute+" minutes",
19: }
20: }, hour, minute, false);

21: return dialog;
22: }
23: }
‫ باإلضافة لكائن‬getActivity() ‫ وتم تمرير كائن الفعالية‬TimePickerDialog ‫الحظ أنه تم إنشاء كائن من نوع‬
‫ والذي يحدد اإلجراء الذي يتم تنفيذه عن تحديد توقيت جديد (في المثال أعاله يتم‬OnTimeSetListener ‫من نوع‬
‫ تم أيضا ً تمرير الوقت الحالي (بالساعة والدقيقة) والذي تم قراءته‬.)33 ‫ إلى‬03 ‫طباعة الوقت) (أنظر األسطر من‬
‫ وذلك لتحديد‬TimePickerDialog ‫) إلى الكائن‬9 ‫ إلى‬7 ‫ (أنظر األسطر من‬Calendar ‫باستخدام كائن من نوع‬
.‫الوقت االفتراضي عن فتح مربع الحوار‬
‫ سنقوم اآلن بعرض الكود الخاص بالفعالية‬,‫( المختلفة‬Dialogs) ‫بعد توضيح الكود الخاص بمربعات الحوار‬
:‫ والتي يتم من خاللها تشغيل مربعات الحوار‬MainActivity
2:
3: @Override
7: }
8:
9: public void showSimpleAlert(View view){
10: MySimpleAlertDialog dialog = new
11: MySimpleAlertDialog();
12: FragmentTransaction) ftr =
13: this.getFragmentManager().beginTransaction();
14: dialog.show(ftr, "mytag");
15: }
16:
17: public void showCustomAlert(View view){
18: MyCustomDialog dialog = new MyCustomDialog();
19: FragmentTransaction ftr =
21: dialog.show(ftr, "mytag");
22: }
23:
24: public void showListDialog(View view){
25: MyListDialog dialog = new MyListDialog();
26: FragmentTransaction ftr =
‫‪28:‬‬ ‫;)"‪dialog.show(ftr, "mytag‬‬

‫} ‪29:‬‬
‫‪30:‬‬
‫{)‪31: public void showTimePickerDialog(View view‬‬
‫‪32:‬‬ ‫‪TimerPickerFragment dialog = new‬‬
‫;)(‪33: TimerPickerFragment‬‬
‫‪34:‬‬ ‫= ‪FragmentTransaction ftr‬‬
‫;)(‪35: this.getFragmentManager().beginTransaction‬‬
‫‪36:‬‬ ‫;)"‪dialog.show(ftr, "mytag‬‬
‫} ‪37:‬‬
‫} ‪38:‬‬
‫لعرض مربعات الحوار المختلفة‪ ,‬يجب بدايةً الوصول للكائن ‪ FragmentManager‬المسؤول عن إدارة كل ما له‬
‫عالقة بالقطع )‪ (Fragments‬ومن ثم إنشاء كائن من نوع ‪ .FragmentTransaction‬الحظ أن طريقة عرض أي‬
‫مربع حوار ‪ Dialog‬تتم باستخدام الدالة )(‪ Dialog.show‬والتي يمرر لها كائن من نوع‬
‫)‪ )FragmentTransaction‬باإلضافة إلى اسم معرف ‪.Tag‬‬
‫أسئلة على الوحدة التاسعة‬

‫‪ .0‬ما مميزات استخدام القطع )‪ (Fragments‬لتصميم واجهات تطبيقات أندرويد؟‬
‫‪ .3‬ما الفرق بين القطعة )‪ (Fragment‬والفعالية )‪(Activity‬؟‬
‫‪ .2‬أذكر طريقتين إلضافة القطع )‪ (Fragments‬للفعالية )‪(Activity‬؟‬
‫‪ .2‬لماذا ينصح بتضمين مربع الحوار )‪ (AlertDialog‬أو أي أنواع أخرى من مربعات الحوار )‪ (Dialog‬داخل‬
‫قطعة من نوع )‪(DialogFragment‬؟‬
‫‪ .5‬قد بتصميم تطبيق إخباري بالخصائص التالية‪ :‬واجهة التطبيق في الوضع األفقي )‪ (Landscape‬موضحة في‬
‫األسفل‪ ,‬حيث يتم عرض قائمة الروابط )‪ (Links‬على اليسار‪ ,‬وعند النقر على أي رابط يتم عرض التفاصيل‬
‫في المنتصف‪ ,‬بينما على يمين الشاشة يتم عرض قائمة باإلشعارات و التحديثات‪.‬‬
‫في الوضع الرأسي (‪ )Portrait‬يتم عرض كل جزء من األجزاء السابقة في فعالية )‪ (Activity‬منفصلة كما‬
‫هو موضح باألسفل‪ ,‬حيث تعرض الفعالية الرئيسية قائمة من الروابط في )‪ (ListView‬وأسفلها زر باسم‬
‫"‪ ."Notifications‬عند النقر على أي رابط يتم إظهار التفاصيل في فعالية جديدة‪ ,‬وعند النقر على زر‬
‫"‪ "Notifications‬يتم عرض اإلشعارات في فعالية أخرى كما هو موضح‪.‬‬
‫صفحــة ‪096 .‬‬

‫‪ .6‬في تمرين ‪ 9-2‬تم إنشاء مربع حوار مخصص )‪( (CustomDialog‬أنظر شكل ‪ )9-10‬حيث يتم إدخال اسم‬
‫م ستخدم وكلمة مرور من خالله‪ .‬قد بتعديل التمرين بحيث يتم إعادة البيانات المدخلة إلى الفعالية الرئيسية‬
‫)‪.(MainActivity‬‬
‫تلميح‪ :‬بما أن مربع الحوار )‪ (AlertDialog‬مض َمن داخل قطعة من نوع )‪ ,(DialogFragment‬يمكن‬
‫استخدام نفس الطريقة التي تم شرحها للتواصل بين القطعة (‪ )Fragment‬والفعالية المضيفة )‪.(Activity‬‬
‫‪ .7‬في الوحدة الخامسة‪ ,‬تمرين ‪ 5-2‬قمنا بإنشاء درج تصفح )‪ .(Navigation Drawer‬ذكرنا أن تصميم الواجهة‬
‫مكون من جزئين هما الجزء الثابت )‪ (Main content view‬والجزء المضمن في درج التصفح‪ .‬ذكرنا أيضاً‬
‫أن الجزء الثابت يمكن إدراجه كقطعة )‪ (Fragment‬حيث يتيح ذلك إمكانية تغيير المحتوى األساسي إثناء‬
‫عمل التطبيق عند طريق استبدال القطع )‪ .(Fragments‬قم بتعديل تمرين ‪ 5-2‬الستخدام القطع )‪(Fragment‬‬
‫لتحقيق هذا الغرض‪.‬‬
‫صفحــة ‪097 .‬‬

‫الوحدة العاشرة‪:‬‬
‫نشر تطبيقات أندرويد‬
‫)‪(Publishing Android Applications‬‬
‫‪ ‬خطوات ومستلزمات نشر تطبيق أندرويد على متجر جوجل )‪.(Google Play‬‬
‫‪ ‬طريقة تهيئة التطبيق للنشر وتوقيعه رقمياً‪.‬‬
‫‪ ‬إنشاء سجل المطور )‪.(Developer Profile‬‬
‫متجر جوجل )‪(Google Play Store‬‬
‫متجر جوجل )‪ (Google Play Store‬يمثل اآللية الرسمية لنشر تطبيقات األندرويد‪ .‬إن نشر تطبيقك على متجر‬
‫جوجل يجعل من التطبيق قابل للتحميل واالستخدام من قبل المستخدمين في جميع أنحاء العالم‪ .‬يمكن أيضا‬
‫للمستخدمين إضافة تعليقات أو إعطاء تقييم للتطبيق بما يمكن من اكتشاف األخطاء أو تحسين التطبيق الحقاً‪ .‬كما‬
‫يوفر متجر جوجل بض اإلحصائيات التي يمكن االستفادة منها لقياس نجاح أي تطبيق‪.‬‬
‫في هذه الوحدة سيتم شرح خطوات نشر التطبيق على متجر جوجل )‪.(Google Play Store‬‬
‫يمكن تلخيص خطوات نشر التطبيق على متجر جوجل بما يلي‪:‬‬
‫تصدير التطبيق )‪ (Export‬كملف من نوع ‪.(Android Package) APK‬‬ ‫‪.0‬‬
‫عمل توقيع رقمي )‪ (Digital Signature‬للتطبيق باستخدام شهادة )‪ .(Certificate‬توقيع التطبيق رقمياً‬ ‫‪.3‬‬
‫يساعد نظام أندرويد في تحديد هوية مالك التطبيق‪.‬‬
‫رفع التطبيق على المتجر‪.‬‬ ‫‪.2‬‬
‫استخدام سوق أندرويد )‪ (Android Market‬الستضافة وبيع التطبيق‪.‬‬ ‫‪.2‬‬
‫في ما يلي سنقوم بشرح خطوات إعداد التطبيق للتوقيع ومن ثم سنقوم بشرح طريقة نشر التطبيق‪:‬‬
‫تحديد إصدار التطبيق‬
‫ابتدا ًء من إصدار أندرويد ‪ ,1.0‬يحتوي ملف الوثيقة )‪ (Manifest‬لكل تطبيق على خاصيتي‪:‬‬
‫‪ android:versionCode‬و ‪ .android:versionName‬قيمة الخاصية األولى تحدد رقم اإلصدار الخاص‬
‫بالتطبيق‪ .‬لكل نسخة جديدة معدلة من التطبيق يجب إضافة ‪ 1‬لهذه القيمة وذلك للتفريق بين النسخة الجديدة والقديمة‪.‬‬
‫هذه القيمة غير مستخدمة من قبل نظام أندرويد وهي مفيدة فقط للمطورين لمعرفة إصدارات التطبيق‪.‬‬
‫قيمة الخاصية ‪ android:versionName‬تحتوي على معلومات اإلصدار التي تظهر للمستخدمين وتأخذ الصيغة‪:‬‬
‫>‪<major>.<minor>.<point‬‬
‫صفحــة ‪098 .‬‬

‫ أما إذا تم إضافة تعديالت أو إضافات صغيرة‬,major ‫إذا تم إجراء تغيير كبير على التطبيق يتم إضافة واحد للقيمة‬
(Version Name) ‫ التطبيق الجديد قد يأخذ اسم اإلصدار‬,ً‫ فمثال‬.point ‫ أو‬minor ‫أو ثانوية يتم زيادة قيمة‬
‫ عند عمل تعديل كبير يمكن أن‬."1.1.0" ‫" أو‬1.0.1" ‫" و عدن عمل تعديل بسيط يأخذ اسم اإلصدار‬1.0.0" :‫التالي‬
.‫" وهكذا‬2.0.0" :‫يأخذ التطبيق اسم اإلصدار‬
‫ يجب أن تتوفر‬, (www.android.com/market/) ‫إذا كنت تنوي نشر التطبيق على سوق أندرويد اإللكتروني‬
:‫( الخاص بالتطبيق‬Manifest) ‫جميع البيانات التالية ضمن ملف الوثيقة‬
 android:versionCode (<Manifest> ‫)ضمن الخاصية‬.
 android:versionName (<Manifest> ‫)ضمن الخاصية‬.
 android:icon (<application> ‫)ضمن الخاصية‬.
 android:label (<application> ‫)ضمن الخاصية‬.
:"UCAS APP" ‫( لتطبيق باسم‬Manifest) ‫المثال التالي يوضح هذه البيانات ضمن ملف وثيقة‬
<?xml version=”1.0” encoding=”utf-8”?>
<manifest
xmlns:android=”http://schemas.android.com/apk/res/android”
package=”ps.ucas.edu.ps.publishexample”
android:versionCode=”1”
android:versionName=”1.0” >
<uses-sdk android:minSdkVersion=”13” />
<uses-permission
android:name=”android.permission.INTERNET”/>
<uses-permission
android:name=”android.permission.ACCESS_FINE_LOCATION”/>
<uses-permission
android:name=”android.permission.ACCESS_COARSE_LOCATION”/>
<application
android:icon=”@drawable/ic_launcher”
android:label=”UCAS APP” >
<uses-library android:name=”com.google.android.maps” />
<activity
android:label=”@string/app_name”
android:name=”.LBSActivity” >
<intent-filter >
<action android:name=”android.intent.action.MAIN” />
<category android:name=”android.intent.category.LAUNCHER”
/>
</intent-filter>
‫يجب التأكد من إضافة كل األذونات )‪ (Permissions‬التي يتطلبها التطبيق ضمن ملف الوثيقة )‪ (Manifest‬كما‬
‫هو موضح في المثال السابق‪ .‬الحظ أيضا أن التطبيق السابق يتطلب إصدار أندرويد ‪ 13‬على األقل ‪(Android‬‬
‫)‪ . 3.2.1‬يفضل استخدام أدنى رقم إصدار يتوافق مع تطبيقك حتى يتمكن أكبر عدد من المستخدمين االستفادة منه‪.‬‬
‫التوقيع الرقمي للتطبيق‬
‫كل تطبيقات األندرويد يجب توقيعها رقميا ً قبل أن يتم تشغيلها على أجهزة أندرويد‪ .‬توقيع التطبيق رقمياً يضمن‬
‫ضمان موثوقية التطبيق عن طريق تحديد هوية المطور أو مالك التطبيق‪ .‬توقيع التطبيق يتطلب ما يسمى بشهادة‬
‫رقمية )‪ (Digital Certificate‬تكون بمثابة التوقيع المميز للمطور والذي يتم إلحاقه بالتطبيق عند نشره‪ .‬يمكن‬
‫للمطور إنشاء الشهادة الرقمية الخاصة به واستخدامها لتوقيع تطبيقاته‪.‬‬
‫عند تجربة التطبيقات على برنامج المحاكاة )‪ (Emulator‬تقوم الواجهة التطبيقية المستخدمة مثل ‪Eclipse‬‬
‫بإصدار شهادة للتجربة ‪ Debug Certificate‬ولذلك ال يتطلب أن يقوم المطور بأي خطوات لتوقيع التطبيق‬
‫رقمياً‪ .‬أما عند نشر التطبيق‪ ,‬فال يمكن استخدام الشهادة التجريبية ‪ Debug Certificate‬ويجب إنشاء شهادة جديدة‪.‬‬
‫يمكن إنشاء الشهادة باستخدام األداة ‪ keytool.exe‬الموجودة ضمن ‪ .Java SDK‬كذلك توفر الواجهة التطبيقية‬
‫مثل ‪ Eclipse‬امكانية إنشاء الشهادة الرقمية وتوقيع التطبيق بها باستخدام ‪.Wizard‬‬
‫المثال التالي يوضح خطوات تصدير تطبيق أندرويد وتوقيعه رقمياً‪:‬‬
‫‪ .0‬اختر التطبيق الذي تريد نشره ومن ثم اختر ‪.File -> Export‬‬
‫ضمن مربع الحوار الذي يظهر افتح القائمة باسم ‪ Android‬وقم بالنقر على الخيار الفرعي ‪Export Android‬‬
‫‪ Application‬كما هو موضح في شكل ‪ .10.1‬اضغط على الزر ‪.Next‬‬
‫صفحــة ‪311 .‬‬

‫شكل ‪ :10.1‬تصدير التطبيق من خالل ‪eclipse‬‬

‫يظهر مربع الحوار بالشكل ‪ 10.2‬والذي يبين اسم التطبيق الذي سيتم تصديره‪ ,‬ومن ثم اضغط على زر ‪.Next‬‬
‫صفحــة ‪310 .‬‬

‫شكل ‪ :10.2‬اختيار التطبيق ليتم تصديره‬

‫ضمن مربع الحوار الذي سيظهر والموضح في شكل ‪ 10.3‬قم باختيار ‪ Create new keystrore‬وذلك حتى يتم‬
‫إنشاء شهادة جديدة )‪ (Certificate or Keystore‬لتوقيع التطبيق‪ ,‬كذلك حدد المسار ليتم حفظ ملف الشهادة به‪.‬‬
‫يجب أيضا ً إدخال كلمة مرور لحفظ الشهادة الجديدة حتى ال يتم استخدامها من قبل شخص غير مصرح له‪ .‬قم بالنقر‬
‫على زر ‪.Next‬‬
‫صفحــة ‪313 .‬‬

‫شكل ‪ :10.3‬إنشاء الشهادة الرقمية لتوقيع التطبيق‬

‫ضمن مربع الحوار الذي يظهر (أنظر شكل ‪ )10.4‬أدخل اسم للمفتاح السري ‪ private key‬المستخدم ضمن‬
‫الشهادة ‪ Certificate‬كذلك أدخل كلمة مرور لحفظه‪ .‬كذلك يجب أن تحدد فترة صالحية المفتاح ‪private key‬‬
‫والتي يجب أن تنتهي بعد تاريخ ‪ .22-10-2033‬لذلك أدخل أي عدد بحيث يكون أكبر من الفرق بين سنة ‪2033‬‬
‫والسنة الحالية‪ .‬بعد ذلك أنقر على زر ‪.Next‬‬
‫صفحــة ‪312 .‬‬

‫شكل ‪ :10.4‬إدخال البيانات الخاصة بالشهادة الرقمية‬

‫ضمن مربع الحوار الذي يظهر كما في شكل ‪ ,10.5‬حدد المسار الذي يتم فيه حفظ ملف ‪ ,APK‬ومن ثم انقر على‬
‫زر اإلنهاء ‪.Finish‬‬
‫صفحــة ‪312 .‬‬

‫شكل ‪ :10.5‬اختيار المسار لحفظ ملف ‪APK‬‬
‫نشر التطبيق على سوق أندرويد )‪(Android Market‬‬

‫الخطوة األولى لنشر التطبيق على سوق أندرويد )‪ (Android Market‬هو إنشاء السجل الخاص بالمطور‬
‫)‪ (Developer Profile‬وذلك من خالل الرابط‪ .http://market.android.com/publish/Home :‬يجب في‬
‫البداية تسجيل الدخول بحساب جوجل )‪ ,(Google Account‬ومن ثم يمكن إنشاء سجل مطور جديد‬
‫)‪ (Developer Profile‬كما هو موضح في شكل ‪ .10.6‬بعد االنتهاء من إدخال بيانات المطور أنقر على‬
‫‪.Continue‬‬
‫صفحــة ‪315 .‬‬

‫شكل ‪ :10.6‬إنشاء سجل مطور جديد )‪(Developer Profile‬‬
‫لنشر تطبيقات على سوق أندرويد يجب أن يدفع المطور رسوم تسجيل وتبلغ ‪ 35‬دوالر تدفع لمرة واحدة‪ ,‬وال يمكن‬
‫النشر بدون دفع هذه الرسوم‪ .‬يمكن النقر على زر ‪ Google Checkout‬لدفع رسوم التسجيل‪ .‬كذلك يجب الموافقة‬
‫على اتفاقية جوجل الخاصة بالنشر )‪ (Distribution agreement‬بعد قراءتها وذلك بتحديد مربع االختيار ‪I‬‬
‫‪.Agree‬‬
‫بعد االنتهاء من إنشاء سجل المطور )‪ (Developer Profile‬يتم إظهار الرسالة الموضحة في شكل ‪ 10.7‬والتي‬
‫تبين أن التسجيل تم بنجاح‪.‬‬
‫صفحــة ‪316 .‬‬

‫شكل ‪ :10.7‬شاشة توضح إنشاء سجل المطور )‪ (Developer Profile‬بنجاح‬

‫قم اآلن بالنقر على الرابط ‪ Google Play Developer Site‬والذي يؤدي إلى الصفحة الرئيسية للمطور (أنظر‬
‫شكل ‪ )10.8‬والتي يمكن من خاللها نشر التطبيقات‪.‬‬
‫شكل ‪ :10.8‬الواجهة الرئيسية لصفحة المطور والتي يتم من خاللها نشر التطبيقات‬
‫صفحــة ‪317 .‬‬

‫رفع التطبيق‬
‫بعد إنشاء سجل المطور )‪ (Developer Profile‬يمكنك نشر التطبيق على متجر جوجل‪ .‬تأكد من توفر المكونات‬
‫ملف ‪ APK‬الخاص بالتطبيق والذي تم توقيعه رقمياً‪.‬‬ ‫‪‬‬
‫صور )‪ (screenshots‬توضح واجهات التطبيق (صورتان على األقل)‪.‬‬ ‫‪‬‬
‫وصف مختصر للتطبيق ووظائفه‪.‬‬ ‫‪‬‬
‫من الصفحة الرئيسية للمطور (أنظر شكل ‪ )10.8‬قم بالنقر على الرابط ‪ Upload Application‬حيث ستظهر‬
‫الصفحة في شكل )‪ (10.9‬والتي من خاللها يتم رفع ملف ‪ APK‬وكذلك ملفات الصور‪ .‬يجب إيضاً إدخال بعض‬
‫البيانات الخاصة بالتطبيق مثل عنوان التطبيق ‪,‬وصف له‪ ,‬آخر التعديالت على التطبيق (في حالة تعديل تطبيق‬
‫منشور مسبقاً)‪ ,‬نوع التطبيق وتصنيفه‪.‬‬
‫بع د نشر التطبيق على متجر جوجل‪ ,‬يمكن تتبع أي تعليقات يرسلها المستخدمون وكذلك أي أخطاء محتملة في‬
‫التطبيق وعدد مرات تنزيله‪.‬‬
‫صفحــة ‪318 .‬‬

‫شكل ‪ :10.9‬الصفحة التي يتم من خاللها رفع ملف التطبيق وملحقاته‪.‬‬
‫صفحــة ‪319 .‬‬

‫المراجـــع‬
[1]. Joseph Annuzzi, Lauren Darcey and Shane Conder, “Introduction to Android
Application Development: Android Essentials”, 4th Edition, Developer’s
Library, December 6, 2013.
[2]. PawPrints Learning Technologies, “Beginning Android Development: Create
Your Own Android Apps”, September 25, 2014
[3]. Joseph Annuzzi, Lauren Darcey and Shane Conder, “Advanced Android
Application Development”, 4th Edition, Developer's Library, November 24,
2014.
[4]. Greg Nudelman, ”Android Design Patterns: Interaction Design Solutions for
Developers”, Wiley, March 11, 2013.
[5]. Neil Smyth, “Android 4.4 App Development Essentials”, January 27, 2014.
[6]. Bill Phillips, Brian Hardy, “Android Programming: The Big Nerd Ranch
Guide”, April 7,2013.
[7]. Wei-Meng Lee, “Beginning Android 4 Application Development”, March 6,
2012.
[8]. The Developer’s Guide – Android Developers, available on
https://developer.android.com/guide/index.html (Last access: January 30, 2015).
[9]. Andoid Development Tutorial by Lars Vogel, available on
http://www.vogella.com/tutorials/Android/article.html (Last access: January 30,
2015).

Android Basics

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Android Basics

Uploaded by

Copyright:

Available Formats

‫بسم هللا الرحمن الرحيم‬

‫أساسيات برمجة تطبيقات الهواتف الذكية باستخدام نظام أندرويد‬

‫د‪ .‬إياد محمد قاسم األغا‬

‫مركز التطوير األكاديمي‬

‫منشورات الكلية الجامعية للعلوم التطبيقية‬

‫بيانات االتصال بالكلية الجامعية للعلوم التطبيقية‬

‫بيانات االتصال‬ ‫عنوان الكلية‬

‫قائمة العرض‬ ‫‪ListView‬‬

‫المستخدم تصفح إلى الفعالية‬

‫المستخدم يعود للفعالية‬

‫فعالية أخرى جاءت إلى المقدمة‬

‫تطبيق له أولوية بحاجة إلى ذاكرة‬

‫الفعالية قيد اإلنهاء أو‬

‫الفعالية األولى في المهمة‬

‫تمرين عملي (‪)1-1‬‬

‫‪Android for ‘Starters’, http://techiezjunkyard-android.blogspot.com/2012/01/task-and-back- 1‬‬

‫حفظ حالة الفعالية‬

‫صفحــة ‪01 .‬‬

‫أسئلة على الوحدة األولى‬

‫صفحــة ‪00 .‬‬

‫صفحــة ‪03 .‬‬

‫صفحــة ‪02 .‬‬

Android Developers, http://developer.android.com/guide/topics/manifest/uses -sdk-element.html 1

‫‪ application‬تستخدم قيمة المتغير ‪ app_name‬المعرف في ملف ‪ .strings.xml‬بالمثل‪ ,‬الخاصية ‪label‬‬

‫شكل ‪ :2-1‬هيكلية تطبيق أندرويد‬

‫صفحــة ‪06 .‬‬

‫صفحــة ‪07 .‬‬

‫الوصول من خالل الكود‪:‬‬ ‫‪‬‬

‫مثال ‪ :2‬تحديد ملف هيكلية الواجهة باسم ‪ main_screen‬عند إنشاء الفعالية‬

‫الوصول من خالل ‪XML‬‬ ‫‪‬‬

‫صفحــة ‪08 .‬‬

‫التعامل مع تغيير اإلعدادات )‪(Handling Configuration Changes‬‬

‫‪// Checks the orientation of the screen‬‬

‫صفحــة ‪31 .‬‬

‫تمرين عملي )‪(2-1‬‬

‫صفحــة ‪30 .‬‬

‫شكل ‪ :2-2‬واجهتا التطبيق في الوضعين الرأسي (‪ )Portrait‬واألفقي )‪(Landscape‬‬

‫صفحــة ‪33 .‬‬

‫أسئلة على الوحدة الثانية‬

‫صفحــة ‪36 .‬‬

‫صفحــة ‪37 .‬‬

‫تمرين عملي (‪)3-1‬‬

‫صفحــة ‪38 .‬‬

3-1 ‫ واجهة التطبيق الخاص بالتمرين‬: 3-1‫شكل‬

‫صفحــة ‪20 .‬‬

‫تمرين عملي )‪(3-2‬‬

‫شكل ‪ : 3-2‬واجهة التطبيق الخاص بالتمرين ‪3-2‬‬

‫صفحــة ‪23 .‬‬

:‫ الخاصة بهذا التمرين موضح باألسفل‬Layout ‫ملف تصميم الواجهة‬

android:text="Where are you from?" />

10: protected void onStart() {

‫يتم معالجة األحداث لكل عنصر كما يلي‪:‬‬

‫صفحــة ‪28 .‬‬

‫المحوالت االفتراضية )‪(Default Adapter‬‬

‫تمرين عملي (‪)3-3‬‬

‫‪Using Lists in Android, atutorial by Lars Vogel, 1‬‬

‫صفحــة ‪29 .‬‬

3-3 ‫ واجهة التطبيق الخاصة بالتمرين‬: 3-4 ‫شكل‬

:‫ موضح في األسفل‬MainActivity ‫الكود الخاص بالفعالية‬

‫‪ArrayAdapter<String> adapter = new‬‬

‫صفحــة ‪23 .‬‬

‫شكل ‪ : 3-5‬االختيار المتعدد من القائمة )‪(ListView‬‬

‫المحول الخاص ‪Custom Adapter‬‬