1、前言

Android Studio对模块化开发提供的一个很有用的功能就是可以在主项目下新建库项目(Module),但是在使用库项目时却有一个问题就是资源ID冲突,因为编译时SDK会自动帮我们处理这个问题,所以一般我们不会察觉到,但是在某些情况下,我们需要意识到这个问题的存在。

比如,在新建的库项目中使用如下代码:

public void onButtonClick(View view) {
    switch (view.getId()) {
        case R.id.button_1:
            break;
        case R.id.button_2;
            break;
    }
}

IDE会提示:

Resource IDs cannot be used in a switch statement in Android library modules less.

Validates using resource IDs in a switch statement in Android library module. Resource IDs are non final in the library projects since SDK tools r14, means that the library code cannot treat these IDs as constants.

再比如,我们在库项目中以如下方式使用ButterKnife,编译时就会报错。

@OnClick(R.id.button_1)
public void onButtonClick(View view) {

}

 2、分析

无论是 switch 语句还是注解,都有一个要求就是使用的值必须是常量。在主项目中, R类中的成员变量都被 static final 修饰,而在库项目中仅被 static

// 库项目中生成的R类:
public final class R {
    public static final class id {
        public static int button_1 = 0x7f0c0001;
    }
}

// 主项目中生成的R类:
public final class R {
    public static final class id {
        public static final int text_1 = 2131165184;
    }
}

为什么库项目中生成的资源ID没有被 final

Non-constant Fields in Case Labels

当多个库项目进行合并时,不同项目中的资源ID可能会重复。在ADT 14之前,无论是主项目还是库项目,资源ID统一被定义为 final 类型的静态变量。这样照成的结果就是主项目进行编译时一旦发现资源ID冲突,库项目中对应的资源文件以及引用资源文件的代码都需要重新编译。

如果代码中使用了被 static final

那么当库项目R类中的变量仅被 static

// 主项目中的Activity:
public class MainActivity extends AppCompatActivity {
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 源代码:setContentView(R.layout.activity_main);
        this.setContentView(2131296283);
    }
}
// 库项目中的Activity:
public LibActivity extends AppCompatActivity {
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        this.setContentView(R.layout.activity_lib);
    }
}

主项目R类中的资源ID被 static final 修饰,编译时直接被替换成了对应的常量。库项目R类中的资源ID仅被 static

 3、ButterKnife中的R2类

既然库项目中的资源ID不可以定义为常量,那如何在库文项目使用ButterKnife呢,作者提供了R2类供我使用。

@OnClick({R2.id.button_1, R2.id.button_2})
public void onButtonClick(View view) {
    int id = view.getId();
    if (id == R.id.button_1) {
        // ...
    } else if (id == R.id.button_2) {
        // ...
    }
}

没错在注解中使用R2类,但是在代码里还是需要使用R类,因为R类中的ID不是常量,所以只能使用 if

先来看一下ButterKnife为我们生成的R2类与R类有什么不同:

// 库项目中的R类:
public final class R {
    public static final class id {
        public static int button_1 = 0x7f0c0001;
    }
}
// 库项目中ButterKnife为我们生成的R2类:
public final class R2 {
    public static final class id {
        public static final int button_1 = 0x7f0c0001;
    }
}

ButterKnife做的工作很简单,仅仅是把R类中的变量搬到了R2类里,然后给所有的变量都加上了 final

public class LibActivity_ViewBinding implements Unbinder {

    private LibActivity target;
    private View view_button_1;
    private View view_button_2;

    @UiThread
    public LibActivity_ViewBinding(final LibActivity target, View source) {
        this.target = target;
        View view = Utils.findRequiredView(source, R.id.button_1, "method 'onButtonClick'");
        this.view_button_1 = view;
        //view.setOnClickListener....
        view = Utils.findRequiredView(source, R.id.button_2, "method 'onButtonClick'");
        this.view_button_2 = view;
        //view.setOnClickListener....
    }
}

在ButterKnife生成的代码中,使用的仍然是R类。R2起到的作用仅仅是提供一个符号名,只要让程序知道在生成代码时对应哪一个变量即可。这个方法可以说是很“tricky”了。