Android Support Annotations



안드로이드 개발 시 Annotation을 사용할 수 있도록 서포트 라이브러리를 지원한다. Annotation을 통해 코드의 설명을 간단명료하게 표시할 뿐 아니라 제약할 수도 있다. 즉, 해당 메서드나 멤버 변수를 다른 사람 또는 내가 재사용할 때 필요한 규약을 지정하여 예외적인 사항을 컴파일 에러를 통해 바로 확인이 가능하다.

왜 사용해야 하는가?

런타임시 발생되는 예외사항을 빌드 전 컴파일 에러를 통해 대부분 막을 수 있기때문에 앱의 개발 속도 향상은 물론 코드를 설명하기위한 긴 설명의 주석을 대체할 수 있다. 또한 다른 사람이 작성한 코드를 사용하거나 반대로 내가 작성한 코드를 다른사람이 사용하거나 분석할때 시간을 줄 일 수 있다.

안드로이드 Annotation 라이브러리 추가(build.gradle)

dependencies { 
    compile 'com.android.support:support-annotations:24.2.0' 
}

@NonNull / @Nullable

메서드의 파라미터에 null이 허용되는 경우도 있고, 반드시 값이 필요한 경우도 있다. 자신이 개발한 코드가 아니거나 또는 개발을 했음에도 코드를 살펴보고 null체크를 하는지 판단을 해야 하는 경우 사용하면 된다. 파라미터에 @NonNull을 사용하면 null값을 허용하지 않으며, 임으로 null을 넣는 경우 컴파일 에러가 난다. 반대로 메서드 내부적으로 null체크를 하여 해당 기능을 분기하는 경우 null이 허용 가능함으로 @Nullable를 사용하면 된다.
 
no-annotations
 
nonnull

@CheckResilt

메서드의 리턴 값을 필수적으로 받아야 할 때 사용하면 된다.
 
checkreturn.png

@StringRes / @DrawableRes / @ColorRes / @(Etc)Res

메서드에 전달 인자가 리소스 주소인 Integer인 경우 해당 리소스가 어떠한 형태인지를 미리 알려줄 수 있는 기능이다. 예를 들어 TextView의 setText(int) 메서드의 경우 String 리소스 주소를 넣어야 한다는 것을 명시할 수 있다. String리소스 주소가 아닌 Drawable리소스나 임의의 Integer값을 넣는 경우 컴파일 에러를 통해 알려준다.
 
stringres.png

@MainThread / @UiThread / @WorkerThread

메서드가 실행될 때 해당 수행되어야 할 스레드를 명시할 수 있다. AsyncTask의 스레드에서 UI를 변경하는 작업을 하는 경우 에러가 나는데, 이런 경우를 사전에 알려준다.
 

@Keep

빌드시 프로가드를 통해 난독화가 되어 사용 불가능 한 클래스의 경우 난독화를 예외처리해주어야 한다. 본인이 개발하지 않는 경우 이런 히스토리를 알기는 쉽지 않다. 이런 경우 @Keep를 통해 난독화 예외처리를 해야 하는 클래스인지 명시적으로 알려줄 수 있다.

이외에도 @CallSuper, @RequiresPermission, @Size 등 다양한 Annotation이 존재한다. 좀 더 알아보기 위해 아래 사이트를 참고하자.

참고:




빠르고 유연한 ContraintLayout

ContraintLayout?

ContraintLayout은 2016 구글 I/O를 통해 발표된 안드로이드의 새로운 레이아웃이다. 안드로이드 스튜디오(2.2 Preview2 부터)에 내장된 새로운 레이아웃 에디터(Blue Print)와 연동을 통해 이전의 레이아웃보다 쉽게 구성할 수 있다. 뷰 계층의 깊이와 복잡성을 해결하기 위해 ContraintLayout이 만들어졌으며, 앱의 UI렌더링 속도를 높일 수 있을 뿐만아니라 다양한 기기의 해상도에 최적화된 UI를 쉽게 개발 할 수도 있다. 안드로이드 서포트 라이브러리를 통해 사용가능하며 API 레벨 9부터 사용가능하다.

build.gradle에서 해당 라이브러리를 추가한다.

compile 'com.android.support.constraint:constraint-layout:1.0.0-alpha2'

