Android Resource Klasörü Dosya İsimlendirilmesi

Merhabalar,

Bir proje yaparken zorunlu olmasada sizi ve ekibinizi kurtaracak bir yapı oluşturmanız ve uymanız hem projenin takibi hemde yönetilmesi açısından sizlere kolaylık sağlayacaktır.

Sizde eğer bir android projesine başladığınızda class isimleri gelişigüzel tanımlayıp, layout dosyalarındaki itemleri rastgele bir id’ye tabi tutuyorsanız bu yazı sizler için yazıldı.

 

Aslında takip etmeniz için güzel bir kaynak olarak http://tools.android.com/tech-docs/new-build-system/user-guide#TOC-Project-Structure sunabilirim.

1. Dosya İsimlendirme

  • 1.1 Sınıf Dosyalarının isimlendirilmesi

Projenizde bir sınıf oluştururken UpperCamelCase yapısını kullanmanız gerekmektedir. Yani her bir kelimeniz büyük harfle başlamalıdır. Bağlaçlar vs’de dahildir.

Burada dikkat etmeniz gereken diğer şey ise sınıfınızın adının yaptığı iş ile bitmesi ‘dir. Component olarak Fragment Kullanıyorsanız MainFragment gibi, Service ise MainService gibi componentide sonda belirtebilirsiniz.

Örneğin;

RegisterActivity, MainActivity,  ClassLauncher gibi sizin ve ekibinizdeki diğer kişilerin anlayabileceği bir isimlendirme yapısı tercih etmelisiniz.

  • 1.2 Resources (Kaynak) Dosyalarının isimlendirilmesi

Projenizde res klasörü için bir dosya oluşturuyorsanız burada lowercase bir yapı tercih etmelisiniz.

  • 1.2.1 Drawable Dosyalarının isimlendirilmesi

Burada resmi ne için kullanacaksanız onun tipinin kısaltması ve yapacağı iş şeklinde olması her zaman güzeldir.

Asset TypePrefixExample
Action barab_ab_stacked.png
Buttonbtn_btn_send_pressed.png
Dialogdialog_dialog_top.png
Dividerdivider_divider_horizontal.png
Iconic_ic_star.png
Menumenu_menu_submenu_bg.png
Notificationnotification_notification_bg.png
Tabstab_tab_pressed.png

İconların kısaltılması içinse

Asset TypePrefixExample
Iconsic_ic_star.png
Launcher iconsic_launcheric_launcher_calendar.png
Menu icons and Action Bar iconsic_menuic_menu_archive.png
Status bar iconsic_stat_notifyic_stat_notify_msg.png
Tab iconsic_tabic_tab_recent.png
Dialog iconsic_dialogic_dialog_info.png

Seçicilerin kısaltılması içinse,

StateSuffixExample
Normal_normalbtn_order_normal.9.png
Pressed_pressedbtn_order_pressed.9.png
Focused_focusedbtn_order_focused.9.png
Disabled_disabledbtn_order_disabled.9.png
Selected_selectedbtn_order_selected.9.png

1.2.2 Layout Dosyalarının isimlendirilmesi

Layout dosyalarınız kesinlikle Sizin tanımlamış olduğunuz class’ınız ile eşleşmelidir. Yani sınıfınızı yaptığı iş ve bileşen olarak yazdınız ama layoutunuz farklı bir yapıda ise bu dosyayı bulmanız yada bir süre sonra projenizi tekrar açtığınızda neredeydi bu dosya dememeniz için kesinlikle şarttır. Örneğin SignInActivity sınıfınız’ın layout ismi activitiy_sing_in olmalıdır.

ComponentClass NameLayout Name
ActivityUserProfileActivityactivity_user_profile.xml
FragmentSignUpFragmentfragment_sign_up.xml
DialogChangePasswordDialogdialog_change_password.xml
AdapterView itemitem_person.xml
Partial layoutpartial_stats_bar.xml

Adapter, Listview, RecyclerView itemleri olmaktadır. Bunları ekranda listeleyeceğimiz elemanlardır. Bunlar ise item_ ile başlamalıdır.

1.2.2.3 Menu Dosyalarının isimlendirilmesi

Layout dosyalarına benzer olarak menu dosyalarıda componentlerinin isimleri ile eşleşmeldiri. Yani bir menüyü UserActivity için tasarlamışsak bunu menude tanımlarken activity_user olarak tanımlamamız bizim için daha güzel olacaktır.

1.2.2.4 Values Dosyalarının isimlendirilmesi

Res klasöründeki Values dosyaları isimlendirilirken yapacağı işle isimlendirilmelidir. strings.xml, styles.xml, colors.xml, dimens.xml gibi olmalıdır.

 

Yazar: umiitkose

1 thought on “Android Resource Klasörü Dosya İsimlendirilmesi

    mom jeans

    (6 Nisan 2018 - 21:54)

    Bu dersleri videolu olarak anlatsanız on numara olur

mom jeans için bir cevap yazın Cevabı iptal et

E-posta hesabınız yayımlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir