کنترل تغییرات پیکربندی

برخی از پیکربندی‌های دستگاه می‌توانند در حین اجرای برنامه تغییر کنند. این موارد شامل، اما محدود به موارد زیر نیست:

• اندازه نمایش برنامه
• جهت صفحه نمایش
• اندازه و وزن فونت
• محلی
• حالت تاریک در مقابل حالت روشن
• در دسترس بودن صفحه کلید

بیشتر این تغییرات پیکربندی به دلیل برخی تعاملات کاربر رخ می دهد. برای مثال، چرخاندن یا تا کردن دستگاه، میزان فضای صفحه نمایش در دسترس برنامه شما را تغییر می‌دهد. به همین ترتیب، تغییر تنظیمات دستگاه مانند اندازه فونت، زبان یا موضوع ترجیحی، مقادیر مربوطه خود را در شی Configuration تغییر می دهد.

توجه: اتصال یا جدا کردن دستگاه‌های جانبی خارجی و انجام چند کار بیشتر در دستگاه‌های صفحه‌نمایش بزرگ مانند تبلت‌ها، دستگاه‌های تاشو یا سیستم‌عامل Chrome رایج است. تغییرات پیکربندی ممکن است بیشتر در آن دستگاه ها به دلیل انعطاف پذیری آنها رخ دهد.

این پارامترها معمولاً به تغییرات کافی در رابط کاربری برنامه شما نیاز دارند که پلتفرم اندروید مکانیزمی برای زمان تغییر آنها دارد. این مکانیسم Activity تفریحی است.

فعالیت تفریحی

هنگامی که تغییر پیکربندی رخ می دهد، سیستم یک Activity دوباره ایجاد می کند. برای انجام این کار، سیستم onDestroy() را فراخوانی می کند و نمونه Activity موجود را از بین می برد. سپس با استفاده از onCreate() یک نمونه جدید ایجاد می کند و این نمونه Activity جدید با پیکربندی جدید و به روز شده مقداردهی اولیه می شود. این همچنین به این معنی است که سیستم همچنین UI را با پیکربندی جدید بازسازی می کند.

رفتار تفریحی به برنامه شما کمک می کند تا با بارگیری مجدد خودکار برنامه شما با منابع جایگزینی که با پیکربندی دستگاه جدید مطابقت دارند، با پیکربندی های جدید سازگار شود.

نمونه تفریحی

TextView را در نظر بگیرید که عنوان ثابتی را با استفاده از android:text="@string/title" نمایش می دهد، همانطور که در یک فایل XML طرح بندی تعریف شده است. هنگامی که نما ایجاد می شود، متن را دقیقاً یک بار بر اساس زبان فعلی تنظیم می کند. اگر زبان تغییر کند، سیستم فعالیت را دوباره ایجاد می کند. در نتیجه، سیستم همچنین نمای را دوباره ایجاد می کند و آن را بر اساس زبان جدید به مقدار صحیح اولیه می دهد.

این بازی همچنین هر حالتی را که به عنوان فیلد در Activity یا هر یک از Fragment ، View یا سایر اشیاء موجود در آن نگهداری می شود، پاک می کند. این به این دلیل است که Activity recreation یک نمونه کاملاً جدید از Activity و UI ایجاد می کند. علاوه بر این، Activity قدیمی دیگر قابل مشاهده یا معتبر نیست، بنابراین هرگونه ارجاع باقیمانده به آن یا اشیاء موجود در آن قدیمی است. آنها می توانند باگ، نشت حافظه و خرابی ایجاد کنند.

توجه: بازآفرینی Activity به دلیل تغییرات پیکربندی تنها یکی از مواردی است که ممکن است سیستم یک Activity تخریب کرده و بعداً آن را دوباره ایجاد کند. برای اطلاعات بیشتر، درباره چرخه حیات Activity بخوانید.

انتظارات کاربر

کاربر یک برنامه انتظار دارد وضعیت حفظ شود. اگر کاربری فرمی را پر می کند و برنامه دیگری را در حالت چند پنجره ای برای اطلاعات مرجع باز می کند، اگر به یک فرم پاک شده یا به طور کامل به جای دیگری در برنامه بازگردد، تجربه کاربری بدی است. به‌عنوان یک توسعه‌دهنده، باید تجربه کاربری ثابتی را از طریق تغییرات پیکربندی و فعالیت‌های تفریحی ارائه دهید.

