وبلاگ توسعه دهندگان اندروید: تنظیمات زبان در هر برنامه
انتشار: آذر 01، 1401
بروزرسانی: 03 خرداد 1404

وبلاگ توسعه دهندگان اندروید: تنظیمات زبان در هر برنامه


ارسال شده توسط Neelansh Sahai Developer Relations Engineer Android (در توییتر و لینکدین)اگر مجموعه ای از کاربران دارید که به زبان های ،یسی، هندی و اسپ،ایی کاملاً مسلط هستند و یک برنامه خبری در تلفن خود دارند و ترجیح می دهند اخبار را به زبان هندی بخوانند، چه؟ برای برنامه پیامک خود، آنها اسپ،ایی را ترجیح می دهند زیرا دوستان و خانواده ای دارند که با آنها به زبان اسپ،ایی پیامک ارسال می کنند. اما برای سهولت دسترسی، آنها همچنان ترجیح می دهند دستگاهشان به زبان ،یسی باشد. اکنون موارد استفاده زیادی وجود دارد که کاربران ممکن است بخواهند زبان برنامه آنها با زبان سیستم آنها متفاوت باشد. جالب هست!

شروع با اندروید 13، ما یکی از ویژگی های پر درخواست کاربران را قرار داده ایم، تنظیمات زبان در هر برنامه. این به کاربران امکان می دهد زبان برنامه را از تنظیمات سیستم تغییر دهند و به کاربران کنترل بهتری بر انتخاب زبان خود برای برنامه های مختلف، صرف نظر از زبان سیستم ارائه می دهد..
یک صفحه تلفن همراه که تنظیمات برگزیده زبان برنامه را در تنظیمات سیستم برای برنامه YouTube نشان می دهد

برای کاربران چند زبانه خود بسازید

این وبلاگ بر نحوه ادغام API ترجیحات زبان برای هر برنامه در برنامه شما تمرکز دارد تا به کاربران شما انعطاف پذیری برای انتخاب زبان های مختلف برای برنامه های مختلف ارائه دهد.

1. کاربران می توانند تنظیمات زبان را از تنظیمات سیستم با انتخاب زیر تغییر دهند:

تنظیمات → سیستم → زبان ها و ورودی → زبان های برنامه → [Select the desired App] → [Select the desired Language]

توجه داشته باشید: فقط آن دسته از برنامه هایی که با مشخص ، این ویژگی را انتخاب کرده اند locale_configxml فایل (در مورد این در زیر)، در تنظیمات سیستم ظاهر می شود.

یک صفحه تلفن همراه که با انتخاب تنظیمات → سیستم → زبان ها و ورودی → زبان های برنامه → یافتن تنظیمات زبان از تنظیمات سیستم را نشان می دهد. [Select the desired App] → [Select the desired Language]

2. اگر برنامه شما قبلاً یک انتخابگر زبان درون برنامه ای دارد، می تو،د API ترجیحات زبان در هر برنامه را ادغام کنید تا از پشتیب، کامل پلت فرم استفاده کنید. برای کاربران پیش از اندروید 13، تنظیمات سیستم قابل مشاهده نخواهد بود، اما توسعه دهندگان همچنان می توانند آن را ارائه دهند انتخابگر زبان درون برنامه ای.


صفحه نمایش تلفن همراه که یکپارچه سازی API ترجیحات زبان در هر برنامه را برای برنامه ای که قبلاً یک انتخابگر زبان درون برنامه دارد را نشان می دهد.

چگونه این ویژگی را در اپلیکیشن خود ادغام کنیم؟

5 مرحله وجود دارد که باید هنگام کار بر روی ویژگی ترجیحات زبان در هر برنامه دنبال شود، در اینجا فهرست شده است →


1. ایجاد کنید locale_config.xml فایل


یک فایل جدید در فهرست values/xml/ ایجاد کنید و آن را به ،وان نامگذاری کنید locale_config.xml. این فایل باید حاوی لیستی از تمام مناطقی باشد که توسط برنامه پشتیب، می شوند. ،صر لیست باید یک رشته حاوی یک بر،ب محلی باشد.

توجه داشته باشید: تگ های محلی باید از نحو BCP47 پیروی کنند که معمولاً همینطور است {زبان فرعی}–{بر،ب فرعی اسکریپت}–{بر،ب فرعی کشور}. هر چیزی غیر از آن توسط سیستم فیلتر می شود و در تنظیمات سیستم قابل مشاهده نخواهد بود.


locale_config.xml

