easy_localization 2.3.3加载应用目录本地化文件 首启异常热重载正常
问题根因
easy_localization 2.3.3 版本 默认的资源加载逻辑是通过Flutter的rootBundle读取打包在安装包里的Asset文件,会自动把传入的path参数拼接成Asset的相对路径去查找资源,完全不会主动读取应用私有目录(ApplicationDocumentsDirectory)下的文件。
冷启动阶段组件初始化时,因为没有替换默认加载器,库会把你传入的绝对路径 /data/user/0/com.example.app/app_flutter/localization/en-IN.json 当成Asset路径去rootBundle里查找,自然找不到对应资源,抛出Unable to load asset的错误。
热重载时组件会直接复用内存中已经缓存的本地化数据,不会重新走初始化的资源加载流程,所以功能临时恢复正常,直到下次冷启动重新触发初始化逻辑,问题复现。
修复方案
- 先在
main函数最开头完成Flutter绑定初始化,再异步获取应用目录路径,避免路径为空或读取时序错误void main() async { // 必须先执行这行,才能进行后续的异步文件操作 WidgetsFlutterBinding.ensureInitialized(); // 正确获取应用文档目录 final appDocDir = await getApplicationDocumentsDirectory(); final localizationDirPath = '${appDocDir.path}/localization'; } - 替换默认的Asset加载器为库自带的文件系统加载器,绕开
rootBundle的Asset查找逻辑
初始化EasyLocalization时传入assetLoader参数,关闭默认的Asset兜底查找:EasyLocalization localization = EasyLocalization( path: localizationDirPath, supportedLocales: [ Locale('en', 'US'), Locale('en', 'IN'), // 把实际存储的对应文件的locale加入支持列表,解决文件和支持列表错配问题 Locale('de', 'DE'), Locale('hi', 'IN') ], fallbackLocale: Locale('en', 'IN'), // 关键替换:用文件系统加载器替代默认的Asset加载器,禁止回退到Asset查找 assetLoader: const FileAssetLoader(shouldFallbackToAsset: false), child: AppRootWidget() ); runApp(localization); - 校验文件命名和路径匹配规则
确保localization目录下的文件命名完全和库的默认查找规则一致,即{语言码}-{地区码}.json,比如en-IN.json对应Locale('en', 'IN'),不要出现文件命名和locale参数不匹配的情况。 - 前置校验目标文件存在性
在初始化EasyLocalization之前,提前判断对应语言的json文件是否已经写入完成,如果不存在则先执行文件生成逻辑,避免初始化时读取不到文件触发二次错误。
内容的提问来源于stack exchange,提问作者Mohammed Javad
相关产品推荐
相关产品推荐