ContraintLayout 속성

  • layout_constraintTop_toTopOf
  • layout_constraintTop_toBottomOf
  • layout_constraintBottom_toTopOf
  • layout_constraintBottom_toBottomOf
  • layout_constraintLeft_toTopOf
  • layout_constraintLeft_toBottomOf
  • layout_constraintLeft_toLeftOf
  • layout_constraintLeft_toRightOf
  • layout_constraintRight_toTopOf
  • layout_constraintRight_toBottomOf
  • layout_constraintRight_toLeftOf
  • layout_constraintRight_toRightOf
  • layout_constraintCenterX_toCenterX
  • layout_constraintCenterY_toCenterY
  • layout_constraintBaseline_toBaselineOf

속성을 보면 알겠지만 많은 속성들로 인해 복잡하고 뷰들 간의 관계에 대한 속성들이 대부분이다. 자식뷰들관의 관계를 연결해주는 것을 보면 RelactiveLayout와 비슷해보이지만 ContraintLayout은 자식들과 부모관의 관계에 대한 정렬및 배치 방식과 좌표가 아닌 비율을 통해 위치가 지정되는등 다양한 기능을 가졌다.

 

레이아웃 에디터

개발자라면 그동안 레이아웃을 XML편집기를 이용하여 텍스트로 작성했을 것이다. 하지만 ContraintLayout은 무수히 많은 속성과 타겟 뷰의 ID를 값으로 주는 만큼 레이아웃구조를 텍스트로 작성하거나 또는 읽을때 예전보다는 확연히 힘들것이다. 이렇게 복잡한 레이아웃을 텍스트가 아닌 새롭게 선보인 디자인 툴(Blue Print)을 이용하면 훨씬 쉽고 간단하게 작성할 수 있다.

레이아웃 에디터는 UI설계를 하는 Design과 뷰들관의 관계를 보여주는 BluePrint 화면 2개가 나타난다. 이 2개 화면을 동시에 보거나 따로보는 방법은 레이아웃 에디터의 상단 아이콘을 이용하면 전환할 수 있다.

be44fb8e685150a5565f19c94e36e954
Design 표시 아이콘: 한번 누르면 디자인 화면으로 전환 되며 또한번 누르면 BluePrint 화면을 동시에 2개가 나타난다.

a72c79e2a3bf45f38413fec30f3dac36
BluePrint 표시 아이콘: 한번 누르면 BluePrint화면으로 전환되며 또한번 누르면 디자인 화면과 동시에 2개가 나타난다.

 

레이아웃 편집시 쓰이는 아이콘

b25f376c52508c900dbab5a8bf5d68bf
BluePrint화면의 뷰들간의 관계에 대한 정보를 숨기고 보일 수 있다.

f6ea28b2afd03030cfeed10d9b3f165a
새로운 뷰를 드래그 하는 경우 다른뷰들간의 관계를 자동으로 연결할 수 있다.

3fd3b60139267dc5bd0e2abce72f6f30
관계를 정보를 모두 삭제 한다.

4d928284744c25094798de88e6cce11d
자동으로 관계에 대한 정보를 연결한다.

7c2b5cfb7453a9614c2e5507998eff27
마진값의 단위를 선택한다. 0, 8, 16dp로 전환이 가능하다.

 

레이아웃 내에서 쓰이는 툴


하나의 뷰를 나타내며 가로/세로 크기와 다른뷰와의 관계에 대해 화살표로 설정할 수 있는데 자세히 알아보자.

99a8ebe4d5ada56e4abacb2dfedc9d50
뷰 크기 변경 컨트롤: 각모서리 가장자리에 있는 네모 모양을 통해 뷰의 크기를 늘리고 줄일 수 있다.

924dedda9eb89c0ab8f6a268c4558e13
관계 설정 컨트롤: 둥글게 생긴 부분으로 다른 뷰들관의 관계를 지정할 수 있다. 가로축의 컨트롤은 다른뷰의 가로축에만 연결되며, 세로축은 다른뷰의 세로축에만 연결된다. 이미 관계가 지정되어 있을때 클릭하면 해제된다.

a6b25ad94ce53ddfedbf2d689a506b78
베이스 라인 컨트롤: 뷰의 기본 라인을 맞춘다. 베이스 라인은 뷰내의 실제 컨텐트가 배치해있는 위치이다. 해당 컨트롤을 선택하기위해서는 커서를 몇초간 위치해있어야 한다.

 

ContraintLayout에서 뷰크기 지정

