플러터:데이터 저장(간단한 데이터) - 편집 역사

Sam: /* Hive로 데이터 유지하기 */

2026-01-07T02:58:39Z

Hive로 데이터 유지하기

← 이전 판		2026년 1월 7일 (수) 02:58 판
56번째 줄:		56번째 줄:

	=== 전체 코드 ===		=== 전체 코드 ===
	<syntaxhighlight lang="dart">import 'package:flutter/material.dart';		가장 기본 예제인 카운팅 앱을 변형한 것.

			참고: 브라우저로 실행하면 켤 때마다 다른 port로 실행되는데, 이는 전혀 다른 웹페이지를 연 것으로 인식되어 저장된 데이터를 사용하지 못한다. 다만, f5로 초기화 하면 기존 코드에선 카운팅이 0부터 시작되었던 반면, Hive를 쓴 경우 저장되어 있던 숫자 그대로 활용할 수 있다.<syntaxhighlight lang="dart">import 'package:flutter/material.dart';
	import 'package:hive_flutter/hive_flutter.dart';		import 'package:hive_flutter/hive_flutter.dart';

Sam: /* 개요 */

2026-01-07T02:46:32Z

개요

← 이전 판		2026년 1월 7일 (수) 02:46 판
5번째 줄:		5번째 줄:

	이 문서에선 Hive를 이용한 로컬 DB 기반 데이터 저장에 대해 다룬다.		이 문서에선 Hive를 이용한 로컬 DB 기반 데이터 저장에 대해 다룬다.

			SharedPreferences 등 '키:값' 방식의 간단한 저장방식도 있지만, 규모가 조금만 커져도 DB 저장방식에 밀린다.

	=== Hive의 특징 ===		=== Hive의 특징 ===
49번째 줄:		51번째 줄:
	== Hive로 데이터 유지하기 ==		== Hive로 데이터 유지하기 ==
	=== 준비 ===		=== 준비 ===
	<syntaxhighlight lang="yaml">		pubspec.yaml 설정<syntaxhighlight lang="yaml">dependencies:
	dependencies:
	hive: ^2.2.3		hive: ^2.2.3
	hive_flutter: ^1.1.0		hive_flutter: ^1.1.0</syntaxhighlight>파일 변경 이후 flutter pub get
	</syntaxhighlight>

	=== 전체 코드 ===		=== 전체 코드 ===

2025년 11월 26일 (수) 02:29에 Sam님의 편집

2025-11-26T02:29:16Z

← 이전 판		2025년 11월 26일 (수) 02:29 판
30번째 줄:		30번째 줄:
	\|iOS		\|iOS
	\|Application/<UUID>/Documents/hive/		\|Application/<UUID>/Documents/hive/
			(앱 UUID는 설치할 때마다 달라짐)
	\|		\|
	* 앱 내부 전용 저장 공간		* 앱 내부 전용 저장 공간
40번째 줄:		41번째 줄:
	\|-		\|-
	\|브라우저		\|브라우저
	\|~~브라우저 로컬 저장소 사용~~.		\|파일이 아닌, IndexedDB 내부에 저장됨.
			(Chrome 기준: 개발자도구 → Application → IndexedDB)
	F5 눌러도 저장된 값이 그대로 유지된다.		F5 눌러도 저장된 값이 그대로 유지된다.
	\|(dart에서 작성한 <code>box</code>, <code>decibelBox</code> 등이 그대로 DB 이름이 됨)		\|(dart에서 작성한 <code>box</code>, <code>decibelBox</code> 등이 그대로 DB 이름이 됨)
60번째 줄:		62번째 줄:
	WidgetsFlutterBinding.ensureInitialized();		WidgetsFlutterBinding.ensureInitialized();
	await Hive.initFlutter();		await Hive.initFlutter();
	await Hive.openBox('box'); // 'box'라는 이름으로 열기.		await Hive.openBox('box'); // 'box'라는 이름으로 열기. Hive의 Box는 작은 데이터베이스 하나라고 생각하면 됨.
	runApp(MyApp());		runApp(MyApp());
	}		}

Sam: /* Hive 저장 위치 */

2025-11-26T02:27:01Z

Hive 저장 위치

