Cosmos EPUB은 부드러운 페이지 전환 애니메이션, 텍스트 강조, 하이픈화, 무한 중첩 챕터를 지원하는 기능이 풍부한 플러터 패키지입니다. 이미지 및 오른쪽에서 왼쪽으로 읽는 언어를 처리하며 사용자 정의 테마와 폰트를 제공합니다. 고급 형식과 접근성 기능을 갖춘 몰입형 독서 앱 개발에 적합합니다.
사용 사례
EPUB 형식의 디지털 책 읽기
전자 독서기 애플리케이션 구축
다국어 및 RTL 텍스트 지원
상호작용형 교육 콘텐츠 만들기
텍스트 강조 및 주석 활성화
주요 기능
페이지 플립 애니메이션
텍스트 강조 및 하이픈화
무한히 중첩된 챕터 구조
이미지 및 RTL 언어 지원
사용자 지정 테마 및 글꼴
적합한 대상
전자책 리더
교육 앱
다국어 콘텐츠 플랫폼
접근성 중심 애플리케이션
사용자 정의 가능한 독서 경험
고려 사항
큰 EPUB 파일을 주의 깊게 처리해야 합니다
저사양 기기용 최적화가 필요할 수 있습니다
EPUB 형식만 지원
테마 사용자 정의는 UI 지식이 필요합니다
업데이트를 위해 외부 GitHub 저장소에 의존합니다
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
CosmosEpub 💫
A feature-rich EPUB reader package for Flutter with page flip animations, text highlighting, hyphenation, infinite nested chapters, image support, RTL languages, customizable themes and fonts.
Showcase
Features
Text Highlighting — select text, pick a color (6 options), highlights persist across sessions. Re-highlight to change color. Copy & Select All support.
Hyphenation — syllable-aware word breaking for better justified text. Visible "-" at line breaks. Respects Uzbek digraphs (ch, sh, g', o').
Infinite Nested Chapters — recursive TOC with unlimited depth. Section title pages auto-generated.
// From assetsawaitCosmosEpub.openAssetBook(
assetPath: 'assets/book.epub',
context: context,
bookId: 'my_book_1',
accentColor: Colors.indigoAccent,
onPageFlip: (currentPage, totalPages) {
print('Page $currentPage of $totalPages');
},
onLastPage: (lastPageIndex) {
print('Reached last page');
},
);
// From local fileawaitCosmosEpub.openLocalBook(
localPath: '/path/to/book.epub',
context: context,
bookId: 'my_book_2',
);
// From URLawaitCosmosEpub.openURLBook(
urlPath: 'https://example.com/book.epub',
context: context,
bookId: 'my_book_3',
);
// From bytesawaitCosmosEpub.openFileBook(
bytes: myUint8List,
context: context,
bookId: 'my_book_4',
);
Progress Management
// Get current progressBookProgressModel progress = CosmosEpub.getBookProgress('my_book_1');
print('Chapter: ${progress.currentChapterIndex}');
print('Page: ${progress.currentPageIndex}');
// Set progress manuallyawaitCosmosEpub.setCurrentChapterIndex('my_book_1', 5);
awaitCosmosEpub.setCurrentPageIndex('my_book_1', 3);
// Delete progressawaitCosmosEpub.deleteBookProgress('my_book_1');
awaitCosmosEpub.deleteAllBooksProgress();
Highlight Management
// Get all highlights for a bookList<HighlightModel> highlights = CosmosEpub.getBookHighlights('my_book_1');
// Remove a specific highlightCosmosEpub.removeHighlight(highlights.first.id);
// Remove all highlights for a bookCosmosEpub.removeAllHighlights('my_book_1');
Clear Theme Cache
awaitCosmosEpub.clearThemeCache();
Parameters
Parameter
Type
Default
Description
assetPath / localPath / urlPath / bytes
String / Uint8List
required
EPUB source
context
BuildContext
required
Build context for navigation
bookId
String
required
Unique ID for progress tracking
accentColor
Color
Colors.indigoAccent
Primary accent color
onPageFlip
Function(int, int)?
null
Called on page change
onLastPage
Function(int)?
null
Called on last page
chapterListTitle
String
'Table of Contents'
TOC screen title
shouldOpenDrawer
bool
false
Open TOC on start
starterChapter
int
-1
Start at specific chapter
RTL Language Support 🌍
Automatic detection and support for Right-to-Left languages:
Arabic (العربية), Persian (فارسی), Hebrew (עברית), Urdu (اردو)