뷰의 크기는 우리가 알고 있듯이 고정된크기, 뷰의 컨텐츠에 맞게 지정되는 방식, 부모크기를 따라가는 방식이 있다. 이를 UI적으로 표현하여 좀거 쉽게 설정가능하다.

e8124ddde04b2aa76e42f79582123218

7300702340c7018202fbdcf57af5b525
고정된크기: 뷰의 사이즈가 고정되어 있다.

709b28b53490f5fb5f6dcdc5380a6fb3
부모 컨텐츠 크기: MATCH_PARENT방식으로 작동한다.

af2e72fd3b0d4188c61e06da211f9835
뷰 컨텐츠 크기: 뷰의 크기에 따라 크기가 설정된다.

edcfce9f89f19fb900de367212f55c3a
수평및 수직 정렬: 부모 뷰와 자식뷰가 연결되어 있는 경우 정렬을 퍼센테이지로 설정할 수 있다. LinearLayout의 weight와 비슷하다고 생각하면 쉽다.

팁!

처음 ContraintLayout을 접해보면 생각보다 힘든 작업이 될가능성이 높다. 이것저것 버튼을 눌러서 레이아웃을 맞추기에 생각보다 번거롭기 때문이다. 그래서 한가지 팁을 소개해보겠다. 먼저 뷰들간의 관계를 연결하지 말고 배치만으로 작업을 한다. 연결 되어 있다면 모두 끊은 상태에서 배치작업을 한뒤 자동 관계아이콘을 클릭하여 연결을 자동으로 구성 후 보정작업을 하거나 간단한 경우 직접 연결해준다.

 

ContraintLayout은 알파단계로 약간의 버그가존재하며 디자인툴이 생각보다 빨리 움직이지 않고 한번씩 다운되는등의 문제점이 발생된다. 하지만 기존의 너무 깊은 레이아웃을 구조로 앱의 성능에 문제가 생긴점을 해결해줄 속 시원한 레이아웃이 될것 같다. 그리고 BluePrint로 인해 디자이너도 툴을 쉽게 익히고 사용하는데 무리가 없을것 같다. 기존의 계층구조가 복잡한 레이아웃이 있다면 조금씩 바꿔나가는 것에 추천한다.

 

jCenter로 안드로이드 라이브러리 간단하게 배포하기

안드로이드 스튜디오로 오면서 Gradle로 인해 외부라이브러리 사용이 훨씬 편해졌다. 예전에는 JAR파일이나 라이브러리 프로젝트를 직접 다운받아 프로젝트에 Import해서 라이브러리를 사용했다. 안드로이드 스튜디오의 Gradle파일에서 Dependencies에서 라이브러리명만 작성하면 연결되어 있는 저장소에서 파일을 받아오게 된다. Maven Repository중 가장쉽고 간단한 jCenter가 있으며 최근 안드로이드 스튜디오에서 새로운 프로젝트를 생성하면 기본 저장소로 설정되어 있기도하다.

 

jCenter에 라이브러리 배포하기

1) jCenter를 운영하는 bintray.com 사이트에 가입한다.

2) 가입 후 다양한 Repository가 있는데 우리는 Maven을 사용할 것이다.

3) Maven에서 Add New Package 버튼을 눌러 새로운 패키지 만들어두어도 되나, 아래에서 업로드시 패키지가 없다면 새롭게 생성해주기 때문에 만들지 않아도 된다. 그리고 Import from Github버튼을 눌러 Github에서도 가져올 수 있다. 단, 정보만 가져온다.

 

4) 이제 사이트에서 설정하는 것은 모두 끝났으며, 안드로이스 스튜디오의 라이브러리 프로젝트에서 novoda:bintray-release를 이용하여 빌드후 bintray에 바로 배포하는 라이브러리를 사용한다.

 

5) 프로젝트의 build.gradle에 아래와 같이 novoda:bintray-release라이브러리를 추가하다. 이것을 활용하여 빌드된 파일들을 bintray로 업로드한다.

buildscript{
   repositories{
      jcenter()
   }

   dependencies{
      classpath 'com.android.tools.build:gradle:2.1.0'
      classpath 'com.novoda:bintray-release:0.3.4'
   }
}

 

6) 라이브러리의 모듈에 있는 build.gradle에 업로드할 사용자 정보를 작성한다. 참고로 artifactId는 소문자로 작성하고 단어사이에는 하이픈(-)을 넣어 컨벤션을 지키도록하자.

