如何为免费/付费ProductFlavors编写正确的if判断语句？

问题背景 #

要发布应用的免费和付费版本，制作了简易Demo：付费版包含可跳转至第二个Activity的ImageView，免费版无此ImageView。已配置free和paid两种ProductFlavors，各自创建源集，每个源集含res文件夹及存放activity_main.xml的layout目录。付费源集的xml与main源集一致（存在冗余），免费源集的xml不含该ImageView（实际项目将用于添加/移除AdView）。

在MainActivity.java中通过if判断，意图仅当BuildConfig.FLAVOR为"paid"时，才获取ImageView并设置点击事件。但构建变体设为paidDebug时运行正常，freeDebug时编译失败，提示找不到该ImageView。尝试在不同源集放置不同版本的MainActivity.java，出现“重复类”错误，认为应可通过单个Java文件的if判断实现需求。

此外，无论构建变体是freeDebug还是paidDebug，代码中的"paid".equals(BuildConfig.FLAVOR)判断都会被高亮提示“始终为true”，但运行时打印的BuildConfig.FLAVOR结果正确。现需解答三个问题：

1. 实现思路是否正确？
2. 为何Android Studio认为判断条件始终为true？
3. 为何编译过程会报错if语句内的资源引用？

相关代码 #

MainActivity.java

public class MainActivity extends AppCompatActivity {

    ImageView imageView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        System.out.println("BuildConfig.FLAVOR is..."+BuildConfig.FLAVOR);

        if("paid".equals(BuildConfig.FLAVOR)) {

            imageView = findViewById(R.id.clickableImage);
            imageView.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View view) {
                    openPage2Activity();
                }
            });
        }

    }

    public void openPage2Activity(){
        Intent i = new Intent(this, Page2Activity.class);
        startActivity(i);
    }
}

build.gradle(:app)

flavorDimensions "paytype"

productFlavors {
    free {
        dimension "paytype"
        applicationIdSuffix ".free"
    }
    paid {
        dimension "paytype"
        applicationIdSuffix ".paid"
    }
}

buildTypes {
    release {
        minifyEnabled false
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
    debug {
        applicationIdSuffix ".debug"
    }
}

问题解答 #

1. 实现思路是否正确？ #

方向正确但细节有误。用ProductFlavors区分免费/付费版本是Android多渠道构建的标准方案，但直接通过BuildConfig.FLAVOR做运行时判断，无法绕过编译期的资源合法性检查——编译free变体时，R.id.clickableImage不存在，编译器会直接报错。

正确思路应结合源集资源覆盖特性与编译期常量判断，让编译器针对不同变体自动剔除无效代码，避免资源引用错误。

2. 为何Android Studio认为判断条件始终为true？ #

Android Studio的代码分析基于当前选中的构建变体：

• 若当前选中paidDebug，BuildConfig.FLAVOR在该变体下是固定常量"paid"，因此IDE会提示判断始终为true；
• 若切换到freeDebug，IDE会提示判断始终为false，甚至标红R.id.clickableImage。

而运行时打印结果正确，是因为每个变体编译时都会生成专属的BuildConfig类，其中的FLAVOR值对应该变体的字符串。

3. 为何编译过程会报错if语句内的资源引用？ #

这里并非“执行”代码，而是编译期的合法性检查。编译器会扫描所有代码的语法与资源引用有效性，不会因为代码在运行时可能不执行就跳过检查。编译free变体时，R.id.clickableImage不存在，因此findViewById(R.id.clickableImage)会触发编译错误。

修正方案 #

方式一：源集覆盖Java代码（解决重复类问题） #

之前的重复类错误，是因为同时在main源集与free/paid源集放置了同名的MainActivity.java。正确做法是：

• 公共逻辑留在main源集的MainActivity.java中；
• 仅在paid源集创建MainActivity.java，重写差异化逻辑。

示例：
main源集的MainActivity.java：

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        System.out.println("BuildConfig.FLAVOR is..."+BuildConfig.FLAVOR);
        
        initPaidFeatures();
    }

    protected void initPaidFeatures() {
        // 默认空实现，付费版重写
    }

    public void openPage2Activity(){
        Intent i = new Intent(this, Page2Activity.class);
        startActivity(i);
    }
}

paid源集的MainActivity.java：

public class MainActivity extends com.yourpackage.MainActivity { // 包名需与main源集一致

    ImageView imageView;

    @Override
    protected void initPaidFeatures() {
        imageView = findViewById(R.id.clickableImage);
        imageView.setOnClickListener(v -> openPage2Activity());
    }
}

编译free变体时，仅加载main源集的MainActivity；编译paid变体时，paid源集的MainActivity会覆盖main中的版本，不会出现重复类问题。

方式二：使用编译期常量 #

在build.gradle中为每个Flavor添加自定义编译期常量，编译器会自动根据变体剔除无效代码：

修改build.gradle(:app)：

flavorDimensions "paytype"

productFlavors {
    free {
        dimension "paytype"
        applicationIdSuffix ".free"
        buildConfigField "boolean", "IS_PAID", "false"
    }
    paid {
        dimension "paytype"
        applicationIdSuffix ".paid"
        buildConfigField "boolean", "IS_PAID", "true"
    }
}

// 其余代码不变

修改MainActivity.java：

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        System.out.println("BuildConfig.FLAVOR is..."+BuildConfig.FLAVOR);

        if (BuildConfig.IS_PAID) {
            ImageView imageView = findViewById(R.id.clickableImage);
            imageView.setOnClickListener(v -> openPage2Activity());
        }
    }

    public void openPage2Activity(){
        Intent i = new Intent(this, Page2Activity.class);
        startActivity(i);
    }
}

BuildConfig.IS_PAID是编译期常量，编译free变体时，编译器会直接剔除if块内的代码，不会检查R.id.clickableImage；编译paid变体时则保留代码。

另外，可删除paid源集的activity_main.xml，因为paid变体默认会使用main源集的布局，仅free变体使用自身源集的无ImageView布局即可，消除冗余。

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