<؟نسخه xml="1.0" رمزگذاری ="utf-8"?>
xmlns:اندروید="http://schemas.android.com/apk/res/android">
 ...


 <محلی android:name="که در"/>


 <محلی android:name="من-جی پی"/>


 <محلی android:name="zh-Hans-MO"/>


 <محلی android:name="zh-Hant-TW"/>
...

2. locale_config را در AndroidManifest.xml اضافه کنید

این را مشخص کنید locale_config.xml فایل در برنامه AndroidManifest.xml

AndroidManifest.xml

<منظور>
 ...
 <برنامه
 ...
 android:localeConfig="@xml/locale_config">


پس از مراحل 1 و 2، کاربران شما می توانند از تنظیمات سیستم در دستگاه های دارای Android نسخه 13 یا بالاتر، اولویت زبان خود را برای برنامه شما پیدا کرده و تنظیم کنند. اگر کاربران شما از دستگاه هایی استفاده می کنند که نسخه های پایین تر از Android 13 را اجرا می کنند، می تو،د انتخابگر زبان درون برنامه ای ارائه کنید. به صورت اختیاری، می تو،د برای دستگاه های دارای Android نسخه 13 یا بالاتر، همان انتخابگر زبان را نیز در برنامه خود قرار دهید. وقتی برنامه شما دارای یک انتخابگر زبان درون برنامه ای است، مهم است که تنظیمات برگزیده کاربر بین سیستم و برنامه همگام باشد. اینجاست که API های AndroidX به تصویر کشیده می شوند. برای یادگیری نحوه ایجاد انتخابگر زبان درون برنامه ای به ادامه مطلب مراجعه کنید.


از آ،ین نسخه کتابخانه AppCompat استفاده کنید

دف آ،ینAppCompatVersion = "1.6.0-rc01"

وابستگی ها {
 ...
 پیاده سازی "androidx.appcompat:appcompat:$latestAppCompatVersion"
 پیاده سازی "androidx.appcompat:appcompat-resources:$latestAppCompatVersion"
 ...
}

4. از API های AndroidX استفاده کنید

از APIهای موجود در کد خود برای تنظیم و دریافت مناطق برنامه استفاده کنید.

MainActivity.kt

val appLocale: LocaleListCompat = LocaleListCompat.forLanguageTags("،-YY")

// این را در رشته اصلی فراخو، کنید زیرا ممکن است به Activity.res،() نیاز داشته باشد.
AppCompatDelegate.setApplicationLocales(appLocale)


// برای دریافت محلی انتخاب شده و نمایش آن در برنامه خود با این تماس بگیرید
val SelectLocale = AppCompatDelegate.getApplicationLocales()[0]

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

5. فضای ذخیره سازی را به AndroidX واگذار کنید

اجازه دهید AndroidX فضای ذخیره سازی محلی را مدیریت کند تا اولویت کاربر باقی بماند.

AndroidManifest.xml

<برنامه
 ...
 <خدمات
 android:name="androidx.appcompat.app.AppLocalesMetadataHolderService"
 android:enabled="کاذب"
 android:exported="کاذب">
 <متا داده
 android:name="autoStoreLocales"
 android:value="درست است، واقعی" />
...


مراحل 3، 4، و 5 در بالا حداقل مؤلفه های مورد نیاز برای ایجاد انتخابگر زبان درون برنامه را نشان می دهند.

و با این کار، برنامه شما اکنون می تواند از تعویض محلی پشتیب، کند.

موارد دیگری که هنگام مهاجرت به API باید از آنها مراقبت کنید

پیش از این، توسعه دهندگان مجبور بودند ترجیحات کاربر را به تنهایی کنترل کنند، یا با استفاده از آن SharedPreferences، ذخیره داده ها در سرور یا منطق برنامه دیگر. با API های جدید، نیازی به رسیدگی جداگانه به این موضوع نیست. بنابراین وقتی از این APIها استفاده می کنید، AndroidX قبلاً از ،مت ذخیره سازی مراقبت می کند، اما چه اتفاقی می افتد وقتی برنامه برای اولین بار پس از اینکه کاربر دستگاه خود را به Android 13 یا بالاتر به روزرس، می کند، باز شود؟


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

// ثابت هایی را که باید در قطعه کد زیر استفاده شوند را مشخص کنید

همراه و همدم هدف - شی {

// ثابت برای فایل SharedPreference
 پایان val PREFERENCE_NAME = "share_preference"
 پایان val PREFERENCE_MODE = متن نوشته.MODE_PRIVATE

 // ثابت برای کلیدهای SharedPreference
 پایان val FIRST_TIME_MIGRATION = "first_time_migration"
 پایان val SELECTED_LANGUAGE = "selected_language"

 // ثابت برای مقادیر SharedPreference
 پایان val STATUS_DONE = "وضعیت_انجام شد"
}


