يتمتع نظام تشغيل أندرويد بوسائل أمان خاصة كي تحمي مستخدميه من مخاطر سرقة البيانات أو العبث في الهاتف دون علم المستخدم، وذلك عن طريق عزل كل تطبيق داخل صندوق خاص به لا يستطيع أن يرى أو يتعامل مع الموارد الخاصة بالتطبيقات الأخرى ما لم تكن لديه الأذونات الخاصة لذلك وموافقة المستخدم عليها.
بشكل افتراضي لا يملك التطبيق أي أذونات للوصول لأي شيء خارج التطبيق كاستخدام الكاميرا أو الاتصال بأحد جهات الاتصال في الهاتف ما لم يتم تضمين الأذونات الخاصة بذلك داخل التطبيق ثم موافقة المستخدم عليه.

فعند تنصيب التطبيق من متجر Play يطلب من المستخدم الموافقة على أذونات محددة يحتاجها التطبيق كي يعمل وبعد الموافقة عليها يبدأ التطبيق في التحميل والتنصيب، لذا يُنصح دائمًا بقراءة هذه الأذونات بعناية والتأكد من احتياج التطبيق لها ليؤدي وظيفته المطلوبة دون الخوف من الوصول لأشياء لا يحتاجها وذلك لكثرة وجود البرمجيات الخبيثة التي تستغل موافقتك على الأذونات للعبث بموارد ومعلومات هاتفك.

تطبيق 1

في هذا المثال سنتعرف على كيفية صنع تطبيق يطلب الوصول إلى أذونات معينة من المستخدم كي يؤدي وظيفته، يقوم هذا التطبيق بدور المصباح اليدوي حيث يُضيء الضوء الخاص بالكاميرا (Flashlight) بشكل برمجي عند الضغط على زر بداخله.

كما نفعل دومًا نبدأ بصنع واجهة المستخدم الخاصة بالتطبيق، وتتكون من زر من النوع ImageButton -وهو زر يستطيع أن يحتوي على صورة -لتصبح الشيفرة الخاصة بملف activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
>

    <ImageButton
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@drawable/power_on"
        android:id="@+id/btn"
        android:background="@null"/>
</LinearLayout>

بعد ذلك نقوم بالتعديل في ملف AndroidManifest.xml وإضافة الأذونات المطلوبة لكي نستطيع التحكم في ضوء الكاميرا.

<uses-permission android:name="android.permission.CAMERA"/>
<uses-feature android:name="android.hardware.Camera"/>

باستخدام الوسم الخاص بالأذونات <uses-permissions> وتحديد الاسم الخاص به في الخاصية android:name، وأيضًا إضافة الوسم <uses-feature> لإعلام الهاتف أن التطبيق يحتاج إلى وجود كاميرا كي يعمل.
ويوجد العديد من الأذونات التي تمكنك من القيام بالعديد من المهام من داخل التطبيق كالاتصال بالإنترنت أو القراءة والكتابة في الذاكرة ويمكنك التعرف عليها من هنا ويتم تعريفها داخل الملف AndroidManifest.xml كما سبق.
إذا لم يتم تعريف الأذونات المستخدمة في التطبيق داخل ملف AndroidManifest.xml فإن التطبيق لن يعمل.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="apps.noby.flashlight">

    <uses-permission android:name="android.permission.CAMERA"/>
<uses-feature android:name="android.hardware.Camera"/>
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

ننتقل الآن إلى كتابة شيفرة التحكم الخاصة بالتطبيق في ملف MainActivity.java وتنقسم إلى
1-التأكد من توفر ضوء للكاميرا في الهاتف أولًا.

if(!getApplicationContext().getPackageManager().hasSystemFeature(PackageManager.FEATURE_CAMERA_FLASH))
    finish();

وإذا لم يتواجد ضوء الكاميرا في الهاتف فسيتم غلق التطبيق في الحال.
2-الحصول على كائن يُمكننا من التحكم في ضوء الكاميرا وذلك عن طريق فتح الكاميرا ثم الحصول على الخصائص والمعاملات الخاصة بها وتغيير المتغير الخاص بضوء الكاميرا.

camera = Camera.open();
param = camera.getParameters();

3-برمجة الزر المتواجد في الواجهة الرئيسية لكي يُضيء ضوء الكاميرا عند الضغط عليه ويغلقه عن الضغط مرة أخرى.

 btn = (ImageButton) findViewById(R.id.btn);

        btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if(!isTorchON){
                    turnONTorch();
                }else
                    turnOFFTorch();
            }
        });

لتُصبح شيفرة التحكم الرئيسية هي

package apps.noby.flashlight;

import android.hardware.Camera;
import android.hardware.Camera.Parameters;
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.widget.ImageButton;

public class MainActivity extends Activity {


    ImageButton btn;
    boolean isTorchON;
    Camera camera;
    private Parameters param;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);


        btn = (ImageButton) findViewById(R.id.btn);

        btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if(!isTorchON){
                    turnONTorch();
                }else
                    turnOFFTorch();
            }
        });
    }


    @Override
protected void onStart() {
    super. onStart();

    if(!getApplicationContext().getPackageManager().hasSystemFeature(PackageManager.FEATURE_CAMERA_FLASH))
        finish();

    if (camera == null) {
        isTorchON = false;
        camera = Camera.open();
        param = camera.getParameters();
    }
}


    @Override
    protected void onPause() {
        super.onPause();
        if (camera != null) {
            camera.release();
            camera = null;
        }
    }
}

يتبقى تعريف ما هي الوظيفة الخاصة بالدالة turnONTorch() وTurnOFFTorch().
تقوم الدالة turnONTorch() بتشغيل الضوء وذلك عن طريق تمرير المعامل FLASH_MODE_TORCH كإحدى معاملات الكاميرا ثم تفعيل الكاميرا بالمعاملات الجديدة عند استدعاء startPreview().

    private void turnONTorch() {

        param.setFlashMode(Parameters.FLASH_MODE_TORCH);
        camera.setParameters(param);
        camera.startPreview();
        isTorchON = true;
        btn.setImageResource(R.drawable.power_off);

    }

وبالمثل نبني turnOFFTorch() كي يتم إطفاء الضوء.

    private void turnOFFTorch() {

        param.setFlashMode(Parameters.FLASH_MODE_OFF);
        camera.setParameters(param);
        camera.stopPreview();
        isTorchON = false;
        btn.setImageResource(R.drawable.power_on);

    }

لتُصبح الشيفرة النهائية لملف MainActivity.java

package apps.noby.flashlight;

import android.content.pm.PackageManager;
import android.hardware.Camera;
import android.hardware.Camera.Parameters;
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.widget.ImageButton;

public class MainActivity extends Activity {
ImageButton btn;
boolean isTorchON;
Camera camera;
private Parameters param;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);


    btn = (ImageButton) findViewById(R.id.btn);

    btn.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            if(!isTorchON){
                turnONTorch();
            }else
                turnOFFTorch();
        }
    });
}

private void turnONTorch() {

    param.setFlashMode(Parameters.FLASH_MODE_TORCH);
    camera.setParameters(param);
    camera.startPreview();
    isTorchON = true;
    btn.setImageResource(R.drawable.power_off);

}

private void turnOFFTorch() {

    param.setFlashMode(Parameters.FLASH_MODE_OFF);
    camera.setParameters(param);
    camera.stopPreview();
    isTorchON = false;
    btn.setImageResource(R.drawable.power_on);

}

@Override
protected void onStart() {
    super. onStart();

    if(! getApplicationContext().getPackageManager().hasSystemFeature(PackageManager.FEATURE_CAMERA_FLASH))
        finish();

    if (camera == null) {
        isTorchON = false;
        camera = Camera.open();
        param = camera.getParameters();
    }
}

@Override
protected void onPause() {
    super.onPause();
    if (camera != null) {
        camera.release();
        camera = null;


    }
    }
}

بعد ذلك نقوم بتجربة التطبيق على هاتف حقيقي وليس المحاكي حيث لا يمكنه محاكاة إضاءة ضوء الكاميرا.

تطبيق 2

بعد الإصدار السادس لنظام تشغيل أندرويد (Android Marshmallow) تم تعريف نموذج جديد للتعامل مع الأذونات داخل التطبيق حيث كان النموذج القديم يتطلب موافقة المستخدم على كافة الأذونات الخاصة بالتطبيق قبل تحميله على الهاتف أو رفضها وعدم تحميل التطبيق. أما الآن فأصبح بإمكان المستخدم تحميل وتنصيب التطبيق على الهاتف دون الموافقة على الأذونات إلا عند الحاجة إليها لكي تقوم بوظيفة ما، كما يمكن الموافقة على بعض الأذونات ورفض الأخرى (قد يؤدي ذلك إلى عدم عمل التطبيق بشكله الكامل) ويمكن بعد ذلك الموافقة عليها مما يعطي المستخدم القدرة على التحكم في التطبيق من داخل الإعدادات الخاصة بالتطبيق.

وتنقسم الأذونات إلى قسمين:

1. الأذونات العادية وهي التي لا تهدد خصوصية المستخدم، ويتم التعامل معها دون طلب الأذن عند الحاجة إليها يكفي فقط طلب الأذن عند التحميل من المتجر مرة واحدة.
2. الأذونات الخطيرة وهي التي قد تصل إلى بيانات خاصة بالمستخدم وتحتاج إلى انتباه المستخدم للتطبيق وطلب الأذن منه عندما استخدامها من قبل التطبيق.
   سنتعامل في هذا التطبيق مع أحد هذه الأذونات الخطيرة، حيث سنقوم بصنع تطبيق يمكنه الاتصال مباشرة برقم محدد من قبل المستخدم ويُعتبر الاتصال من الأذونات الخطيرة وذلك لأنه قد يُعرض المستخدم لتكاليف خاصة بالاتصال.

نبدأ أولًا بصنع واجهة المستخدم وهي تتكون من عنصر EditText كي يكتب المستخدم بداخله الرقم الذي يرغب في الاتصال به وزر للضغط عليه حتى يقوم التطبيق بالاتصال بهذا الرقم.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="horizontal"
    android:layout_margin="16dp">

    <EditText
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:hint="Enter Phone Number"
        android:id="@+id/ph_num"/>

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Call"
        android:id="@+id/call_btn"/>
</LinearLayout>

بعد ذلك نحدد الأذونات الخاصة بالتطبيق في AndroidManifest.xml وهنا هو

<uses-permission android:name="android.permission.CALL_PHONE"/>

ويتم تضمينه داخل الملف كما سبق.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="apps.noby.dailer">

    <uses-permission android:name="android.permission.CALL_PHONE"/>

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

الآن يتبقى برمجة الزر كي يقوم بالاتصال ويتم التحكم في ذلك عن طريق استخدام Intent وتمرير له ACTION_CALL لتحديد وظيفته وهي الاتصال، ثم تحديد البيانات التي نرغب في إرسالها بداخل هذا الـ Intent وهي رقم الهاتف الذي تم إدخاله من قبل المستخدم داخل EditText وتسبقه “tel:” لإعلام نظام التشغيل بأنه رقم هاتف.

     String num = et.getText().toString();
     Intent intent =new Intent(Intent.ACTION_CALL);
     intent.setData(Uri.parse("tel:" + num)) ;

قبل القيام بعملية الاتصال يجب أولًا التأكد من حصول التطبيق على الأذونات الخاصة بالاتصال من المستخدم سواء عند التنصيب في الإصدارات القديمة أو طلبها في الإصدارات الأحدث.

call_btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                String num = et.getText().toString();
                Intent intent =new Intent(Intent.ACTION_CALL);
                intent.setData(Uri.parse("tel:" + num)) ;

                    if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED) {

                        ActivityCompat.requestPermissions(MainActivity.this,new String[]{Manifest.permission.CALL_PHONE},CALL_PHONE_PERMISSIONS_REQUEST);
                    }
                    else
                        startActivity(intent);
            }
        });

للتحقق من الأذونات نستخدم التابع checkSelfPermission() فإذا كان لم يتم الحصول عليه نطلب من المستخدم الموافقة عليه باستخدام التابع requestPermissions() غير ذلك نقوم بالاتصال.
عند طلب الحصول على إذن محدد من المستخدم يظهر أمام المستخدم مربع يطلب منه الموافقة أو الرفض ويقوم بتسجيل اختيار المستخدم لذلك ثم يستدعي التابع onRequestPermissionsResult() بشكل تلقائي ونقوم بداخله من التأكد من موافقة المستخدم على الأذن وإظهار رسالة بذلك.

    public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults) {

        if (requestCode == CALL_PHONE_PERMISSIONS_REQUEST) {
            if (grantResults.length == 1 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                Toast.makeText(this, "Call Phones permission granted", Toast.LENGTH_SHORT).show();
            } else {
                Toast.makeText(this, "Call Phones permission denied", Toast.LENGTH_SHORT).show();
            }
        } else {
            super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        }
    }
}

لتُصبح الشيفرة الكاملة لهذا التطبيق في ملف MainActivity.java هي

package apps.noby.dailer;

import android.Manifest;
import android.app.Activity;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.net.Uri;
import android.os.Bundle;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

public class MainActivity extends Activity {

    private static final int CALL_PHONE_PERMISSIONS_REQUEST = 3;
    private EditText et;
    private Button call_btn;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        et = (EditText) findViewById(R.id.ph_num);
        call_btn = (Button) findViewById(R.id.call_btn);

        call_btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                String num = et.getText().toString();
                Intent intent =new Intent(Intent.ACTION_CALL);
                intent.setData(Uri.parse("tel:" + num)) ;

                    if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED) {

                        ActivityCompat.requestPermissions(MainActivity.this,new String[]{Manifest.permission.CALL_PHONE},CALL_PHONE_PERMISSIONS_REQUEST);
                    }
                    else
                        startActivity(intent);
            }
        });

    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults) {

        if (requestCode == CALL_PHONE_PERMISSIONS_REQUEST) {
            if (grantResults.length == 1 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                Toast.makeText(this, "Call Phones permission granted", Toast.LENGTH_SHORT).show();
            } else {
                Toast.makeText(this, "Call Phones permission denied", Toast.LENGTH_SHORT).show();
            }
        } else {
            super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        }
    }
}

لاحظ أنه إذا كان الهاتف يعمل بإصدار سابق لـ Android Marshmallow فسيتم الحصول على الموافقة على كافة الأذونات عند التحميل من المتجر كما كان يحدث سابقًا.
يمكننا الآن تجربة التطبيق على المحاكي أو على هاتف حقيقي.

يجب عليك مراعاة عدم إجهاد المستخدم بالعديد من الأذونات التي لا حاجة لها داخل تطبيقك حتى لا يضطر المستخدم إلى إزالة تطبيقك والتخلص منه.
لذا يجب الاهتمام بتقديم تجربة استخدام جيدة، ففي العديد من الأحيان لا يكون خيار طلب الأذونات من المستخدم والقيام بالمهمة من داخل تطبيقك هو الخيار الأفضل، فقد يكون الأفضل استخدام الـ intent وطلب الوظيفة من تطبيق آخر للقيام بها.
مثال على ذلك يمكننا تعديل التطبيق السابق وإزالة الأذن الخاص بالاتصال من التطبيق، وتعديل الشيفرة في MainActivty.java كي تقوم بنقل مهمة الاتصال من التطبيق نفسه إلى أحد تطبيقات الاتصال المتواجدة بالهاتف

package apps.noby.dailer;
import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;

public class MainActivity extends Activity {

    private EditText et;
    private Button call_btn;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        et = (EditText) findViewById(R.id.ph_num);
        call_btn = (Button) findViewById(R.id.call_btn);

        call_btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                String num = et.getText().toString();
                Intent intent =new Intent(Intent.ACTION_DIAL);
                intent.setData(Uri.parse("tel:" + num)) ;
                startActivity(intent);
            }
        });

    }

}

عند تجربة التطبيق على المحاكي ينقلنا إلى تطبيق الاتصال الخاص بالهاتف مع إدخال رقم الهاتف والانتظار لاتصال المستخدم بالرقم.

لا توجد طريقة أفضل من الأخرى، بل يعتمد ذلك على مدى اهتمامك بالحصول على التحكم الكامل بكافة التفاصيل لأداء المهمة عند ذلك قم بطلب الأذن من المستخدم وإذا رفض المستخدم ذلك فلن يعمل تطبيقك، أو ترك الوظيفة إلى تطبيق آخر وتكتفي فقط باستقبال أو إرسال البيانات منه أو إليه ولن تحتاج إلى الحصول على أي أذونات من المستخدم لكنك ستنقل المستخدم إلى تطبيق آخر لا تعلم عنه شيئًا قد يضر تجربة الاستخدام الخاصة بتطبيقك.

بهذا نكون قد وصلنا إلى نهاية هذا الدرس، في انتظار تجربتكم وآرائكم.

Icons.zip

يتميز نظام تشغيل أندرويد بوجود شريط أعلى الشاشة يمُد المستخدم بالعديد من المعلومات الهامة من ضمنها الإشعارات التي ترسلها التطبيقات.

فالإشعارات هي جزء من واجهة المستخدم لكنها تظهر خارج التطبيق لإعلام المستخدم بحدث معين، مما يُمكّن المستخدم من عرضه والتفاعل معه بينما يستخدم تطبيقًا آخر. ويحتوي الإشعار على رسالة مختصرة عن هذا الحدث.

ويظهر الإشعار عند حدوثه كأيقونة تعبر عن التطبيق في شريط الحالة أعلى الشاشة، ويمكنك معرفة تفاصيله عند سحب درج الإشعارات والضغط على الإشعار.

هناك عدة خطوات لصنع الإشعارات من داخل تطبيقك:

صنع كائن البناء الخاص بالإشعار من الصنف Notification.Builder

Notification.Builder mBuilder = new Notification.Builder(this);

من خلال هذا الكائن يمكننا التحكم في الخصائص الخاصة بالإشعار مثل عنوان الإشعار، الأيقونة المستخدمة، التحكم في الأولوية، التحكم في المهام التي يستطيع القيام بها عند الضغط عليه وغيرهم من الخصائص المختلفة.

تخصيص الحد الأدنى من الخصائص للإشعار

بعد الحصول على كائن البناء نبدأ في التحكم في خصائص الإشعار، وهناك بعض الخصائص الأساسية اللازم توافرها في الإشعار وهي:

