MeteorCat / AndroidSDK设计

/ ─── fgame-lib/
  │      ├─ src/
  │      │  ├─ main/
  │      │  │  ├─ java/com/game/fgame/
  │      │  │  │  ├─ core/            // 核心逻辑（单例管理、初始化）
  │      │  │  │  ├─ login/           // 登录模块
  │      │  │  │  ├─ pay/             // 支付模块
  │      │  │  │  ├─ report/          // 数据上报模块
  │      │  │  │  ├─ config/          // 配置管理
  │      │  │  │  ├─ utils/           // 工具类（加密、日志、网络等）
  │      │  │  │  └─ FGameSdk.java    // 对外接口类（单例，提供所有API）
  │      │  │  ├─ res/                // 资源文件（若有自定义布局、图片等）
  │      │  │  └─ AndroidManifest.xml // 声明权限、服务等（需注意与CP方合并冲突）
  │      │  └─ test/                  // 单元测试（核心工具类、签名逻辑等）
  │      ├─ build.gradle              // 库配置（依赖、混淆、AAR输出等）
  │      └─ proguard-rules.pro        // 混淆规则（保护SDK代码不被反编译）
  │
  │── gradle/                         // gradle-wrapper 配置目录
  |
  |── build.gradle                    // 根目录打包配置
  |
  |── settings.gradle                 // 包含项目的模块设置, 如指定项目名称|要包含的子项目列表等   
  |
  |── gradle.properties               // 用于配置 Gradle 构建系统的属性文件, 如设置 Gradle 的堆大小|缓存等

# 我编写都是 Linux 环境, 所以采用 shell 命令去创建
# 这里必须采用 gradle-wrapper 去锁定版本, 否则 gradle 所有版本或大或小有兼容性问题, 是很垃圾的管理工具
mkdir gradle/wrapper

# 生成第三方的镜像配置文件
touch gradle/wrapper/gradle-wrapper.properties

distributionBase=GRADLE_USER_HOME
distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/v7.2.0/gradle-7.2-all.zip
distributionPath=wrapper/dists
zipStorePath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME

rootProject.name = 'fgame-sdk' // 根目录的名称
// 子模块依赖
include ':fgame-lib'

# gradle 全局属性 
# 安卓打包工具版本, 注意打包版本需要做好 gradle 匹配, 否则会出问题
AndroidBuildGradleToolsVersion=7.0.4
# 其他公共打包配置项常量, 注: CompileSdkVersion 低于30默认启动弹出 "该应用专为旧版本安卓构建"
AndroidMinSdkVersion=21
AndroidCompileSdkVersion=30
AndroidTargetSdkVersion=30
# SDK包的命名空间
GameSdkNamespace=com.game.fgame.core

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        mavenCentral()
        jcenter() // 保持对旧库的兼容性
    }
    dependencies {
        // 加载全局常量的安卓打包版本
        //noinspection AndroidGradlePluginVersion
        classpath "com.android.tools.build:gradle:${AndroidBuildGradleToolsVersion}"
        // 注意：不要在此处放置应用依赖项，它们属于各自的模块构建文件
    }
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }

        google()
        mavenCentral()
        jcenter() // 保持对旧库的兼容性
    }
}

tasks.register('clean', Delete) {
    delete rootProject.buildDir
}

apply plugin: 'com.android.library'


/**
 * 获取正式包时间格式
 * @return
 */
static def GetReleaseTime() {
    return new Date().format("yyyyMMddHHmm", TimeZone.getTimeZone("GMT+8"))
}

/**
 * 安卓打包配置
 */
