Thay đổi ngôn ngữ có lập trình bằng Kotlin

Thứ Bảy, 10/04/2021

Tram Ho

Theo mặc định, Android sẽ cố gắng load resources dựa trên Ngôn ngữ hệ thống được đặt trên điện thoại của người dùng. Do đó, nếu người dùng ngôn ngữ Tamil, Kavi, với thiết bị Android của tôi được đặt thành ngôn ngữ Tamil, mở ứng dụng Android của tôi trên điện thoại, tôi sẽ thấy một ứng dụng được bản địa hóa (transalte auto) sang ngôn ngữ của mình.

Nhưng điều gì sẽ xảy ra nếu một người dùng khác muốn sử dụng ngôn ngữ Tamil cho ứng dụng Android của mình trên Android có ngôn ngữ mặc định được đặt thành tiếng Anh?

Để giải quyết vấn đề này, chúng tôi sẽ phải cập nhật theo chương trình ngôn ngữ của ứng dụng Android của mình để ghi đè ngôn ngữ mặc định được đặt trong hệ thống của người dùng. Ở đây chúng tôi sẽ yêu cầu người dùng chọn ngôn ngữ và chỉ chuyển đổi ngôn ngữ trong ứng dụng.

Hãy bắt đầu với việc tạo file resource mới cho ngôn ngữ Tamil bằng trình hướng dẫn tạo resource file của Android Studio.
Đầu tiên, nhấp chuột phải vào thư mục res và chọn “New -> Android resource file”: Nó sẽ hiển thị thông báo như tên tệp loại này là string.xml, và chọn tiêu chi của loại resource là “Locale”

Tại đây bạn sẽ chọn ngôn ngữ,

Nó sẽ tạo ra file XML cho bạn sau đó bạn có thể đặt chuỗi string mẫu như bên dưới.
Dưới đây là string.xml mặc định dành cho ngôn ngữ là Tiếng Anh:

<span class="token prolog">&lt;?xml version="1.0" encoding="utf-8"?&gt;</span>
<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>resources</span><span class="token punctuation">&gt;</span></span>
    <span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>string</span> <span class="token attr-name">name</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>title_greatings<span class="token punctuation">"</span></span><span class="token punctuation">&gt;</span></span>Hello<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>string</span><span class="token punctuation">&gt;</span></span>
    //... other strings
<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>resources</span><span class="token punctuation">&gt;</span></span>

<?xml version="1.0" encoding="utf-8"?>

<string name="title_greatings">Hello</string>

//... other strings

</resources>

Tương tự, các bạn sẽ tạo ra 1 file string.xml mới dành cho ngôn ngữ Tamil:

<span class="token prolog">&lt;?xml version="1.0" encoding="utf-8"?&gt;</span>
<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>resources</span><span class="token punctuation">&gt;</span></span>
    <span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>string</span> <span class="token attr-name">name</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>title_greatings<span class="token punctuation">"</span></span><span class="token punctuation">&gt;</span></span>வணக்கம்<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>string</span><span class="token punctuation">&gt;</span></span>
    //... other strings
<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>resources</span><span class="token punctuation">&gt;</span></span>

<?xml version="1.0" encoding="utf-8"?>

//... other strings

</resources>

Vậy là xong, chúng ta đã cấu hình ngôn ngữ với nhiều file string tùy í theo ngôn ngữ mà chúng ta muốn.

Bây giờ, hãy tạo một lớp utility class ContextUtils để chứa các function cập nhật ngôn ngữ của chúng ta. Đặt cái này trong gói utils trên ứng dụng android, như sau:

<span class="token keyword">class</span> <span class="token function">ContextUtils</span><span class="token punctuation">(</span>base<span class="token operator">:</span> Context<span class="token punctuation">)</span> <span class="token operator">:</span> <span class="token function">ContextWrapper</span><span class="token punctuation">(</span>base<span class="token punctuation">)</span> <span class="token punctuation">{</span>

    <span class="token keyword">companion</span> <span class="token keyword">object</span> <span class="token punctuation">{</span>

        <span class="token keyword">fun</span> <span class="token function">updateLocale</span><span class="token punctuation">(</span>c<span class="token operator">:</span> Context<span class="token punctuation">,</span> localeToSwitchTo<span class="token operator">:</span> Locale<span class="token punctuation">)</span><span class="token operator">:</span> ContextWrapper <span class="token punctuation">{</span>
            <span class="token keyword">var</span> context <span class="token operator">=</span> c
            <span class="token keyword">val</span> resources<span class="token operator">:</span> Resources <span class="token operator">=</span> context<span class="token punctuation">.</span>resources
            <span class="token keyword">val</span> configuration<span class="token operator">:</span> Configuration <span class="token operator">=</span> resources<span class="token punctuation">.</span>configuration
            <span class="token keyword">if</span> <span class="token punctuation">(</span>Build<span class="token punctuation">.</span>VERSION<span class="token punctuation">.</span>SDK_INT <span class="token operator">&gt;=</span> Build<span class="token punctuation">.</span>VERSION_CODES<span class="token punctuation">.</span>N<span class="token punctuation">)</span> <span class="token punctuation">{</span>
                <span class="token keyword">val</span> localeList <span class="token operator">=</span> <span class="token function">LocaleList</span><span class="token punctuation">(</span>localeToSwitchTo<span class="token punctuation">)</span>
                LocaleList<span class="token punctuation">.</span><span class="token function">setDefault</span><span class="token punctuation">(</span>localeList<span class="token punctuation">)</span>
                configuration<span class="token punctuation">.</span><span class="token function">setLocales</span><span class="token punctuation">(</span>localeList<span class="token punctuation">)</span>
            <span class="token punctuation">}</span> <span class="token keyword">else</span> <span class="token punctuation">{</span>
                configuration<span class="token punctuation">.</span>locale <span class="token operator">=</span> localeToSwitchTo
            <span class="token punctuation">}</span>
            <span class="token keyword">if</span> <span class="token punctuation">(</span>Build<span class="token punctuation">.</span>VERSION<span class="token punctuation">.</span>SDK_INT <span class="token operator">&gt;=</span> Build<span class="token punctuation">.</span>VERSION_CODES<span class="token punctuation">.</span>N_MR1<span class="token punctuation">)</span> <span class="token punctuation">{</span>
                context <span class="token operator">=</span> context<span class="token punctuation">.</span><span class="token function">createConfigurationContext</span><span class="token punctuation">(</span>configuration<span class="token punctuation">)</span>
            <span class="token punctuation">}</span> <span class="token keyword">else</span> <span class="token punctuation">{</span>
                resources<span class="token punctuation">.</span><span class="token function">updateConfiguration</span><span class="token punctuation">(</span>configuration<span class="token punctuation">,</span> resources<span class="token punctuation">.</span>displayMetrics<span class="token punctuation">)</span>
            <span class="token punctuation">}</span>
            <span class="token keyword">return</span> <span class="token function">ContextUtils</span><span class="token punctuation">(</span>context<span class="token punctuation">)</span>
        <span class="token punctuation">}</span>
    <span class="token punctuation">}</span>
<span class="token punctuation">}</span>

class ContextUtils(base: Context) : ContextWrapper(base) {

companion object {

fun updateLocale(c: Context, localeToSwitchTo: Locale): ContextWrapper {

var context = c

val resources: Resources = context.resources

val configuration: Configuration = resources.configuration

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {

val localeList = LocaleList(localeToSwitchTo)

LocaleList.setDefault(localeList)

configuration.setLocales(localeList)

} else {

configuration.locale = localeToSwitchTo

}

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) {

context = context.createConfigurationContext(configuration)

} else {

resources.updateConfiguration(configuration, resources.displayMetrics)

}

return ContextUtils(context)

}

Ở đoạn code trên,

Filed(trường) configuration.locale đã bị deprecated từ API level 24 (Nougat) trở đi. Điều này đã được các nhà phát triển Android API đưa ra để làm cho các lập trình viên chuyển sang sử dụng getters và setters thay vì truy cập trực tiếp vào các biến.
Đây là cách thiết lập ngôn ngữ được ưa thích (thay vì sử dụng trình truy cập trực tiếp hoặc setLocale (java.util.Locale)) bắt đầu từ API 24.
Trước API 24, các nhà phát triển (developer) có thể truy cập trực tiếp vào trường configuration.locale để thay đổi nó theo ý muốn.

Sau đó, chúng ta có thể sử dụng phương thức (func) này để áp dụng các thay đổi ngôn ngữ.

Tiếp theo, Tạo BaseActivity extend từ AppCompatActivity và nó phải được kế thừa bởi các activities khác.

Chúng ta sẽ sử dụng phương thức ghi đè attachBaseContext để cập nhật cấu hình ngôn ngữ thành ACTIVITY để nó sẽ phản ánh trên tất cả các activity khác được extended.

<span class="token keyword">open</span> <span class="token keyword">class</span> BaseActivity<span class="token operator">:</span> <span class="token function">AppCompatActivity</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>