• الأيقونة الخاصة بالإشعار.
• عنوان الإشعار.
• المحتوى الخاص بالإشعار.

mBuilder.setSmallIcon(R.drawable.msg_icon);
mBuilder.setContentTitle("New Message");
mBuilder.setContentText("Hi, This is the message text.");

ويوجد العديد من الخصائص الأخرى التي يمكنك استخدامها حسب حاجة التطبيق لها.

بناء الإشعار بالخصائص السابقة

يتم ذلك باستدعاء التابع ()build والحصول على كائن من Notification.

Notification notif = mBuilder.build();

إظهار الإشعار في درج الإشعارات

يوفر أندرويد الصنف NotificationManager لإدارة الإشعارات من حيث إصدار الإشعار، تعديل الإشعار بعد إصداره أو إلغاء الإشعار برمجيًا. لذا يجب أولًا الحصول على كائن من هذا الصنف وذلك عن طريق استدعاء الدالة ()getSystemService وتمرير الثابت NOTIFICATION_SERVICE والذي يعني طلب الخدمات الخاصة بالإشعارات من خدمات النظام. وسيتم استخدام الدالة ()getSystemService كثيرًا عند الحاجة لطلب خدمات من النظام.

NotificationManager notifyMngr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);

بعد ذلك نستدعي التابع ()notify باستخدام الكائن من NotificationManager ليظهر الإشعار في الحال، وتمرير رقم مميز له يُعبر عن الإشعار ليُستخدم هذا الرقم فيما بعد للتعديل على الإشعار أو إلغائه، كما يتم تمرير الإشعار الذي تم بنائه من قبل.

int notificationId = 103;
notifyMngr.notify(notificationId, notif);

تطبيق 1

سنقوم في هذا التطبيق بتجربة الخطوات السابق شرحها لتكوين التطبيق مثل الصورة التالية:

أولًا نبدأ بصنع واجهة المستخدم البسيطة في ملف activity_main.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:orientation="vertical"
	android:gravity="center">

	<Button
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Show Notification"
		android:id="@+id/shw_notification"/>
</LinearLayout>

بعد ذلك ننتقل إلى الشيفرة الخاصة بالتطبيق في MainActivity.java باتباع الخطوات ذاتها لصنع الإشعار عند الضغط على الزر.

package apps.noby.simplenotification;

import android.app.Activity;
import android.app.Notification;
import android.app.NotificationManager;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;

public class MainActivity extends Activity {

	private Button shwbtn;
	private String title;
	private String detailText;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);

		shwbtn = (Button) findViewById(R.id.shw_notification);
		title = "New Message";
		detailText ="Hi, This is the message text.";

		shwbtn.setOnClickListener(new View.OnClickListener() {
			@Override
			public void onClick(View v) {
				//Step 1
				Notification.Builder mBuilder = new Notification.Builder(MainActivity.this);
	
				//Step 2
				mBuilder.setSmallIcon(R.drawable.ic_message);
				mBuilder.setContentTitle(title);
				mBuilder.setContentText(detailText);

				//Step 3
				Notification notif = mBuilder.build();

				//Step 4
				NotificationManager notifyMngr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);

				int notificationId = 103;
				notifyMngr.notify(notificationId,notif);
			}
		});
	}
}

ثم نقوم بتجربة التطبيق على المحاكي للتأكد من عمله كما ينبغي.

تطبيق 2

في التطبيق السابق عند الضغط على الإشعار لا يحدث شيئ، لذا في هذا التطبيق سنقوم بفتح نشاط جديد يعرض تفاصيل الإشعار أو ما نريد من معلومات عند الضغط على الإشعار.

ولفتح نشاط جديد داخل التطبيق سنستخدم Intent ولكن سنقوم بتغليف الكائن من Intent داخل كائن آخر من PendingIntent وفائدة هذا التغليف هو أنه لا يمكن استخدام الكائن من Intent خارج التطبيق، والإشعار كما ذكرنا يُعرض خارج حدود التطبيق لذا يقوم PendingIntent بإعطاء الصلاحية للتطبيقات الأخرى أو النظام والذي نُرسل إليه PendingIntent القدرة على تنفيذ الأوامر كأنها تتم داخل تطبيقك.

أولًا نقوم بصنع نشاط جديد يُدعى ResultActivity.

ثانيًا سنقوم بتعديل الشيفرة الخاصة بـ MainActivity.java وإضافة كائن من Intent.

Intent intent = new Intent(MainActivity.this,ResultActivity.class);

ونستطيع إرسال بيانات إلى النشاط الآخر بنفس الطريقة المستخدمة في الدروس السابقة.

intent.putExtra(DESC_KEY,detailText);

ثم نقوم بتغليف الكائن داخل PendingIntent:

PendingIntent pIntent = PendingIntent.getActivity(MainActivity.this , 0 , intent , PendingIntent.FLAG_UPDATE_CURRENT);

والخطوة الأخيرة هي وضع هذا Intent ضمن خصائص الإشعار باستخدام كائن البناء:

mBuilder.setContentIntent(pIntent);

لتُصبح الشيفرة النهائية لملف MainActivity.java بعد التعديل هي:

package apps.noby.simplenotification;

import android.app.Activity;
import android.app.Notification;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;

public class MainActivity extends Activity {

	private Button shwbtn;
	private String title;
	private String detailText;
	public final static String DESC_KEY ="descriptionKey";

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);

        shwbtn = (Button) findViewById(R.id.shw_notification);
		title = "New Message";
		detailText ="Hi, This is the message text.";

    	shwbtn.setOnClickListener(new View.OnClickListener() {
			@Override
			public void onClick(View v) {
				//Step 1
				Notification.Builder mBuilder = new Notification.Builder(MainActivity.this);

				//Step 2
				mBuilder.setSmallIcon(R.drawable.ic_message);
				mBuilder.setContentTitle(title);
				mBuilder.setContentText(detailText);

				Intent intent = new Intent(MainActivity.this,ResultActivity.class);
				intent.putExtra(DESC_KEY,detailText);
				PendingIntent pIntent = PendingIntent.getActivity(MainActivity.this,0,intent,PendingIntent.FLAG_UPDATE_CURRENT);

				mBuilder.setContentIntent(pIntent);

				//Step 3
				Notification notif = mBuilder.build();

				//Step 4
				NotificationManager notifyMngr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);

				int notificationId = 103;
				notifyMngr.notify(notificationId,notif);
			}
		});
	}
}

ولم نقم بتغيير شيء في ملف الواجهة activity_main.xml.

الآن لعرض التفاصيل التي سترسل إلى النشاط الجديد ResultActivity.java نبدأ في صنع واجهة المستخدم الخاصة بالنشاط ثم بتغيير الشيفرة الخاصة به ولا يوجد اختلاف بينها وبين الطريقة المستخدمة في الدروس السابقة.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:gravity="center"
	android:orientation="vertical">

	<TextView
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:textSize="25sp"
		android:id="@+id/desc"/>
</LinearLayout>

package apps.noby.simplenotification;

import android.content.Intent;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;

public class ResultActivity extends AppCompatActivity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_result);

		TextView tv = (TextView) findViewById(R.id.desc);
		Intent intent = getIntent();
		String description = intent.getExtras().getString(MainActivity.DESC_KEY);
		tv.setText(description);
	}
}

ثم نقوم بتجربة التطبيق على المحاكي.

تطبيق 3

لاحظ أنه عند الضغط على الإشعار في التطبيق السابق يقوم بفتح نشاط جديد ولكن يظل الإشعار متواجدًا في درج الإشعارات رغم عرضه والتفاعل معه لذا سنقوم في هذا التطبيق بتغيير بسيط حتى يختفي الإشعار بمجرد التفاعل معه.

في شيفرة التطبيق السابق بداخل الملف MainActivity.java سنقوم بتعديل السطور الخاصة بالخطوة الثانية لتُصبح.

mBuilder.setContentTitle(title);
mBuilder.setContentText(detailText);

mBuilder.setAutoCancel(true);

Intent intent = new Intent(MainActivity.this,ResultActivity.class);
intent.putExtra(DESC_KEY,detailText);

قمنا فقط بإضافة السطر الخاص باستدعاء التابع ()setAutoCancel وتمرير القيمة true باستخدام كائن البناء، والآن عند تجربة التطبيق بعد هذا التعديل ستجد أنه يقوم بإزالة الإشعار بمجرد الضغط عليه.

تطبيق 4

يتم استخدام الشكل السابق بكثرة خاصة في تطبيقات المحادثة أو رسائل البريد حيث يتم عرض صورة المستخدم وبجانبها بحجم صغير الأيقونة الخاصة بالتطبيق.

ولصنع ذلك يتم استدعاء التابع ()setLargeIcon باستخدام كائن البناء وتمرير له الصورة المراد عرضها بحجم كبير.

لكن هناك شرط وهو أن تكون الصورة بصيغة Bitmap ولأننا حتى الآن نقوم في الدروس باستخدام الصور المتواجدة في مجلد drawable لذا ينبغي قبل تمريرها للتابع ()setLargeIcon أن نقوم بتحويلها إلى Bitmap ويتم ذلك عن طريق الخطوة التالية.

Bitmap img = BitmapFactory.decodeResource(MainActivity.this.getResources(), R.drawable.ic_person);

