Skip to content

Coding Convention

yubinquitous edited this page Jan 21, 2022 · 3 revisions

1. 기본

기본적으로 공식문서인 Kotlin Coding ConventionsKotlin style guide를 준수한다.

1.1. 안드로이드 스튜디오

안드로이드 스튜디오의 Optimize imports 기능과 Reformat Code 기능을 이용한다.

  • Optimize imports (Ctrl+Alt+O) : 사용하지 않는 Class를 import하고 있는 경우 제거해준다.
  • Reformat Code (Ctrl+Alt+L) : 코드의 Kotlin Style Guide를 적용하여 Code를 Reformat한다.

2. Resource Naming Convention

2.1. ID

<WHAT>_<DESCRIPTION> 방식으로 사용한다.

View Prefix
TextView tv_
ImageView iv_
EditText et_
Button, ImageButton btn_
Toolbar tb_
ConstraintLayout cl_
LinearLayout ll_
BottomNavigationView bnv_
Menu menu_
  • custom view의 경우 prefix에 custom_ 를 추가한다.

2.2. Layout

<WHAT>_<WHERE> 방식으로 사용한다.

View Prefix
Activity activity_
Fragment fragment_
Dialog dialog_
CustomView view_
Item item_
  • 예시

    SignInActivity.kt → activity_sign_in.xml
    
    CustomCalendarView.kt → view_custom_calendar.xml
    

2.3. Drawable

<WHAT>_<DESCRIPTION> 방식으로 사용한다.

View Prefix
Icon ic_
Background bg_
Shape <shame>_<color>_<radius>_<value>
  • 예시

    ic_error.xml
    rectangle_yellow_radius_20.xml
    

2.4. Menu

menu_ 방식으로 사용한다.


2.5. Color

  • style guide의 이름을 사용한다.

2.6. String

<WHERE/WHAT>_<DESCRIPTION> 방식을 사용한다.


2.7. Style

<WHAT><DESCRIPTION>Style 방식을 사용한다.

  • 예시

    <style name="LoginEditTextStyle"/>
    <style name="MainDialogStyle"/>

2.8. Navigation

nav_<ACTIVITY> 방식으로 사용한다.


3. 클래스, 인터페이스명

  • <CONTENT><TYPE> 방식을 사용한다.
  • 예시 : UserData, UserRepository