android 统一套代码打不同的包

原创

mob64ca12edea6e 2025-02-14 06:46:03 ©著作权

文章标签 java Gradle android 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者mob64ca12edea6e的原创作品，请联系作者获取转载授权，否则将追究法律责任

Android 应用统一套代码打不同的包

在移动应用开发中，常常需要为不同的环境（如开发、测试、生产等）打包发布不同的应用版本。传统的方法是为每个版本写一套代码，或者使用不同的包名、资源和配置。然而，这样不仅工作量巨大，还可能导致维护困难。本文将介绍如何通过统一的代码打包生成不同的 APK，并给出具体的实现方法及示例。

统一代码管理

我们可以使用多种工具和方法来统一管理代码。Android Gradle Plugin 提供了构建变体（Build Variants）功能，可以让我们通过在同一个代码库中维护多个版本的应用。我们可以利用 Gradle 的构建类型（buildTypes）和产品风味（productFlavors）来实现。

构建变体基本结构

在你的 build.gradle 文件中，结构看起来像这样：

android {
    ...
    buildTypes {
        debug {
            applicationIdSuffix ".debug"
        }
        release {
            ...
        }
    }
    
    productFlavors {
        dev {
            applicationId "com.example.app.dev"
            versionName "1.0-dev"
        }
        prod {
            applicationId "com.example.app"
            versionName "1.0"
        }
    }
}

在本例中，我们定义了两个构建类型（debug 和 release）和两个产品风味（dev 和 prod）。这意味着我们最终会得到四个不同的 APK 文件：

com.example.app.dev.debug
com.example.app.dev.release
com.example.app.prod.debug
com.example.app.prod.release

分别针对不同环境的资源和代码

为了更好地适配不同的环境，可以根据不同的产品风味和构建类型提供额外的资源文件或代码。我们可以在 src 目录下创建对应的文件夹。例如：

src/
    main/
        java/com/example/app/
        res/
    dev/
        java/com/example/app/
        res/
    prod/
        java/com/example/app/
        res/
    debug/
        java/com/example/app/
        res/
    release/
        java/com/example/app/
        res/

在这些目录中，你可以为不同的风味或构建类型添加特定的类、布局文件或其他资源。

示例代码实现

我们可以假设我们的应用程序有一个简单的功能：登录。在 src/main/java/.../MainActivity.java 中定义基础的登录逻辑。

package com.example.app;

import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 策略逻辑、网络请求等
    }
}

然后，在 src/dev 和 src/prod 中，如果我们希望为这两个版本实现不同的登录 API，可以创建同名但实现不同的类。

src/dev/java/com/example/app/LoginApi.java:

package com.example.app;

public class LoginApi {
    public String getApiUrl() {
        return "
    }
}

src/prod/java/com/example/app/LoginApi.java:

package com.example.app;

public class LoginApi {
    public String getApiUrl() {
        return "
    }
}

这样在 MainActivity 中，我们可以根据不同的环境选择不同的 LoginApi 实现。

部署和构建

一旦我们完成了代码和资源的配置，就可以通过 Gradle 命令来构建 APK：

./gradlew assembleDevDebug
./gradlew assembleProdRelease

这将生成靶向不同环境的 APK 文件，它们将位于 app/build/outputs/apk/ 目录中。

旅行图

接下来，让我们用 Mermaid 表示一次构建包含不同版本 APK 的旅行过程：

journey
    title 构建应用的旅行
    section 开始构建
      配置 Gradle 文件: 5: 用户
      添加不同产品的资源: 4: 用户
    section 開始檢查
      校验代码: 3: 用户
      运行单元测试: 4: 用户
    section 打包APK
      生成 APK 文件: 5: 用户
      签名 APK: 4: 用户
    section 部署
      部署到测试商店: 4: 用户
      部署到生产商店: 5: 用户