1. 项目背景与核心痛点上次我们聊了应用内语言切换的基础实现主要是通过Resources和Configuration这套标准API来做的。很多朋友跟着做下来界面切换是没问题了但很快就遇到了新的麻烦那些动态生成的文本怎么办比如从网络接口拉下来的商品描述、用户昵称或者根据业务逻辑拼接的提示语它们可不会乖乖地躺在strings.xml里等你切换。这就是我们今天要啃的硬骨头动态文本的国际化。这不仅仅是把getString(R.string.xxx)换成某个getLocalizedString(key)那么简单。它涉及到整个应用架构的调整从数据层到UI层从网络请求到本地缓存都需要考虑语言这个维度。我见过不少项目静态文本切换得很溜一到动态内容就抓瞎要么是切换后内容不更新要么是各种语言资源错乱用户体验大打折扣。所以这篇内容会深入下去重点解决几个核心问题如何设计一个能感知语言变化的文本管理模块如何让网络请求的数据带上语言标签如何优雅地通知所有界面去更新那些“活”的文本我们会从设计思路到代码落地一步步拆解目标是构建一个健壮的、可维护的动态文本国际化方案。2. 动态文本国际化的架构设计静态文本的切换系统帮我们做了大部分工作。但动态文本是“野生的”我们需要自己建立一套规则来管理它们。一个好的架构设计是成功的一半这里我分享一个经过多个项目验证的、分层清晰的方案。2.1 核心思路中央化的文本仓库与观察者模式我们不能让每个Activity或Fragment自己去操心“当前是什么语言我应该显示什么文本”。这会导致逻辑分散极易出错。正确的做法是建立一个中央化的文本仓库Repository。这个仓库对外提供统一的获取文本的接口并且内部维护当前应用的语言状态。当语言发生切换时仓库自身状态更新并需要有能力通知所有依赖它的UI组件。这天然就是观察者模式Observer Pattern的应用场景。UI组件观察者订阅仓库被观察者当仓库的语言状态变化时主动通知所有订阅者“喂语言变了你们该刷新了”2.2 三层架构模型为了更好的解耦和职责分离我建议采用典型的三层模型数据层Data Layer负责文本数据的获取。这包括本地资源从strings.xml或本地数据库如果动态文本也做本地化缓存中读取。远程接口从服务器获取对应语言的动态内容。这里的关键是网络请求必须携带语言标识如Accept-Language头或lang参数。本地缓存对从网络获取的、语言相关的数据进行缓存避免重复请求并支持离线查看。缓存必须按语言进行隔离。领域层/管理层Domain/Manager Layer这是我们架构的核心——文本管理模块LocalizationManager。它的职责包括持有当前应用的语言设置例如从SharedPreferences读取。提供统一的getString(String key, Object... args)方法。这个方法内部会决定是从本地资源找还是从数据层获取。管理一组观察者通常是UI组件。当语言设置变更时更新内部状态并通知所有观察者。表现层Presentation Layer即我们的Activity,Fragment,ViewModel等。它们的职责是在创建时向LocalizationManager注册自己为观察者。在销毁时取消注册防止内存泄漏。在接到语言变更通知时重新调用数据获取逻辑并更新UI。这个模型清晰地将“数据从哪来”、“状态怎么管”、“界面怎么变”分开每层各司其职后续维护和扩展都会轻松很多。3. 实现核心LocalizationManager 详解理论说完了我们来动手实现这个核心的LocalizationManager。我会用一个相对完整的示例来展示并解释关键点。3.1 基础接口与实现首先我们定义观察者接口和可被观察的管理器接口。// 观察者接口任何需要响应语言变化的组件都应实现它 public interface LanguageChangeObserver { void onLanguageChanged(NonNull Locale newLocale); } // 文本管理器接口 public interface LocalizationManager { // 获取当前语言 Locale getCurrentLocale(); // 切换语言 void changeLanguage(NonNull Context context, NonNull Locale newLocale); // 获取文本支持格式化参数 String getString(StringRes int resId, Object... args); String getString(NonNull String key, Object... args); // 用于动态文本key // 注册/注销观察者 void registerObserver(LanguageChangeObserver observer); void unregisterObserver(LanguageChangeObserver observer); }接下来是具体的实现类。这里我们采用单例模式因为整个应用只需要一个全局的语言状态管理者。public class AppLocalizationManager implements LocalizationManager { private static volatile AppLocalizationManager sInstance; private final SetLanguageChangeObserver mObservers new CopyOnWriteArraySet(); private Locale mCurrentLocale; private final SharedPreferences mPrefs; private AppLocalizationManager(NonNull Context context) { mPrefs PreferenceManager.getDefaultSharedPreferences(context); // 初始化时从SP读取保存的语言默认为系统语言 String savedLang mPrefs.getString(app_language, ); if (!TextUtils.isEmpty(savedLang)) { mCurrentLocale Locale.forLanguageTag(savedLang); } else { mCurrentLocale getSystemLocale(context); } // 初始化时也需要更新应用级别的Configuration updateAppLocale(context, mCurrentLocale); } public static AppLocalizationManager getInstance(Context context) { if (sInstance null) { synchronized (AppLocalizationManager.class) { if (sInstance null) { sInstance new AppLocalizationManager(context.getApplicationContext()); } } } return sInstance; } Override public Locale getCurrentLocale() { return mCurrentLocale; } Override public void changeLanguage(NonNull Context context, NonNull Locale newLocale) { if (newLocale.equals(mCurrentLocale)) { return; // 语言未变化无需处理 } mCurrentLocale newLocale; // 1. 持久化存储 mPrefs.edit().putString(app_language, newLocale.toLanguageTag()).apply(); // 2. 更新应用级别Configuration updateAppLocale(context, newLocale); // 3. 通知所有观察者 notifyObservers(newLocale); } private void updateAppLocale(Context context, Locale locale) { Resources resources context.getResources(); Configuration config resources.getConfiguration(); config.setLocale(locale); // createConfigurationContext 是API 17的方法能创建新的上下文更干净 Context newContext context.createConfigurationContext(config); // 更新Application的Resources影响后续所有通过Application Context获取的资源 // 注意这不会自动更新已存在的Activity的Resources context.getApplicationContext().getResources().updateConfiguration(config, context.getApplicationContext().getResources().getDisplayMetrics()); } private void notifyObservers(Locale newLocale) { for (LanguageChangeObserver observer : mObservers) { observer.onLanguageChanged(newLocale); } } Override public String getString(StringRes int resId, Object... args) { // 这个方法需要一个Context来获取Resources通常由调用方传入或使用全局Application Context // 为了接口简洁这里假设我们持有Application Context实际使用需注意 Context appContext MyApplication.getInstance(); return appContext.getString(resId, args); } Override public String getString(NonNull String key, Object... args) { // 动态文本获取逻辑这里是一个示例 // 1. 先查内存缓存按语言隔离的缓存 // 2. 查本地数据库/文件缓存 // 3. 都没有可能返回一个默认值或触发异步网络请求需回调 // 本例中简单返回key实际项目需完善 String cachedText getCachedDynamicText(key, mCurrentLocale); if (cachedText ! null) { return String.format(cachedText, args); } // 异步请求网络这里可以先返回一个占位符或key本身 fetchDynamicTextFromNetwork(key, mCurrentLocale); return key; // 或返回一个加载中状态 } Override public void registerObserver(LanguageChangeObserver observer) { mObservers.add(observer); } Override public void unregisterObserver(LanguageChangeObserver observer) { mObservers.remove(observer); } private Locale getSystemLocale(Context context) { Configuration config context.getResources().getConfiguration(); if (Build.VERSION.SDK_INT Build.VERSION_CODES.N) { return config.getLocales().get(0); } else { return config.locale; // 旧API } } // ... 其他辅助方法如 getCachedDynamicText, fetchDynamicTextFromNetwork }注意上面的getString(int resId)方法直接使用了Application Context来获取字符串。这在大多数情况下是可行的因为我们已经用updateAppLocale更新了Application Context的Configuration。但是有些深度定制的系统或特定场景下直接更新Application的Resources可能不够彻底。更稳健的做法是让调用方传入一个Context通常是Activity的Context或者我们在LocalizationManager内部维护一个随着语言变化的Context通过createConfigurationContext创建。这里为了示例清晰做了简化实际项目中需要根据情况选择。3.2 在UI组件中的集成使用有了管理器UI组件该如何使用呢最佳实践是在BaseActivity或BaseFragment中集成注册和注销的逻辑。public abstract class BaseActivity extends AppCompatActivity implements LanguageChangeObserver { Override protected void onCreate(Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 在super.onCreate之前设置语言可以影响某些早期初始化 AppLocalizationManager.getInstance(this).applySavedLocale(this); // 注册为观察者 AppLocalizationManager.getInstance(this).registerObserver(this); } Override protected void onDestroy() { super.onDestroy(); // 注销防止内存泄漏 AppLocalizationManager.getInstance(this).unregisterObserver(this); } Override public void onLanguageChanged(NonNull Locale newLocale) { // 语言变化了这里通常需要重新创建Activity以达到彻底刷新UI的目的。 // 因为很多系统控件如ActionBar、对话框的资源是在Activity创建时加载的。 recreate(); // 简单粗暴但有效 } /** * 一个便捷方法用于获取本地化字符串避免到处写 getInstance() */ protected final String getLocalizedString(StringRes int resId, Object... args) { return AppLocalizationManager.getInstance(this).getString(resId, args); } protected final String getLocalizedString(NonNull String key, Object... args) { return AppLocalizationManager.getInstance(this).getString(key, args); } }在具体的Activity中你只需要继承BaseActivity。对于静态文本你仍然可以在布局XML里用string/xxx系统会根据我们设置的Configuration自动选取。对于动态文本则在代码中使用getLocalizedString方法。public class ProductDetailActivity extends BaseActivity { private TextView mTvProductDesc; private String mProductId; Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_product_detail); mTvProductDesc findViewById(R.id.tv_product_desc); mProductId getIntent().getStringExtra(product_id); loadProductDetail(); } private void loadProductDetail() { // 假设从网络获取商品详情 String descKey product_desc_ mProductId; // 动态文本的key // 使用我们的管理器获取文本管理器会处理缓存和网络请求 String localizedDesc getLocalizedString(descKey); mTvProductDesc.setText(localizedDesc); // 其他静态文本可以直接用R.string getSupportActionBar().setTitle(getLocalizedString(R.string.title_product_detail)); } }当用户在设置页切换语言并调用LocalizationManager.changeLanguage()后所有注册了的BaseActivity都会触发onLanguageChanged并执行recreate()。Activity重建时onCreate会再次执行loadProductDetail会再次调用此时LocalizationManager的当前语言已经是新的了因此getLocalizedString会获取到新语言的文本无论是从本地缓存还是新的网络请求UI自然就更新了。4. 网络请求与数据层的语言适配动态文本的源头往往是服务器。因此让整个网络请求体系支持语言切换至关重要。4.1 为网络请求添加语言标识这通常通过两种方式实现HTTP Header在OkHttp的Interceptor或Retrofit的OkHttpClient中统一添加Accept-Language头。这是RESTful API的推荐做法。public class LanguageInterceptor implements Interceptor { private final AppLocalizationManager mLocalizationManager; public LanguageInterceptor(Context context) { mLocalizationManager AppLocalizationManager.getInstance(context); } Override public Response intercept(Chain chain) throws IOException { Request originalRequest chain.request(); Request newRequest originalRequest.newBuilder() .header(Accept-Language, mLocalizationManager.getCurrentLocale().toLanguageTag()) .build(); return chain.proceed(newRequest); } }Query Parameter在每个需要语言参数的接口请求中显式添加lang参数。可以在Retrofit的Service接口定义中使用Query注解。public interface ApiService { GET(product/detail) CallProductDetail getProductDetail(Query(id) String productId, Query(lang) String languageTag); } // 调用时 apiService.getProductDetail(productId, localizationManager.getCurrentLocale().toLanguageTag());第一种方式更全局、更隐形第二种方式更灵活、更显式。可以根据后端接口的规范来选择或者结合使用。4.2 响应数据的缓存策略从网络获取到对应语言的动态文本比如完整的商品详情JSON后我们不能每次都去请求。需要建立缓存。缓存键设计缓存键必须包含数据标识和语言标识。例如cache_key_product_12345_zh-CN和cache_key_product_12345_en-US应该是两个独立的缓存条目。存储介质可以使用Room数据库表中包含id数据ID、lang语言标签、content内容JSON或文本等字段。也可以使用DataStore或序列化到文件但数据库更便于查询和管理。缓存更新当网络请求成功返回时更新对应语言和数据的缓存。当语言切换后UI请求数据时应首先查询缓存。如果缓存命中且未过期则直接使用否则发起网络请求。这样用户在切换语言后如果该内容之前已经以新语言加载过就能立即从缓存中读出体验流畅。如果没有缓存则显示加载状态并去网络获取。5. 复杂场景与进阶优化基本的框架搭好了但在实际项目中总会遇到一些“坑”和需要优化的点。5.1 非Activity组件的文本更新我们的观察者模式主要绑定了Activity的生命周期。但对于Dialog、PopupWindow、自定义View等它们可能独立于Activity存在或者附着在Window上。方案一依赖Activity让这些组件在显示时从所属的Activity如果Activity继承了BaseActivity获取最新的文本并设置。在Activity的onLanguageChanged中除了recreate()还需要手动更新当前正在显示的这些组件。方案二独立观察让这些组件自己也实现LanguageChangeObserver并注册到LocalizationManager。但需要非常小心生命周期管理必须在组件销毁时如Dialog.dismiss()时注销否则会导致内存泄漏和无效回调。推荐方案对于简单的弹窗建议在每次显示时show()方法里重新根据当前语言设置文本。对于复杂的、长期存在的自定义View可以采用方案二但生命周期管理必须严格。5.2 避免Activity频繁Recreate的性能与体验问题调用Activity.recreate()会重新走一遍生命周期如果页面数据复杂、网络请求多可能会造成卡顿和流量消耗。局部刷新对于某些简单的、纯展示性的动态文本我们可以在onLanguageChanged中不调用recreate()而是手动找到那些TextView调用setText(getLocalizedString(...))来更新。这要求我们对页面中所有动态文本的更新逻辑有集中控制例如在ViewModel中。ViewModel 存活利用ViewModel在Activity重建时保持存活的特性。将页面的核心数据如从网络获取的商品详情对象放在ViewModel中。当Activity因语言切换而recreate后新的Activity可以连接到同一个ViewModel直接使用其中的数据只需重新绑定到UI即可避免了重复的网络请求。但要注意ViewModel中的数据文本可能还是旧语言的需要有一个机制在语言切换后触发ViewModel重新加载数据或更新文本字段。异步加载与缓存如前所述强大的缓存可以极大减少recreate后等待网络请求的时间提升体验。5.3 语言设置持久化与同步我们使用SharedPreferences存储了用户选择的语言。但需要考虑多进程应用如某些SDK或特殊组件运行在独立进程的情况。SharedPreferences虽然支持多进程模式MODE_MULTI_PROCESS但自 API 11 起已废弃且不可靠。使用 ContentProvider可以创建一个简单的ContentProvider来提供语言设置这个“配置项”的查询和更新接口所有进程都通过这个Provider来访问保证一致性。这是比较重的方案。使用文件锁或广播主进程将语言设置写入一个文件其他进程监听文件变化或接收广播。相对麻烦。实际考量对于绝大多数应用语言设置不需要实时同步到所有进程。通常只有主UI进程关心这个设置。其他进程如推送服务进程启动时读取一次设置即可不需要实时同步。因此使用SharedPreferences对于大多数场景是足够的。如果确实需要强一致性可以考虑使用Jetpack DataStore它未来可能会提供更好的多进程支持但目前仍处于alpha/beta阶段。6. 测试与调试技巧实现完了怎么验证是否正常工作呢单元测试为LocalizationManager编写单元测试模拟语言切换验证getString方法是否返回了正确语言环境的资源。可以使用AndroidJUnitRunner和Config注解来指定测试的Locale。界面测试使用Espresso编写界面测试在测试中切换语言然后检查特定视图上的文本是否发生了变化。手动测试关键路径在应用内切换语言检查所有静态文本标题、按钮、标签是否立即改变。检查动态文本如列表项、详情页是否在切换语言后随着页面刷新或recreate而改变。测试网络请求使用抓包工具如 Charles/Fiddler查看切换语言前后发出的请求中Accept-Language头或lang参数是否正确变化。测试缓存切换到语言A加载某数据再切换到语言B再加载然后切回语言A检查是否从缓存读取而没有发起网络请求。处理系统语言变更我们的应用内切换是独立的。但用户也可能直接在系统设置里更改系统语言。为了应对这种情况可以在BaseActivity中重写onConfigurationChanged方法检测系统语言是否变化并决定是否要同步更新我们应用内的语言状态。通常为了保持应用内体验的一致性很多应用选择忽略系统语言变更除非用户明确在应用设置中选择了“跟随系统”。Override public void onConfigurationChanged(NonNull Configuration newConfig) { super.onConfigurationChanged(newConfig); Locale systemLocale newConfig.getLocales().get(0); Locale appLocale AppLocalizationManager.getInstance(this).getCurrentLocale(); // 如果应用当前语言不是“跟随系统”模式且系统语言变了可以提示用户或者不做处理 // 如果应用设置中有“跟随系统”选项且打开了那么这里应该调用 changeLanguage 同步到系统语言 if (isFollowSystemLanguage() !systemLocale.equals(appLocale)) { AppLocalizationManager.getInstance(this).changeLanguage(this, systemLocale); } }7. 总结与个人心得动态文本的国际化是把语言切换从“表面功夫”变成“深入骨髓”的关键一步。它要求我们对应用的数据流和状态管理有更清晰的规划。回顾整个实现最核心的其实就是“状态集中管理”和“变更主动通知”这两个思想。LocalizationManager就是那个集中管理语言状态的中心而观察者模式则是通知变更的桥梁。一旦这个通路建立起来剩下的就是往里面填充细节网络请求怎么带参数、数据怎么按语言缓存、不同的UI组件怎么响应这个通知。在实际项目中我最大的体会是前期设计比后期修补重要得多。最好在项目架构设计初期就把LocalizationManager作为基础组件之一纳入考虑。如果是在一个已有大量代码的项目中接入工作量会大很多需要仔细梳理所有动态文本的显示处并将其替换为通过管理器获取。另一个教训是关于Activity.recreate()。它虽然简单有效但副作用也明显。对于复杂的页面比如包含视频播放、地图、复杂动画重建成本很高。因此在架构设计上要尽量让页面状态易于保存和恢复多用ViewModel、onSaveInstanceState并辅以强大的缓存来减轻重建带来的性能负担和体验断层。最后测试一定要充分。语言切换相关的Bug往往在特定场景下才会出现比如在页面加载过程中切换语言、后台进程的语言状态不一致等需要设计覆盖各种边界条件的测试用例。 新乡本地动态 ← 返回资讯列表
