3. 在 Android 项目中开启 RTL 支持

3.1 原理讲解

Android 从 API 17 (Android 4.2) 开始原生支持 RTL 布局。当应用声明 android:supportsRtl="true" 后，系统会:

• 根据用户的语言选择（阿拉伯语、希伯来语、波斯语等）自动镜像布局方向
• 读取 layout-ldrtl 和 drawable-ldrtl 等资源限定符
• 将 start/end 属性映射到实际的 left/right 位置

minSdkVersion 要求：若目标设备 API < 17，系统会忽略 supportsRtl 标记，所有布局依然保持 LTR 方向。因此国内许多存量应用需同时保留两种布局方向的资源。

3.2 实现流程

1. 确认项目的 minSdkVersion ≥ 17（或至少准备降级方案）
2. 在 AndroidManifest.xml 的 <application> 标签中添加 android:supportsRtl="true"
3. 重新编译项目，生成 APK
4. 使用真机或模拟器切换至 RTL 语言进行验证

3.3 代码/配置示例

修改 AndroidManifest.xml（位于 app/src/main/ 目录）：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.rtlapp">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/Theme.RtlApp">

        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

同时 build.gradle (Module: app) 中的 minSdkVersion 建议设置为 17 或更高，以完全发挥 RTL 能力：

android {
    compileSdk 34

    defaultConfig {
        applicationId "com.example.rtlapp"
        minSdkVersion 17
        targetSdkVersion 34
        versionCode 1
        versionName "1.0"
    }
    ...
}

3.4 调试方法

3.5 常见错误及性能稳定性优化

• 错误：supportsRtl 未声明 → 即使 API ≥ 17，系统也不会启用 RTL 镜像，所有布局仍为 LTR。
• 错误：minSdkVersion < 17 且未设置兼容资源 → 低版本设备上 supportsRtl 被忽略，但 RTL 语言用户无法获得正确镜像。
• 性能优化：RTL 镜像会增加布局绘制开销（约 5%~10%），建议在 minSdkVersion 17 以上才启用，避免无意义渲染。
• 稳定性优化：在 Application.onCreate() 中检查当前语言方向，若为 RTL 且 supportsRtl 未生效（如系统 Bug），可手动设置 setLayoutDirection(Locale.forLanguageTag("ar")) 作为兜底。

3.6 RTL 支持配置流程图