برای بررسی اینکه آیا حالت در برنامه شما حفظ شده است یا خیر، می‌توانید اقداماتی را انجام دهید که باعث تغییرات پیکربندی می‌شوند، هم زمانی که برنامه در پیش‌زمینه و هم در پس‌زمینه است. این اقدامات عبارتند از:

• چرخاندن دستگاه
• ورود به حالت چند پنجره ای
• تغییر اندازه برنامه در حالت چند پنجره ای یا یک پنجره آزاد
• تا کردن یک دستگاه تاشو با نمایشگرهای متعدد
• تغییر تم سیستم، مانند حالت تاریک در مقابل حالت روشن
• تغییر اندازه فونت
• تغییر زبان سیستم یا برنامه
• اتصال یا جدا کردن صفحه کلید سخت افزاری
• اتصال یا جدا کردن یک داک

توجه: از لحاظ تاریخی، می‌توانید با محدود کردن نسبت‌ها و جهت‌گیری‌های پشتیبانی شده یا غیرفعال کردن تغییر اندازه، از برخی از این تغییرات پیکربندی جلوگیری کنید. در Android 12L (سطح API 32) و بالاتر، برنامه‌ای که این محدودیت‌ها را اضافه کرده است، اگر مستقیماً از وضعیت فعلی دستگاه پشتیبانی نکند، وارد حالت سازگاری می‌شود. اگر برنامه‌ای این محدودیت‌ها را برای جلوگیری از Activity تفریحی اضافه کرده است، مطمئن شوید که برنامه به درستی کار می‌کند و هنگام باز کردن قفل آن محدودیت‌ها حالت خود را از دست نمی‌دهد تا از صفحه نمایش در همه دستگاه‌ها استفاده کامل کند.

سه رویکرد اصلی وجود دارد که می‌توانید برای حفظ وضعیت مرتبط از طریق «تفریح Activity استفاده کنید. اینکه کدام مورد استفاده شود بستگی به نوع حالتی دارد که می خواهید حفظ کنید:

• پایداری محلی برای رسیدگی به مرگ فرآیند برای داده های پیچیده یا بزرگ. ذخیره سازی محلی دائمی شامل پایگاه داده یا DataStore است.
• اشیاء حفظ شده مانند نمونه‌های ViewModel برای کنترل وضعیت مرتبط با رابط کاربری در حافظه زمانی که کاربر فعالانه از برنامه استفاده می‌کند.
• حالت نمونه ذخیره شده برای مدیریت مرگ فرآیند آغاز شده توسط سیستم و حفظ حالت گذرا که به ورودی یا ناوبری کاربر بستگی دارد.

برای مطالعه جزئیات در مورد APIهای هر یک از اینها، و زمانی که استفاده از هر کدام مناسب است، به Save states UI مراجعه کنید.

فعالیت تفریحی را محدود کنید

برای تغییرات پیکربندی خاص می‌توانید از انجام فعالیت‌های خودکار جلوگیری کنید. بازآفرینی Activity منجر به بازسازی کل UI و هر شیء مشتق شده از Activity می شود. ممکن است دلایل خوبی برای اجتناب از این کار داشته باشید. به عنوان مثال، برنامه شما ممکن است نیازی به به روز رسانی منابع در طول یک تغییر پیکربندی خاص نداشته باشد، یا ممکن است محدودیت عملکرد داشته باشید. در آن صورت، می‌توانید اعلام کنید که فعالیت شما خود تغییر پیکربندی را انجام می‌دهد و از راه‌اندازی مجدد فعالیت‌تان توسط سیستم جلوگیری می‌کند.

برای غیرفعال کردن بازآفرینی فعالیت برای تغییرات پیکربندی خاص، نوع پیکربندی را به android:configChanges در ورودی <activity> در فایل AndroidManifest.xml خود اضافه کنید. مقادیر احتمالی در مستندات ویژگی android:configChanges ظاهر می شود.

