Android RLT布局兼容注意事项

引

近期公司项目需要开拓阿拉伯市场，故需要在APP端兼容阿拉伯语。
阿拉伯语与其他多语言不同之处在于其布局是由右到左排布的，与我们常见的从左到右的布局不同。故需要修改部分代码的写法以兼容右到左布局。

开发问题及修改方法

模块	注意功能点	解决方法
字符串文件String.xml	翻译校验	注意占位符是否正常存在
货币符号	阿拉伯货币符号会使金额在前符号在后	通过代码中货币切换方法转变顺序
货币金额	在部分语种下金额小数点会变成逗号	通过代码中货币切换方法中调用DecimalFormatSymbols 指定LOCAL为US，保持小数点详见注释1
布局文件xml	paddingLeft/paddingRight	增加paddingStart/paddingEnd
	marginLeft/lmarginRight	增加marginStar/lmarginEnd
	drawableLeft/drawableRight	增加drawableStart/drawableEnd详见注释2
	TextView，EditText中RTL布局下英语无法靠右显示的问题	在Style文件中设置特定属性统一修改详见注释3
	FrameLayout中靠左子View未设置Start属性时，无法兼容RTL布局	添加android:layout_gravity=start
图标翻转	ImageView	设置rotationY为180，可通过在不同布局的xml文件中声明
	TextView中Drawable	图标素材翻转
代码中动态设置间距	setMargins	根据Left,Right参数值在下方分别添加setMarginStart和setMarginEnd
	setPadding	替换为setPaddingRelative
TextView设置Drawable	setCompoundDrawables	替换为setCompoundDrawablesRelative
RecycleView分割线	RTL布局中分割线不会相应替换	创建基类ItemDecoration，在getItemOffsets方法中根据作用布局决定是否进行left right调换详见注释4
自定义View	自定义圆角属性未随着RTL布局变换	获取对应圆角属性时，根据布局方向做相关值转换
自定义动画	setTranslationX在RTL布局无法正常转换	RTL布局中设置的参数需取反，translationX -> -translationX
ViewPager	官方不能兼容从右到左	1.引入第三方rtlViewPager 2.引入官方viewpager2
字符串拼接	阿拉伯语+英语位置错误	从左到右嵌入(U 202A) >从右到左嵌入(U 202B) >流行方向格式化(U 202C)

注释

1.在部分语种下金额小数点会变成逗号

//设置LOCAL为US，默认LOCAL为当前语言LOCAL
DecimalFormatSymbols symbols = new DecimalFormatSymbols(Locale.US);
//创建对应的格式化，取小数点后两位
DecimalFormat format = new DecimalFormat("0.##", symbols);
//将金额转换为String类型
format.format(d)

2.布局文件xml，Left变Start
XML文件的修改可通过Android Studio自带的工具进行统一修改。
步骤为菜单栏Refactor->Add RTL Support Where Possible

3.TextView，EditText中阿拉伯语环境下英语无法靠右显示的问题

<!-- 在BaseStyle中指定editTextStyle和android:textViewStyle -->
<style name="AppBaseTheme" parent="Theme.AppCompat.NoActionBar">
    <item name="editTextStyle">@style/EditTextStyle.Alignment</item>
    <item name="android:textViewStyle">@style/TextViewStyle.TextDirection</item>
</style>

<!--EditText Style-->
<style name="EditTextStyle.Alignment" parent="@android:style/Widget.EditText">
    <item name="android:textAlignment">viewStart</item>
    <item name="android:gravity">start</item>
    <item name="android:textDirection">locale</item>
</style>

<!--TextView Style-->
<style name="TextViewStyle.TextDirection" parent="android:Widget.TextView">
    <item name="android:textDirection">locale</item>
</style>

4.右到左布局中分割线不会相应替换

public abstract class BaseCustomRtlDecoration extends RecyclerView.ItemDecoration {

    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
        getCustomItemOffsets(outRect, view, parent, state);
        if (TextUtilsCompat.getLayoutDirectionFromLocale(
                view.getContext().getResources().getConfiguration().locale) == ViewCompat.LAYOUT_DIRECTION_RTL){
            //使用异或操作完成数据交换，以免创建额外变量。
            outRect.right = outRect.left ^ outRect.right;
            outRect.left = outRect.left ^ outRect.right;
            outRect.right = outRect.left ^ outRect.right;
        }
    }

    //所有子ItemDecoration实现此方法，用法与getItemOffsets一致
    public void getCustomItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) { }
}

参考文章

Android 中东阿拉伯语适配