Android Studio中ResourceBundle的配置、放置及Gradle适配问题

一、Android对ResourceBundle的支持说明 #

Android兼容Java标准库的java.util.ResourceBundle，但官方更推荐使用Android原生资源系统（strings.xml等）——它更适配Android的本地化机制、资源管理流程，还能在XML布局中直接引用。如果坚持使用ResourceBundle，需调整文件位置与Gradle配置确保资源被正确打包。

二、正确的资源文件放置位置 #

ResourceBundle从classpath加载资源，因此需将.properties文件放在Android Studio项目的src/main/resources目录下，且路径要与你的baseName完全匹配：

• 若baseName为mmo.myapplication.messages，则文件路径应为：
  • 默认语言：src/main/resources/mmo/myapplication/messages.properties
  • 英文（en_US）：src/main/resources/mmo/myapplication/messages_en_US.properties
• 注意：文件夹结构要严格对应包名（mmo/myapplication），文件名需符合baseName_语言代码_地区代码.properties的命名规则，大小写敏感。

三、Gradle配置调整（确保资源被打包） #

默认情况下，Android Studio会自动识别src/main/resources为资源目录，但迁移项目可能存在配置缺失，需在模块的build.gradle（Module级）中明确配置：

android {
    sourceSets {
        main {
            resources {
                srcDirs = ['src/main/resources']
                // 若有其他资源目录也可添加，比如src/main/resources-legacy
            }
        }
    }
}

配置后同步Gradle，确保.properties文件被打包进APK的classes.dex中（而非assets目录）。

四、官方推荐的替代方案：Android原生资源系统 #

如果想彻底适配Android生态，建议替换为官方的本地化方案：

1. 在res/values/strings.xml中定义默认语言文本：

   <resources>
       <string name="button_label">确认</string>
       <string name="column_title">名称</string>
   </resources>
   

2. 在对应语言的资源目录下创建strings.xml，比如res/values-en/strings.xml：

   <resources>
       <string name="button_label">Confirm</string>
       <string name="column_title">Name</string>
   </resources>
   

3. 在代码中通过getString(R.string.button_label)获取文本，XML布局中直接用@string/button_label引用。

这种方式无需处理ResourceBundle的classpath问题，Android系统会自动根据设备locale加载对应资源，还支持多维度适配（如屏幕尺寸、API级别）。

五、排查当前报错的关键点 #

• 检查baseName是否与文件路径完全匹配：比如报错中的mmo.myapplication.messages，需确认resources/mmo/myapplication/messages.properties存在。
• 检查文件名是否符合规则：比如英文资源应为messages_en_US.properties，而非messages_en.properties（除非只指定语言代码en）。
• 清理项目并重新构建：执行Build > Clean Project和Build > Rebuild Project，避免缓存导致的资源未更新。

内容的提问来源于stack exchange，提问作者mmo