方法 1:Gradle(推荐)

添加 SDK 仓库

在项目的依赖管理中配置 Singular Maven 仓库。

Gradle 7+ 配置

将 Singular SDK 仓库添加到 settings 文件中:

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 安装

将 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.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 中