← 이전 판		2025년 11월 26일 (수) 02:27 판
34번째 줄:		34번째 줄:
	* 앱 종료 후에도 유지		* 앱 종료 후에도 유지
	* 앱 삭제 시 같이 삭제		* 앱 삭제 시 같이 삭제
			\|-
			\|Windows
			\|%APPDATA%\<앱폴더>\hive
			\|예시: C:\Users\<사용자>\AppData\Roaming\com.example.myapp\hive\
			\|-
			\|브라우저
			\|브라우저 로컬 저장소 사용.
			F5 눌러도 저장된 값이 그대로 유지된다.
			\|(dart에서 작성한 <code>box</code>, <code>decibelBox</code> 등이 그대로 DB 이름이 됨)
	\|}		\|}

42번째 줄:		51번째 줄:
	hive: ^2.2.3		hive: ^2.2.3
	hive_flutter: ^1.1.0		hive_flutter: ^1.1.0

	~~dev_dependencies:~~
	~~hive_generator: ^2.0.0~~
	~~build_runner: ^2.4.0~~
	</syntaxhighlight>		</syntaxhighlight>

55번째 줄:		60번째 줄:
	WidgetsFlutterBinding.ensureInitialized();		WidgetsFlutterBinding.ensureInitialized();
	await Hive.initFlutter();		await Hive.initFlutter();
	await Hive.openBox('box'); // ~~단일 박스~~ 열기		await Hive.openBox('box'); // 'box'라는 이름으로 열기.
	runApp(MyApp());		runApp(MyApp());
	}		}
