방법 1: Gradle (권장)

SDK 저장소 추가

프로젝트의 의존성 관리에서 Singular Maven 저장소를 구성합니다.

Gradle 7+ 구성

settings 파일에 Singular SDK 저장소를 추가합니다:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://maven.singular.net/")
        }
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven {
            url 'https://maven.singular.net/'
        }
    }
}

이전 Gradle 버전

이전 Gradle 버전의 경우, 프로젝트 수준 빌드 파일에 저장소를 추가하세요:

repositories {
    mavenCentral()
    maven {
        url = uri("https://maven.singular.net/")
    }
}

repositories {
    mavenCentral()
    maven {
        url 'https://maven.singular.net/'
    }
}

Singular 라이브러리 의존성 추가

앱 모듈의 의존성에 Singular 라이브러리를 추가합니다.

dependencies {
    implementation("com.singular.sdk:singular_sdk:12.13.0")
}

dependencies {
    implementation 'com.singular.sdk:singular_sdk:12.13.0'
}

문제 해결: 중복 클래스 문제

여러 의존성에 동일한 라이브러리가 포함되어 있을 때 중복 클래스 오류가 발생할 수 있습니다. 이는 이전 버전의 Google Play Services 라이브러리를 사용할 때 흔히 발생합니다.

해결책: 충돌하는 의존성 제외

중복 클래스 문제를 해결하려면 Singular SDK 또는 충돌을 일으키는 다른 의존성에서 충돌하는 전이 의존성(transitive dependency)을 제외합니다.

dependencies {
    // Exclude specific Google Play Services modules from Singular SDK
    implementation("com.singular.sdk:singular_sdk:12.13.0") {
        exclude(group = "com.google.android.gms", module = "play-services")
    }

    // Add the specific Google Play Services libraries your app needs
    implementation("com.google.android.gms:play-services-ads-identifier:17.0.0")
    implementation("com.google.android.gms:play-services-appset:16.0.2")
}

dependencies {
    // Exclude specific Google Play Services modules from Singular SDK
    implementation('com.singular.sdk:singular_sdk:12.13.0') {
        exclude group: 'com.google.android.gms', module: 'play-services'
    }

    // Add the specific Google Play Services libraries your app needs
    implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
    implementation 'com.google.android.gms:play-services-appset:16.0.2'
}

전역 제외 규칙

중복 클래스 충돌이 프로젝트 전반의 여러 의존성에 영향을 미치는 경우, 전역 제외 규칙을 적용할 수 있습니다.

configurations.all {
    exclude(group = "com.google.android.gms", module = "play-services")
}

configurations.all {
    exclude group: 'com.google.android.gms', module: 'play-services'
}

의존성 해결 검증

제외 규칙을 적용한 후, 충돌이 해결되었는지 확인하기 위해 의존성 트리를 검증합니다.

./gradlew app:dependencies --configuration debugRuntimeClasspath

이 명령은 앱의 전체 의존성 트리를 표시하여 어떤 라이브러리가 포함되어 있고 어떤 라이브러리가 제외되었는지를 보여줍니다.

Samsung Galaxy Store 지원

앱이 Samsung Galaxy Store를 통해 배포되는 경우 Samsung Galaxy Store install referrer 의존성을 추가합니다.

dependencies {
    implementation("store.galaxy.samsung.installreferrer:samsung_galaxystore_install_referrer:4.0.0")
}

dependencies {
    implementation 'store.galaxy.samsung.installreferrer:samsung_galaxystore_install_referrer:4.0.0'
}

전이 의존성 (Transitive Dependencies)

Singular SDK의 전이 의존성을 비활성화한 경우, 앱 모듈의 의존성에 필요한 라이브러리를 수동으로 추가하세요.

dependencies {
    implementation("com.android.installreferrer:installreferrer:2.2")
    implementation("com.google.android.gms:play-services-appset:16.0.2")
}

dependencies {
    implementation 'com.android.installreferrer:installreferrer:2.2'
    implementation 'com.google.android.gms:play-services-appset:16.0.2'
}

Google Play Services 의존성

앱에서 Google Play Services API 17.0.0 이상을 구현하지 않은 경우, 다음 의존성을 추가하세요.

dependencies {
    implementation("com.google.android.gms:play-services-ads-identifier:17.0.0")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0+'
}

대체 설치 방법

수동 다운로드

SDK AAR 파일을 다운로드하여 프로젝트에 수동으로 연동합니다.

1. SDK 다운로드: 이 페이지 상단의 링크에서 SDK를 다운로드합니다
2. 압축 해제 및 libs에 추가: SDK 패키지의 압축을 해제하고 Singular.aar 을 Android 프로젝트의 libs 디렉터리에 추가합니다
3. libs 디렉터리 생성: 존재하지 않을 경우, 프로젝트 폴더(보통 <project>/app/libs )에 libs 디렉터리를 생성합니다

Maven 설치

프로젝트의 pom.xml 파일에 Singular Maven 저장소를 추가합니다.

<project ...>
    <repositories>
        <repository>
            <id>singular.net</id>
            <url>http://maven.singular.net/</url>
        </repository>
    </repositories>
</project>

의존성을 추가합니다:

<dependency>
    <groupId>com.singular.sdk</groupId>
    <artifactId>singular_sdk</artifactId>
    <version>12.13.0</version>
</dependency>

Eclipse 설치

다음 단계를 따라 Eclipse를 사용하여 SDK를 연동합니다.

Eclipse AAR 플러그인을 사용할 수 있습니다: gradle-eclipse-aar-plugin

플러그인을 사용하지 않으려면 다음 단계를 따르세요:

1. AAR 압축 해제: singular_sdk-12.13.0.aar 의 압축을 해제합니다
2. JAR 파일 이름 변경: classes.jar 의 이름을 singular_sdk-12.13.0.jar 로 변경합니다 (이것이 기본 SDK jar입니다)
3. install referrer 추가: com.android.installreferrer:installreferrer:2.2 라이브러리를 프로젝트에 추가합니다
4. 권한 복사: AAR에 포함된 AndroidManifest.xml 의 BIND_GET_INSTALL_REFERRER_SERVICE 권한을 사용 중인 AndroidManifest.xml 에 복사합니다
5. 라이선스 권한 복사: AAR에 포함된 AndroidManifest.xml 의 CHECK_LICENSE 권한을 사용 중인 AndroidManifest.xml 에 복사합니다