android {

    // 主要配置
    compileSdkVersion AndroidCompileSdkVersion


    // 包的命名空间
    namespace GameSdkNamespace

    // 默认配置
    defaultConfig {
        minSdkVersion AndroidMinSdkVersion
        targetSdkVersion AndroidTargetSdkVersion
    }

    // 源代码引入结构
    sourceSets {
        main {
            manifest.srcFile 'src/main/AndroidManifest.xml'
            assets.srcDirs = ['src/main/assets']
            res.srcDirs = ['src/main/res']
            java.srcDirs = ['src/main/java']
            resources.srcDirs = ['src/main/resources']
            aidl.srcDirs = ['src/main/aidl']
            renderscript.srcDirs = ['src/main/renderscript']
            jniLibs.srcDir 'src/main/jniLibs'
        }
    }

    // 解决lint报错的代码, 保持旧包兼容性
    lintOptions {
        quiet true
        abortOnError false
        ignoreWarnings true
        checkReleaseBuilds false //方法过时警告的开关
        disable 'InvalidPackage' //Some libraries have issues with this.
        disable 'OldTargetApi' //Lint gives this warning but SDK 20 would be Android L Beta.
        disable 'IconDensities' //For testing purpose. This is safe to remove.
        disable 'IconMissingDensityFolder' //For testing purpose. This is safe to remove.
    }


    // 打包配置, 主要排除掉对于说明文件
    packagingOptions {
        exclude 'META-INF/DEPENDENCIES.txt'
        exclude 'META-INF/LICENSE.txt'
        exclude 'META-INF/NOTICE.txt'
        exclude 'META-INF/NOTICE'
        exclude 'META-INF/LICENSE'
        exclude 'META-INF/DEPENDENCIES'
        exclude 'META-INF/notice.txt'
        exclude 'META-INF/license.txt'
        exclude 'META-INF/dependencies.txt'
        exclude 'META-INF/LGPL2.1'
        exclude 'META-INF/versions/9/module-info.class'
    }


    // 打包构建配置
    buildTypes {

        release {
            minifyEnabled true
            zipAlignEnabled true
            shrinkResources false // 建议在release版本设为true以减小体积
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'),
                    'proguard_common_rules.pro',
                    'proguard_rules_sdk_core.pro'
            consumerProguardFiles 'proguard_rules_sdk_core.pro'

            libraryVariants.all { variant ->
                variant.outputs.all { output ->
                    outputFileName = "fgame_lib_v1-${GetReleaseTime()}.aar"
                }
            }
        }

        debug {
            minifyEnabled false
            zipAlignEnabled false
            shrinkResources false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'),
                    'proguard_common_rules.pro',
                    'proguard_rules_sdk_core.pro'
            consumerProguardFiles 'proguard_rules_sdk_core.pro'
        }
    }
}

/**
 * 第三方包配置
 */
dependencies {
    // 引入 jar 和 aar 依赖包
    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')

    // SDK所需基础依赖
    compileOnly 'com.android.support:support-compat:28.0.0'
    compileOnly 'com.android.support:support-core-utils:28.0.0'
    compileOnly 'com.android.support:support-core-ui:28.0.0'
    api 'com.android.support:support-v4:28.0.0'
    compileOnly 'com.android.support:appcompat-v7:28.0.0'
    compileOnly 'com.android.support:localbroadcastmanager:28.0.0'
    compileOnly 'com.android.support:design:28.0.0'
}

dependencies {
    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
    //sdk需要依赖以下android库，请务必导入，如果版本号与您本地有差异，请设置成大于或等于sdk所需库版本
    implementation('androidx.legacy:legacy-support-v4:1.0.0')
    implementation('androidx.multidex:multidex:2.0.1')
}

dependencies {
    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
    //sdk需要依赖以下android库，请务必导入，如果版本号与您本地有差异，请设置成大于或等于sdk所需库版本
    implementation 'com.android.support:support-v4:28.0.0'
    implementation 'com.android.support:multidex:1.0.3'
}

// FGameSdk.java 初始化方法
public static void init(Context context, String configPath) {
    // 读取assets中的渠道配置文件（如channel_config.json）
    String channelCode = readChannelFromAssets(context, configPath);
    // 保存渠道码到全局变量，用于后续数据上报
    SdkConfig.getInstance().setChannelCode(channelCode);
}

{
  "appid": 10001,
  "channel": "10003"
}