69번째 줄:		74번째 줄:

	@override		@override
	void initState() {		void initState() { // 앱 시작 시 초기화
	super.initState();		super.initState();
	count = box.get('count', defaultValue: 0); // 저장된 값 불러오기		count = box.get('count', defaultValue: 0); // 저장된 값 불러오기

2025년 11월 26일 (수) 02:13에 Sam님의 편집

2025-11-26T02:13:35Z

← 이전 판		2025년 11월 26일 (수) 02:13 판
4번째 줄:		4번째 줄:
	Flutter에서 화면을 이동하거나 앱을 재시작해도 데이터를 유지하려면 상태 관리와 로컬 저장 방법을 이해해야 한다.		Flutter에서 화면을 이동하거나 앱을 재시작해도 데이터를 유지하려면 상태 관리와 로컬 저장 방법을 이해해야 한다.

	~~Hive는 빠르고 강력한~~ 로컬 ~~데이터베이스로, 여러 개의 데이터나 구조화된 모델을 저장하기에 적합하다.~~		이 문서에선 Hive를 이용한 로컬 DB 기반 데이터 저장에 대해 다룬다.
	~~SharedPreferences보다 성능이 뛰어나고, 대량~~ 데이터~~(수백~수천 개) 저장에도 안정적이다~~.

	=== Hive의 특징 ===		=== Hive의 특징 ===
	* 매우 빠름 (binary 기반)		* 매우 빠름 (binary 기반)
	* 리스트, Map, 객체까지 저장 가능		* 리스트, Map, 객체까지 저장 가능(클래스 형태도 저장)
	* 앱 재시작 후에도 유지됨
	* 오프라인 DB 역할 수행		* 오프라인 DB 역할 수행
	* iOS/Android 모두 지원		* iOS/Android 모두 지원
			* 수백~수천 개 데이터 저장해도 빠름

	== Hive 저장 위치 ==		=== Hive 저장 위치 ===
	{\| class="wikitable"		{\| class="wikitable"
	\|+		\|+
38번째 줄:		37번째 줄:

	== Hive로 데이터 유지하기 ==		== Hive로 데이터 유지하기 ==
	~~숫자, 문자열, 리스트, 객체 등 다양한 구조를 저장 가능.~~

	=== 준비 ===		=== 준비 ===
	<syntaxhighlight lang="yaml">		<syntaxhighlight lang="yaml">
51번째 줄:		48번째 줄:
	</syntaxhighlight>		</syntaxhighlight>

	=== ~~초기화~~ ===		=== 전체 코드 ===
	~~App 시작 시 Hive 초기화 필요~~.		<syntaxhighlight lang="dart">import 'package:flutter/material.dart';
			import 'package:hive_flutter/hive_flutter.dart';

	~~<syntaxhighlight lang="dart">~~
	void main() async {		void main() async {
	WidgetsFlutterBinding.ensureInitialized();		WidgetsFlutterBinding.ensureInitialized();
	await Hive.initFlutter();		await Hive.initFlutter();
	await Hive.openBox('~~decibelBox~~');		await Hive.openBox('box'); // 단일 박스 열기
	runApp(MyApp());		runApp(MyApp());
	}		}
	~~</syntaxhighlight>~~

	~~=== 저장하기 ===~~		class MyApp extends StatefulWidget {
	<~~syntaxhighlight lang="dart"~~>		@override
	~~var box = Hive.box~~(~~'decibelBox'~~);		State<MyApp> createState() => _MyAppState();
	~~box.put~~(~~'decibel', 85.0~~);		}
	~~</syntaxhighlight>~~
	* `'decibel'` key에 85 저장
	* Hive는 binary 저장 형식이라 빠르고 안정적임

	~~=== 불러오기 ===~~		class _MyAppState extends State<MyApp> {
	<~~syntaxhighlight lang="dart"~~>		final box = Hive.box('box');
	~~var~~ box = Hive.box('~~decibelBox~~');		int count = 0;
	~~double decibel~~ = ~~box.get('decibel', defaultValue: 0.~~0);
	~~</syntaxhighlight>~~

	~~== 왜 Hive를 사용하는가? ==~~		@override
	~~=== SharedPreferences 단점 ===~~		void initState() {
	* 단순 key-value만 저장 가능		super.initState();
	* XML 기반 → 속도 느림		count = box.get('count', defaultValue: 0); // 저장된 값 불러오기
	* 데이터가 많아지면 성능 급격히 저하		}
	* 구조화된 데이터 저장 어려움

	~~=== Hive 장점 ===~~		void increase() {
	* 구조화된 데이터 저장 가능 (~~클래스 형태도 저장~~)		setState(() {
	* 수백~수천 개 데이터 저장해도 빠름		count++;
	* 로컬 DB처럼 사용 가능		box.put('count', count); // 저장
	* 대량 데이터 + ~~리스트~~ + 정렬/~~삭제 필요할 때 적합~~		});
			}

	~~== 결론 ==~~		@override
	* 단순 앱 설정값 → SharedPreferences 가능		Widget build(BuildContext context) {
	* 여러 개의 기록, ~~리스트~~, 구조화된 데이터 → Hive 사용이 정답		return MaterialApp(
			home: Scaffold(
			appBar: AppBar(title: Text("Hive 초간단 예제")),
			body: Center(child: Text("$count", style: TextStyle(fontSize: 40))),
			floatingActionButton: FloatingActionButton(
			onPressed: increase,
			child: Icon(Icons.add),
			),
			),
			);
			}
			}
			</syntaxhighlight>

2025년 11월 26일 (수) 02:10에 Sam님의 편집

2025-11-26T02:10:13Z

← 이전 판		2025년 11월 26일 (수) 02:10 판
4번째 줄:		4번째 줄:
	Flutter에서 화면을 이동하거나 앱을 재시작해도 데이터를 유지하려면 상태 관리와 로컬 저장 방법을 이해해야 한다.		Flutter에서 화면을 이동하거나 앱을 재시작해도 데이터를 유지하려면 상태 관리와 로컬 저장 방법을 이해해야 한다.

	~~SharedPreferences를 사용하여 간단한 key에 값을 저장하는 방법에 대해 다룬다~~. 대량 데이터 ~~저장엔 적합하지 않음~~.		Hive는 빠르고 강력한 로컬 데이터베이스로, 여러 개의 데이터나 구조화된 모델을 저장하기에 적합하다.
			SharedPreferences보다 성능이 뛰어나고, 대량 데이터(수백~수천 개) 저장에도 안정적이다.

	=== ~~저장위치~~ ===		=== Hive의 특징 ===
			* 매우 빠름 (binary 기반)
			* 리스트, Map, 객체까지 저장 가능
			* 앱 재시작 후에도 유지됨
			* 오프라인 DB 역할 수행
			* iOS/Android 모두 지원

			== Hive 저장 위치 ==
	{\| class="wikitable"		{\| class="wikitable"
	\|+		\|+
13번째 줄:		21번째 줄:
	!비고		!비고
	\|-		\|-
	\|~~안드로이~~		\|안드로이드
	\|/data/data/<패키지명>/~~shared_prefs~~/~~<파일명>.xml~~		\|/data/data/'''<패키지명>'''/files/hive/
	\|		\|
	* ~~이 경로는~~ 앱만 접근 가능		* 앱만 접근 가능
	* ~~사용자가~~ 파일 ~~앱으로 볼 수 없음~~		* 파일 앱에서 보이지 않음
	* ~~앱을 삭제하면 같이~~ 삭제됨		* 앱 삭제 시 데이터도 삭제됨
	* ~~앱을 종료하거나~~ 재부팅해도 ~~파일은 그대로 있음~~		* 앱 종료/재부팅해도 유지됨
	\|-		\|-
	\|iOS		\|iOS
	\|~~Library/Preferences~~/<~~bundle_identifier~~>~~.plist~~		\|Application/<UUID>/Documents/hive/
	\|		\|
	* 앱 내부 전용 저장 공간		* 앱 내부 전용 저장 공간
	* 앱 종료 후에도 유지		* 앱 종료 후에도 유지
	* 앱 삭제 시 같이 삭제		* 앱 삭제 시 같이 삭제
	\|-
	\|
	\|
	\|
	\|}		\|}

	== ~~앱 재시작 후에도~~ 데이터 ~~유지(SharedPreferences)~~ ==		== Hive로 데이터 유지하기 ==
	~~간단한~~ 숫자, 문자열, ~~bool~~ 저장 가능.		숫자, 문자열, 리스트, 객체 등 다양한 구조를 저장 가능.

	=== 준비 ===		=== 준비 ===
	<syntaxhighlight lang="yaml">		<syntaxhighlight lang="yaml">
	dependencies:		dependencies:
	~~shared_preferences~~: ^2.1.1		hive: ^2.2.3
			hive_flutter: ^1.1.0

			dev_dependencies:
			hive_generator: ^2.0.0
			build_runner: ^2.4.0
			</syntaxhighlight>

			=== 초기화 ===
			App 시작 시 Hive 초기화 필요.

			<syntaxhighlight lang="dart">
			void main() async {
			WidgetsFlutterBinding.ensureInitialized();
			await Hive.initFlutter();
			await Hive.openBox('decibelBox');
			runApp(MyApp());
			}
	</syntaxhighlight>		</syntaxhighlight>

	=== 저장하기 ===		=== 저장하기 ===
	<syntaxhighlight lang="dart">		<syntaxhighlight lang="dart">
	~~final prefs~~ = ~~await SharedPreferences~~.~~getInstance~~();		var box = Hive.box('decibelBox');
	~~await prefs~~.~~setDouble~~('decibel', 85);		box.put('decibel', 85.0);
	</syntaxhighlight>		</syntaxhighlight>
	* `'decibel'` key에 85 저장		* `'decibel'` key에 85 저장
	* ~~“기본값 85” 의미가 아니라, 지금 저장하는 값~~		* Hive는 binary 저장 형식이라 빠르고 안정적임

	=== 불러오기 ===		=== 불러오기 ===
	<syntaxhighlight lang="dart">		<syntaxhighlight lang="dart">
	double decibel = ~~prefs~~.~~getDouble~~('decibel') ~~?? 0~~;		var box = Hive.box('decibelBox');
			double decibel = box.get('decibel', defaultValue: 0.0);
	</syntaxhighlight>		</syntaxhighlight>
	* ~~저장된 값이 없으면 null 반환~~
	* ~~null일 경우 안전하게 0으로 사용~~ (~~`?? 0`~~)		== 왜 Hive를 사용하는가? ==
			=== SharedPreferences 단점 ===
			* 단순 key-value만 저장 가능
			* XML 기반 → 속도 느림
			* 데이터가 많아지면 성능 급격히 저하
			* 구조화된 데이터 저장 어려움

			=== Hive 장점 ===
			* 구조화된 데이터 저장 가능 (클래스 형태도 저장)
			* 수백~수천 개 데이터 저장해도 빠름
			* 로컬 DB처럼 사용 가능
			* 대량 데이터 + 리스트 + 정렬/삭제 필요할 때 적합

			== 결론 ==
			* 단순 앱 설정값 → SharedPreferences 가능
			* 여러 개의 기록, 리스트, 구조화된 데이터 → Hive 사용이 정답

Sam: /* 1. 화면 내 상태 유지 (StatefulWidget) */

2025-11-26T02:09:06Z

1. 화면 내 상태 유지 (StatefulWidget)

차이 보기

Sam: 새 문서: {{플러터}} == 개요 == Flutter에서 화면을 이동하거나 앱을 재시작해도 데이터를 유지하려면 상태 관리와 로컬 저장 방법을 이해해야 합니다. 이 문서에서는 데시벨 슬라이더 예제를 통해 상태 유지 방법을 단계별로 학습합니다. --- == 1. 화면 내 상태 유지 (StatefulWidget) == === 예제 코드 === class DecibelPage extends StatefulWidget { @override _DecibelPageStat...

2025-11-26T01:29:52Z

새 문서: {{플러터}} == 개요 == Flutter에서 화면을 이동하거나 앱을 재시작해도 데이터를 유지하려면 상태 관리와 로컬 저장 방법을 이해해야 합니다. 이 문서에서는 데시벨 슬라이더 예제를 통해 상태 유지 방법을 단계별로 학습합니다. --- == 1. 화면 내 상태 유지 (StatefulWidget) == === 예제 코드 === <syntaxhighlight lang="dart"> class DecibelPage extends StatefulWidget { @override _DecibelPageStat...

새 문서

{{플러터}}

== 개요 ==
Flutter에서 화면을 이동하거나 앱을 재시작해도 데이터를 유지하려면 상태 관리와 로컬 저장 방법을 이해해야 합니다.
이 문서에서는 데시벨 슬라이더 예제를 통해 상태 유지 방법을 단계별로 학습합니다.

---

== 1. 화면 내 상태 유지 (StatefulWidget) ==

=== 예제 코드 ===
<syntaxhighlight lang="dart">
class DecibelPage extends StatefulWidget {
@override
_DecibelPageState createState() => _DecibelPageState();
}

class _DecibelPageState extends State<DecibelPage> {
double currentValue = 0;

@override
Widget build(BuildContext context) {
return Scaffold(
body: Slider(
min: 0,
max: 120,
value: currentValue,
onChanged: (value) {
setState(() {
currentValue = value;
});
},
),
);
}
}
</syntaxhighlight>

=== 특징 ===
* 화면 내에서만 값 유지
* 다른 화면으로 이동하면 값 초기화

---

== 2. 화면 간 상태 공유 (Provider) ==

=== 준비 ===
<syntaxhighlight lang="yaml">
dependencies:
provider: ^6.0.0
</syntaxhighlight>

=== 예제 코드 ===
<syntaxhighlight lang="dart">
class DecibelModel extends ChangeNotifier {
double value = 0;

void setValue(double v) {
value = v;
notifyListeners();
}
}

void main() {
runApp(
ChangeNotifierProvider(
create: (_) => DecibelModel(),
child: MyApp(),
),
);
}

// 슬라이더 연결
Slider(
min: 0,
max: 120,
value: context.watch<DecibelModel>().value,
onChanged: (v) => context.read<DecibelModel>().setValue(v),
)
</syntaxhighlight>

=== 특징 ===
* 앱이 켜져 있는 동안 값 유지
* 여러 화면에서 값 공유 가능

---

== 3. 앱 재시작 후에도 데이터 유지 (SharedPreferences) ==

=== 준비 ===
<syntaxhighlight lang="yaml">
dependencies:
shared_preferences: ^2.1.1
</syntaxhighlight>

=== 저장하기 ===
<syntaxhighlight lang="dart">
final prefs = await SharedPreferences.getInstance();
await prefs.setDouble('decibel', 85);
</syntaxhighlight>
* `'decibel'` key에 85 저장
* “기본값 85” 의미가 아니라, 지금 저장하는 값

=== 불러오기 ===
<syntaxhighlight lang="dart">
double decibel = prefs.getDouble('decibel') ?? 0;
</syntaxhighlight>
* 저장된 값이 없으면 null 반환
* null일 경우 안전하게 0으로 사용 (`?? 0`)

=== 특징 ===
* 앱 재시작 후에도 값 유지
* 간단한 숫자, 문자열, bool 저장 가능

---

== 4. 실습 순서 추천 ==
# StatefulWidget으로 슬라이더 만들기
# Provider로 화면 전환 후 값 유지 확인
# SharedPreferences로 앱 재시작 후 값 유지 확인

---

== 5. 핵심 포인트 ==
* `setDouble` → 저장하는 값
* `getDouble ?? 기본값` → 값이 없을 때 사용할 안전한 기본값
* 상태 관리 없이 단순 화면 전환만 하면 값 초기화
* Provider, Riverpod 등 상태 관리 라이브러리를 사용하면 화면 간 공유 가능
* SharedPreferences, Hive 등 로컬 저장을 활용하면 앱 종료 후에도 값 유지 가능