[2] 서포트 라이브러리 셋업하기

서포트 라이브러리 셋업하기 Support Library Setup

IN THIS DOCUMENT

  1. “Android Support Libraries”  다운로드하기
  2. “Android Support Libraries” 선택하기
  3. “Android Support Libraries” 추가하기
    1. 라이브러리를 리소스 없이 추가하기
    2. 라이브러리를 리소스와 함께 추가하기
  4. “Support Library API”들 사용하기
    1. 매니페스트 선언 변경 – Manifest Declaration Changes
  5. 예제 코드

함께 볼 것 – SEE ALSO

Support Library Revisions
Support Library Features

why 서포트 라이브러리 셋업하기?

다른 이유는 아직 모르겠습니다. 액션 바를 저사양 API에서 사용하려면 서포트 라이브러리를 사용해야 한다고 합니다.
다른 좋은 기능들도 지원하겠지요. 일단 설치 해 봅니다.

“Android Support Libraries” 설치는 우리가 어떤 기능을 사용할 것인지,
안드로이드 플랫폼을 어디까지 지원할 것인지에 따라서 달라집니다.
이 문서에서 “Android Support Libraries” 패키지를 다운로드하고,
라이브러리를 여러분의 환경에 추가하는 것을 알려드리겠습니다.

 “Android Support Libraries” 다운로드하기


“Android Support Libraries” 는  “Android SDK Manager” 를 통해서 다운로드 할 수 있습니다.
다음과 같이 “Android Support Libraries” 파일을 받습니다.

  1. SDK Manager” 를 실행합니다.
  2. “SDK Manager” – Extras 폴더 를 찾습니다.
  3. “Android Support Libraries” 를 선택합니다.
    주의 : 안드로이드 스튜디오로 개발하고 있다면 “Android Support Repository” 를 다운받으세요.
  4. Install packages… 버튼을 클릭합니다.

그림 1. “Android SDK Manager” 에서 “Android Support Library” 를 선택한 모습

다운로드 후, 여러분의 안드로이드 SDK 폴더에 “Android Support Libraries” 가 설치됩니다.
라이브러리 파일들은 SDK 및 다음 하위 디렉토리에  위치합니다.
<sdk>/extras/android/support/

“Android Support Libraries”  선택하기


“Android Support Libraries” 를 여러분의 앱에 추가하기 전에,
어떤 기능들을 포함하고 싶은지, 안드로이드 버전을 어디까지 맞출 것인지 정해야 합니다.
각각의 라이브러리가 제공하는 기능들에 대한 자세한 정보는 Support Library Features 를 참고하세요.

“저는 Action Bar 를 사용하고 싶습니다.
[Android] Action Bar 추가하기[1] 액션 바 셋업하기  에서 이 페이지로 넘어왔습니다.
액션 바를 셋업하려는 데, Android 2.1 버전까지 지원하려면 서포트 라이브러리중 v7 appcompat 가 필요하다고 했지요.
그래서 우리는  v7 appcompat를 마음속에 염두해 놓고 다음을 계속 진행합니다!”

“Android Support Libraries” 추가하기


서포트라이브러리를 사용하려면, 어플리케이션 프로젝트의 클래스패스디펜던시를 수정해야 합니다.
원하는 서포트 라이브러리마다 이 과정을 진행해 줘야 합니다.

일부 서포트라이브러리들은 컴파일된 코드 클래스와 리소스(XML이나 이미지 같은 파일)를 포함하고 있습니다.

v7 appcompat 와 v7 gridlayout 라이브러리들은 리소스를 포함하고 있지요.

“드디어 나왔군요! 우리가 찾던 V7 appcompat”

만약 라이브러리가 리소스를 갖고 있는지 잘 모르겠다면 Support Library Features 페이지를 확인해 보세요.

라이브러리를 리소스 없이 추가하기

라이브러리를 리소스를 제외하고 추가하기 위해서  다음을 진행합니다.

Using Eclipse
Using Android Studio

라이브러리를 리소스와 함께 추가하기

서포트 라이브러리를 리소스와 함께 추가하기 위해서 (액션 바를 위한 v7 appcompat) 다음을 진행합니다

Using Eclipse
Using Android Studio(우리는 이 스텝을 진행합니다.)

  • [SDK Manager] 를 이용해서 [Android Support Repository] 를 받았는지 확인합니다.
  • build.gradle 파일(Module:app 이라고 되어있는것!)을 오픈합니다
  • 디펜던시 섹션에 “support library 기능 프로젝트 식별자”를  추가합니다.
  • dependencies {
        ...
        compile "com.android.support:appcompat-v7:18.0.+"
    }
  • bundle.gradle
  • (참고로 저는 compile ‘com.android.support:appcompat-v7:22.0.0’ 라고 이미 추가되어 있습니다. 프로젝트를 생성 할 때 API10으로 생성해서 그런가봅니다)

(일단 여기까지 셋업을 해도 액션바가 잘 되는것을 확인했습니다.)

“Support Library APIs” 사용하기


Support Library classes that provide support for existing framework APIs typically have the same name as framework class but are located in the android.support class packages, or have a *Compat suffix.

이미 있는 프레임워크 API를 제공하는 서포트라이브러리 클래스들은 framework 클래스와 같은 이름을 가집니다.
하지만 android.support 클래스 패키지에 위치해 있습니다. 또는 *Compat 접미어를 가지지요.

