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

2016-06-15
 

안드로이드 스튜디오로 오면서 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>’ 이런식의 주소가 붙여지니 테스트해보자.