이번 글에서는 플러터 앱 개발을 위한 상태 관리 라이브러리인 Riverpod와 로컬 데이터베이스인 Hive를 연동하는 방법에 대해 알아보겠습니다.

1. Riverpod 소개

Riverpod는 플러터 앱 상태 관리를 위한 강력하고 간편한 라이브러리입니다. Provider 패턴을 기반으로 하며, 의존성 주입(Dependency Injection)과 상태 관리를 쉽게 구현할 수 있습니다.

2. Hive 소개

Hive는 플러터 앱에서 경량화된 로컬 데이터베이스로 사용될 수 있는 패키지입니다. NoSQL 데이터베이스로써, JSON 데이터를 저장하고 검색할 수 있습니다. 빠른 성능과 가벼운 구조로 유명합니다.

3. Riverpod와 Hive 연동 방법

3.1. Hive 패키지 추가하기

먼저, pubspec.yaml 파일에 Hive 패키지를 추가해야 합니다. 다음과 같이 dependencies 섹션에 추가해주세요:

dependencies:
  hive: ^2.0.0

3.2. Hive 초기화하기

Hive를 사용하기 위해서는 먼저 Hive를 초기화해야 합니다. main() 함수에서 await Hive.initFlutter()를 호출해 초기화합니다. 다음은 초기화 과정의 예시 코드입니다:

import 'package:flutter/material.dart';
import 'package:hive/hive.dart';
import 'package:hive_flutter/hive_flutter.dart';

void main() async {
  await Hive.initFlutter();
  runApp(MyApp());
}

3.3. 데이터 모델 생성하기

Hive에서 데이터를 저장하기 위해서는 각 데이터 모델에 대한 Hive 어댑터를 생성해야 합니다. Hive 어댑터는 데이터 모델을 Hive에 매핑하는 역할을 합니다. 예를 들어, User 모델을 사용한다고 가정해봅시다:

import 'package:hive/hive.dart';

part 'user.g.dart';

@HiveType(typeId: 0)
class User extends HiveObject {
  @HiveField(0)
  late String name;

  @HiveField(1)
  late int age;
}

여기서 @HiveType 데코레이터는 Hive 타입임을 나타내고, @HiveField 데코레이터는 각 필드가 Hive에서 어떤 인덱스를 가지는지 명시합니다.

3.4. 데이터 저장하기

Hive를 사용하여 데이터를 저장하기 위해서는 다음과 같은 코드를 사용할 수 있습니다:

final box = Hive.box<User>('users');
final user = User()..name = 'John'..age = 25;
box.add(user);

위 코드는 User 모델의 인스턴스를 생성하고, 해당 인스턴스를 Hive의 users 박스에 추가하는 예시입니다.

3.5. 데이터 조회하기

Hive를 사용하여 데이터를 조회하기 위해서는 다음과 같은 코드를 사용할 수 있습니다:

final box = Hive.box<User>('users');
final User user = box.get(index);
print(user.name);  // John
print(user.age);  // 25

위 코드는 users 박스에서 지정한 인덱스에 해당하는 User 모델을 가져오는 예시입니다.

4. 결론

이상으로 플러터 앱 개발에서 Riverpod와 Hive를 연동하는 방법을 알아보았습니다. Riverpod의 간편한 상태 관리와 Hive의 빠른 로컬 데이터베이스 성능을 활용하여 효과적인 앱 개발을 진행할 수 있습니다. 추가적인 내용은 공식 문서를 참고하시길 바랍니다.

• Riverpod 공식 문서
• Hive 공식 문서