Caution: When using classes from the Support Library, be certain you import the class from the appropriate package. For example, when applying the ActionBar class:

서포트라이브러리에 있는 클래스를 사용할 때는, 클래스를 적절한 패키지로부터 import 해야 합니다. 예를 들어 ActionBar 클래스를 적용할 때는

  • android.support.v7.app.ActionBar when using the Support Library.
  • android.app.ActionBar when developing only for API level 11 or higher.
  • android.support.v7.app.ActionBar : 서포트 라이브러리를 사용할 때
  • android.app.ActionBar : API 레벨 11 이상에서만 개발할 때

위처럼 적당히 골라서 사용해줘야 합니다.

Note: After including the Support Library in your application project, we strongly recommend using the ProGuard tool to prepare your application APK for release. In addition to protecting your source code, the ProGuard tool also removes unused classes from any libraries you include in your application, which keeps the download size of your application as small as possible. For more information, see ProGuard.

주의 : 프로젝트에 서포트라이브러리를 포함시키고 나서, 어플리케이션 APK 를 배포를 위해 준비하기 위해, ProGuard tool을 사용하는 것을 강력하게 추천합니다. 게다가 소스코드를 보호하기 위해서, Proguard 툴은 라이브러리에서 제공하긴 하지만 사용하지 않는 클래스를 제거합니다. 이렇게 해서 앱 사이즈를 최대한 줄일 수 있습니다. 더 자세한 정보는 ProGuard 를 참고하세요

Further guidance for using some Support Library features is provided in the Android developer training classes, guides and samples. For more information about the individual Support Library classes and methods, see the android.support packages in the API reference.

서포트라이브러리에 대한 좀 더 자세한 가이드라인은 안드로이드 개발자 트레이닝 클래스 가이드와 샘플에 있습니다. 좀 더 자세한 개별적인 서포트라이브러리에 대한 내용은 android.support 패키지를 보세요

Manifest Declaration Changes

If you are increasing the backward compatibility of your existing application to an earlier version of the Android API with the Support Library, make sure to update your application’s manifest. Specifically, you should update theandroid:minSdkVersion element of the <uses-sdk> tag in the manifest to the new, lower version number, as shown below:

우리의 앱을 이전 버전과의 호환성을 높이기 위해서는, 매니페스트파일을 업데이트 해야합니다. 특별히, android:minSdkVersion 속성을 새롭고 더 낮은 버전 넘버로 업데이트 해야합니다.

  <uses-sdk
      android:minSdkVersion="7"
      android:targetSdkVersion="17" />

The manifest setting tells Google Play that your application can be installed on devices with Android 2.1 (API level 7) and higher.

매니페스트 세팅은 구글플에이에 우리의 어플리케이션이 2.1 버전 (API level 7) 이상에서 설치될 수 있다는 것을 알려줍니다.

If you are using Gradle build files, the minSdkVersion setting in the build file overrides the manifest settings.

만약 Gradle 빌드 파일을 사용한다면, 빌드 파일에 있는 minSdkVersion 셋팅은 매니페스트 셋팅을 덮어씁니다.

apply plugin: 'com.android.application'

android {
    ...

    defaultConfig {
        minSdkVersion 8
        ...
    }
    ...
}

In this case, the build file setting tells Google Play that the default build variant of your application can be installed on devices with Android 2.2 (API level 8) and higher. For more information about build variants, see Build System Overview.

이 경우, 빌드 파일 셋팅은 구글 플레이에게 기본 빌드 값은 2.2 이상(API level 8)에서 설치 가능하다는 것을 보여줍니다.

Note: If you are including the v4 support and v7 appcompat libraries in your application, you should specify a minimum SDK version of "7" (and not "4"). The highest support library level you include in your application determines the lowest API version in which it can operate.

주의 : 만약 v4를 포함하고, v7 appcompat 라이브러리를 어플리케이션에 포함한다면, 최소 SDK 버전을 7로 명시해 줘야합니다(4가 아니에요). 어플리케이션에서 가장 높은 라이브러리 버전은, 구동할 수 있는 가장 낮은 버전의 API를 정의하는 것입니다. (오잉또잉? 이게 무슨말이지요?)

예제 코드


Each Support Library includes code samples to help you get started using the support APIs. The code is included in the download from the SDK Manager and is placed inside the Android SDK installation directory, as listed below:

  • 4v Samples: <sdk>/extras/android/support/samples/Support4Demos/
  • 7v Samples: <sdk>/extras/android/support/samples/Support7Demos/
  • 13v Samples: <sdk>/extras/android/support/samples/Support13Demos/
  • App Navigation: <sdk>/extras/android/support/samples/SupportAppNavigation/

  

Advertisements

답글 남기기

아래 항목을 채우거나 오른쪽 아이콘 중 하나를 클릭하여 로그 인 하세요:

WordPress.com 로고

WordPress.com의 계정을 사용하여 댓글을 남깁니다. 로그아웃 / 변경 )

Twitter 사진

Twitter의 계정을 사용하여 댓글을 남깁니다. 로그아웃 / 변경 )

Facebook 사진

Facebook의 계정을 사용하여 댓글을 남깁니다. 로그아웃 / 변경 )

Google+ photo

Google+의 계정을 사용하여 댓글을 남깁니다. 로그아웃 / 변경 )

%s에 연결하는 중