وقتی جهت صفحه و در دسترس بودن صفحه کلید تغییر می کند، کد مانیفست زیر، بازآفرینی Activity برای MyActivity غیرفعال می کند:

<activity
    android:name=".MyActivity"
    android:configChanges="orientation|screenSize|screenLayout|keyboardHidden"
    android:label="@string/app_name">

برخی از تغییرات پیکربندی همیشه باعث شروع مجدد فعالیت می شود. شما نمی توانید آنها را غیرفعال کنید. به عنوان مثال، نمی‌توانید تغییر رنگ‌های پویا معرفی شده در اندروید 12L (سطح API 32) را غیرفعال کنید.

اخطار: حتی زمانی که برای یک تغییر پیکربندی مشخص، بازآفرینی فعالیت را غیرفعال می‌کنید، خود تغییر همچنان رخ می‌دهد. غیرفعال کردن Activity تفریحی مسئولیت مدیریت آن تغییر پیکربندی را به Activity منتقل می کند. اگر «تفریح Activity غیرفعال کنید، برنامه‌تان باید به‌طور مناسب تغییرات را در صورت وقوع، مدیریت کند.

به تغییرات پیکربندی در سیستم View واکنش نشان دهید

در سیستم View ، هنگامی که تغییری در پیکربندی رخ می دهد که برای آن Recreation Activity غیرفعال کرده اید، فعالیت با Activity.onConfigurationChanged() تماس می گیرد. هر نماهای پیوست شده نیز با View.onConfigurationChanged() تماس می گیرند. برای تغییرات پیکربندی که به android:configChanges اضافه نکرده‌اید، سیستم طبق معمول فعالیت را دوباره ایجاد می‌کند.

هشدار: در سیستم View ، غیرفعال کردن Activity recreation می‌تواند استفاده از منابع جایگزین را بسیار دشوارتر کند. این به این دلیل است که سیستم دیگر آنها را برای شما اعمال نمی کند. در برنامه‌هایی که با سیستم View ساخته شده‌اند، تنها زمانی که به دلیل تغییر پیکربندی باید از راه‌اندازی مجدد اجتناب کنید، Activity بازآفرینی را به عنوان آخرین راه‌حل غیرفعال کنید. برای اکثر برنامه ها توصیه نمی شود.

متد onConfigurationChanged() یک شی Configuration دریافت می کند که پیکربندی دستگاه جدید را مشخص می کند. فیلدهای موجود در شی Configuration را بخوانید تا مشخص کنید پیکربندی جدید شما چیست. برای ایجاد تغییرات بعدی، منابعی را که در رابط کاربری خود استفاده می کنید به روز کنید. هنگامی که سیستم این روش را فراخوانی می کند، شی Resources فعالیت شما به روز می شود تا منابع را بر اساس پیکربندی جدید برگرداند. این به شما امکان می‌دهد بدون اینکه سیستم فعالیت شما را مجدداً راه‌اندازی کند، عناصر رابط کاربری خود را بازنشانی کنید.

به عنوان مثال، پیاده سازی onConfigurationChanged() زیر بررسی می کند که آیا یک صفحه کلید در دسترس است یا خیر:

کاتلین

override fun onConfigurationChanged(newConfig: Configuration) {
    super.onConfigurationChanged(newConfig)

    // Checks whether a keyboard is available
    if (newConfig.keyboardHidden === Configuration.KEYBOARDHIDDEN_YES) {
        Toast.makeText(this, "Keyboard available", Toast.LENGTH_SHORT).show()
    } else if (newConfig.keyboardHidden === Configuration.KEYBOARDHIDDEN_NO) {
        Toast.makeText(this, "No keyboard", Toast.LENGTH_SHORT).show()
    }
}

جاوا

@Override
public void onConfigurationChanged(Configuration newConfig) {
    super.onConfigurationChanged(newConfig);

    // Checks whether a keyboard is available
    if (newConfig.keyboardHidden == Configuration.KEYBOARDHIDDEN_YES) {
        Toast.makeText(this, "Keyboard available", Toast.LENGTH_SHORT).show();
    } else if (newConfig.keyboardHidden == Configuration.KEYBOARDHIDDEN_NO){
        Toast.makeText(this, "No keyboard", Toast.LENGTH_SHORT).show();
    }
}

