onRestart — استعادة Activity في دورة الحياة

onRestart — جوهر الطريقة في دورة حياة Android

onRestart — طريقة رد اتصال يستدعيها Android بدقة قبل onStart عندما تعود Activity من الحالة Stopped غير المرئية إلى كونها مرئية. هذه الطريقة فريدة من نوعها حيث أنها تُستدعى فقط عند عرض Activity مرة أخرى — أثناء الإنشاء الأول للمثيل، يبدأ التسلسل بـ onCreate، متجاوزاً onRestart. الدورة الكاملة: onCreate → onStart → onResume (التشغيل الأول) أو onRestart → onStart → onResume (العرض اللاحق).

من منظور نظام Android، onRestart هي تحسين يسمح لـ Activity بالتحضير لعودتها: تحديث البيانات من المستودع، مزامنة حالة واجهة المستخدم، التحقق من اتصال الشبكة. على عكس onResume، الذي يُستدعى في كل مرة تحصل فيها Activity على التركيز (بما في ذلك عند العودة من حوار أو قائمة نظام)، يتم تشغيل onRestart فقط أثناء دورة كاملة من الإخفاء والعودة. هذا يجعل onRestart المكان المثالي لعمليات التحديث «الثقيلة» غير اللازمة أثناء فقدان التركيز الجزئي.

وفقاً لمواصفات دورة حياة Activity في Android، يمكن أن تتراوح الفترة الزمنية بين onStop و onRestart من بضع ثوانٍ (المستخدم بدّل بسرعة) إلى عدة ساعات (كان التطبيق في الخلفية وعاد المستخدم). خلال هذا الوقت، قد تكون البيانات في مصدر بعيد (API، قاعدة بيانات) قد تغيرت، لذا فإن onRestart هي نقطة طبيعية للتحقق من الحداثة.

متى يُستدعى onRestart: الشروط والتسلسل

onRestart يُستدعى فقط عندما تعود Activity من الحالة Stopped، والتي دخلتها Activity بعد استدعاء onStop. فيما يلي جميع السيناريوهات التي تؤدي إلى onRestart.

سيناريوهات استدعاء onRestart:

• العودة من Activity أخرى — فتح المستخدم Activity جديدة (مثلاً، نقر على إشعار) ثم عاد للخلف (ضغط «رجوع»). المكدس: MainActivity.onPause → MainActivity.onStop → يتم إنشاء SecondActivity → يضغط المستخدم «رجوع» → SecondActivity.onPause → SecondActivity.onStop → SecondActivity.onDestroy → MainActivity.onRestart → MainActivity.onStart → MainActivity.onResume.
• العودة من التصغير — صغر المستخدم التطبيق (الصفحة الرئيسية) وبعد فترة عاد. CurrentActivity.onPause → CurrentActivity.onStop → (التطبيق في الخلفية) → يعود المستخدم → CurrentActivity.onRestart → CurrentActivity.onStart → CurrentActivity.onResume.
• العودة من شاشة القفل — شاشة القفل تغطي Activity؛ بعد فتح القفل، تستلم Activity onRestart إذا مر وقت طويل (أكثر من 5 ثوانٍ).
• العودة من تطبيق تم تشغيله عبر Intent — الكاميرا، المعرض، المتصفح — أي تطبيق طرف ثالث تم تشغيله عبر startActivityForResult() أو ActivityResultLauncher.

متى لا يُستدعى onRestart: أثناء تدوير الشاشة (يتم تدمير Activity وإعادة إنشائها عبر onCreate)، عند العودة من مربع حوار (لا تدخل Activity في onStop، فقط onPause → onResume)، أثناء إنهاء العملية (يتم إعادة إنشاء Activity).

onRestart مقابل onCreate: أيهما تختار

onRestart و onCreate هما نهجان مختلفان لاستعادة Activity. يعتمد الاختيار بينهما على ما إذا كانت Activity قد دُمّرت بالكامل أو تم إخفاؤها ببساطة.

قاعدة الاختيار: قم بتهيئة View والاشتراك في LiveData/StateFlow في onCreate (أو onViewCreated للـ Fragment). تحديثات البيانات وإعادة تحميل القوائم والتحقق من الحالة — في onRestart. إذا تم تحميل البيانات عبر ViewModel، يمكن لـ onRestart ببساطة استدعاء طريقة refresh() على ViewModel، وستشترك View في البيانات المحدثة عبر تدفق تفاعلي.

توصي Google: لا تكرر منطق onCreate في onRestart. استخرج طرق refresh() في ViewModel التي تحمل البيانات الحالية، واستدعها في onRestart. هذا يحافظ على هندسة MVVM نظيفة ويزيل تكرار الكود.

حالات استخدام onRestart: تحديث البيانات وواجهة المستخدم

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

• تحديث قائمة من قاعدة البيانات أو API — ذهب المستخدم إلى Activity أخرى، غير البيانات هناك، عاد — يجب أن تكون القائمة محدثة. استدع viewModel.refreshItems() في onRestart.
• التحقق من التفويض — إذا كانت Activity مخفية لفترة طويلة، قد يكون رمز الوصول قد انتهت صلاحيته. onRestart هي نقطة التحقق من صحة الرمز وإعادة التوجيه إلى شاشة تسجيل الدخول.
• مزامنة حالة واجهة المستخدم — تبديل السمة، تغيير اللغة، تحديث الإعدادات — يجب أن تنطبق التغييرات عند العودة إلى الشاشة.
• إعادة تحميل الوسائط — إذا كانت Activity تعرض محتوى قد يتغير (خلاصة أخبار، أسعار عملات، طقس)، قم بتحديث البيانات في onRestart.
• التحقق من اتصال الشبكة — عند العودة من وضع عدم الاتصال، يجب على Activity التحقق من توفر الشبكة وتبديل واجهة المستخدم.
• استعادة الرسوم المتحركة — الرسوم المتحركة التي تم تحريرها في onStop يجب إعادة تشغيلها في onRestart قبل onStart.

