方法 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 Services ライブラリでよく発生します。

解決方法競合する依存関係を除外する

重複クラスの問題を解決するには、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

このコマンドは、アプリの完全な依存関係ツリーを表示し、どのライブラリが含まれ、どれが除外されているかを示します。

サムスンギャラクシーストアのサポート

アプリが Samsung Galaxy Store を通じて配布される場合は、Samsung Galaxy Store インストール リファラー依存関係を追加します。

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 サービス依存関係

アプリが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 ）にlibs というディレクトリを作成します。

Mavenのインストール

Singular Maven リポジトリをプロジェクトのpom.xmlファイルに追加します。

<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 にリネームします。
3. Add 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にコピーします。