ثم بعد ذلك تمريرها كما سبق لبناء الإشعار.

mBuilder.setLargeIcon(img);

لتُصبح الشيفرة الكاملة الخاصة بالملف MainActivity.java هي:

package apps.noby.simplenotification;

import android.app.Activity;
import android.app.Notification;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.content.Intent;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;

public class MainActivity extends Activity {

	private Button shwbtn;
	private String title;
	private String detailText;
	public final static String DESC_KEY ="descriptionKey";

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);

		shwbtn = (Button) findViewById(R.id.shw_notification);
		title = "New Message";
		detailText ="Hi, This is the message text.";

      	shwbtn.setOnClickListener(new View.OnClickListener() {
			@Override
			public void onClick(View v) {
				//Step 1
				Notification.Builder mBuilder = new Notification.Builder(MainActivity.this);

				//Step 2
				mBuilder.setSmallIcon(R.drawable.ic_message);

				Bitmap img = BitmapFactory.decodeResource(MainActivity.this.getResources(), R.drawable.ic_person);
				mBuilder.setLargeIcon(img);

				mBuilder.setContentTitle(title);
				mBuilder.setContentText(detailText);
				mBuilder.setAutoCancel(true);

				Intent intent = new Intent(MainActivity.this,ResultActivity.class);
				intent.putExtra(DESC_KEY,detailText);
				PendingIntent pIntent = PendingIntent.getActivity(MainActivity.this,0,intent,PendingIntent.FLAG_UPDATE_CURRENT);

				mBuilder.setContentIntent(pIntent);

				//Step 3
				Notification notif = mBuilder.build();

				//Step 4
				NotificationManager notifyMngr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);

				int notificationId = 103;
				notifyMngr.notify(notificationId,notif);

			}
		});
	}
}

ليعمل التطبيق كما هو متوقع على المحاكي.

تطبيق 5

في بعض الأحيان نحتاج إلى التفاعل السريع للمستخدم مع التطبيق دون الحاجة لفتح التطبيق أو لتوفير أكثر من اختيار لفتح أجزاء محددة في التطبيق.

للقيام بذلك نستخدم التابع ()addAction والذي يمكننا من إضافة زر إلى الإشعار.

PendingIntent pIntent = PendingIntent.getActivity(MainActivity.this,0,intent,PendingIntent.FLAG_UPDATE_CURRENT);

mBuilder.setContentIntent(pIntent);
mBuilder.addAction(R.drawable.ic_reply,"Reply",pIntent);
mBuilder.addAction(R.drawable.ic_content_copy,"Copy",pIntent);

//Step 3
Notification notif = mBuilder.build();

ولاستخدام هذا التابع نقوم بتمرير صورة لتظهر داخل الزر، النص الخاص بالزر وأخيرًا كائن من PendingIntent ليتم تنفيذه عند الضغط على هذا الزر.

ويمكنك عمل ()addAction حتى ثلاث مرات فقط، ويمكن لكل زر أن يكون له PendingIntent مختلف خاص به ليقوم بتنفيذ أمر مختلف وفي المثال السابق لشرح الفكرة تم استخدام PendingIntent واحد.

والآن نقوم بتشغيل التطبيق على المحاكي للتأكد من عمله بشكل صحيح.

تطبيق 6

في بعض الأحيان تحتاج إلى التعديل على إشعار سابق دون إصدار إشعار جديد، وذلك بإضافة بعض المعلومات له أو بتغيير محتوى الإشعار أو كلاهما.

وقد تحتاج أيضًا إلى إزالة الإشعار برمجيًا دون تدخل من المستخدم وذلك عند حدوث شيء محدد أو مرور وقت محدد.

أولًا للقيام بالتعديل أو بتغيير محتوى إشعار دون إصدار إشعار آخر جديد نقوم ببناء الإشعار ثم نقوم بإصداره باستخدام نفس الـ NotificationID الذي نمرره للتابع ()notify حتى يقوم بتعديل الإشعار صاحب ID ذاته.

بفرض أن لدينا هذا الإشعار عند الضغط على زر Show Notification.

shwbtn = (Button) findViewById(R.id.shw_notification);

shwbtn.setOnClickListener(new View.OnClickListener() {
	@Override
	public void onClick(View v) {
		//Step 1
		Notification.Builder mBuilder = new Notification.Builder(MainActivity.this);

		//Step 2
		mBuilder.setSmallIcon(R.drawable.ic_message);

		Bitmap img = BitmapFactory.decodeResource(MainActivity.this.getResources(), R.drawable.ic_person);
		mBuilder.setLargeIcon(img);

		mBuilder.setContentTitle("New Message");
		mBuilder.setContentText("Hi, This is the message text.");
		mBuilder.setNumber(++totalNumber);
		mBuilder.setAutoCancel(true);

		Intent intent = new Intent(MainActivity.this,ResultActivity.class);
		intent.putExtra(DESC_KEY,"Hi, This is the message text.");
		PendingIntent pIntent = PendingIntent.getActivity(MainActivity.this,0,intent,PendingIntent.FLAG_UPDATE_CURRENT);
		mBuilder.setContentIntent(pIntent);

		//Step 3
		Notification notif = mBuilder.build();

		//Step 4
		NotificationManager notifyMngr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);

		int notificationId = 103;
		notifyMngr.notify(notificationId,notif);
	}
});

ثم عند الضغط على الزر Update Notification يتم تغييرها إلى المحتوى التالي.

updatebtn = (Button) findViewById(R.id.upd_notification);

updatebtn.setOnClickListener(new View.OnClickListener() {
	@Override
	public void onClick(View v) {
		//Step 1
		Notification.Builder mBuilder = new Notification.Builder(MainActivity.this);

		//Step 2
		mBuilder.setSmallIcon(R.drawable.ic_message);
	
		Bitmap img = BitmapFactory.decodeResource(MainActivity.this.getResources(), R.drawable.ic_person);
		mBuilder.setLargeIcon(img);

		mBuilder.setContentTitle("Updated Message");
		mBuilder.setContentText("Hi, This is an updated Message.");
		mBuilder.setNumber(++totalNumber);
		mBuilder.setAutoCancel(true);

		Intent intent = new Intent(MainActivity.this,ResultActivity.class);
		intent.putExtra(DESC_KEY,"Hi, This is an updated Message.");
		PendingIntent pIntent = PendingIntent.getActivity(MainActivity.this,0,intent,PendingIntent.FLAG_UPDATE_CURRENT);
		mBuilder.setContentIntent(pIntent);

		//Step 3
		Notification notif = mBuilder.build();

		//Step 4
		NotificationManager notifyMngr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);

		int notificationId = 103;
		notifyMngr.notify(notificationId,notif);
	}
});

لاحظ أننا قمنا باستخدام نفس NotificationID في خطوة إظهار الإشعار وذلك لإخبار النظام أننا نريد التعديل على إشعار متواجد بالفعل.

والآن لإزالة الإشعار نضغط على الزر Cancel Notification.

cnclbtn = (Button) findViewById(R.id.cncl_notification);

cnclbtn.setOnClickListener(new View.OnClickListener() {
	@Override
	public void onClick(View v) {
		NotificationManager notifyMngr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
		totalNumber = 0;
		int notificationId = 103;
		notifyMngr.cancel(notificationId);
	}
});

لإزالة الإشعار نستدعي التابع ()cancel باستخدام الكائن من NotificationManager ونمرر لها الـ ID الخاص بالإشعار.

لاحظ أننا قد قمنا باستخدام التابع ()setNumber عند بناء الإشعار وذلك ليُظهر عدد مرات بناء وتعديل الإشعار ذاته، ويتم بدأ العد مجددًا عند الضغط على الزر Cancel Notification.

وبتغيير ملف الواجهة في activity_main.xml ليُصبح.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:orientation="vertical"
	android:gravity="center">

	<Button
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Show Notification"
		android:id="@+id/shw_notification"/>

	<Button
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Update Notification"
		android:id="@+id/upd_notification"/>

	<Button
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Cancel Notification"
		android:id="@+id/cncl_notification"/>
</LinearLayout>

تستطيع أن تلاحظ الرقم المتواجد أقصى يمين الإشعار والذي يُعبر عن عدد مرات التعديل على الإشعار ذاته، ويتحكم التابع ()setNumber في القيمة التي ستظهر بناءً على قيمة المعامل الذي تم تمريره له.

تطبيق 7

هناك العديد من الإشعارات التي لا يستطيع المستخدم من إزالتها ويجب عليه انتظار انتهاء حدث معين أو القيام بمهمة معينة حتى يختفي الإشعار، مثال على ذلك عند تحميلك لملف تجد إشعار لا يمكنك إزالته يُخبرك بمعلومات عن التحميل وللتخلص منه ينبغي الانتظار حتى اكتمال تحميل الملف أو إلغاء التحميل.

لتفعيل هذه النوعية من الإشعارات داخل التطبيق لدينا طريقتان

1. نقوم بتغير قيمة إحدى خصائص الإشعار الذي قمنا ببنائه وتدعى flags، حيث نقوم بإضافة خاصيتين إلى الإشعار وهما:

• Notification.FLAG_NO_CLEAR وهي تلغي تأثير التابع ()setAutoCancel فلا يتم مسح الإشعار عند الضغط عليه.
• Notification.FLAG_ONGOING_EVENT وهي المسؤولة عن إخبار النظام أن هذا الإشعار لديه معلومات لا زالت لها أهمية ولا ينبغي إزالتها الآن.

