方法 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.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 安装

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