引
近期公司项目需要开拓阿拉伯市场,故需要在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) { }
}