يمكن أن تؤثر العديد من عمليات نظام Android في حالة الجزء. لضمان حفظ حالة المستخدم، يحفظ إطار عمل Android الأجزاء والحزمة الخلفية ويستعيدها تلقائيًا. لذلك، تحتاج إلى التأكد من حفظ أي بيانات في الجزء الخاص بك واستعادتها أيضًا.
يوضح الجدول التالي العمليات التي تؤدي إلى فقدان حالة الجزء، بالإضافة إلى ما إذا كانت الأنواع المختلفة من الحالات تستمر خلال هذه التغييرات. في ما يلي أنواع الحالات المذكورة في الجدول:
- المتغيرات: المتغيرات المحلية في الجزء.
- حالة العرض: أي بيانات مملوكة لملف شخصي واحد أو أكثر في الجزء.
- SaveState: البيانات المضمّنة في مثيل الجزء هذا والتي يجب حفظها في
onSaveInstanceState()
. - UnConfig: هي بيانات يتم سحبها من مصدر خارجي، مثل خادم أو مستودع محلي، أو البيانات التي ينشئها المستخدم والتي يتم إرسالها إلى خادم بعد إتمامها.
غالبًا ما يتم التعامل مع المتغيرات بالطريقة نفسها مثل SavedState، إلا أن الجدول التالي يميز بينهما لتوضيح تأثير العمليات المختلفة على كل منها.
العملية | المُتغيّرات | حالة المشاهدة | SaveState (حالة الحفظ) | غير تهيئة |
---|---|---|---|---|
تمت الإضافة إلى الحزمة السابقة | ✓ | ✓ | x | ✓ |
تغيير الضبط | x | ✓ | ✓ | ✓ |
وفيات أو ترفيه | x | ✓ | ✓ | ✓* |
لم تتم إضافة المستخدم إلى الحزمة التي تمت إزالتها. | x | x | x | x |
انتهى المضيف | x | x | x | x |
* يمكن الاحتفاظ بالحالة غير المضبوطة خلال مرحلة إيقاف العملية باستخدام وحدة الحالة المحفوظة لـ ViewModel.
الجدول 1: العمليات المتنوّعة التي تؤدّي إلى تدمير الأجزاء وآثارها على أنواع الحالات المختلفة
لنلقِ نظرة على مثال محدد. فكِّر في شاشة تنشئ سلسلة عشوائية، وتعرضها في TextView
، وتوفّر خيارًا لتعديل السلسلة قبل إرسالها إلى صديق:
![تطبيق منشئ نصوص عشوائي يوضّح أنواعًا مختلفة من الحالات](https://developer.android.com/static/images/guide/fragments/text-generator-app.png?authuser=7&hl=ar)
في هذا المثال، افترض أنّه بمجرد أن يضغط المستخدم على زر التعديل،
يعرض التطبيق طريقة عرض EditText
حيث يمكن للمستخدم تعديل الرسالة. إذا نقر
المستخدم على إلغاء، من المفترض أن يتم محو طريقة العرض EditText
وضبط مستوى الرؤية على View.GONE
. قد تتطلب مثل هذه الشاشة إدارة أربع أجزاء من البيانات لضمان
تجربة سلسة:
البيانات | Type | نوع الولاية | الوصف |
---|---|---|---|
seed |
Long |
غير تهيئة | يتم استخدام البذرة لتوليد عمل خيري جديد عشوائيًا. يتم إنشاؤه عند
إنشاء ViewModel . |
randomGoodDeed |
String |
SaveState + المتغيّر | يتم إنشاؤه عند إنشاء الجزء لأول مرة.
يتم حفظ randomGoodDeed لضمان أن يرى المستخدمون
العمل الصالح العشوائي نفسه حتى بعد وفاة العملية
أو إعادة تنظيمها. |
isEditing |
Boolean |
SaveState + المتغيّر | تم ضبط العلامة المنطقية على true عندما يبدأ المستخدم في التعديل.
يتم حفظ isEditing لضمان أن يظل جزء التعديل
على الشاشة مرئيًا عند إعادة إنشاء الجزء. |
النص المعدَّل | Editable |
حالة المشاهدة (مملوكة من قِبل "EditText ") |
النص المعدَّل في عرض EditText .
تحفظ طريقة عرض EditText هذا النص لضمان عدم فقدان
التغييرات التي يجريها المستخدم قيد التقدّم. |
الجدول 2: يذكر أن تطبيق إنشاء النص العشوائي يجب أن يديره.
توضّح الأقسام التالية طريقة إدارة حالة بياناتك بشكل صحيح من خلال عمليات تدميرية.
عرض الحالة
وتكون المشاهدات مسؤولة عن إدارة حالتها الخاصة. على سبيل المثال، عندما تقبل إحدى طرق العرض البيانات التي أدخلها المستخدم، تقع على عاتق العرض مسؤولية حفظ واستعادة هذا الإدخال لمعالجة تغييرات الإعدادات. تحتوي جميع طرق العرض المقدّمة في إطار عمل Android
على طريقة تنفيذ خاصة بها للسمتَين onSaveInstanceState()
وonRestoreInstanceState()
، وبالتالي لن تضطر إلى إدارة حالة العرض
ضمن الجزء الخاص بك.
على سبيل المثال، في السيناريو السابق، يتم الاحتفاظ بالسلسلة المعدّلة في EditText
. يعرف EditText
قيمة النص الذي يعرضه، بالإضافة إلى التفاصيل الأخرى، مثل بداية ونهاية أي نص محدد.
تحتاج طريقة العرض إلى معرّف للاحتفاظ بحالتها. ويجب أن يكون رقم التعريف هذا فريدًا في الجزء والعرض الهرمي لطريقة العرض. لا يمكن للفيديوهات التي لا تتضمّن معرّفًا الاحتفاظ بحالتها.
<EditText android:id="@+id/good_deed_edit_text" android:layout_width="match_parent" android:layout_height="wrap_content" />
كما هو مذكور في الجدول 1، تحفظ طرق العرض ViewState
وتستعيدها من خلال جميع العمليات التي لا تزيل الجزء أو تدمر المضيف.
SavedState
يكون الجزء مسؤولًا عن إدارة كميات صغيرة من الحالة الديناميكية
التي تُعد جزءًا لا يتجزأ من طريقة عمل الجزء. يمكنك الاحتفاظ
بالبيانات المتسلسلة بسهولة باستخدام
Fragment.onSaveInstanceState(Bundle)
.
وعلى غرار
Activity.onSaveInstanceState(Bundle)
،
يتم الاحتفاظ بالبيانات التي تدرجها في الحزمة من خلال التغييرات في الإعدادات
ومعالجة إيقاف البيانات وإعادة الترفيه، وتكون متاحة في طرق
onCreate(Bundle)
وonCreateView(LayoutInflater, ViewGroup, Bundle)
وonViewCreated(View, Bundle)
للجزء الخاص بك.
استكمالاً للمثال السابق، تشير السمة randomGoodDeed
إلى الفعل الذي
يتم عرضه للمستخدم، في حين أنّ السمة isEditing
هي علامة لتحديد ما إذا
كان الجزء يعرض علامة EditText
أو يخفيها. يجب الاحتفاظ بهذه الحالة المحفوظة
باستخدام onSaveInstanceState(Bundle)
، كما هو
موضَّح في المثال التالي:
Kotlin
override fun onSaveInstanceState(outState: Bundle) { super.onSaveInstanceState(outState) outState.putBoolean(IS_EDITING_KEY, isEditing) outState.putString(RANDOM_GOOD_DEED_KEY, randomGoodDeed) }
Java
@Override public void onSaveInstanceState(@NonNull Bundle outState) { super.onSaveInstanceState(outState); outState.putBoolean(IS_EDITING_KEY, isEditing); outState.putString(RANDOM_GOOD_DEED_KEY, randomGoodDeed); }
لاستعادة الحالة في onCreate(Bundle)
، يتم استرداد القيمة المخزَّنة من الحزمة:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) isEditing = savedInstanceState?.getBoolean(IS_EDITING_KEY, false) randomGoodDeed = savedInstanceState?.getString(RANDOM_GOOD_DEED_KEY) ?: viewModel.generateRandomGoodDeed() }
Java
@Override public void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); if (savedInstanceState != null) { isEditing = savedInstanceState.getBoolean(IS_EDITING_KEY, false); randomGoodDeed = savedInstanceState.getString(RANDOM_GOOD_DEED_KEY); } else { randomGoodDeed = viewModel.generateRandomGoodDeed(); } }
كما ورد في الجدول 1، لاحظ أنه يتم الاحتفاظ بالمتغيرات عند وضع الجزء على الحزمة الخلفية. إن معاملتها على أنها حالة محفوظة تضمن استمرارها خلال جميع العمليات المدمرة.
غير تهيئة
ويجب وضع البيانات غير المضمّنة خارج الجزء، مثلاً ViewModel
. في المثال السابق أعلاه، يتم إنشاء seed
(حالة عدم الضبط) في ViewModel
.
تعود ملكية منطق الاحتفاظ بحالته إلى ViewModel
.
Kotlin
public class RandomGoodDeedViewModel : ViewModel() { private val seed = ... // Generate the seed private fun generateRandomGoodDeed(): String { val goodDeed = ... // Generate a random good deed using the seed return goodDeed } }
Java
public class RandomGoodDeedViewModel extends ViewModel { private Long seed = ... // Generate the seed private String generateRandomGoodDeed() { String goodDeed = ... // Generate a random good deed using the seed return goodDeed; } }
تتيح الفئة ViewModel
بطبيعتها للبيانات أن تبقى البيانات على الرغم من تغييرات الإعدادات، مثل تدوير الشاشة، وتظل في الذاكرة عند وضع الجزء على الحزمة الخلفية. بعد انتهاء عملية الوفاة والتسلية،
يُعاد إنشاء ViewModel
، ويتم إنشاء seed
جديد. إنّ إضافة وحدة
SavedState
إلى "ViewModel
" تسمح لـ "ViewModel
" بالاحتفاظ بحالة بسيطة من خلال
عملية إيقاف العملية والترفيه.
مراجع إضافية
لمزيد من المعلومات حول إدارة حالة التجزئة، راجع الموارد الإضافية التالية.
الدروس التطبيقية حول الترميز
- الدرس التطبيقي حول ترميز المكوّنات الواعية لدورة الحياة