ما لا يجب فعله في onRestart: لا تعِد تهيئة Views — فهي حية لأن Activity لم تُدمر. لا تعِد الاشتراك في LiveData — الاشتراك في onCreate لا يزال حياً. لا تنشئ Fragments جديدة — فهي موجودة بالفعل في FragmentManager.

onRestart وإنهاء العملية: استثناء مهم

أهم استثناء: onRestart لا يُستدعى إذا تم إنهاء عملية التطبيق بواسطة النظام. هذه نقطة رئيسية غالباً ما يغفلها المطورون عند الاعتماد على onRestart لاستعادة الحالة.

أثناء إنهاء العملية:

• كان التطبيق في الخلفية، قام Android بإنهاء العملية لتحرير الذاكرة.
• يعود المستخدم — يبدأ النظام عملية جديدة.
• يتم إعادة إنشاء Activity: onCreate(Bundle) → onStart → onResume.
• onRestart لا يُستدعى — بالنسبة للنظام، هذا مثيل جديد لـ Activity.

كيف تحمي نفسك من هذا: احفظ دائماً الحالة الحرجة في onSaveInstanceState(Bundle) (يُستدعى قبل onStop) أو استخدم SavedStateHandle في ViewModel. في onCreate، تحقق من savedInstanceState: إذا لم يكن null، استعد الحالة من Bundle؛ إذا كان null، قم بتحميل بيانات جديدة.

وفقاً لـ Google Android Vitals، حوالي 7% من العوائد إلى Activity بعد وقت طويل في الخلفية تحدث بعد إنهاء العملية. هذا يعني أن كل 15 Activity كان يجب أن تستدعي onRestart تمر في الواقع عبر onCreate. تجاهل هذا السيناريو هو أحد الأسباب الرئيسية لأخطاء «شاشة فارغة بعد العودة».

أمثلة كود مع onRestart بلغة Kotlin

مثال 1: onRestart مع تحديث القائمة عبر ViewModel

تستدعي Activity طريقة viewModel.refreshTasks() في onRestart لتحديث قائمة المهام بعد العودة من شاشة التحرير.

class TaskListActivity : AppCompatActivity() {
    private val viewModel: TaskViewModel by viewModels()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_task_list)
        viewModel.tasks.observe(this) { tasks ->
            Log.d("TaskList", "تم استلام ${tasks.size} مهمة")
        }
    }

    override fun onRestart() {
        super.onRestart()
        Log.d("TaskList", "onRestart: تحديث قائمة المهام")
        viewModel.refreshTasks()
    }
}

class TaskViewModel : ViewModel() {
    private val _tasks = MutableLiveData<List<Task>>()
    val tasks: LiveData<List<Task>> get() = _tasks

    fun refreshTasks() {
        viewModelScope.launch {
            _tasks.value = TaskRepository().getAllTasks()
        }
    }
}

ViewModel.refreshTasks() تحمل البيانات الحالية من المستودع. LiveData تُعلم Activity تلقائياً بتغيرات البيانات — يتم تحديث واجهة المستخدم بدون كود إضافي. onRestart لا تنشئ اشتراكاً جديداً — تم إنشاؤه بالفعل في onCreate.

مثال 2: onRestart مع التحقق من التفويض

تتحقق Activity من صحة الرمز عند العودة وتُعيد التوجيه إلى تسجيل الدخول إذا لزم الأمر.

class ProfileActivity : AppCompatActivity() {
    private val authManager = AuthManager()
    private val launcher = registerForActivityResult(
        ActivityResultContracts.StartActivityForResult()
    ) { Log.d("Profile", "عُدنا من شاشة تسجيل الدخول") }

    override fun onRestart() {
        super.onRestart()
        if (!authManager.isTokenValid()) {
            Log.d("Profile", "انتهت صلاحية الرمز — إعادة التوجيه إلى تسجيل الدخول")
            launcher.launch(Intent(this, LoginActivity::class.java))
        }
    }
}

class AuthManager {
    fun isTokenValid(): Boolean {
        val expiry = SharedPreferencesManager().getTokenExpiry()
        return System.currentTimeMillis() < expiry
    }
}

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

مثال 3: onRestart في Fragment مع ViewLifecycleOwner

يستخدم Fragment onRestart عبر LifecycleObserver لتحديث البيانات.

class FeedFragment : Fragment() {
    private val viewModel: FeedViewModel by viewModels()

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        viewLifecycleOwner.lifecycle.addObserver(object : LifecycleObserver {
            @OnLifecycleEvent(Lifecycle.Event.ON_RESTART)
            fun onRestart() {
                Log.d("FeedFragment", "onRestart عبر LifecycleObserver")
                viewModel.refreshFeed()
            }
        })
    }
}

بدلاً من تجاوز onRestart في Fragment، يُستخدم LifecycleObserver — نهج أكثر مرونة يسمح بإضافة منطق أحداث دورة الحياة دون وراثة. يضمن ViewLifecycleOwner أن observer يعيش ضمن نطاق View (لا يتجاوز onDestroyView).