ButterKnife是什么搏熄？有什么用耸成？
ButterKnife是一個(gè)注解框架的偷懶插件乒裆。
使用它我們可以減少findViewById()和setonclicktListener()等大量重復(fù)性代碼工作趾唱。
官網(wǎng)地址是：http://jakewharton.github.io/butterknife/
ButterKnife會(huì)消耗性能嗎兜辞？
ButterKnife其對(duì)性能的影響微乎其微(查看過(guò)Butter Knife的源碼，其自定義注解的實(shí)現(xiàn)都是限定為RetentionPolicy.CLASS间螟，也就是到編譯出.class文件為止有效吴旋，在運(yùn)行時(shí)不額外消耗性能，其是通過(guò)java注解自動(dòng)生成java代碼的形式來(lái)完成工作)厢破，其也有一個(gè)明顯的缺點(diǎn)荣瑟，那就是代碼的可讀性差一些。
如何使用ButterKnife摩泪？
1.導(dǎo)入依賴項(xiàng)
dependencies {
compile fileTree(include: ['*.jar'], dir: 'libs')
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support:appcompat-v7:25.1.0'
testCompile 'junit:junit:4.12'
compile 'com.jakewharton:butterknife:8.5.1'//添加這里
annotationProcessor 'com.jakewharton:butterknife-compiler:8.5.1'//添加這里
}
dependencies {
classpath 'com.jakewharton:butterknife-gradle-plugin:8.5.1'//添加這里
}
2.綁定單個(gè)控件
class ExampleActivity extends Activity {
@BindView(R.id.title) TextView title;
@BindView(R.id.subtitle) TextView subtitle;
@BindView(R.id.footer) TextView footer;
@Override public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.simple_activity);
ButterKnife.bind(this);
}
}
3.綁定多個(gè)控件
@BindViews({ R.id.first_name, R.id.middle_name, R.id.last_name })
List<EditText> nameViews;
4.資源綁定：
通過(guò)預(yù)定義的注解（@BindBool, @BindColor, @BindDimen, @BindDrawable, @BindInt, @BindString）結(jié)合一個(gè)資源 ID以和表示該資源類型的相應(yīng)的字段笆焰。
class ExampleActivity extends Activity {
@BindString(R.string.title) String title;
@BindDrawable(R.drawable.graphic) Drawable graphic;
@BindColor(R.color.red) int red;
@BindDimen(R.dimen.spacer) Float spacer;
// ...
}
5.Fragment中的綁定：
public class FancyFragment extends Fragment {
@BindView(R.id.button1) Button button1;
@BindView(R.id.button2) Button button2;
@Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fancy_fragment, container, false);
ButterKnife.bind(this, view);
return view;
}
}
6.List適配器中的用法：
public class MyAdapter extends BaseAdapter {
@Override public View getView(int position, View view, ViewGroup parent) {
ViewHolder holder;
if (view != null) {
holder = (ViewHolder) view.getTag();
} else {
view = inflater.inflate(R.layout.whatever, parent, false);
holder = new ViewHolder(view);
view.setTag(holder);
}
holder.name.setText("測(cè)試");
return view;
}
static class ViewHolder {
@BindView(R.id.title) TextView name;
@BindView(R.id.job_title) TextView jobTitle;
public ViewHolder(View view) {
ButterKnife.bind(this, view);
}
}
}
7.apply的用法：
ButterKnife.apply(nameViews, DISABLE);
ButterKnife.apply(nameViews, ENABLED, false);
8.Action 和 Setter 接口可以指定簡(jiǎn)單的行為：
static final ButterKnife.Action<View> DISABLE = new ButterKnife.Action<View>() {
@Override public void apply(View view, int index) {
view.setEnabled(false);
}
};
static final ButterKnife.Setter<View, Boolean> ENABLED = new ButterKnife.Setter<View, Boolean>() {
@Override public void set(View view, Boolean value, int index) {
view.setEnabled(value);
}
};
9.單個(gè)監(jiān)聽(tīng)器綁定：
@OnClick(R.id.submit)
public void submit(View view) {
}
@OnClick(R.id.submit)
public void submit() {
}
//定義的指定類型將會(huì)被自動(dòng)轉(zhuǎn)換
@OnClick(R.id.submit)
public void sayHi(Button button) {
button.setText("Hello!");
}
10.多個(gè)監(jiān)聽(tīng)器綁定：
@OnClick({ R.id.door1, R.id.door2, R.id.door3 })
public void pickDoor(DoorView door) {
if (door.hasPrizeBehind()) {
Toast.makeText(this, "You win!", LENGTH_SHORT).show();
} else {
Toast.makeText(this, "Try again", LENGTH_SHORT).show();
}
}
11.重置綁定：
Fragment的生命周期與Activity不同，當(dāng)我們?cè)趏nCreateView綁定Fragment见坑，在onDestroyView將View 設(shè)置為null時(shí)嚷掠，Butter Knife 的 unbind()方法可以幫我們做這些。
public class FancyFragment extends Fragment {
Unbinder mUnbinder ;
@Bind(R.id.button1) Button button1;
@Bind(R.id.button2) Button button2;
@Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fancy_fragment, container, false);
mUnbinder = ButterKnife.bind(this, view);
return view;
}
@Override public void onDestroyView() {
super.onDestroyView();
mUnbinder .unbind();
}
}
12.可選綁定：
默認(rèn)情況下荞驴，”@Bind”和”@OnClick”(或者其他監(jiān)聽(tīng))監(jiān)聽(tīng)綁定都是必需的不皆。如果不能找到目標(biāo)視圖，則會(huì)引發(fā)異常熊楼。
為了制止這種行為霹娄，創(chuàng)建一個(gè)可選的結(jié)合，添加一個(gè)‘@Nullable’注解字段或方法鲫骗。
任何名字為@Nullable的注解可以被這樣使用犬耻。鼓勵(lì)你使用Android自己的注解庫(kù)”support-annotations”中的@Nullable注解，參見(jiàn)Android Tools Project.
@Nullable @Bind(R.id.might_not_be_there) TextView mightNotBeThere;
@Nullable @OnClick(R.id.maybe_missing) void onMaybeMissingClicked() {
}
13.多元監(jiān)聽(tīng)：
與方法注解相匹配的監(jiān)聽(tīng)器有多個(gè)回調(diào)可以被用來(lái)綁定在他們中間的任何一個(gè)身上挎峦。每一個(gè)注解都有默認(rèn)的回調(diào)跟它綁定在一起香追。可以使用callback參數(shù)聲明一個(gè)可替代的回調(diào)坦胶。
@OnItemSelected(R.id.list_view)
void onItemSelected(int position) {
}
@OnItemSelected(value = R.id.maybe_missing, callback = NOTHING_SELECTED)
void onNothingSelected() {
}
代碼混淆
在代碼混淆的時(shí)候可能出問(wèn)題透典，這時(shí)候需要在當(dāng)前model下的proguard-rules.pro文件做如下修改：
-keep class butterknife.** { *; }
-dontwarn butterknife.internal.**
-keep class **$$ViewBinder { *; }
-keepclasseswithmembernames class * {
@butterknife.* <fields>;
}
-keepclasseswithmembernames class * {
@butterknife.* <methods>;
}
Zelezny插件的使用
在AndroidStudio->File->Settings->Plugins->搜索Zelezny下載添加就行 ，可以快速生成對(duì)應(yīng)組件的實(shí)例對(duì)象顿苇，不用手動(dòng)寫(xiě)峭咒。使用時(shí)，在要導(dǎo)入注解的Activity 或 Fragment 或 ViewHolder的layout資源代碼上纪岁，右鍵——>Generate——Generate ButterKnife Injections凑队，然后就出現(xiàn)如圖的選擇框。（此動(dòng)態(tài)圖來(lái)自官網(wǎng)）