//Step 3
Notification notif = mBuilder.build();

notif.flags |= Notification.FLAG_NO_CLEAR | Notification.FLAG_ONGOING_EVENT;

2. استدعاء التابع ()setOngoing باستخدام كائن البناء و تمرير له القيمة true، مع إزالة سطر استدعاء التابع ()setAutoCancel حتى لا يتم إزالة الإشعار عند الضغط عليه.

//Step 2

mBuilder.setSmallIcon(R.drawable.ic_message);
mBuilder.setContentTitle("New Message");
mBuilder.setContentText("Hi, This is the message text.");
mBuilder.setOngoing(true);

ملحوظة: لا يوجد فرق بين أي من الطريقتين من حيث الوظيفة أو التأثير.

ولإزالة هذا الإشعار عند الانتهاء من الحدث ينبغي استدعاء التابع ()cancel وتمرير له NotificationID كما سبق، ولا يمكن إزالته إلا بهذه الطريقة.

تطبيق 8

عندما يأتي تنبيه من تطبيق ما وكانت شاشة القفل مغلقة فهناك ثلاثة اختيارات للنظام للتعامل مع هذا الإشعار.

إما إظهار محتوى الإشعار على شاشة القفل، أو إظهار الإشعار مع إخفاء محتواه أو عدم إظهار الإشعار ويمكن التحكم في هذه الاختيارات برمجيًا من خلال التابع ()setVisibility باستخدام كائن البناء ويُمرر له ثابت قيمته:

• Notification.VISIBILITY_PUBLIC إذا أردت أن يظهر محتوى الإشعار.
• Notification.VISIBILITY_PRIVATE إذا أردت إظهار الإشعار فقط دون إظهار محتواه.
• Notification.VISIBILITY_SECRET وذلك لعدم ظهور الإشعار على شاشة القفل ويظهر حين نتجاوز قفل الشاشة أولًا.

//Step 2
mBuilder.setSmallIcon(R.drawable.ic_message);
mBuilder.setContentTitle("New Message");
mBuilder.setContentText("Hi, This is the message text.");
mBuilder.setAutoCancel(true);
mBuilder.setVisibility(Notification.VISIBILITY_PRIVATE);

ملحوظة: حتى يعمل التابع ()setVisibility يجب أن يكون الحد الأدنى من نسخة النظام التي يدعمها التطبيق هي Lollipop API 21، حيث لا تدعم النسخ الأقدم هذه الميزة لذا تأكد من تغييرها عند عمل مشروع جديد.

تطبيق 9

يدعم أندرويد عدة أنواع من الإشعارات بجانب النوع الأساسي الذي استخدمناه في الأمثلة السابقة.

Big Text Style

حيث تستطيع أن تجمع بين الأمرين، إشعار بسيط يعرض نصًا مختصرًا ويمكن للمستخدم أن يقوم بتكبيره لعرض المزيد من التفاصيل. ويكثر استخدام هذه الطريقة عند عرض إشعار برسالة بريد إلكتروني جديدة فيمكن لك تكبيرها وقراءة تفاصيل الرسالة دون فتح التطبيق.

ويمكنك تطبيق ذلك في تطبيقك عن طريق.

1. عمل إشعار وتحديد خصائصه كما سبق وذلك لتُعرض هذه المعلومات عندما يكون الإشعار صغير الحجم.
2. عمل كائن من Notification.BigTextStyle وتحديد عنوان جديد وعرض تفاصيل أكثر ثم إضافته لخصائص الإشعار.
3. بناء الإشعار.

ولتوضيح هذه الخطوات بالشيفرة نقوم بالتالي:

private void showBigTextNotification() {

	//Step 1
	mBuilder = new Notification.Builder(this);
	mBuilder.setSmallIcon(R.drawable.ic_txt);
	mBuilder.setContentTitle(“Big Text in Normal Mode”);
	mBuilder.setContentText(“Example of a Big Text Notification.”);

	//Step 2
	Notification.BigTextStyle bigText = new Notification.BigTextStyle();
	bigText.bigText(“This Text will be repeated over and over.This Text will be repeated over and over.This Text will be repeated over and over.This Text will be repeated over and over.”);
	bigText.setBigContentTitle(“Big Text in Expansion Mode”);

	mBuilder.setStyle(bigText);

	//Step 3
	Notification notfi = mBuilder.build();
	mNotificationManager.notify(200,notfi);
}

Inbox Style

يختلف هذا النوع عن النوع السابق في أنه يتيح لك عرض التفاصيل في أكثر من سطر، أما النوع السابق سيعرض كافة التفاصيل في نفس السطر دون القدرة على التحكم فيما يُعرض في كل سطر على حدا.

ويُستخدم هذا النوع عند التعديل على إشعار وإضافة المزيد من التفاصيل إليه. مثل تطبيقات البريد الإلكتروني عند عرض في نفس الإشعار سطرًا عن كل رسالة قادمة.

لتطبيق هذا النوع نمر بنفس الخطوات السابقة ولكن باستخدام كائن من الصنف Notification.InboxStyle.

لاحظ أن لكل صنف توابعه الخاصة التي تُمكنك من إضافة الخصائص له.

private void showInboxNotification() {

	//Step 1
	mBuilder = new Notification.Builder(this);
	mBuilder.setSmallIcon(R.drawable.ic_inbox);
	mBuilder.setContentTitle(“Inbox in Normal Mode”);
	mBuilder.setContentText(“Example of a Inbox Notification.”);

	lines = new String[6];
	lines[0] = “Line number 1”;
	lines[1] = “Line number 2”;
	lines[2] = “Line number 3”;
	lines[3] = “Line number 4”;
	lines[4] = “Line number 5”;
	lines[5] = “Line number 6”;

	//Step 2
	Notification.InboxStyle inbox = new Notification.InboxStyle();
	for(int I = 0 ; i<lines.length; i++)
		inbox.addLine(lines[i]);
	inbox.setBigContentTitle(“Inbox in Expansion Mode”);
	mBuilder.setStyle(inbox);

	//Step 3
	Notification notfi = mBuilder.build();
	mNotificationManager.notify(97,notfi);
}

Big Picture Style

عندما تكون تفاصيل الإشعار هي صورة يُفضل استخدام هذا النوع.

وأيضًا يختلف نوع الكائن المستخدم Notification.BigPictureStyle.

private void showBigPictureNotification() {

	//Step 1
	mBuilder = new Notification.Builder(this);
	mBuilder.setSmallIcon(R.drawable.ic_picture);
	mBuilder.setContentTitle(“Big Picture in Normal Mode”);
	mBuilder.setContentText(“Example of a Big Picture Notification.”);

	Bitmap img = BitmapFactory.decodeResource(getResources(),R.drawable.picture);

	//Step 2
	Notification.BigPictureStyle bigPic = new Notification.BigPictureStyle();
	bigPic.bigPicture(img);
	bigPic.setBigContentTitle(“Big Picture in Expansion Mode”);
	mBuilder.setStyle(bigPic);

	//Step 3
	Notification notfi = mBuilder.build();
	mNotificationManager.notify(6,notfi);
}

وبدمج كافة الأنواع في تطبيق واحد يعرض الإشعار عند الضغط على الزر المناسب لتُصبح الشيفرة النهائية لملف MainActivity.java هي:

package apps.noby.advancednotification;

import android.app.Activity;
import android.app.Notification;
import android.app.NotificationManager;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;

public class MainActivity extends Activity {

	private Button bigTextButton;
	private Button inboxButton;
	private Button bigPictureButton;
	private Button cancelButton;

	private Notification.Builder mBuilder;
	private NotificationManager mNotificationManager;

