如何基于Build Flavors在Gradle中添加特定库实现

1. 定义Product Flavor #

首先在模块级build.gradle（或build.gradle.kts）中声明你的Product Flavors，比如区分免费版free和付费版paid：

android {
    flavorDimensions "appType"
    productFlavors {
        free {
            dimension "appType"
            // 免费版专属配置，比如applicationId后缀
            applicationIdSuffix ".free"
        }
        paid {
            dimension "appType"
            applicationIdSuffix ".paid"
        }
    }
}

2. 为指定Flavor添加依赖 #

在依赖块中使用*flavorNameImplementation*语法，仅给目标Flavor引入特定库，其他Flavor不会包含这些依赖：

dependencies {
    // 所有Flavor共用的基础依赖
    implementation "androidx.appcompat:appcompat:1.6.1"
    
    // 仅paid Flavor生效的专属依赖
    paidImplementation "com.example:premium-sdk:2.0.0"
}

3. 隔离Flavor专属代码 #

在项目src目录下创建与Flavor同名的代码目录，比如src/paid/java（或kotlin），将仅属于该Flavor的业务代码放在这里：

• 目录结构示例：

  src/
    main/
      java/com/example/myapp/
        MainActivity.java
        Feature.java // 通用接口
    paid/
      java/com/example/myapp/
        PremiumFeature.java // 付费版实现
    free/
      java/com/example/myapp/
        BasicFeature.java // 免费版实现
  

通过接口抽象实现跨Flavor的无差别调用：

• main目录下定义通用接口：

public interface Feature {
    void enable();
}

• paid目录下实现付费版逻辑：

public class PremiumFeature implements Feature {
    @Override
    public void enable() {
        // 调用付费SDK的具体逻辑
    }
}

• free目录下实现免费版逻辑：

public class BasicFeature implements Feature {
    @Override
    public void enable() {
        // 免费版功能逻辑
    }
}

编译时Gradle会自动匹配当前Flavor的实现类，无需额外判断。

4. 配置Flavor专属Manifest #

如果需要给特定Flavor添加组件（如Activity、Service），在对应Flavor目录下创建AndroidManifest.xml，Gradle会自动合并main目录与当前Flavor的Manifest：
比如src/paid/AndroidManifest.xml：

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>
        <activity
            android:name=".PremiumActivity"
            android:exported="false" />
    </application>
</manifest>

其他Flavor编译时不会包含这个Activity，避免不必要的组件注册。

5. 处理跨Flavor条件逻辑 #

如果main目录下的代码需要根据Flavor执行不同逻辑，可通过BuildConfig.FLAVOR做判断，但注意不要直接引用仅存在于某Flavor的类（否则其他Flavor编译报错）：

if (BuildConfig.FLAVOR.equals("paid")) {
    // 付费版专属逻辑，建议用反射或依赖注入实现实例化
    Class<?> premiumClass = Class.forName("com.example.myapp.PremiumFeature");
    Feature feature = (Feature) premiumClass.newInstance();
    feature.enable();
}

更推荐用依赖注入框架（如Dagger、Hilt），在不同Flavor下提供不同的依赖实例，避免硬编码判断。

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