Andorid自定义attr的各种坑

Posted 2021-01-08 163yun

本文来自网易云社区

作者：孙有军

在开发Andorid应用程序中，经常会自定义View来实现各种各样炫酷的效果，在实现这吊炸天效果的同时，我们往往会定义很多attr属性，这样就可以在XML中配置我们想要的属性值，以下就是定义属性值可能遇到的各种坑。

大家都知道怎么定义attr属性，一般如下：

<declare-styleable name="Sample">
   <attr name="custom" format="string|reference" /></declare-styleable>

先声明一个styleable名称，name名称最好见名知义，一个styleable里面可以有多个attr属性，每一个attr都含有一个name，同时需要指明所能赋值的类型，这是是依靠format来定义的。定义好之后就可以在自定义View中使用，来实现各种吊炸天的效果，使用如下： xml中使用：

<com.sample.ui.widget.Custom   android:id="@+id/custom_view"   android:layout_width="130dp"   android:layout_height="130dp"   android:layout_gravity="center_horizontal"   android:layout_marginTop="90dp"   app:text="@string/custom_desc"
   />

记得声明 xmlns:app="http://schemas.android.com/apk/res-auto", app 可以随便取名 代码中获取值：

TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.Sample);
String value = a.getString(R.styleable.Sample.custom);
a.recycle();

根据format不同，还有getDimension,getColor等方式获取值。

上面只是描述了一般定义的方式，但他不是今天的主题，今天的主题是可能遇到的各种坑：

1：项目中只包含一个attr.xml，出现 Attribute "custom" has already been defined，参考链接

<declare-styleable name="Sample">
        <attr name="custom" format="string|reference" /></declare-styleable><declare-styleable name="Sample1">
        <attr name="custom" format="string|reference" /></declare-styleable>

如上声明了两个styleable，同时包含了相同的属性custom，这时在编译时会提示Attribute "xxx" has already been defined，表示相同属性重复定义，相同styleable name不能再同一个attr.xml中重复定义，styleable name不一致attir也不能重复定义，attr format属性不影响重复定义结果。因此可以采用如下方法解决该问题：

a：重命名相同属性名，将其中一个改为不同的名字 b：提取重复定义attr，作为公共属性，方式如下：

<attr name="custom" format="string|reference" /><declare-styleable name="Sample">
    <attr name="custom" /></declare-styleable><declare-styleable name="Sample1">
    <attr name="custom" /></declare-styleable>

2： 项目中引用了多个外部项目，出现 Attribute "custom" has already been defined 不同的导入项目中，可能包含多个attr.xml，这样在定义时极有可能重复定义，他又分为如下两种情况：

a: 主项目，引用库包含同名styleable name，如： 主项目：

<declare-styleable name="Sample">
    <attr name="custom" /></declare-styleable>

引用库：

<declare-styleable name="Sample">
    <attr name="custom" /></declare-styleable>

这种情况下，编译是不会出现错误的，可以正常编译。

b: 主项目，引用库包含不同名styleable，但是有同名attr，如; 主项目：

<declare-styleable name="Sample">
    <attr name="custom" /></declare-styleable>

引用库：

<declare-styleable name="Sample1">
    <attr name="custom" /></declare-styleable>

编译时会出现 Attribute "custom" has already been defined。由此可以得出，在项目中引用各种库，模块时，各个不同的模块定义attr，要遵循以下规则， 1：全部不能重复定义，全部不能重复很难实现，不同的团队，不同的产品是极有可能重复定义，因此该方式很难实现。 2：各个不同模块，定义时加上模块前缀，这种方式重复几率就小很多，编译时再将重复的重命名就ok了。

网易云免费体验馆，0成本体验20+款云产品！

更多网易研发、产品、运营经验分享请访问网易云社区。

相关文章：
【推荐】 GDB抓虫之旅（上篇）
【推荐】 客户端SDK测试思路