	private String[] lines;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);

		bigTextButton = (Button) findViewById(R.id.bg_txt);
		inboxButton = (Button) findViewById(R.id.inbx);
		bigPictureButton = (Button) findViewById(R.id.bg_pic);
		cancelButton = (Button) findViewById(R.id.cncl);

		mNotificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
		
      	bigTextButton.setOnClickListener(new View.OnClickListener() {
			@Override
			public void onClick (View v){
				showBigTextNotification();
			}
		}
	);

	inboxButton.setOnClickListener(new View.OnClickListener() {
		@Override
		public void onClick(View v) {
			showInboxNotification();
		}
	});

	bigPictureButton.setOnClickListener(new View.OnClickListener() {
		@Override
		public void onClick(View v) {
			showBigPictureNotification();
		}
	});

	cancelButton.setOnClickListener(new View.OnClickListener() {
		@Override
		public void onClick(View v) {
			cancelNotification();
		}
	});
	}

	private void cancelNotification() {
		mNotificationManager.cancelAll();
	}

	private void showBigTextNotification() {
		mBuilder = new Notification.Builder(this);
		mBuilder.setSmallIcon(R.drawable.ic_txt);
		mBuilder.setContentTitle("Big Text in Normal Mode");
		mBuilder.setContentText("Example of a Big Text Notification.");

		Notification.BigTextStyle bigText = new Notification.BigTextStyle();
		bigText.bigText("This Text will be repeated over and over.This Text will be repeated over and over.This Text will be repeated over and over.This Text will be repeated over and over.");
		bigText.setBigContentTitle("Big Text in Expansion Mode");

		mBuilder.setStyle(bigText);

		Notification notfi = mBuilder.build();
	
		mNotificationManager.notify(200,notfi);
	}

	private void showInboxNotification() {
		mBuilder = new Notification.Builder(this);
		mBuilder.setSmallIcon(R.drawable.ic_inbox);
		mBuilder.setContentTitle("Inbox in Normal Mode");
		mBuilder.setContentText("Example of a Inbox Notification.");

		lines = new String[6];
		lines[0] = "Line number 1";
		lines[1] = "Line number 2";
		lines[2] = "Line number 3";
		lines[3] = "Line number 4";
		lines[4] = "Line number 5";
		lines[5] = "Line number 6";

		Notification.InboxStyle inbox = new Notification.InboxStyle();
		for(int i = 0 ; i<lines.length; i++)
			inbox.addLine(lines[i]);
		inbox.setBigContentTitle("Inbox in Expansion Mode");
		mBuilder.setStyle(inbox);

		Notification notfi = mBuilder.build();

		mNotificationManager.notify(97,notfi);
	}

	private void showBigPictureNotification() {
		mBuilder = new Notification.Builder(this);
		mBuilder.setSmallIcon(R.drawable.ic_picture);
		mBuilder.setContentTitle("Big Picture in Normal Mode");
		mBuilder.setContentText("Example of a Big Picture Notification.");

		Bitmap img = BitmapFactory.decodeResource(getResources(),R.drawable.picture);

		Notification.BigPictureStyle bigPic = new Notification.BigPictureStyle();
		bigPic.bigPicture(img);
		bigPic.setBigContentTitle("Big Picture in Expansion Mode");
		mBuilder.setStyle(bigPic);

		Notification notfi = mBuilder.build();
		mNotificationManager.notify(6,notfi);
	}
}

وملف واجهة المستخدم activity_main.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:gravity="center"
	android:orientation="vertical">

	<Button
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Big Text Style"
		android:id="@+id/bg_txt"/>

	<Button
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Inbox Style"
		android:id="@+id/inbx"/>

	<Button
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Big Picture Style"
		android:id="@+id/bg_pic"/>

	<Button
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Cancel ALL"
		android:id="@+id/cncl"/>
</LinearLayout>

بهذا نكون قد وصلنا إلى نهاية هذا الدرس، في انتظار تجربتكم وآرائكم.

تنتشر الهواتف المحمولة والحواسيب اللوحية العاملة بنظام تشغيل أندرويد في أحجام مختلفة ودقة شاشات مختلفة، لذلك من الأفضل دائمًا إذا استطاع التطبيق أن يتأقلم مع حجم ودقة الشاشة لتقديم أفضل تجربة استخدام مع الاستغلال الأمثل لشاشة.

ويمكن أن تبني تطبيقًا تتغير الواجهة الخاصة به بشكل ديناميكي تبعًا للمساحة المتاحة في الشاشة، فإذا لم تتواجد مساحة كافية، يظهر جزء من الواجهة فقط في الشاشة ومنه يمكن الانتقال للواجهة الأخرى مثل الصورة التالية:

أما إذا توافرت المساحة الكافية فيمكن دمج أكثر من واجهة في واجهة واحدة لسهولة التنقل بينها كما في الصورة التالية:

لذا يوفر أندرويد عدة طرق للقيام بذلك من ضمنها استخدام الـ Fragment داخل التطبيق.

Fragment

يُعبر مصطلح Fragment عن تجزئة واجهة المستخدم إلى وحدات أصغر تُمكن المطوّر من دمج أو فصل هذه الوحدات تبعًا لحجم الشاشة، ولا تتكون تلك الوحدة من عناصر واجهة المستخدم فقط ولكنها أيضًا تتكون من شيفرات تتحكم في وظيفة هذه الواجهة وسلوكها.

لكن هذه الوحدات ليست مستقلة بذاتها أي لا يمكن أن تُعرض بداخل التطبيق إلا من خلال نشاط “Activity” يستضيفها بداخله. ولهذا المفهوم العديد من المزايا التي توفرها عند تطوير التطبيقات ومنها:

1. تقسيم الشيفرات المعقدة التي تتواجد في واجهة نشاط واحد إلى عدة وحدات لكل منها شيفرة بسيطة يتم دمجها وترتيبها بعد ذلك داخل واجهة واحدة.
2. إمكانية إعادة استخدام الوحدة عدة مرات في أنشطة مختلفة ودمجها مع وحدات أخرى مختلفة.
3. التكييف مع الواجهات المختلفة والأحجام المختلفة.

دورة حياة التجزئة Fragment

للـ Fragment دورة حياة مشابهة لدورة حياة النشاط ويتم استدعاء التوابع الخاصة بدورة الحياة عند حدوث حدث معين كإنشاء أو إزالة الـ Fragment.

• ()onAttach: ويتم استدعاؤه عندما يتم ربط الـ Fragment بالنشاط المضيف.
• ()onCreate: ويتم استدعاؤه بعد ربطه بالنشاط مباشرة وذلك لاستخدامها في تهيئة العناصر والمتغيرات التي نرغب في بقائها حتى بعد إزالة واجهة الـ Fragment من داخل النشاط المضيف.
• ()onCreateView: ويتم استدعاؤه لربط الواجهة الخاصة بالـ Fragment بالشيفرة الخاصة به.
• ()onActivityCreated: ويتم استدعاؤه بعد انتهاء النشاط المضيف من التابع ()onCreate الخاص به.
• ()onStart: ويتم استدعاؤه عندما تبدأ الواجهة الخاصة بالـ Fragment في الظهور وذلك بعد الانتهاء من ()onStart الخاصة بالنشاط أولًا.
• ()onResume: ويتم استدعاؤه عندما تظهر الواجهة الخاصة بالـFragment وتصبح قابلة لتفاعل المستخدم معها، مع العلم بأنه لا يمكن للمستخدم بالتفاعل مع واجهة الـ Fragment قبل أن يتم استدعاء ()onResume الخاصة بالنشاط أولًا لتصبح واجهة النشاط قابلة للتفاعل أيضًا.
• ()onPause: ويتم استدعاؤه عندما تبدأ الواجهة الخاصة بالنشاط المضيف في الاختفاء أو تظهر بشكل جزئي ولا يمكن للمستخدم التفاعل معها لوجود شيء ما يحجبها، أو عند الاستعداد لاستبدال أو إزالة الـ Fragment.
• ()onStop: ويتم استدعاؤه عندما تختفي الواجهة الخاصة بالنشاط المضيف من أمام المستخدم أو لاستبدال أو إزالة الـ Fragment.
• ()onDestroyView: ويتم استدعاؤه عند إزالة الواجهة التي تم إضافتها من قبل في ()onCreateView.
• ()onDestroy: ويتم استدعاؤه قبل تدمير الواجهة وإزالتها من الذاكرة.
• ()onDetach: ويتم استدعاؤه عند إزالة الـ Fragment من واجهة النشاط المضيف.

لذا فكما ذكرنا فدورة حياة الـ Fragment مشابهة لدورة حياة النشاط ولكن هناك بعض التوابع الخاصة بالـ Fragment فقط ولا تتواجد في النشاط.

تطبيق 1

الهدف من هذا التطبيق فهم الأساسيات الخاصة بالـ Fragments حيث تتكون من:

1. واجهة خاصة به (XML File).
2. صنف جديد يرث من Fragment.
3. مكان خاص له في الواجهة الرئيسية الخاصة بالنشاط المضيف.

من Android Studio نُنشئ مشروعًا جديدًا يُدعى Simple Fragment وبنفس الإعدادات في المشاريع السابقة.

نبدأ أولًا بصنع Fragment جديد (ملف واجهة وملف للشيفرة) عن طريق الضغط بالزر الأيمن على اسم الحزمة الخاصة بالمشروع كما بالصورة التالية:

ثم اختر:

New > Fragment > Fragment Blank

لتظهر لك هذه النافذة، قم بتغيير الاسم إلى الاسم الذي تراه مناسبًا وتغيير الاختيارات كما بالصورة:

ثم اضغط Finish.

سيقوم Android Studio بعد ذلك بإنشاء صنف جديد يُدعى ExampleFragment ويرث من الصنف Fragment، كما سينشئ ملف واجهة جديد يُدعى fragment_example.

نقوم بتغيير ملف الواجهة كما كنا نفعل في التطبيقات السابقة وفي هذا المثال سنكتفي بوضع نص في منتصف الواجهة مع تغيير لون الخلفية:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:background="#ccefff"
	android:orientation="vertical">

	<TextView
		android:layout_width="match_parent"
		android:layout_height="match_parent"
		android:text="Hello From Example Fragment"
		android:gravity="center"/>
</LinearLayout>

والآن لربط ملف الواجهة بالشيفرة الخاصة بالصنف ExampleFragment نكتب داخل التابع ()onCreateView -وهو التابع المسؤول عن ربط الشيفرة بالواجهة- الشيفرة التالية:

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {

	View rootView =inflater.inflate(R.layout.fragment_example, container, false);
	return rootView;
}

تختلف طريقة ربط الواجهة في الـ Fragment عنها في النشاط (Activity) فلا نستطيع استخدام التابع ()setContentView، عوضًا عن ذلك نستخدم الكائن inflater الذي تم تمريره للتابع ()onCreateView ونستدعي به التابع ()inflate وقد تعاملنا مع هذا التابع من قبل في الدرس الخاص بقوائم العرض ListView، ونمرر للتابع المعاملات الآتية:

1. الواجهة التي نريد ربطها.
2. الواجهة التي ستحتوي واجهة الـ Fragment بداخلها وهي هنا container.
3. قيمة منطقية تُعبر عن "هل نريد وضع واجهة الـ Fragment داخل الواجهة container -المعامل السابق- أم لا؟"، وسنقوم دائمًا عند التعامل مع الـ Fragments بالإجابة بلا أو القيمة المنطقية false؛ وذلك لأنها بشكل افتراضي يتم ربطها.

ويقوم هذا التابع بتحويل ملف الواجهة (XML File) إلى كائن من الصنف View يمكن التعامل معه داخل شيفرات جافا بسهولة.

بعد ذلك نعيد الكائن rootView إلى التابع، لتصبح الشيفرة النهائية على الشّكل التّالي:

package apps.noby.simplefragment;

import android.os.Bundle;
import android.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;

public class ExampleFragment extends Fragment {

  	@Override
	public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {

		View rootView =inflater.inflate(R.layout.fragment_example, container, false);
		return rootView;
	}
}

لاحظ أنه لكي تعمل الشيفرة بشكل سليم عند الوراثة من الصنف Fragment يجب أن تقوم بتضمين ;import android.app.Fragment.

يتبقى الآن الخطوة الأخيرة وهي إيجاد مكان لهذا الـ Fragment داخل النشاط المضيف له، وفي هذا التطبيق النشاط المضيف هو النشاط الرئيسي (MainActivity)، ولوضع مكان للـ Fragment داخل ملف واجهة النشاط نقوم بتعريف عنصر واجهة جديد من النوع <fragment> وتحديد له بعض الخصائص كما يلي:

<fragment
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:name="apps.noby.simplefragment.ExampleFragment"
	android:id="@+id/fragment_container"
	tools:layout="@layout/fragment_example" />

هناك بعض الخصائص المشتركة في العناصر كتحديد الطول والعرض وهناك خصائص تميز العنصر ولابد من تحديدها مثل android:name وتكمن أهميته في تحديد الصنف الذي سيُعرض داخل هذا العنصر ولن يعمل التطبيق بدون وضع قيمة لهذه الخاصية وهنا وضعنا اسم الصنف الذي صنعناه سابقًا مع وضع اسم الحزمة كاملًا قبله. ولابد أيضًا من تحديد id مميز لهذا العنصر.

وسنضع داخل ملف الواجهة الرئيسي نص قبل واجهة الـ Fragment ليصبح ملف الواجهة كالتالي:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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:orientation="vertical">

	<TextView
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Hello Main Activity!"
		android:layout_gravity="center"
		android:textSize="25sp"/>

	<fragment
		android:layout_width="match_parent"
		android:layout_height="match_parent"
		android:name="apps.noby.simplefragment.ExampleFragment"
		android:id="@+id/fragment_container"
		tools:layout="@layout/fragment_example" />
</LinearLayout>

ولن نقوم بتغيير الشيفرة الخاصة بالنشاط الرئيسي وسندعها كما هي، الآن يمكننا تجربة التطبيق على المحاكي للتأكد من عمله كما ينبغي.

وتُسمى هذه الطريقة بالطريقة الساكنة لتضمين الـ Fragment؛ وذلك لأننا لم نحتج إلى كتابة شيفرات داخل النشاط لوضع الـ Fragment بداخله.

تطبيق 2

في هذا التطبيق سنقوم بعرض أكثر من Fragment بداخل نشاط واحد عند توفر المساحة المناسبة له، أما إذا لم تتوفر فسيتم عرض Fragment واحد فقط.

سنقوم بتعديل على المثال السابق وعمل Fragment جديد يُدعى DetailsFragment بنفس الطريقة السابقة ونجعل له الواجهة التالية:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:background="#ffc829"
	android:orientation="vertical">

  <TextView
		android:layout_width="match_parent"
		android:layout_height="match_parent"
		android:text="Hello From Details Fragment"
		android:gravity="center"/>
</LinearLayout>

وتتشابه الواجهة السابقة مع واجهة الـ Fragment الآخر، بعد ذلك سنقوم بعمل ملف واجهة جديد يُدعى activity_main ولكن سنختار أن يوضع في المجلد layout-large كما في الصورة التالية:

وبداخل ملف الواجهة الجديد نضع مكان آخر للـ Fragment الجديد بجانب الأول.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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:orientation="vertical">

	<TextView
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Hello Main Activity!"
		android:layout_gravity="center"
		android:textSize="25sp"/>

	<LinearLayout
		android:layout_width="match_parent"
		android:layout_height="match_parent"
		android:orientation="horizontal">

		<fragment
			android:layout_width="0dp"
			android:layout_height="match_parent"
			android:layout_weight="1"
			android:name="apps.noby.simplefragment.ExampleFragment"
			android:id="@+id/fragment_container"
			tools:layout="@layout/fragment_example" />

		<fragment
			android:layout_width="0dp"
			android:layout_height="match_parent"
			android:layout_weight="1"
			android:name="apps.noby.simplefragment.DetailsFragment"
			android:id="@+id/fragment_details"
			tools:layout="@layout/fragment_details" />

	</LinearLayout>
</LinearLayout>

ووضع القيم الخاصة بالخاصيتين name و id، والشيفرة الخاصة بملف جافا الخاص بـ DetailsFragment يتشابه مع ExampleFragment.

package apps.noby.simplefragment;


import android.os.Bundle;
import android.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;


public class DetailsFragment extends Fragment {

	@Override
	public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {

		View rootView = inflater.inflate(R.layout.fragment_details,container,false);
		return rootView;
	}
}

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

بناءً على الحجم الخاص بشاشة الجهاز يقوم التطبيق باستدعاء ملف الواجهة الخاص بالنشاط المناسب (العادي أو الكبير).

لاحظ أنه يجب أن يكون بجانب اسم المجلد layout كلمة large حتى يعلم التطبيق بوجود ملفات خاصة بالشاشات ذات الحجم الكبير.

تطبيق 3

في هذا التطبيق سنقوم بتغيير طريقة تضمين الـ Fragment من الطريقة الساكنة إلى الديناميكية أي إمكانية إضافة، تبديل حذف الـ Fragment أثناء تشغيل التطبيق والتحكم به عن طريق الشيفرة.

وللقيام بذلك سنستبدل عنصر الواجهة <fragment> بالعنصر <FrameLayout> والذي يقوم بحجز مساحة فارغة في الواجهة سيتم تحديد فيما بعد ما الذي سيشغلها.

كل ما سيختلف في هذا التطبيق ملفات الواجهة الرئيسية الخاصة بالنشاط المضيف فقط ولن يحدث تغيير في الواجهة الخاصة بالـ Fragment.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:orientation="vertical">

	<TextView
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Hello Main Activity!"
		android:layout_gravity="center"
		android:textSize="25sp"/>

	<FrameLayout
		android:layout_width="match_parent"
		android:layout_height="match_parent"
		android:id="@+id/view_container" />
</LinearLayout>

ولتحديد المحتوى الخاص بالعنصر FrameLayout ننتقل إلى ملف النشاط MainActivity.java لتعديله، الآن لإضافة Fragment جديد داخل الواجهة ينبغي أن نمر بثلاث خطوات

1. إيجاد كائن من الصنف FragmentManger والذي يستطيع إدارة كافة المهام الخاصة بالتعامل مع الـ Fragments ومن ضمن هذه المهام هي إضافة الـ Framgments ولجلب كائن من هذا الصنف نستدعى التابع ()getFragmentManager حيث يوجد كائن بالفعل داخل النشاط ويكتفي استدعاءه فقط.

FragmentManager fragmentManager = getFragmentManager();

2. للتحكم في المهام الخاصة بإضافة أو تبديل او إزالة الـ Fragments نحتاج إلى كائن من الصنف FragmentTransaction والذي يحتوي على التوابع التي تقوم بعملية الإضافة تلك.

FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();

3. أخيرًا نستطيع استدعاء التابع المناسب للعملية وتمرير له المعاملات الصحيحة.

ExampleFragment frag = new ExampleFragment();
fragmentTransaction.add(R.id.view_container, frag);
fragmentTransaction.commit();

يستطيع التابع ()add من إضافة Fragment إلى الواجهة التي سيُعرض بها، وتلك هي المعاملات التي نمررها له:

• الـ id الخاص بعنصر الواجهة.
• كائن من الـ Fragment الذي نرغب في عرضه بداخل عنصر الواجهة.

وبعد ذلك نستدعي التابع ()commit لتنفيذ العملية السابقة، حيث لن يتم تنفيذها إلا بعد استدعاءه.

لتصبح الشيفرة الكاملة للنشاط كما يلي:

package apps.noby.simplefragment;

import android.app.Activity;
import android.app.FragmentManager;
import android.app.FragmentTransaction;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;

public class MainActivity extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);

		if(findViewById(R.id.view_container) != null){
			FragmentManager fragmentManager = getFragmentManager();
			FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
			ExampleFragment frag = new ExampleFragment();
			fragmentTransaction.add(R.id.view_container, frag);
			fragmentTransaction.commit();
		}
	}
}

