Code Convention

Android Coding Convention

목차

• 1. 기본
  • 1.1. 안드로이드 스튜디오
• 2. Resource Naming Convention
  • 2.1. ID
    • 2.1.1. Prefix
    • 2.1.2. 예시
  • 2.2. Layout
    • 2.2.1. Prefix
    • 2.2.2. 예시
  • 2.3. Drawable
    • 2.3.1. Prefix
    • 2.3.2. 예시
  • 2.4. Menu
    • 2.4.1. Prefix
  • 2.5. Color
    • 2.5.1. 예시
  • 2.6. String
    • 2.6.1. Prefix
    • 2.6.2. 예시
  • 2.7. Style
    • 2.7.1. Prefix
    • 2.7.2. 예시
• 3. Kotlin Naming Convention
  • 3.1. Class
    • 2.6.1. Prefix
    • 2.6.2. 예시
  • 3.2. Method
    • 2.7.1. Prefix
    • 2.7.2. 예시
  • 3.3. Variable
    • 2.7.1. Prefix
    • 2.7.2. 예시

1. 기본

기본적으로 공식문서인 Kotlin Coding Conventions과 Kotlin 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

View 이름의 축약하여 Camel Case로 변환한 것을 Prefix로 사용한다.

2.1.1. Prefix

<WHAT>_<DESCRIPTION>

View	Prefix
TextView	text
ImageView	image
EditText	edit
Button, ImageButton	button
Toolbar	toolBar
ConstraintLayout	layout
LinearLayout	layout
BottomNavigationView	bottomNavi
..	..

2.1.2. 예시

@+id/textLogin
@+id/editPassword
@+id/buttonLogin

2.2. Layout

Layout의 xml 파일의 이름은 .kt .java의 Pascal Case를 Snake Case로 변환하여 사용한다.

2.2.1. Prefix

<WHAT>_<WHERE>

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

2.2.2. 예시

SignInActivity.kt -> activity_sign_in.xml
SignUpFragment.kt -> fragment_sign_up.xml
CustomCalendarView.kt -> view_custom_calendar.xml
item_user.xml

2.3. Drawable

2.3.1. Prefix

<WHAT_DESCRIPTION>

Drawable	Prefix
Icon	ic_
Image	img_
Background	bg_
Shape	<shape>_<color>_<radius>_<value>

2.3.2. 예시

ic_error.xml
img_default_user.xml
bg_main.xml
rectangle_yellow_radius_20.xml

2.4. Menu

2.4.1. Prefix

menu_

2.5. Color

Color의 이름은 Camel Case를 이용해 작성하되, 사이트를 참고해 Color를 직관적으로 연상할 수 있는 이름 + RGB 이름을 조합하여 사용한다. 이때 중복되는 경우에는 앞에 두글자만 적는다.

2.5.1. 예시

<color name="blackFF000000">#FF000000</color>
<color name="whiteFF">#FFFFFFFF</color>
<color name="cornflowerBlue6195ED">#6195ED</color>

2.6. Style

View의 Pascal Case와 Style에 대한 설명을 조합하여 Style 명을 지정한다.

2.6.1. Prefix

<WHAT><Description>Style

2.6.2. 예시

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

2.7. String

현재 View이름과 해당하는 String 설명을 조합하여 string명을 지정한다. 이때 lowerCamelCase로 이름을 작성한다.

2.7.1. 예시

<string name="homeCancel">
<string name="myPagePlus">

## 3. Kotlin Naming Convention

3.1. Class

클래스 파일 이름은 UpperCamelCase(파스칼 케이스(PascalCase))로 작성한다.

3.1.1. Prefix

<DESCRIPTION><WHAT>

Prefix는 해당 클래스와 관련성이 높은 것으로 임의로 작성한다.

3.1.2. 예시

MainActivity
UserViewModel
WriteFragment

3.2. Method

메소드 이름은 lowerCamelCase로 작성한다.

3.2.1. Prefix

"동사"로 시작하는 "동사구" 형태를 사용하되, 동사 원형만을 사용한다.
자주 사용하는 동사는 용법에 맞게 사용한다.

Word	Description
show	Invisible한 것을 Visible하게 바꾸는 동작
check	어떤 것을 확인한 후 boolean 또는 값으로 반환하는 동작
is	어떤 것인지 확인한 후 boolean으로 반환하는 동작
has	어떤것을가지고 있는 확인 후 boolean으로 반환하는 동작

3.2.2. 예시

showList
updateContacts

3.3. Variable

변수 이름 또한 마찬가지로 lowerCamelCase로 작성한다.

3.3.1. 예시

isEnd
viewPagerAdapter