apply plugin: 'com.android.library'
apply plugin: 'com.novoda.bintray-release'

publish {
   userOrg = 'kmshack'
   groupId = ‘com.kmshack.library'
   artifactId = ‘android-exception-tracker'
   publishVersion = '1.0.2'
   desc = 'Android Exception Tracker'
   website = 'https://github.com/kmshack/ExceptionTracker'
   issueTracker = "https://github.com/kmshack/ExceptionTracker/issues"
   repository = "https://github.com/kmshack/ExceptionTracker.git"
}

 

7) 터미널에가서 프로젝트의 위치에서 아래명령으로 빌드를 수행해보자.

$ ./gradlew clean build bintrayUpload -PbintrayUser=BINTRAY_USERNAME -PbintrayKey=BINTRAY_KEY -PdryRun=false

*BINTRAY_USERNAME은 아이디이며, BINTRAY_KEY는 Bintray 프로필 페이지의 API Key메뉴에서 값을 확인 할 수 있다.

 

8) 빌드가 끝나면 Bintray 사이트로 가면 해당 패키지가 만들어 졌고, 관련된 라이브러리 파일들도 업로드된 것을 볼 수 있다.

 

9) 여기까지가 Bintray 저장소에 라이브러리를 올린 것이고, 기본 저장소인 jCenter에는 아직 등록 되지 않았다. jCenter에 등록은 아주 간단하다. 패키지 정보 화면에서 Add to jCenter버튼을 눌러 확인만 하고 기다리면 jCenter저장소와 연동된다.

 

10) 연동이 된다면 Add to jCenter버튼은 없어지고, jCenter아이콘이 나타나며, 이제 안드로이드 스튜디오에서 사용해보면 된다.
compile ‘<groupId>:<artifactId>:<publishVersion>’ 이런식의 주소가 붙여지니 테스트해보자.

 

안드로이드 스튜디오 유용한 단축키 모음 #1

라인 아래위 이동

 alt + shift + up/down
❖ alt + shift + up/down

선택된 위치의 줄을 아래 또는 위로 움직인다.

 

라인 삭제

 cmd + backspace
❖ ctrl + y

선택된 위치의 줄을 삭제 한다.

 

라인 복제

 cmd + d
❖ ctrl + d

선택된 위치의 줄을 똑같이 복제한다.

 

확장 선택

 alt + up / down
❖ ctrl + w / ctrl + shift + w

선택 영역을 큰단위로 점차 확장 선택한다.

 

조건 추가

 cmd + alt + t
❖ ctrl + alt + t

선택된 라인및 영역 을 if / else, try / catch, for, while등으로 조건을 추가할 수 있다.

 

최근 편집 목록

 cmd + e
❖ ctrl + e

최근 편집한 파일의 목록을 보여준다. 상단 탭보다 더 많은 목록을 볼 수 있다.

 

문법 자동 완성

 cmd + shift + enter
❖ ctrl + shift + enter

해당 코드에 맞는 문법을 자동으로 완성해주는 기능이다. if를 입력하고 단축키를 누르면 괄호와 묶음 표현코드를 자동으로 작성해준다.

 

라인 합치기

 ctrl + shift + j
❖ ctrl + shift + j

문법에 맞도록 선택된 줄을 한줄로 합치는 기능이다. 주석이나 의미없이 줄바꿈한 코드를 빠르게 한줄로 수정할 수 있다.

 

클래스 구조 탐색창

 cmd + F12
❖ ctrl + F12

클래스구조 창을 띄운다. 메서드, 변수등 리스트로 한번에 볼 수 있으며 검색을 통해 해당위치로 빠르게 이동 할 수 있다.

 

구현 코드 빠른 창으로 보기

 alt + space
❖ ctrl + shift + i

선택된 메서드를 보기위해 클래스로 이동하지 않고 팝업창을 통해 빠르게 볼 수 있다.

 

북마크 기능

북마크(선택/해지 토글) 하기
 F3
❖ F11

북마크 보기
 alt + F3
❖ ctrl + F11

해당 위치를 북마크 해둘 수 있는 기능이다. 복잡한 구조에서 해당 메서드나 변수를 찾을때 북마크 해두면 쉽게 찾아 갈 수 있다.

 

