Athana SDK

For Games

安装

环境要求

组件 版本
AGP（Android Gradle Plugin） 8.11+
Gradle 8.14+

项目根目录构建配置

Unity 插件集成方式见：Unity 集成

Cocos 插件集成方式见：Cocos 集成

1
2
3
4
5
6
7
8
9
// build.gradle.kts
plugins {
    ...
    // SDK 基于 Kotlin 运行环境，所以如果项目没有添加 Kotlin 插件则需要添加
    id("org.jetbrains.kotlin.android") version "2.0.21" apply false
    // 如果需要投放至 Google Ads，则需要添加 Google-Services 和 Firebase 插件
    id("com.google.gms.google-services") version "4.4.2" apply false
    id("com.google.firebase.crashlytics") version "3.0.4" apply false
}
1
2
3
4
5
6
7
8
9
// build.gradle
plugins {
    ...
    // SDK 基于 Kotlin 运行环境，所以如果项目没有添加 Kotlin 插件则需要添加
    id "org.jetbrains.kotlin.android"  version "2.0.21" apply false
    // 如果需要投放至 Google Ads，则需要添加 Google-Services 和 Firebase 插件
    id "com.google.gms.google-services" version "4.4.2" apply false
    id "com.google.firebase.crashlytics" version "3.0.4" apply false
}

应用构建配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
// app/build.gradle.kts 或 launcher/build.gradle.kts
plugins {
    ...
    // 如果需要投放至 Google Ads，则需要添加 Google-Services 和 Firebase 插件
    id("com.google.gms.google-services")
    id("com.google.firebase.crashlytics")
}

android {
    ...
    defaultConfig {
        ...
        // account: 账号模块需要使用的配置
        resValue("string", "gpg_project_id", "<PROJECT_ID>")  
        resValue("string", "facebook_app_id", "<FACEBOOK_APP_ID>")  
        resValue("string", "facebook_scheme", "fb<FACEBOOK_APP_ID>")
        manifestPlaceholders.putAll(mapOf(
            // 配置 Facebook SDK
            "FB_LABEL" to "@string/app_name",  
            "FB_APP_ID" to "@string/facebook_app_id",  
            "FB_CLIENT_TOKEN" to "<FACEBOOK_TOKEN_CLIENT>",  
            "FB_SCHEME" to "@string/facebook_scheme",  
            // 配置 Google Play Games
            "GMS_GAMES_ID" to "@string/gpg_project_id"
        ))
    }
    
    buildTypes {
        release {
            ...
            // 配置 Firebase 插件，不上传混淆映射文件
            configure<CrashlyticsExtension> {
                mappingFileUploadEnabled = false
                nativeSymbolUploadEnabled = false
            }
        }
        debug {
            ...
            // 配置 Firebase 插件，不上传混淆映射文件
            configure<CrashlyticsExtension> {
                mappingFileUploadEnabled = false
                nativeSymbolUploadEnabled = false
            }
        }
    }
}

dependencies {
    // Add this dep ↓   
    val sdkVersion = "1.3.7"
    implementation("com.inonesdk.athana:athana:${sdkVersion}")
    implementation("com.inonesdk.athana:ad-max:${sdkVersion}")
    implementation("com.inonesdk.athana:conversion-appsflyer:${sdkVersion}")
    // （选配）会在 Google Ads 上进行投放，则需要添加以下依赖
    implementation("com.inonesdk.athana:conversion-firebase:${sdkVersion}")
    // （选配）会在 Facebook 上进行直投，且需要获取落地页参数，则需要添加以下依赖
    implementation("com.inonesdk.athana:conversion-meta:${sdkVersion}")
    // （选配）需对接第三方登录，则可添加以下依赖
    implementation("com.inonesdk.athana:account-athana:${sdkVersion}")
    // （选配）需对接推送，则可添加以下依赖
    implementation("com.inonesdk.athana:push-firebase:${sdkVersion}")
    
    ...
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
// app/build.gradle 或 launcher/build.gradle
...
// 如果需要投放至 Google Ads，则需要添加 Google-Services 和 Firebase 插件
apply plugin: 'com.google.gms.google-services'
apply plugin: 'com.google.firebase.crashlytics'

android {
    ...
    defaultConfig {
        ...
        // account: 账号模块需要使用的配置
        resValue "string", "gpg_project_id", "<PROJECT_ID>"
        resValue "string", "facebook_app_id", "<FACEBOOK_APP_ID>"
        resValue "string", "facebook_scheme", "fb<FACEBOOK_APP_ID>"
        manifestPlaceholders = [
                // 配置 Facebook SDK
                FB_LABEL: "@string/app_name",
                FB_APP_ID: "@string/facebook_app_id",
                FB_CLIENT_TOKEN: "<FACEBOOK_CLIENT_TOKEN>",
                FB_SCHEME: "@string/facebook_scheme",
                // 配置 Google Play Games
                GMS_GAMES_ID: "@string/gpg_project_id"
        ]
    }
    
    buildTypes {
        release {
            ...
            // 配置 Firebase 插件，不上传混淆映射文件
            firebaseCrashlytics {
                mappingFileUploadEnabled false
                nativeSymbolUploadEnabled false
            }
        }
        
        debug {
            ...
            // 配置 Firebase 插件，不上传混淆映射文件
            firebaseCrashlytics {
                mappingFileUploadEnabled false
                nativeSymbolUploadEnabled false
            }
        }
    }
}

dependencies {
    // Add this dep ↓   
    var sdkVersion = "1.3.7"
    implementation("com.inonesdk.athana:athana:${sdkVersion}")
    implementation("com.inonesdk.athana:ad-max:${sdkVersion}")
    implementation("com.inonesdk.athana:conversion-appsflyer:${sdkVersion}")
    // （选配）会在 Google Ads 上进行投放，则需要添加以下依赖
    implementation("com.inonesdk.athana:conversion-firebase:${sdkVersion}")
    // （选配）会在 Facebook 上进行直投，且需要获取落地页参数，则需要添加以下依赖
    implementation("com.inonesdk.athana:conversion-meta:${sdkVersion}")
    // （选配）需对接第三方登录，则可添加以下依赖
    implementation("com.inonesdk.athana:account-athana:${sdkVersion}")
    // （选配）需对接推送，则可添加以下依赖
    implementation("com.inonesdk.athana:push-firebase:${sdkVersion}")
    ...
}

后续环节：集成

0%