시크릿 갤러리 앱

secret_gallery/ ├── lib/ │ ├── main.dart # 앱 진입점 · 다크 테마 설정 │ ├── models/ │ │ ├── album.dart # Album 데이터 모델 │ │ └── photo.dart # Photo 데이터 모델 │ ├── services/ │ │ ├── auth_service.dart # 앱/앨범 비밀번호 인증 │ │ ├── db_service.dart # SQLite CRUD (앨범·사진) │ │ ├── file_service.dart # 이미지 파일 복사·삭제 │ │ └── share_service.dart # 사진 공유 │ └── pages/ │ ├── lock_page.dart # 앱 잠금 화면 (PIN 입력/설정) │ ├── album_list_page.dart # 앨범 목록 화면 │ ├── photo_list_page.dart # 앨범 내 사진 목록 화면 │ ├── gallery_picker_page.dart# 기기 갤러리 피커 화면 │ ├── photo_detail_page.dart # 사진 상세·편집 화면 │ └── settings_page.dart # 설정 화면 ├── guide/ # 강의 노트 문서 폴더 └── pubspec.yaml

flutter create secret_gallery cd secret_gallery

flutter pub add path_provider path sqflite image_picker shared_preferences share_plus permission_handler photo_manager flutter_reorderable_grid_view

dependencies: flutter: sdk: flutter path_provider: ^2.1.0 # 내부 저장소 경로 path: ^1.9.0 # 경로 문자열 조합 sqflite: ^2.3.3 # SQLite 데이터베이스 image_picker: ^1.1.2 # 갤러리/카메라 피커 (보조) shared_preferences: ^2.3.0 # 앱 PIN 저장 share_plus: ^10.1.4 # 사진 공유 permission_handler: ^11.3.0 # 갤러리 권한 요청 photo_manager: ^3.0.0 # 인앱 갤러리 피커 flutter_reorderable_grid_view: ^5.6.0 # 드래그 순서 변경 그리드

lib/ ├── models/ ← Album, Photo 모델 ├── services/ ← DB·인증·파일·공유 서비스 └── pages/ ← 각 화면

void main() { runApp(const MainApp()); } class MainApp extends StatelessWidget { const MainApp({super.key}); @override Widget build(BuildContext context) { return MaterialApp( title: '시크릿 갤러리', debugShowCheckedModeBanner: false, theme: ThemeData.dark(), // 전체 다크 테마 home: const LockPage(), // 앱 시작 = 잠금 화면 ); } }

class Album { final int? id; final String name; final String type; // 'normal' | 'secret' final String? password; // 비밀 앨범일 때만 존재 final int sortOrder; }

class Photo { final int? id; final int albumId; // 소속 앨범 FK final String path; // 내부 저장소 절대 경로 final String? title; // 사용자가 지정한 제목 final String? memo; // 사용자가 입력한 메모 final String createdAt; // ISO 8601 문자열 final int sortOrder; }

CREATE TABLE albums ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, type TEXT NOT NULL, -- 'normal' | 'secret' password TEXT, sort_order INTEGER NOT NULL DEFAULT 0 ); CREATE TABLE photos ( id INTEGER PRIMARY KEY AUTOINCREMENT, album_id INTEGER NOT NULL, path TEXT NOT NULL, title TEXT, memo TEXT, created_at TEXT NOT NULL, sort_order INTEGER NOT NULL DEFAULT 0 );

1. initState → hasAppPassword() 확인 - 없으면 _isSettingMode = true (PIN 설정 화면) - 있으면 PIN 입력 화면 2. _onSubmit() - 설정 모드: setAppPassword() → AlbumListPage 이동 - 입력 모드: checkAppPassword() → 맞으면 이동, 틀리면 오류 메시지

1. _loadAlbums() → DB에서 앨범 목록 조회 2. _buildNormalGrid() → GridView.builder + 앨범 카드 3. 다중 선택 모드 → Set<int> + 드래그 선택(Listener + RenderBox hit test) 4. 정렬 팝업 → PopupMenuButton<_SortType> 5. 순서 변경 모드 → ReorderableBuilder + DB sort_order 업데이트 6. 앨범 생성 다이얼로그 → StatefulBuilder (비밀 앨범 토글 연동) 7. 비밀 앨범 진입 → 비밀번호 다이얼로그 → AuthService.checkAlbumPassword() 8. 검색 모드 → AppBar TextField → _searchQuery 필터링

1. _loadPhotos() → DB에서 앨범 내 사진 조회 2. 그리드 뷰 → GridView.builder + Hero 태그 3. _addPhoto() → GalleryPickerPage → FileService.saveImage() → DB 저장 4. 다중 선택·삭제·공유 → Set<int> + Share.shareXFiles() 5. 정렬 / 순서 변경 → AlbumListPage와 동일 패턴

1. permission_handler 권한 요청 (Android 버전별 분기) 2. photo_manager로 전체 사진 목록 로드 3. GridView.builder + 썸네일 (AssetEntityImage) 4. 탭으로 다중 선택 → Set<AssetEntity> 5. 확인 버튼 → Navigator.pop(context, _selected.toList())

1. Hero 애니메이션으로 이미지 전환 2. 제목·메모 TextField 3. _saveMetadata() → DB.updatePhotoMeta() 4. _sharePhoto() → ShareService.sharePhoto()

1. 앱 비밀번호 변경: 현재 PW 확인 → 새 PW 입력 → 확인 → setAppPassword()

final visual = await Permission.photos.request(); if (visual.isGranted || visual.isLimited) return true; final imgStatus = await Permission.mediaLibrary.request(); if (imgStatus.isGranted) return true; final storage = await Permission.storage.request(); return storage.isGranted;

PopupMenuButton<_SortType>( color: Colors.grey[850], // ← 명시적 배경색 설정 ... )

body: _sortType == _SortType.custom ? _buildReorderableGrid() : _buildNormalGrid(),