詳解React-Native全球化多語言切換工具庫react-native-i18n
開篇啰嗦–階段感悟
最近2 -3個(gè)月基本都因?yàn)橐恍┧绞聸]怎么系統(tǒng)的工作和學(xué)習(xí),途中看了幾天Kotlin的東西寫了些demo并且整了個(gè)小項(xiàng)目,但是整體狀態(tài)不是很好,這些天看到些95后碼農(nóng)的強(qiáng)勢細(xì)思極恐。
現(xiàn)在大多數(shù)醒來就已經(jīng)是中午,起得早去一下健身房,起的晚就家里宅一天。公司有事或者有其他家事就去協(xié)調(diào)/溝通/處理下,整個(gè)人感覺都提前進(jìn)入養(yǎng)老狀態(tài)(當(dāng)然這個(gè)鍋有一半是沉迷王者榮耀不可自拔,不太好)
最近項(xiàng)目上基本沒啥事情了,然后讓手下的小伙伴們對之前做的一些內(nèi)容進(jìn)行二次封裝,然后他們引用了一個(gè)第三方國際化的庫我覺得不錯(cuò),然后看了看源碼就分享下,希望大家用得上(雖然現(xiàn)在產(chǎn)品的受眾群都是國內(nèi)的,但是準(zhǔn)備下好像沒毛病?)
廢話啰嗦完了,老規(guī)矩:https://github.com/ddwhan0123/Useful-Open-Source-Android (雖然我不怎么工作了,但是git還是每天會(huì)花時(shí)間看看)
庫屬性介紹:
項(xiàng)目地址:https://github.com/AlexanderZaytsev/react-native-i18n
屬性 | 解釋 |
---|---|
支持RN版本 | 所有版本 |
支持平臺(tái) | iOS+Android |
是否需要NativeModule | 是 |
是否可移植 | 是 |
是否含有jni模塊 | 否 |
使用:
1.install (略,git里都寫著了,就是npm那些事)
2.項(xiàng)目中使用
因?yàn)槭且恍╈o態(tài)屬性引用,所以你用redux做儲(chǔ)存替換也可以,直接做飲用也可以(本文拿en,zh為例)。
首先是建英文版本的配置文件,en/index.js
export default { home: { greeting: 'Greeting in en', tab_home: 'Home', tab_donate: 'Donate', tab_demo: 'Demo', language: 'language', live_demo: 'Live Demo', buy_me_coffee: 'Buy me a coffee', gitee: 'Gitee', star_me: 'Star me', donate: 'donate', exit: 'exit?', }, donate: { donate: 'donate us~~~', donate_desc: '© 2017 Pactera Technology International Limited. All rights reserved.', }, demo: { dialog: 'dialog', button: 'button', switch: 'switch', action_sheet: 'Action Sheet', } };
然后是中文的zh/index.js
export default { home: { greeting: 'Greeting in zh', tab_home: '首頁', tab_donate: '捐贈(zèng)', tab_demo: '例子', language: '語言', live_demo: '例子', buy_me_coffee: '請我一杯coffee', gitee: 'Gitee', star_me: '關(guān)注我', donate: '貢獻(xiàn)', exit: '是否退出?', }, donate: { donate: '支持我們~~', donate_desc: '© 2017 Pactera Technology International Limited. All rights reserved.', }, demo: { dialog: '提示框', button: '按鈕', switch: '開關(guān)', action_sheet: '', } };
屬性名,結(jié)構(gòu)是一致的只是屬性不同,當(dāng)然這里是靜態(tài)的2個(gè)文件,如果場景需要可以服務(wù)端下發(fā)json,那就是完全動(dòng)態(tài)的了,這部分看業(yè)務(wù)需求了。
2.1 默認(rèn)的語言環(huán)境
我們在上面寫了2種語言配置,那么哪種作為初始化的呢?在業(yè)務(wù)層調(diào)用前,我們可以先進(jìn)行預(yù)設(shè)
i18n/index.js
import i18n from 'react-native-i18n'; import en from './en'; import zh from './zh'; i18n.defaultLocale = 'en'; i18n.fallbacks = true; i18n.translations = { en, zh, }; export {i18n};
這邊進(jìn)行了一些預(yù)設(shè),默認(rèn)語境為en,允許fallbacks狀態(tài)(為true時(shí),順序向下遍歷翻譯),預(yù)設(shè)轉(zhuǎn)換的文件就2個(gè),一個(gè)en一個(gè)zh,這個(gè)你也可以自行后續(xù)添加根據(jù)需求而定。
2.2 業(yè)務(wù)層調(diào)用
先是倒包
import {i18n} from '你預(yù)設(shè)的index的目錄';
調(diào)用(拿一個(gè)Toast做個(gè)例子)
ToastAndroid.show(i18n.t('home.exit'),ToastAndroid.SHORT);
兩種輸出結(jié)果如下:
源碼分析
這個(gè)庫的實(shí)現(xiàn)分為2部分,一部分是Native的版本判斷等功能以及js部分的核心實(shí)現(xiàn)fnando/i18n-js
i18n-js是一個(gè)輕量級的js翻譯庫,他支持各種格式和內(nèi)容的換算和語言內(nèi)容的切換,地址如下:https://github.com/fnando/i18n-js
那么翻譯轉(zhuǎn)換這塊是 I18n.js做的那么Native做了些啥呢?我們來一探究竟(以安卓為例,蘋果看不懂,抱歉)
Native代碼就兩個(gè)類,所以我之前說你直接把Native代碼copy走然后項(xiàng)目依賴I18n.js也能達(dá)到這個(gè)效果
RNI18nPackage是一個(gè)普通的Package類,它的作用就是把我們的module加到主應(yīng)用的getPackages()方法中的列表里,然后一起打進(jìn)包里而已。
具體功能都在RNI18nModule里
public class RNI18nModule extends ReactContextBaseJavaModule { public RNI18nModule(ReactApplicationContext reactContext) { super(reactContext); } //RN調(diào)用的控件名 @Override public String getName() { return "RNI18n"; } //對取出的Locale列表進(jìn)行格式化的方法 private String toLanguageTag(Locale locale) { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { return locale.toLanguageTag(); } StringBuilder builder = new StringBuilder(); builder.append(locale.getLanguage()); if (locale.getCountry() != null) { builder.append("-"); builder.append(locale.getCountry()); } return builder.toString(); } private WritableArray getLocaleList() { WritableArray array = Arguments.createArray(); if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { //獲取區(qū)域設(shè)置列表。這是獲取區(qū)域的首選方法。 LocaleList locales = getReactApplicationContext() .getResources().getConfiguration().getLocales(); for (int i = 0; i < locales.size(); i++) { array.pushString(this.toLanguageTag(locales.get(i))); } } else { array.pushString(this.toLanguageTag(getReactApplicationContext() .getResources().getConfiguration().locale)); } return array; } //js端可獲取屬性的列表 @Override public Map<String, Object> getConstants() { HashMap<String, Object> constants = new HashMap<String,Object>(); constants.put("languages", this.getLocaleList()); return constants; } //提供給js端調(diào)用的方法,用來獲取默認(rèn)的語言環(huán)境,回調(diào)方式用的是promise @ReactMethod public void getLanguages(Promise promise) { try { promise.resolve(this.getLocaleList()); } catch (Exception e) { promise.reject(e); } } }
加一個(gè)toast看下locale會(huì)出現(xiàn)什么
Toast.makeText(getReactApplicationContext(),"locales.get(i) "+locales.get(i),Toast.LENGTH_LONG).show();
效果如下:
本想一探究竟內(nèi)部的實(shí)現(xiàn),結(jié)果是個(gè)不公開的類
總結(jié):
首先Native那里獲取本手機(jī)的LocaleList然后格式化取第一個(gè)元素交由I18n.js處理,然后I18n.js根據(jù)key選用一套有效的語言規(guī)則,再之后流程就和使用時(shí)候的順序一樣了。
整個(gè)庫集成難度較低,使用起來比較簡便,使用下來沒碰到大坑,配合redux更美味。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
React報(bào)錯(cuò)Function?components?cannot?have?string?refs
這篇文章主要為大家介紹了React報(bào)錯(cuò)Function?components?cannot?have?string?refs解決方案詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-12-12使用webpack5從0到1搭建一個(gè)react項(xiàng)目的實(shí)現(xiàn)步驟
這篇文章主要介紹了使用webpack5從0到1搭建一個(gè)react項(xiàng)目的實(shí)現(xiàn)步驟,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-12-12React Native Popup實(shí)現(xiàn)示例
本文主要介紹了React Native Popup實(shí)現(xiàn)示例,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2022-05-05react-native-tab-navigator組件的基本使用示例代碼
本篇文章主要介紹了react-native-tab-navigator組件的基本使用示例代碼,具有一定的參考價(jià)值,有興趣的可以了解一下2017-09-09