方法 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 にコピーしてください