[펌]안드로이드 코딩 스타일 안내(가이드)

출처 : http://givenjazz.tistory.com/44

 android-formatting.xml

 android.importorder

20개 정도 규칙이 있으며 출처는 source.android.com에서 좀 더 자세한 내용을 볼 수 있다.

build된 sdk에는 없지만 sdk 소스를 다운받으면 이클립스용 코딩 포맷과 import순서가 정보가 적힌 xml파일도 같이 받을 수 있는데, 이 글에 첨부했다.

android-formatting.xml은 "Window › Preferences › Java › Code Style > Formatter 에 import하고,

android.importorder "Organize Imports에 import하면

Shift+command+F로 자동포멧정리 기능을 안드로이드에 맞게 사용할 수 있다.

Java Language Rules

1. Exceptions: 예외 무시하지말고 처리하기.
2. Exceptions: 상위 Exception으로 싸잡아서 처리하지 않기.
3. Finalizers: 왠만하면 쓰지않기 (언제 적용될지 모름)
4. Imports: *쓰지말고 정확하게 풀네임 적기.

Java Library Rules

표준 코딩컨벤션이 바뀌어서 예전 코딩컨벤션과 충돌이 난다면 예전 코딩컨벤션으로 작성해서 일관성을 유지하기.

Java Style Rules

자바표준 컨벤션에서 추가사항:

1. Comments/Javadoc: 표준대로 작성하기.
2. Short methods: 메소드는 40줄이 넘지않게 짧게 작성하기
3. Fields: 초기에 선언하기나 사용하기 바로 전에 선언할 것.
4. Local variables: 지역변수 범위는 최소화하기.
5. Imports: 안드로이드, 서드파티(알파벳 순), java, javax 순으로 import하기.
6. Indentation: 탭안쓰고 공백 4개 사용하기.
7. Line length: 한줄에 100칸 이하 유지하기.
8. Field names: Non-public, non-static 변수는 m으로 시작하고, static변수는 s로 시작하기.
9. Braces: { 는 줄넘기지말고 사용하기
10. Annotations: 표준 어노테이션 사용하기.
11. Acronyms are words: XMLHTTPReques처럼 적지말고 XmlHttpRequest로 적기
12. TODO style: "TODO: write this description"
13. Consistency: 일관적으로 작성하기
14. Logging: 로그도 비용이 드니 적절하기 사용하기
    ERROR > WARNING > INFORMATION > DEBUG > VERBOSE 사용할 것.
    한줄에 출력할 수 있는 80~100글자가 적당.
    StringBuilder는 기본버퍼가 16character라 String보다 항상 좋다고 할 수 없으니 확신이 없으면 그냥 String연산이 무난.
    System.out.print는 어차피 /dev/null로 던져버리니 절대 쓰지말 것. 괜히 비용만 잡아먹음.

Javatests Style Rules

1. Naming test methods: testMethod_specificCase 이런식으로 이름짓기