Android自定义attr的各种坑

ゝ一世哀愁。 2022-08-22 00:03 148阅读 0赞

在开发Android应用程序中，经常会自定义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][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，作为公共属性，方式如下：

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>

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

[http_schemas.android.com_apk_res-auto]: http://schemas.android.com/apk/res-auto