وفائدة الجملة الشرطية هو التأكد من أننا نتعامل مع ملف الواجهة activity_main.xml الخاص بالهواتف والذي يحتوي بداخله على عنصر له id قيمته view_container، وليس ملف الواجهة الآخر الخاص بالشاشات كبيرة الحجم حيث لا يحتوي على عنصر له ذلك الـ id.

والآن بتجربة التطبيق على كلا المحاكيين -الهاتف والحاسب اللوحي- نجد أنه يعمل كالتطبيقات السابقة.

تطبيق 4

في التطبيقات السابقة لم نتمكن من عرض الـ Fragment الآخر في حالة الهاتف وذلك لأن التبديل بين Fragment وآخر لا تتم إلا داخل النشاط المضيف، لذا ينبغي أن نجعل الشيفرة الخاصة بالـ Fragment قادرة على التحدث مع النشاط المضيف لها وتنفيذ شيفرات بداخله. ويمكننا القيام بذلك باستخدام interface كحلقة وصل بين النشاط المضيف والـ Fragment.

نضع أولًا زر في الواجهة الخاصة بـ fragment_example.xml عند الضغط عليه ننتقل إلى الـ fragment_details كالآتي.

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:background="#ccefff"
	android:orientation="vertical"
	android:gravity="center">

	<TextView
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Hello From Example Fragment"/>

	<Button
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Go to Details Frafment"
		android:id="@+id/go_to_btn"/>

</LinearLayout>

ثم ننتقل إلى الشيفرة الخاصة بـ ExampleFragment.java وبداخلها نقوم بصنع interface جديد يُدعى OnBtnClicked وبداخله التابع ()goToFragment.

public interface OnBtnClicked{
	public void goToFragment();
}

ثم نجعل الصنف الخاص بالنشاط المضيف يقوم باستخدام هذا الـ interface.

public class MainActivity extends Activity implements ExampleFragment.OnBtnClicked

نعود مجددًا للشيفرة الخاصة بـ ExampleFragmen.java ونقوم بكتابة التابع ()onAttach الخاص بدورة الحياة للـ Fragment كالتالي:

private MainActivity mContext;

@Override
public void onAttach(Context context) {
	super.onAttach(context);
	mContext = (MainActivity) context;
}

ووظيفة الشيفرة السابقة جعل الشيفرة الخاصة بالـ Fragment تستطيع التواصل مع النشاط المضيف باستخدام كائن منه يُمرر لحظة ربط الـ fragment بالنشاط المضيف.

ثم بعد ذلك لربط الزر الذي قمنا بإضافته في الواجهة بالشيفرة نستخدم التابع ()findViewById ولكن هذه المرة باستخدام الكائن rootView وذلك لأنه يُعبر عن الواجهة فلا يمكننا من استدعاء التابع مباشرة كما كان داخل النشاط.

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {

	View rootView =inflater.inflate(R.layout.fragment_example, container, false);

	Button btn = (Button)rootView.findViewById(R.id.go_to_btn);

	btn.setOnClickListener(new View.OnClickListener() {
		@Override
		public void onClick(View v) {
			mContext.goToFragment();
		}
	});

	return rootView;
}

ونجعل الزر مستعدًا للاستجابة عند الضغط عليه على أن يقوم باستدعاء التابع ()goToFragment باستخدام الكائن الخاص بالنشاط المضيف. لتصبح الشيفرة النهائية لهذا الـ Fragment كالتالي:

package apps.noby.simplefragment;
import android.content.Context;
import android.os.Bundle;
import android.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.Button;


public class ExampleFragment extends Fragment {

	private MainActivity mContext;
  
	@Override
	public void onAttach(Context context) {
		super.onAttach(context);
		mContext = (MainActivity) context;
	}

	@Override
	public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {

		View rootView =inflater.inflate(R.layout.fragment_example, container, false);

		Button btn = (Button)rootView.findViewById(R.id.go_to_btn);

		btn.setOnClickListener(new View.OnClickListener() {
			@Override
			public void onClick(View v) {
				mContext.goToFragment();
			}
		});
		return rootView;
	}

	public interface OnBtnClicked{

		public void goToFragment();
	}
}

يتبقى فقط إضافة الوظيفة التي نريدها عن الضغط على هذا الزر وذلك بكتابة الشيفرة الخاصة بالتابع ()goToFragment داخل النشاط المضيف.

package apps.noby.simplefragment;

import android.app.Activity;
import android.app.FragmentManager;
import android.app.FragmentTransaction;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;

public class MainActivity extends Activity implements ExampleFragment.OnBtnClicked {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);

		if(findViewById(R.id.view_container) != null){
			FragmentManager fragmentManager = getFragmentManager();
			FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
			ExampleFragment frag = new ExampleFragment();
			fragmentTransaction.add(R.id.view_container, frag);
			fragmentTransaction.commit();
		}
	}

	@Override
	public void goToFragment() {
		if(findViewById(R.id.view_container) != null){
			FragmentManager fragmentManager = getFragmentManager();
			FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
			DetailsFragment frag = new DetailsFragment();
			fragmentTransaction.replace(R.id.view_container, frag);
			fragmentTransaction.addToBackStack(null);
			fragmentTransaction.commit();
		}
	}
}

وتتشابه الشيفرة داخل التابع ()goToFragment مع الأخرى المتواجدة داخل ()onCreate ولكننا نستخدم التابع ()replace بدلًا من ()add وذلك لتبديل الواجهات داخل نفس العنصر FrameLayout بشكل ديناميكي، كما نستدعي التابع ()addToBackStack وذلك حتى نضيف واجهة الـ Fragment السابق في الذاكرة الخاصة بزر الرجوع حتى نعود إليها عند الضغط على زر الرجوع وإلا سيتم غلق التطبيق.

وتوضح الصورة التالية ما المقصود بذلك:

والآن عند تجربة التطبيق على المحاكي (الهاتف أو الحاسب اللوحي) نجد أننا نستطيع الوصول إلى الـ DetailsFragment عند الضغط على الزر.

تطبيق 5

في التطبيق التالي سنقوم بإرسال نص من Fragment إلى آخر للتحدث فيما بينهما.

ويتم ذلك عن طريق استخدام التابع ()setArguments وللقيام بذلك نقوم بتلك التعديلات على التطبيق السابق.

في ملف الواجهة fragment_example.xml نضيف عنصر EditText بالخصائص الآتية.

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:background="#ccefff"
	android:orientation="vertical"
	android:gravity="center">

	<TextView
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Hello From Example Fragment"/>

	<EditText
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:hint="Enter Your Name"
		android:id="@+id/edit_txt"/>

	<Button
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Go to Details Frafment"
		android:id="@+id/go_to_btn"/>

</LinearLayout>

وفي ملف الواجهة fragment_details نضيف الخاصية id للعنصر TextView.

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:background="#ffc829"
	android:orientation="vertical">

	<TextView
		android:layout_width="match_parent"
		android:layout_height="match_parent"
		android:text="Hello From Details Fragment"
		android:gravity="center"
		android:id="@+id/txt_view"/>

</LinearLayout>

وفي ملف الواجهة الرئيسي الخاص بالشاشات ذات الحجم الكبير نقوم بتغيير العنصر fragment الثاني بالعنصر FrameLayout.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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:orientation="vertical">

	<TextView
		android:layout_width="wrap_content"
		android:layout_height="wrap_content"
		android:text="Hello Main Activity!"
		android:layout_gravity="center"
		android:textSize="25sp"/>

	<LinearLayout
		android:layout_width="match_parent"
		android:layout_height="match_parent"
		android:orientation="horizontal">
		
		<fragment
			android:layout_width="0dp"
			android:layout_height="match_parent"
			android:layout_weight="1"
			android:name="apps.noby.simplefragment.ExampleFragment"
			android:id="@+id/fragment_container"
			tools:layout="@layout/fragment_example" />

		<FrameLayout
			android:layout_width="0dp"
			android:layout_height="match_parent"
			android:layout_weight="1"
			android:id="@+id/fragment_details"/>
	</LinearLayout>
</LinearLayout>

داخل الشيفرة الخاصة بـ ExampleFragment.java نقوم بتغيير التابع داخل الـ interface ليقبل تمرير نص، ثم عند الضغط على الزر نرسل النص المكتوب داخل عنصر الواجهة EditText إلى التابع ()goToFragment.

package apps.noby.simplefragment;
import android.content.Context;
import android.os.Bundle;
import android.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.Button;
import android.widget.EditText;


public class ExampleFragment extends Fragment {

	private MainActivity mContext;
  
	@Override
	public void onAttach(Context context) {
		super.onAttach(context);
		mContext = (MainActivity) context;
	}

	@Override
	public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {

		final View rootView =inflater.inflate(R.layout.fragment_example, container, false);

		Button btn = (Button)rootView.findViewById(R.id.go_to_btn);

		btn.setOnClickListener(new View.OnClickListener() {
			@Override
			public void onClick(View v) {
				EditText et = (EditText) rootView.findViewById(R.id.edit_txt);
				String name = et.getText().toString();
				mContext.goToFragment(name);
			}
		});

		return rootView;
	}

	public interface OnBtnClicked{

		public void goToFragment(String name);
	}
}