방법 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.14.0")
}

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

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

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

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

중복 클래스 문제를 해결하려면, Singular SDK 또는 충돌을 일으키는 다른 의존성에서 충돌하는 전이 의존성을 제외하세요.

dependencies {
    // Exclude specific Google Play Services modules from Singular SDK
    implementation("com.singular.sdk:singular_sdk:12.14.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.14.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'
}

전이 의존성

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 디렉터리 생성: 디렉터리가 없는 경우, 프로젝트 폴더에 libs 라는 디렉터리를 생성하세요(일반적으로 <project>/app/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.14.0</version>
</dependency>

Eclipse 설치

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

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

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

1. AAR 압축 해제: singular_sdk-12.14.0.aar 의 압축을 해제하세요
2. JAR 파일 이름 변경: classes.jar 의 이름을 singular_sdk-12.14.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 에 복사하세요