Transfuse 项目技术文档

1. 安装指南

在开始使用 Transfuse 前，请确保您的开发环境已经配置了以下依赖：

• Java Development Kit (JDK)
• Android SDK
• Maven 或 Gradle

Maven 安装方式：

将以下依赖添加到您的 Maven pom.xml 文件中：

<dependency>
    <groupId>org.androidtransfuse</groupId>
    <artifactId>transfuse</artifactId>
    <version>${transfuse.version}</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>org.androidtransfuse</groupId>
    <artifactId>transfuse-api</artifactId>
    <version>${transfuse.version}</version>
</dependency>

Gradle 安装方式：

将以下依赖添加到您的 Gradle build.gradle 文件中：

apt "org.androidtransfuse:transfuse:${transfuseVersion}"
compile "org.androidtransfuse:transfuse-api:${transfuseVersion}"

确保在添加依赖后，同步您的项目。

2. 项目的使用说明

Transfuse 是一个专门针对 Google Android API 的 Java 依赖注入（DI）和集成库。其主要特性如下：

• 依赖注入：Transfuse 实现了 JSR-330 标准注解，并提供了单元测试。
• POJO 组件：用户可以使用普通 Java 对象（POJO）开发 Android 组件，使得代码更易于测试，解耦和灵活。
• 编译时代码生成：Transfuse 采用编译时生成支持代码的技术，使得库体积小，轻量级且快速。
• Manifest 管理：Transfuse 管理Android Manifest，消除了声明和注册组件时的重复劳动。

使用示例

以下是一个使用 Transfuse 的 Android Activity 示例：

@Activity(label = "@string/app_name")
@Layout(R.layout.main)
public class HelloTransfuse {

    @Inject @View(R.id.textview)
    TextView textView;

    @Inject @Resource(R.string.hello)
    String helloText;

    @OnCreate
    public void hello() {
        textView.setText(helloText);
    }
}

在上述代码中：

1. Activity 类不再继承 android.app.Activity 类。
2. Android Activity 生命周期通过轻量级事件处理。
3. 所有特殊注入，例如注入 View 元素，都使用限定符注入（例如 @View、@Resource 等）。
4. Activity 的 Manifest 元数据，如标签，现在在类级别定义，而不是在 AndroidManifest.xml 文件中定义。Transfuse 负责在 AndroidManifest.xml 文件中注册 Activity 及所有相关元数据。

3. 项目API使用文档

Transfuse 提供了丰富的 API 用于实现依赖注入和 Android 组件管理。以下是部分常用 API：

• @Activity：用于标注一个 Activity 组件。
• @Layout：用于指定 Activity 的布局资源。
• @Inject：用于标注字段或构造器，以实现依赖注入。
• @View：用于标注视图组件的注入。
• @Resource：用于标注资源类型的注入。
• @OnCreate：用于标注在 Activity 创建时调用的事件方法。

更多 API 使用详情，请参考项目官方文档。

4. 项目安装方式

项目安装方式已在安装指南中详细说明，请参考上述 Maven 或 Gradle 安装步骤。