Android에서 AAR(Android Archive) 라이브러리 만들기

Android에서 AAR(Android Archive) 라이브러리 만들기

Android에서 AAR(Android Archive) 파일은 다른 프로젝트에서 재사용할 수 있는 라이브러리를 패키징하는 데 사용됩니다. 이 글에서는 AAR을 만드는 방법과 이를 프로젝트에 추가하는 방법을 실제 예제와 함께 자세히 설명합니다.

---

1. AAR 라이브러리 프로젝트 생성하기

먼저, 새로운 Android Library 모듈을 생성해야 합니다.

1. Android Studio에서 File → New → New Module을 선택합니다.
2. Android Library를 선택하고 Next를 클릭합니다.
3. 라이브러리의 이름(mylibrary)과 패키지명을 설정한 후 Finish를 클릭합니다.

이제 프로젝트 구조에서 mylibrary라는 새로운 모듈이 추가됩니다.

---

2. 라이브러리 코드 작성하기

라이브러리 모듈(:mylibrary)에 기능을 추가해 보겠습니다. 예를 들어, 간단한 유틸리티 클래스를 만들어봅니다.

MyLibraryUtil.kt (간단한 유틸리티 클래스)

package com.example.mylibrary

class MyLibraryUtil {
    fun getGreeting(name: String): String {
        return "Hello, $name! Welcome to AAR Library!"
    }
}

또한, 이 클래스를 사용할 때 좀 더 직관적인 접근을 위해 object 형태로 변경할 수도 있습니다.

object MyLibraryUtil {
    fun getGreeting(name: String): String {
        return "Hello, $name! Welcome to AAR Library!"
    }
}

이제 이 유틸리티 클래스를 AAR에 포함하도록 설정할 준비가 되었습니다.

---

3. AAR 빌드 설정

라이브러리 모듈의 build.gradle.kts(:mylibrary) 파일에서 AAR을 생성하도록 설정합니다.

plugins {
    id("com.android.library")
    id("org.jetbrains.kotlin.android")
}

android {
    namespace = "com.example.mylibrary"
    compileSdk = 34

    defaultConfig {
        minSdk = 21
        targetSdk = 34
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            consumerProguardFiles("consumer-rules.pro")
        }
    }
}

이제 MyLibraryUtil 클래스를 포함한 AAR 파일을 생성할 수 있습니다.

---

4. AAR 빌드 및 출력 경로 확인

AAR 파일을 생성하려면 다음 명령어를 실행합니다.

./gradlew :mylibrary:assembleRelease

명령어 실행 후 mylibrary/build/outputs/aar/mylibrary-release.aar 파일이 생성됩니다.

---

5. AAR을 프로젝트에 추가하기

5.1 libs 폴더에 추가

1. app/libs 폴더를 생성하고 mylibrary-release.aar 파일을 복사합니다.
2. build.gradle.kts(:app)에 다음을 추가합니다.

dependencies {
    implementation(files("libs/mylibrary-release.aar"))
}

1. Sync Now를 클릭하여 프로젝트를 갱신합니다.

5.2 Maven 로컬 저장소를 사용하여 추가

AAR을 로컬 Maven 저장소에 배포하려면 다음을 실행합니다.

./gradlew :mylibrary:publishToMavenLocal

그리고 build.gradle.kts(:app)에 다음을 추가합니다.

repositories {
    mavenLocal()
}

dependencies {
    implementation("com.example.mylibrary:mylibrary:1.0")
}

---

6. AAR을 사용하는 예제 코드

이제 우리가 만든 AAR 라이브러리를 실제 프로젝트에서 사용해 보겠습니다.

import com.example.mylibrary.MyLibraryUtil

fun main() {
    val message = MyLibraryUtil.getGreeting("Android Developer")
    println(message) // 출력: "Hello, Android Developer! Welcome to AAR Library!"
}

이제 앱에서 MyLibraryUtil.getGreeting("Your Name")을 호출하면 우리가 만든 AAR 라이브러리의 기능을 사용할 수 있습니다.

---

결론

이제 AAR 라이브러리를 만드는 전체 과정을 배웠습니다.

✅ 라이브러리 프로젝트 생성 ✅ 유틸리티 클래스 작성 ✅ AAR 빌드 및 생성 ✅ 프로젝트에 적용 ✅ 실제 코드에서 사용

이제 AAR을 활용하여 공통 기능을 모듈화하고, 여러 프로젝트에서 재사용할 수 있습니다!

 

필요에 따라 ProGuard 설정이나 원격 Maven 저장소 배포 등의 추가 작업도 고려해볼 수 있습니다. 🚀