如何在Android付费构建变体中排除免费变体的代码？

我有两个Android产品风味（productFlavors）：

productFlavors {
    free {
        // 配置项
    }
    paid {
        // 配置项
    }
}

仅为free变体引入AdMob依赖：

dependencies {
    freeImplementation 'com.google.android.gms:play-services-ads:21.4.0'
    // 其他依赖
}

构建free变体一切正常，但构建paid变体时，编译器仍尝试编译free源目录中的代码（即便这些代码未被使用），由于paid变体未引入AdMob依赖，导致构建失败。我曾尝试通过sourceSets配置排除文件，但效果不佳：

sourceSets {
    main {
        // 配置项
    }
    paid {
        java {
            exclude ... // 尝试排除的路径
        }
    }
}

想问两个问题：

1. 是否有办法在构建paid变体时排除所有free源文件？
2. 既然编译器会尝试编译所有代码，那么为不同变体设置不同代码的意义何在？

一、如何在构建paid变体时排除free源文件 #

首先得明确Android变体的源码组织逻辑：默认情况下，构建paid变体时，Gradle只会编译src/main/（公共代码）和src/paid/（paid专属代码）下的文件，不会自动包含src/free/的代码。你碰到的问题，大概率是依赖AdMob的代码没放在src/free/目录，而是误放在了src/main/里，导致构建paid时这部分代码也被编译。

有两种解决方式：

1. 规范源码目录（推荐） #

把所有依赖AdMob、仅属于free变体的代码，移到src/free/java/对应的包路径下。这样构建paid变体时，这部分代码会被自动忽略，不用额外配置，代码结构也更清晰。

2. 通过sourceSets强制排除 #

如果暂时没法移动代码，可以在build.gradle里给paid变体的sourceSets添加排除规则：

sourceSets {
    paid {
        java {
            // 排除free变体的所有源码
            exclude '**/src/free/**'
            // 如果是要排除main目录里涉及AdMob的特定文件/包
            // exclude 'com/example/yourapp/ad/**'
        }
    }
}

注意：这种是临时兜底方案，长期来看还是推荐按规范组织目录。

二、变体专属代码的意义 #

编译器并不会“编译所有代码”——Android Gradle插件会根据当前构建的变体，自动筛选需要编译的源码集：

• 构建free变体：编译src/main/ + src/free/
• 构建paid变体：编译src/main/ + src/paid/

变体专属代码的核心价值：

• 功能隔离：比如free版加广告、限功能，paid版去广告、解锁全功能，不用维护两个独立项目
• 配置分离：不同变体可以用不同的API密钥、服务器地址、资源（如图标、字符串）
• 减少冗余：公共代码放main，变体专属代码只写一次，避免重复开发
• 灵活构建：快速切换变体测试，或打包不同版本的安装包

内容的提问来源于stack exchange，提问作者kodo_simio