اگر نیازی به به روز رسانی برنامه خود بر اساس این تغییرات پیکربندی ندارید، در عوض می توانید onConfigurationChanged() پیاده سازی نکنید. در این صورت، تمام منابعی که قبل از تغییر پیکربندی استفاده می‌شد، همچنان استفاده می‌شوند و شما فقط از راه‌اندازی مجدد فعالیت خود اجتناب می‌کنید. به عنوان مثال، یک برنامه تلویزیونی ممکن است وقتی صفحه کلید بلوتوث متصل یا جدا می شود، واکنش نشان ندهد.

حفظ حالت

هنگامی که از این تکنیک استفاده می کنید، همچنان باید در طول چرخه زندگی عادی فعالیت حالت خود را حفظ کنید. این به دلیل موارد زیر است:

• تغییرات اجتناب ناپذیر: تغییرات پیکربندی که نمی توانید از آنها جلوگیری کنید می توانند برنامه شما را مجددا راه اندازی کنند.
• مرگ فرآیند: برنامه شما باید بتواند مرگ فرآیند آغاز شده توسط سیستم را مدیریت کند. اگر کاربر برنامه شما را ترک کند و برنامه به پس‌زمینه برود، ممکن است سیستم برنامه را از بین ببرد.

مهم: هنگامی که برای تغییر پیکربندی، بازآفرینی فعالیت را غیرفعال می‌کنید، مسئول بازنشانی هر عنصری هستید که برای آن گزینه‌های جایگزین ارائه می‌دهید. به عنوان مثال، اگر بازآفرینی فعالیت را برای Activity غیرفعال کنید که دارای تصاویری است که بین افقی و عمودی تغییر می‌کنند، باید در طول onConfigurationChanged () هر منبع را به هر عنصر اختصاص دهید.

به تغییرات پیکربندی در Jetpack Compose واکنش نشان دهید

Jetpack Compose به برنامه شما امکان می‌دهد راحت‌تر به تغییرات پیکربندی واکنش نشان دهد. با این حال، اگر Recreation Activity برای همه تغییرات پیکربندی که امکان انجام این کار وجود دارد غیرفعال کنید، برنامه شما همچنان باید تغییرات پیکربندی را به درستی مدیریت کند.

شی Configuration در سلسله مراتب Compose UI با LocalConfiguration ترکیب محلی موجود است. هر زمان که تغییر می کند، توابع ترکیبی که از LocalConfiguration.current می خوانند دوباره ترکیب می شوند. برای اطلاعات در مورد نحوه عملکرد محلی های ترکیب، به داده های محدوده محلی با CompositionLocal مراجعه کنید.

مهم: همانطور که در بخش Restrict Activity recreation بحث شد، غیرفعال کردن کامل Activity recreation در یک برنامه Android غیرممکن است، بنابراین همچنان لازم است که وقتی سیستم یک Activity دوباره ایجاد می‌کند، حالت را به درستی ذخیره کنید. علاوه بر این، نماهای تعبیه‌شده در Compose با APIهای قابلیت همکاری ، مانند AndroidView ، می‌توانند انتظار داشته باشند که Activity بازآفرینی در تغییرات پیکربندی رخ دهد. همچنین، اگر یک تابع قابل ترکیب به دلیل تغییر پیکربندی مجدداً ترکیب شود، نماهای استفاده شده در داخل APIهای قابلیت همکاری مجدد نیز ترکیب می شوند.

مثال

در مثال زیر، یک composable تاریخ را با یک فرمت خاص نمایش می دهد. Composable با فراخوانی ConfigurationCompat.getLocales() با LocalConfiguration.current به تغییرات پیکربندی محلی سیستم واکنش نشان می دهد.

@Composable
fun DateText(year: Int, dayOfYear: Int) {
    val dateTimeFormatter = DateTimeFormatter.ofPattern(
        "MMM dd",
        ConfigurationCompat.getLocales(LocalConfiguration.current)[0]
    )
    Text(
        dateTimeFormatter.format(LocalDate.ofYearDay(year, dayOfYear))
    )
}