   <span class="token keyword">override</span> <span class="token keyword">fun</span> <span class="token function">attachBaseContext</span><span class="token punctuation">(</span>newBase<span class="token operator">:</span> Context<span class="token punctuation">)</span> <span class="token punctuation">{</span>
<span class="token comment">// get chosen language from shread preference</span>
    <span class="token keyword">val</span> localeToSwitchTo <span class="token operator">=</span> <span class="token function">PreferenceManager</span><span class="token punctuation">(</span>newBase<span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">getAppLanguage</span><span class="token punctuation">(</span><span class="token punctuation">)</span>
    <span class="token keyword">val</span> localeUpdatedContext<span class="token operator">:</span> ContextWrapper <span class="token operator">=</span> ContextUtils<span class="token punctuation">.</span><span class="token function">updateLocale</span><span class="token punctuation">(</span>newBase<span class="token punctuation">,</span> localeToSwitchTo<span class="token punctuation">)</span>
    <span class="token keyword">super</span><span class="token punctuation">.</span><span class="token function">attachBaseContext</span><span class="token punctuation">(</span>localeUpdatedContext<span class="token punctuation">)</span>
<span class="token punctuation">}</span>

<span class="token punctuation">}</span>

open class BaseActivity: AppCompatActivity() {

override fun attachBaseContext(newBase: Context) {

// get chosen language from shread preference

val localeToSwitchTo = PreferenceManager(newBase).getAppLanguage()

val localeUpdatedContext: ContextWrapper = ContextUtils.updateLocale(newBase, localeToSwitchTo)

super.attachBaseContext(localeUpdatedContext)

}

Question: What is the use of AttachBaseContext?

Anwser: Phương thức attachBaseContext của lớp ContextWrapper đảm bảo rằng context chỉ được attached một lần. ContextThemeWrapper áp dụng theme từ Application hoặc Activity được định nghĩa ở thẻ android: theme trong tệp AndroidManifest.xml. Vì cả Application và Service không cần theme, chúng kế thừa nó trực tiếp từ ContextWrapper. Trong quá trình tạo activity, Application và Service được khởi tạo, một đối tượng ContextImpl mới được tạo mỗi lần và nó thực thi các chức năng trong Context.

Ví dụ:
LanguageChooseActivity → MainActvity

<span class="token keyword">class</span> LanguageActivity<span class="token operator">:</span> <span class="token function">AppCompatActivity</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>

