لوگو عباس اویسی

متولد تهران، توسعه دهنده‌ی اندروید، پیگیر فوتبال. ارشد نرم افزار و علاقمند به جنبه‌های مختلف توسعه‌ی نرم افزار

  • عمومی
  • اندروید
  • جنریتور حلما
  • فریم‌ورک dagger
  • وب‌سرویس آموزشی فیلم‌ها

منتشر شدن نسخه‌ی ۰٫۱٫۰ جنریتور حلما

شهریور ۲۱, ۱۳۹۶

اگر پروژه‌هاتون رو براساس الگوی معماری MVP درست میکنید، احتمالا از ساخت فایل‌های اضافه برای هر اکتیویتی یا فرگمنت خسته شدید. اینجاس جنریتور میتونه کلی از کارتون کم کنه! و این وظیفه رو به عهده بگیره. خودم از وقتی که نسخه‌ی خیلی اولیه جنریتور رو منتشر کردم، ازش استفاده میکنم. مزیت جنریتور در ساخت فایل‌های مرتبط با MVP و … نسبت به روش‌های دیگه اینه هم سریع‌تر هست و هم اینکه مثل روش کپی پیست باگ تولید نمیکنه (مثلا پیش نمیاد یادتون بره یه فیلد رو rename کنید).

توی این مدت یه سری مشکلات داخلش پیدا کردم. بین پروژه‌ها دو روزی فرصت شد تا برای بهبود و توسعه‌اش وقت بذارم. البته مهمترین مشکل نسخه‌ی قبل نداشتن راهنما برای استفاده بود. در ادامه تغییرات جدید و نحوه‌ی استفاده از جنریتور رو براتون توضیح میدم.

تغییرات جدید در نسخه‌ی ۰٫۱٫۰

  1. اضافه‌ کردن آپشن nav-custom به ساب جنریتور activity
  2. اضافه کردن ساب جنریتور جدید به اسم fragment برای ساختن فرگمنت‌ها
  3. تغییر مکان unsubscribe شدن observableها از onPuase به onStop
  4. اضافه کردن کتابخونه calligraphy برای استفاده از فونت‌ها و استفاده از Timber برای لاگ کردن
  5. اضافه کردن مثال اینکه چطور میشه خطاهایی که از سمت سرور میاد و شامل json هست رو با rxjava هندل کرد. (داخل فایل MyApiServiceImpl.java)
  6. بهبود بخش‌های مختلف جنریتور و رفع تعدادی باگ

 

راهنمای استفاده از جنریتور حلما

برای کار با جنریتور حلما اول باید نصبش کنید، آموزش نصب توی این لینک هست. وقتی جنریتور روی دستگاهتون نصب شد، میتونید با دستور زیر اولین پروژتون رو باهاش بسازید:

Java
1
yo helma-mvp

بعد اجرای این دستور، جنریتور تعدادی سوال میپرسه که براساس جواب‌هاتون پروژه رو تولید میکنه.

 

نکته مهم۱- برای اجرای بقیه دستورات باید وارد فولدر پروژه بشید و اونجا این دستورات رو اجرا کنید وگرنه با خطا مواجه میشید.

نکته مهم۲- در کنار اکتیویتی‌ و فرگمنت‌هایی که توسط دستورات زیر ساخته میشند، فایل‌های مورد نیاز برای الگوی معماری mvp مثل presenter و کتابخونه‌ی dagger2 هم ساخته میشند.

 

لیست دستوراتی که جنریتور حلما پشتیبانی میکنه:

۱- دستور ساخت اکتیویتی خالی

Java
1
yo helma-mvp:activity

۲- دستور ساخت اکتیویتی که شامل کد‌های endless recyclerview  هست

Java
1
yo helma-mvp:activity --list

۳- دستور ساخت اکیتویتی که شامل یک فرگمنت هست

Java
1
yo helma-mvp:activity --frag

۴- دستور ساخت اکتیویتی که شامل navigation drawer از نوع سفارشی (custom) هست

Java
1
yo helma-mvp:activity --nav-custom

۵- دستور ساخت اکتیویتی که شامل navigation view از نوع استاتیک (یعنی آیتم‌های navigation view از یک فایل xml خونده میشه) هست.

Java
1
yo helma-mvp:activity --nav-support

۶- دستور ساخت اکتیویتی که شامل navigation view از نوع داینامیک هست.

Java
1
yo helma-mvp:activity --nav-support --nav-dynamic

۷- دستور ساخت فرگمنت خالی

Java
1
yo helma-mvp:fragment