برای جلوگیری از بازآفرینی Activity در هنگام تغییر منطقه، Activity میزبان کد Compose باید از تغییرات پیکربندی منطقه انصراف دهد. برای انجام این کار، android:configChanges روی locale|layoutDirection تنظیم کنید.

هشدار: برای ترکیب مجدد توابع ترکیبی، حالت خواندن باید از نوع State باشد. این مورد در مورد محلی های ترکیب مرتبط با پیکربندی و به ویژه LocalConfiguration است. تلاش برای خواندن زبان فعلی در Compose با استفاده از Locale.getDefault() باعث نمی شود که composable دوباره ترکیب شود و به تغییرات پیکربندی واکنشی نشان نمی دهد. این به این دلیل است که از نوع State نیست. برای اطلاعات بیشتر در مورد حالت در Compose، State and Jetpack Compose را ببینید.

تغییرات پیکربندی: مفاهیم کلیدی و بهترین شیوه ها

اینها مفاهیم کلیدی هستند که باید هنگام کار بر روی تغییرات پیکربندی بدانید:

• تنظیمات: پیکربندی دستگاه نحوه نمایش رابط کاربری را برای کاربر مشخص می کند، مانند اندازه نمایش برنامه، منطقه محلی، یا موضوع سیستم.
• تغییرات پیکربندی: تنظیمات از طریق تعامل کاربر تغییر می کند. برای مثال، کاربر ممکن است تنظیمات دستگاه یا نحوه تعامل فیزیکی با دستگاه را تغییر دهد. هیچ راهی برای جلوگیری از تغییرات پیکربندی وجود ندارد.
• Activity بازآفرینی: تغییرات پیکربندی به طور پیش‌فرض منجر به بازآفرینی Activity می‌شود. این یک مکانیسم داخلی برای راه‌اندازی مجدد وضعیت برنامه برای پیکربندی جدید است.
• تخریب Activity : بازآفرینی Activity باعث می شود سیستم نمونه Activity قدیمی را از بین ببرد و نمونه جدیدی را در جای خود ایجاد کند. نمونه قدیمی اکنون منسوخ شده است. هر ارجاع باقی مانده به آن منجر به نشت حافظه، اشکالات یا خرابی می شود.
• حالت: حالت در نمونه Activity قدیمی در نمونه Activity جدید وجود ندارد، زیرا آنها دو نمونه شی متفاوت هستند. وضعیت برنامه و کاربر را همانطور که در وضعیت های ذخیره رابط کاربری توضیح داده شده است حفظ کنید.
• انصراف: انصراف از فعالیت تفریحی برای نوعی تغییر پیکربندی یک بهینه‌سازی بالقوه است. این نیاز دارد که برنامه شما در واکنش به پیکربندی جدید به درستی به روز شود.

برای ارائه یک تجربه کاربری خوب، بهترین شیوه های زیر را رعایت کنید:

• برای تغییرات مکرر پیکربندی آماده باشید: تصور نکنید که تغییرات پیکربندی نادر است یا هرگز اتفاق نمی افتد، صرف نظر از سطح API، فاکتور فرم یا جعبه ابزار UI. زمانی که کاربر تغییری در پیکربندی ایجاد می‌کند، انتظار دارد برنامه‌ها به‌روزرسانی شوند و با پیکربندی جدید به درستی کار کنند.
• حالت حفظ: حالت کاربر را هنگام انجام Activity بازآفرینی از دست ندهید. حالت را همانطور که در حالت های ذخیره رابط کاربری توضیح داده شده است حفظ کنید.
• اجتناب از انصراف به عنوان یک راه حل سریع: از Activity تفریحی به عنوان میانبر برای جلوگیری از از دست دادن حالت انصراف ندهید. انصراف از فعالیت تفریحی مستلزم آن است که به وعده مدیریت تغییر عمل کنید، و همچنان می‌توانید به دلیل بازآفرینی Activity از سایر تغییرات پیکربندی، مرگ پردازش یا بستن برنامه، وضعیت را از دست بدهید. غیرفعال کردن کامل Activity تفریحی غیرممکن است. حالت را همانطور که در حالت های ذخیره رابط کاربری توضیح داده شده است حفظ کنید.
• از تغییرات پیکربندی اجتناب نکنید: برای جلوگیری از تغییرات پیکربندی و بازآفرینی Activity محدودیت هایی در جهت گیری، نسبت ابعاد یا قابلیت تغییر اندازه ایجاد نکنید. این بر کاربرانی که می خواهند از برنامه شما به روش دلخواه خود استفاده کنند تأثیر منفی می گذارد.