    <span class="token keyword">override</span> <span class="token keyword">fun</span> <span class="token function">onCreate</span><span class="token punctuation">(</span>savedInstanceState<span class="token operator">:</span> Bundle<span class="token operator">?</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
        <span class="token keyword">super</span><span class="token punctuation">.</span><span class="token function">onCreate</span><span class="token punctuation">(</span>savedInstanceState<span class="token punctuation">)</span>
        <span class="token function">setContentView</span><span class="token punctuation">(</span>R<span class="token punctuation">.</span>layout<span class="token punctuation">.</span>activity_language<span class="token punctuation">)</span>
        tamil_bt<span class="token punctuation">.</span><span class="token function">setOnClickListener</span> <span class="token punctuation">{</span>
            <span class="token function">PreferenceManager</span><span class="token punctuation">(</span><span class="token keyword">this</span><span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">updateLanguage</span><span class="token punctuation">(</span><span class="token string">"ta"</span><span class="token punctuation">)</span>
            <span class="token function">startActivity</span><span class="token punctuation">(</span><span class="token function">Intent</span><span class="token punctuation">(</span><span class="token keyword">this</span><span class="token punctuation">,</span> MainActivity<span class="token operator">::</span><span class="token keyword">class</span><span class="token punctuation">.</span>java<span class="token punctuation">)</span><span class="token punctuation">)</span>
            <span class="token function">finish</span><span class="token punctuation">(</span><span class="token punctuation">)</span>
        <span class="token punctuation">}</span>

        english_bt<span class="token punctuation">.</span><span class="token function">setOnClickListener</span> <span class="token punctuation">{</span>
            <span class="token function">PreferenceManager</span><span class="token punctuation">(</span><span class="token keyword">this</span><span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">updateLanguage</span><span class="token punctuation">(</span><span class="token string">"en"</span><span class="token punctuation">)</span>
            <span class="token function">startActivity</span><span class="token punctuation">(</span><span class="token function">Intent</span><span class="token punctuation">(</span><span class="token keyword">this</span><span class="token punctuation">,</span> MainActivity<span class="token operator">::</span><span class="token keyword">class</span><span class="token punctuation">.</span>java<span class="token punctuation">)</span><span class="token punctuation">)</span>
            <span class="token function">finish</span><span class="token punctuation">(</span><span class="token punctuation">)</span>
        <span class="token punctuation">}</span>
    <span class="token punctuation">}</span>
<span class="token punctuation">}</span>

class LanguageActivity: AppCompatActivity() {

override fun onCreate(savedInstanceState: Bundle?) {

super.onCreate(savedInstanceState)

setContentView(R.layout.activity_language)

tamil_bt.setOnClickListener {

PreferenceManager(this).updateLanguage("ta")

startActivity(Intent(this, MainActivity::class.java))

finish()

}

english_bt.setOnClickListener {

finish()

}

Ở đây chúng ta lưu trữ bên trong SharedPreference một chuỗi chứa mã ngôn ngữ như tamil → “ta”, English → ”en”, Hindi → ”hi”, v.v.

Mã này được sử dụng để xác định Ngôn ngữ bằng Ngôn ngữ (“ngôn ngữ-mã”)

Sau khi áp dụng trong base activity thì ở bất cứ đâu các chuỗi string được sử dụng sẽ được dịch tự động.

Dưới đây là ví dụ 1 activity extend từ BaseActivity().

<span class="token keyword">class</span> MainActivity <span class="token operator">:</span> <span class="token function">BaseActivity</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>

    <span class="token keyword">override</span> <span class="token keyword">fun</span> <span class="token function">onCreate</span><span class="token punctuation">(</span>savedInstanceState<span class="token operator">:</span> Bundle<span class="token operator">?</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
        <span class="token keyword">super</span><span class="token punctuation">.</span><span class="token function">onCreate</span><span class="token punctuation">(</span>savedInstanceState<span class="token punctuation">)</span>
        <span class="token function">setContentView</span><span class="token punctuation">(</span>R<span class="token punctuation">.</span>layout<span class="token punctuation">.</span>activity_main<span class="token punctuation">)</span>
    <span class="token punctuation">}</span>

<span class="token punctuation">}</span>

class MainActivity : BaseActivity() {

}

Chỉ cần extend BaseActivity là đủ và bạn sẽ thấy điều kỳ diệu.

Thanks for reading!

TÀI LIỆU THAM KHẢO:

https://medium.com/swlh/android-app-specific-language-change-programmatically-using-kotlin-d650a5392220

Chia sẻ bài viết ngay

Nguồn bài viết : Viblo

Thay đổi ngôn ngữ có lập trình bằng Kotlin

Nhà kinh tế đạt giải Nobel Paul Krugman: Tesla sẽ không bao giờ đạt lợi nhuận được như Apple!

HOT: VinFast công bố mẫu ô tô điện mini, kỳ vọng thành “phương tiện quốc dân” mới của người Việt

Hướng dẫn sử dụng ngôn ngữ R cho người mới bắt đầu

10 plugin cần thiết của SublimeText dành cho các lập trình viên JavaScript