方法 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 にコピーします