کنترل تغییرات پیکربندی بر اساس اندازه

تغییرات پیکربندی مبتنی بر اندازه می‌تواند در هر زمانی اتفاق بیفتد و زمانی که برنامه شما روی دستگاهی با صفحه بزرگ اجرا می‌شود که کاربران می‌توانند به حالت چند پنجره‌ای وارد شوند، احتمال بیشتری دارد. آنها انتظار دارند اپلیکیشن شما در آن محیط به خوبی کار کند.

دو نوع کلی تغییر اندازه وجود دارد: قابل توجه و ناچیز. تغییر اندازه قابل توجه تغییر اندازه است که در آن مجموعه متفاوتی از منابع جایگزین به دلیل تفاوت در اندازه صفحه نمایش مانند عرض، ارتفاع یا کوچکترین عرض، برای پیکربندی جدید اعمال می شود. این منابع شامل منابعی است که برنامه برای خود تعریف می کند و منابع موجود در هر یک از کتابخانه های آن.

برای تغییرات پیکربندی مبتنی بر اندازه، فعالیت‌های تفریحی را محدود کنید

هنگامی که Recreation Activity برای تغییرات پیکربندی مبتنی بر اندازه غیرفعال می‌کنید، سیستم Activity دوباره ایجاد نمی‌کند. در عوض، یک تماس با Activity.onConfigurationChanged() دریافت می کند. هر نمای پیوست شده با View.onConfigurationChanged() تماس دریافت می کند.

مهم: در Android 12 (سطح API 31) و Android 12L (سطح API 32)، Activity.onConfigurationChanged() تنها زمانی فراخوانی می شود که تغییر قابل توجه باشد. این یک اشکال است که در نسخه های API آینده برطرف شده است.

زمانی که android:configChanges="screenSize|smallestScreenSize|orientation|screenLayout " در فایل مانیفست خود دارید، ایجاد Activity برای تغییرات پیکربندی مبتنی بر اندازه غیرفعال است.

برای تغییرات پیکربندی مبتنی بر اندازه، امکان بازآفرینی فعالیت را فراهم کنید

در Android نسخه 7.0 (سطح API 24) و بالاتر، Activity تفریحی فقط برای تغییرات پیکربندی مبتنی بر اندازه در صورتی انجام می‌شود که تغییر اندازه قابل توجه باشد. هنگامی که سیستم به دلیل اندازه ناکافی یک Activity ایجاد نمی کند، ممکن است سیستم به جای Activity.onConfigurationChanged() و View.onConfigurationChanged() را فراخوانی کند.

برخی از اخطارها در رابطه با تماس‌های Activity و View » در زمانی که Activity دوباره ایجاد نمی‌شود وجود دارد:

• در Android 11 (سطح API 30) تا Android 13 (سطح API 33)، Activity.onConfigurationChanged() فراخوانی نمی شود.
• یک مشکل شناخته شده وجود دارد که در آن ممکن است در برخی موارد View.onConfigurationChanged() در Android 12L (سطح API 32) و نسخه های اولیه Android 13 (سطح API 33) فراخوانی نشود. برای اطلاعات بیشتر، این شماره عمومی را ببینید. از آن زمان در نسخه های بعدی اندروید 13 و اندروید 14 به این موضوع پرداخته شده است.

برای کدهایی که وابسته به گوش دادن به تغییرات پیکربندی مبتنی بر اندازه هستند، توصیه می کنیم به جای تکیه بر Activity recreation یا Activity.onConfigurationChanged() View.onConfigurationChanged() از یک برنامه کاربردی View با یک View.onConfigurationChanged() لغو شده استفاده کنید.

توجه: اگر android:configChanges="" برای Activity موجود در فایل مانیفست دارید، بازآفرینی Activity غیرفعال نیست. این همچنین با تغییرات پیکربندی مبتنی بر اندازه غیرمرتبط مانند android:configChanges="uiMode" رخ می دهد.