اموزش کار با کتابخانه butterknife در اندروید

سلام به تمامی کاربران عزیز و اندروید دوست سایت تمشکی،امروز با یک کتابخانه جدید و کارآمد در خدمت شما هستم.خب بدون مقدمه چینی میرم سر معرفی و آموزش استفاده از این کتابخونه عزیز و خوشمزه!

کتابخانه ButterKnife

کتابخانه ButterKnife  یک کتابخانه حرفه ای،سبک و کارآمد برای ارتباط المان ها در اکتیویتی ها و فرگمنت ها در اندروید هست که باعث میشه سرعت کار شما بالاتر بره و کدهای شما تمیز تر نوشته بشند.برای مثال به جای استفاده از findViewById()  میتوانید از @BindView استفاده کنید و نیازی به انجام casting  نیست و این کار به طور اتوماتیک برای تمامی المان ها انجام می شود.

به مثال زیر توجه کنید:

 private TextView Name;
 private EditText Email;
 private Button Submit;
 
@Override
 protected void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   setContentView(R.layout.activity_main);
   
   Name = (TextView) findViewById(R.id.name_tv);
   Email = (EditText) findViewById(R.id.email_et);
   Submit = (Button) findViewById(R.id.submit_btn);
   
   Name. ...  دستور عملکرد این المان
   Email. ...  دستور عملکرد این المان
   Submit. ...  دستور عملکرد این المان
   
 }

حالا همین کد را براساس کتابخانه ButterKnife می نویسیم :

@BindView(R.id.name_tv) private TextView Name;	
 @BindView(R.id.email_et) private EditText Email;	
 @BindView(R.id.submit_btn) private Button Submit;	

@Override
 protected void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   setContentView(R.layout.activity_main);
   
   ButterKnife.bind(this); اضافه کردن کد فرخوانی کتابخانه در اکتیویتی
   
   Name. ...  دستور عملکرد این المان
   Email. ...  دستور عملکرد این المان
   Submit. ...  دستور عملکرد این المان
   
 }

حالا تصویر کنید چندین فرم دارید که هر کدام المان های زیادی داره که باید یکی یکی فراخوانی شود، این کار باعث می شود کدهای شما شلوغ شود و فضای زیادی را بگیرد.

کتابخانه ButterKnife نه تنها برای اتصال المان ها ، بلکه برای استفاده ی ساده از مقادیر strings, dimens, drawables, رویداد های کلیک و چیزهایی زیادی دیگر استفاده می شود که در این مقاله به صورت مختصر و مفید به بررسی مهمترین آنها می پردازیم

اضافه کردن  ButterKnife  به Dependency در اندروید استودیو:

برای نصب این کتابخانه تنها کافی هست کد زیر را به dependency  فایل app/build.gradle برنامه اندروید خود اضافه کنید و بر روی دکمه  Sync Now کلیک کنید

    // butter knife
    compile 'com.jakewharton:butterknife:8.8.1'
    annotationProcessor 'com.jakewharton:butterknife-compiler:8.8.1'

به همین سادگی …

خب ، در ادامه شما را به نحوه استفاده از این کتابخانه در موارد دیگر اشنا می کنم.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center_horizontal"
    android:orientation="vertical">
 
    <TextView
        android:id="@+id/name_tv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Enter your name"
        android:textAllCaps="true" />
 
    <EditText
        android:id="@+id/email_et"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
 
    <Button
        android:id="@+id/submit_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="@dimen/dimen_20"
        android:text="@string/submit" />
</LinearLayout>

در زیر نحوه ی استفاده از رویداد کلیک یا همون  OnClickListeners را به شما نشون می دم.

public class MainActivity extends AppCompatActivity {
 
	@BindView(R.id.name_tv) private TextView Name;	
	@BindView(R.id.email_et) private EditText Email;	
	//@BindView(R.id.submit_btn) private Button Submit; 
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
 
        // bind the view using butterknife
        ButterKnife.bind(this);
    }
 
    @OnClick(R.id.submit_btn)
    public void submit() {  در اینجا یه اسم دلخواهه submit
        Toast.makeText(getApplicationContext(), "You have entered: " + Email.getText().toString(),
                Toast.LENGTH_SHORT).show(); من در اینجا مقدار فیلد ایمیل را به کاربر نمایش دادم
    }
}

همونطور که در کد بالا دیدید می تونید خط ۵ را که من در بالا کامنت کردم حذف کنید و بطور مستقیم از OnClick استفاده کنید.

نحوه استفاده از کتابخانه ButterKnife  در فرگمنت اندروید:

public class MyFragment extends Fragment {
 
    Unbinder unbinder;
 
   @BindView(R.id.name_tv) private TextView Name;	
   @BindView(R.id.email_et) private EditText Email;	
   @BindView(R.id.submit_btn) private Button Submit; 
 
    public MyFragment() {
        // Required empty public constructor
    }
 
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
 
    }
 
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
                             Bundle savedInstanceState) {
        // Inflate the layout for this fragment
        View view = inflater.inflate(R.layout.fragment_my, container, false);
 
        // bind view using butter knife
        unbinder = ButterKnife.bind(this, view); اضافه کردن کد فرخوانی کتابخانه در فرگمنت
		
		Name. ...  دستور عملکرد این المان
	    Email. ...  دستور عملکرد این المان
	    Submit. ...  دستور عملکرد این المان
 
        return view;
    }
 
    @Override
    public void onDestroyView() {
        super.onDestroyView();
 
        // unbind the view to free some memory
        unbinder.unbind();
    }
}

 دلیل تعریف و استفاده از Unbinder در onDestroyView  خاتمه دادن به کار و استفاده ی کمتر از حافظه بعد از بسته شدن فرگمنت مورد نظر هست.

نحوه استفاده از کتابخانه ButterKnife در List Adapter ها

public class AdsAdapter extends RecyclerView.Adapter<AdsAdapter.MyViewHolder> {
 
    private List<Ads> ads;
 
    public class MyViewHolder extends RecyclerView.ViewHolder {
 
        @BindView(R.id.name) TextView name;
        @BindView(R.id.email) TextView email;
 
        public MyViewHolder(View view) {
            super(view);
 
            // binding view
            ButterKnife.bind(this, view); فراخوانی کتابخانه
        }
    }
 
    public AdsAdapter(List<Ads> ads) {
        this.ads = ads;
    }
 
    @Override
    public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View itemView = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.ads_list_row, parent, false);
 
        return new MyViewHolder(itemView);
    }
 
    @Override
    public void onBindViewHolder(MyViewHolder holder, int position) {
        Ads ads = ads.get(position);
        holder.name.setText(ads.getName());
        holder.mobile.setText(ads.getEmail());
    }
 
    @Override
    public int getItemCount() {
        return contacts.size();
    }
}

خب تا اینجا برای امروز کافیه ، داره کم کم زیاد میشه

این آموزش ادامه داره …. نظر یادتون نره