액션 찾기

 cmd + shift + a
❖ ctrl + shift + a

다양한 기능을 검색을 통해 찾을 수 있다. 위에서 언급한 기능의 단축키가 생각이 나지 않다면 검색을 통해 찾을 수 있다.

 

해당 단축키는 윈도우 리눅스 Default, OSX는 Mac OSX 10.5+기반으로 작성되었다.

 

안드로이드 스튜디오 빌드 시간 개선법

이클립스에서 스튜디오로 넘어오면서 가장 불만사항이 Gradle로 변경되면서 MultiDex가 지원됨에 따라 빌드시간이 배이상 느려졌습니다. MultiDex로 인한 작업이 60%이상의 시간을 소모 하고 있습니다. 달리 말해 MultiDex를 쓰지 않으면 60%이상의 시간을 단축 시킬수 있습니다.

:transformClassesWithDexForDebug

 

롤리팝(API 21)부터는 Art기반이기때문에 MultiDex가 자동으로 생략 됩니다. 하지만 벅스 프로젝트의 MinSdk버전 16 인해 무조건 MultiDex 작업이 수행됩니다.

MinSdk버전을 롤리팝인 21로 설정하게 된다면 MultiDex가 작동되지 않습니다. 즉, 개발시에만 21로 설정해서 사용하면 60%이상의 빌드시간을 단축 할 수 있습니다.

 

3.2 GHz Intel Core i3 기준으로 빌드시간:

MinSDKVer 16  – Total time: 1 mins 34.019 secs
MinSDKVer 21 – Total time: 41.905 secs

 
배이상 시간이 단축 되었습니다. 롤리팝 이하 버전의 단말에서는 다시 MinSDK를 내려야 하는 불편함이 있긴 하지만 개발시에만 이렇게 쓰는것이 기회비용상 나쁘지는 않을것 같습니다.

 

그리고 오늘 안드로이드 스튜디오 2.0 베타가 출시되었는데 인스턴스런이라고 하여 빌드하지않고 수정된 코드가 바로 에뮬레이터로 표현되는 기능이 들어 있습니다. 블로그의 말로는 50배 이상 빌드에 대한 시간을 단축 할 수 있다고 하네요. 앞으로 지속적으로 지켜봐야 할 부분인것 같습니다.

 

 

Android Studio Key Map

Android Studio Key Map Mac 10.5 +

Action Key Command
Reformat code CMD(⌘) + OPTION(⌥) + L
Auto import class OPTION(⌥) + ENTER
Show docs for selected API F1
Generate method CMD(⌘) + N
Jump to Source CMD(⌘) + DOWN-ARROW
Delete line CMD(⌘) + BACKSPACE
Search by Class name CMD(⌘) + O
Search by Symbol name CMD(⌘) + OPTION(⌥) + O
Search by File CMD(⌘) + SHIFT(⇧) + O
Build CMD(⌘) + F9
Build and run CTRL(⌃) + R
Tab Close CMD(⌘) + W
Edit Focuse After CMD(⌘) + ]
Edit Focuse Before CMD(⌘) + [
Method Block Visibility CMD(⌘) + .
Explore Keyword CMD(⌘) + G
Line Move SHIFT(⇧) + OPTION(⌥) + DOWN/UP-ARROW
Auto Complete CTRL(⌃) + SPACE
이 글은 Evernote에서 작성되었습니다. Evernote는 하나의 업무 공간입니다. Evernote를 다운로드하세요.

Android Studio Project is using an old version of the Android Gradle plug-in Error

Android Studio 0.4.0으로 업데이트 되면서 이전에 만들었던 프로젝트를 불러 오려면 다음과 같은 오류가 발생한다. 

Project is using an old version of the Android Gradle plug-in.

The minimum supported version is 0.7.0.

Please update the version of the dependency ‘com.android.tools.build:gradle’ in your build.gradle files.


 

해결책:

Gradle Plugin 0.7.0과  gradle-wrapper 1.9로 사용하도록 변경하면된다.


build.gradle 파일

buildscript {

    repositories {

        mavenCentral()

    }

    dependencies {

        classpath 'com.android.tools.build:gradle:0.7.+'

    }

}

gradle-wrapper.properties 파일

distributionUrl=http://services.gradle.org/distributions/gradle-1.9-all.zip

하위 호환성이 뭐이래 생각하지만, 아직 베타니까;;