방법 1: Gradle(권장)

SDK 리포지토리 추가

프로젝트의 종속성 관리에서 Singular Maven 리포지토리를 구성합니다.

Gradle 7+ 구성

설정 파일에 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.10.0")
}

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

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

여러 종속성에 동일한 라이브러리가 포함된 경우 중복 클래스 오류가 발생할 수 있습니다. 이는 이전 버전을 사용할 때 Google Play 서비스 라이브러리에서 주로 발생합니다.

해결 방법 충돌하는 종속성 제외

중복 클래스 문제를 해결하려면 충돌하는 전이 종속성 또는 충돌의 원인이 되는 다른 종속성에서 충돌하는 전이 종속성을 Singular SDK에서 제외하세요.

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

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

삼성 갤럭시 스토어 지원

앱이 삼성 갤럭시 스토어를 통해 배포되는 경우 삼성 갤럭시 스토어 설치 리퍼러 종속성을 추가합니다.

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.0")
}

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

구글 플레이 서비스 종속성

앱에서 Google Play 서비스 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. 압축을 풀고 라이브러리에 추가합니다: SDK 패키지의 압축을 풀고 Singular.aar 을 안드로이드 프로젝트의 라이브러리 디렉토리에 추가합니다.
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.10.0</version>
</dependency>

Eclipse 설치

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

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

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

1. AAR의 압축을 풉니다: singular_sdk-12.10.0.aar 압축을 풉니다.
2. JAR 파일의 이름을 바꿉니다: classes.jar 의 이름을 singular_sdk-12.10.0.jar 으로 변경합니다(기본 SDK jar).
3. 설치 리퍼러 추가: 프로젝트에 com.android.installreferrer:installreferrer:2.2라이브러리를 추가합니다.
4. 권한 복사: AAR에 포함된 AndroidManifest.xml 에서 AndroidManifest.xml으로 BIND_GET_INSTALL_REFERRER_SERVICE 권한을 복사합니다.
5. 라이선스 권한 복사: CHECK_LICENSE 권한을 AAR에 포함된 AndroidManifest.xml 에서 AndroidManifest.xml으로 복사합니다.