Hilt 组件作用域基础：@Singleton、@ActivityScoped、@FragmentScoped、@ViewModelScoped

Hilt 的作用域注解用于限定依赖对象的生命周期，让对象与特定的 Android 组件（Application、Activity、Fragment、ViewModel）保持绑定。正确使用作用域可以控制对象创建次数、避免内存泄漏，并让依赖图与组件树对齐。

原理：Hilt 组件层次与作用域

Hilt 按 Android 组件层级创建了对应的 DI 组件：SingletonComponent、ActivityComponent、FragmentComponent、ViewModelComponent。每个组件都有明确的父级关系和生命周期。作用域注解将绑定限制在所属组件内部，子组件可以访问父组件提供的依赖，但父组件无法访问子组件的绑定。

实现流程：定义绑定并指定作用域

1. 在 @Module 中使用 @Provides 或 @Binds 定义依赖，并用作用域注解标记方法。
2. 通过 @InstallIn 将模块安装到对应组件中（作用域必须与组件匹配）。
3. 在目标 @AndroidEntryPoint 类中使用 @Inject 字段或构造注入。
4. 构建项目，Hilt 生成对应组件类，作用域生效。

代码示例

Singleton 作用域（AppModule）

@Module
@InstallIn(SingletonComponent.class)
public class AppModule {
    @Provides
    @Singleton
    public BluetoothManager provideBluetoothManager(@ApplicationContext Context context) {
        return (BluetoothManager) context.getSystemService(Context.BLUETOOTH_SERVICE);
    }
}

Activity 作用域（ActivityModule）

@Module
@InstallIn(ActivityComponent.class)
public class ActivityModule {
    @Provides
    @ActivityScoped
    public BleScanner provideBleScanner(BluetoothLeScanner scanner) {
        return new BleScanner(scanner);
    }
}

Fragment 作用域（FragmentModule）

@Module
@InstallIn(FragmentComponent.class)
public class FragmentModule {
    @Provides
    @FragmentScoped
    public GattCallback provideGattCallback() {
        return new GattCallback();
    }
}

ViewModel 作用域（ViewModel 中使用）

@HiltViewModel
public class BleViewModel extends ViewModel {
    private final BleScanner scanner;

    @Inject
    public BleViewModel(BleScanner scanner) {
        this.scanner = scanner;
    }

    // ViewModel 本身已经是 ViewModelComponent 的子组件
    // 这里注入的 scanner 如果标记了 @ViewModelScoped，则与 ViewModel 同生命周期
}

常见错误与调试

// 错误示例：@Singleton 绑定安装在 ActivityComponent
@Module
@InstallIn(ActivityComponent.class)
public class WrongModule {
    @Provides
    @Singleton          // 编译错误：作用域不匹配
    public MyService provideService() { ... }
}
// 报错信息：@Singleton 无法应用于 ActivityComponent

性能与稳定性优化