// روش کاربردی برای قرار دادن یک رشته در یک SharedPreference
خصوصی سرگرم کننده putString(کلید: رشته، ارزش: رشته) {
 val ویرایشگر = getSharedPreferences(PREFERENCE_NAME، PREFERENCE_MODEویرایش ()
 editor.putString (کلید، مقدار)
 editor.apply()
}

// روش Utility برای دریافت رشته از SharedPreference
خصوصی سرگرم کننده getString(کلید: رشته): رشته? {
 val ترجیح = getSharedPreferences(PREFERENCE_NAME، PREFERENCE_MODE)
 برگشت preference.getString(کلید، خالی)
}

// بررسی کنید که آیا انتقال قبلا انجام شده است یا خیر
اگر (getString(FIRST_TIME_MIGRATION) != STATUS_DONE) {

// زبان انتخاب شده را از هر کجا که ذخیره شده است واکشی کنید. در این مورد SharedPref است

// در این مورد، فرض کنیم در کلیدی به نام SELECTED_LANGUAGE ذخیره شده است.
 getString(SELECTED_LANGUAGE)؟.اجازه دهید { آی تی →

// با استفاده از کتابخانه AndroidX که خود فضای ذخیره سازی را مدیریت می کند، این منطقه را تنظیم کنید
 val localeList = LocaleListCompat.forLanguageTags(آی تی)
 AppCompatDelegate.setApplicationLocales(localeList)

// پرچم مهاجرت را تنظیم کنید تا مطمئن شوید که این فقط یک بار اجرا می شود
 putString(FIRST_TIME_MIGRATION، STATUS_DONE)
 }
}

این ویژگی چه انعطافی را در اختیار کاربران و توسعه دهندگان قرار می دهد؟

در اینجا چند چیز وجود دارد که ممکن است برای شما کاربران مفید باشد.

  1. همه دستگاه هایی که اندروید 13 یا بالاتر دارند، یک مکان مش، برای کاربران خواهند داشت تا بتوانند زبان برنامه های خود را پیدا کنند و تغییر دهند.
  2. اگرچه تنظیمات سیستم محدود به دستگاه های دارای اندروید 13 یا بالاتر است، API های AndroidX با عقب سازگار هستند. بنابراین، در هنگام ساختن برای کاربران چند زبانه خود، هیچ نیازی به اضافه ، بررسی نسخه سیستم عامل در کد شما وجود ندارد.
  3. توسعه دهندگان نیازی ندارند که تغییرات پیکربندی را جداگانه انجام دهند یا هر بار نگران ذخیره زبان انتخابی کاربر باشند. API تغییرات پیکربندی را کنترل می کند و ترجیحات زبان را برای شما ذخیره می کند.
  4. با سایر ویژگی های اندروید مانند پشتیبان گیری و بازیابی کار می کند. اگر کاربر به دستگاه جدیدی تغییر مکان دهد و داده های پشتیبان گیری شده قبلی را بازیابی کند، برنامه شما آ،ین زبان ترجیحی کاربر را حفظ می کند، بنابراین تجربه بهتر و یکپارچه تری را برای کاربران شما فراهم می کند.

خلاصه

با آن، بیشتر ،مت های این ویژگی پوشش داده می شود. بنابراین بیایید خلاصه ای از آنچه را که در مطالعه امروز مورد بحث قرار دادیم، مرور کنیم.

  1. یک مطالعه سریع در مورد آنچه که تنظیمات زبان برای هر برنامه به کاربران چند زبانه و توسعه دهندگان برنامه ارائه می دهد.
  2. آنچه کاربران نهایی در دستگاه های خود خواهند دید.
  3. چگونه برنامه خود را به APIهای ترجیحی زبان برای هر برنامه منتقل کنید.
  4. چند نکته که باید هنگام مهاجرت به API ها رعایت شود تا تجربه کاربری بهتری را تضمین کند.
  5. در نهایت، مزایایی که کاربران نهایی و توسعه دهندگان می توانند از این ویژگی بهره ببرند.

منابع

  1. تنظیمات زبان در هر برنامه
  2. نمونه برنامه (نوشتن)
  3. نمونه برنامه ( بازدیدها )
  4. تنظیمات برگزیده زبان برای هر برنامه (ویدیو یوتیوب)


منبع: http://android-developers.googleblog.com/2022/11/per-app-language-preferences-part-1.html
نویسنده: تیم تحریریه اصفهان موبایل مارکت