thrifty 的安装和配置教程

项目基础介绍

thrifty 是由微软开源的一个 Apache Thrift 的 Android 优化版本。它旨在减少生成的 Java 代码中的方法数量，以便于在 Android 设备上使用。与标准的 Apache Thrift 编译器相比，thrifty 生成的方法数量减少了四分之三，这使得它对于 Android 开发者来说非常吸引人，尤其是考虑到它对 Proguard 的友好性。

主要编程语言

thrifty 主要使用 Java 和 Kotlin 语言进行开发。

项目使用的关键技术和框架

• Apache Thrift: 一种跨语言的 RPC 框架，使用 Thrift 接口定义语言（IDL）来定义服务和服务使用的结构化数据。
• Gradle: 用于自动化构建和测试的框架，thrifty 使用 Gradle 进行项目的构建。

项目安装和配置的准备工作

在开始安装和配置 thrifty 之前，请确保您的开发环境中已经安装以下工具：

• JDK: Java 开发工具包，版本至少为 1.8。
• Gradle: 推荐版本为 7.6 或更高版本。
• Android Studio: 如果您打算在 Android 设备上运行生成的代码。

安装步骤

步骤 1：添加 thrifty 依赖

首先，在您的项目的 build.gradle 文件中添加以下依赖项：

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.microsoft.thrifty:thrifty-runtime-jvm:3.1.0'
}

步骤 2：安装 thrifty 编译器

从 thrifty 的 GitHub 仓库下载 thrifty 编译器（thrifty-compiler.jar）。您可以使用以下命令：

java -jar thrifty-compiler.jar --out=路径/到/输出 文件_one.thrift 文件_two.thrift 文件_n.thrift

将 路径/到/输出 替换为您希望生成代码的目录，文件_one.thrift、文件_two.thrift 等是您的 Thrift IDL 文件。

步骤 3：配置 Gradle 插件（可选）

如果您希望通过 Gradle 自动化代码生成，可以在 build.gradle 文件中添加 thrifty Gradle 插件：

buildscript {
    dependencies {
        classpath 'com.microsoft.thrifty:thrifty-gradle-plugin:3.1.0'
    }
}

apply plugin: 'com.microsoft.thrifty'

thrifty {
    // 在这里进行配置，详情请参考 thrifty-gradle-plugin 的 README.md
}

步骤 4：构建项目

使用以下命令构建您的项目：

./gradlew build

步骤 5：测试

使用以下命令运行测试：

./gradlew check

完成以上步骤后，您就可以开始使用 thrifty 在您的项目中生成和使用了。