idea中gradle的android项目external libraries中引入仓库的jar包

原创

mob64ca12f8da8d 2024-08-03 09:54:26 ©著作权

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

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

在 Android 项目中通过 Gradle 引入外部 JAR 包

现代 Android 开发中，Gradle 为我们提供了极大的方便，使得管理依赖关系成为一件简单的事情。尽管如此，有时我们可能需要引入一些没有在 Maven Central 或其他公共仓库中的 JAR 包。在这种情况下，手动将 JAR 包集成到项目中是一个常见的操作。本文将详细介绍如何在 Android Studio 中引入外部 JAR 包，并提供相关代码示例。

1. JAR 包的基本概念

JAR（Java Archive）包是一个包含多个 Java 类文件的归档文件，可以将它们打包成一个文件，从而提高项目的可移植性。使用 JAR 包最直接的好处是能够复用已有的功能和库，减少代码重复。

2. 准备 JAR 包

假设我们要使用的外部库就是一个名为 example-lib.jar 的 JAR 文件。首先，您需要将该 JAR 文件下载到您的项目目录中。例如，可以创建一个 libs 文件夹来存放所有的 JAR 文件。

项目结构示例：

MyAndroidApp/
├── app/
│   ├── libs/
│   │   └── example-lib.jar
│   └── build.gradle
└── build.gradle

3. 配置 Gradle 文件

接下来，我们需要在 app/build.gradle 文件中添加对 JAR 包的依赖。请打开 app/build.gradle 文件，并在 dependencies 块中添加如下代码：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
}

此行代码的作用是指示 Gradle 在 libs 目录中查找所有的 JAR 文件，并将它们添加到项目的构建路径中。

4. 使用外部库

在配置完 Gradle 之后，您可以直接在代码中使用外部库中提供的类。例如，如果 example-lib.jar 中有一个名为 ExampleClass 的类，您可以在 MainActivity 中这样使用它：

import com.example.library.ExampleClass;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        ExampleClass example = new ExampleClass();
        example.doSomething();
    }
}

5. 依赖关系图

引入库和项目之间的关系可以通过一个简单的实体关系图表来表现，下面是用 Mermaid 语法表示的 ER 图：

erDiagram
    PROJECT {
        string name
        string type
    }
    JAR_PACKAGE {
        string name
        string version
        string path
    }
    PROJECT ||--o{ JAR_PACKAGE : "uses"

6. 构建过程

当您修改完 build.gradle 文件后，需要同步项目以使更改生效。可以在 Android Studio 中点击右上角的 "Sync Now" 按钮。

6.1. 监控构建过程

接下来，使用 Gradle 构建项目时，您可以通过构建工具窗口查看构建过程，以确保 JAR 文件正确加载。

gantt
    title 构建过程
    dateFormat  YYYY-MM-DD
    section 下载 JAR 包
    下载   :done, 2023-10-01, 1d
    section 将 JAR 包放入 libs
    放入   :done, 2023-10-02, 1d
    section 配置 build.gradle
    编辑   :done, 2023-10-03, 1d
    section 同步项目
    同步   :done, 2023-10-04, 1d
    section 编译和运行
    编译   :active, 2023-10-05, 1d