JHenTai

English | 简体中文 | 한국어

Q&A

개요

Android & iOS & Windows & MacOS & Linux를 지원하는 E-Hentai 애플리케이션.

아직 개발 중입니다. 오류 제보나 기능 요청은 언제나 환영합니다.

다운로드 & 설치

Android 설치: 사용자의 디바이스 아키텍처에 맞는 .apk 파일을 다운로드 후 설치하세요.

• arm64-v8a：8세대 ARM 프로세서를 탑재한 안드로이드 폰에 해당됨(일반적인 선택)
• armeabiv-v7a：7세대 ARM 프로세서를 탑재한 안드로이드 폰에 해당됨
• x86_64：희귀함

iOS 설치: AltStore나 SideLoadly를 이용해 .ipa 파일을 다운로드하고 접속하세요.

Windows 설치: download Windows_xxx.zip 파일을 다운로드하고 압축 해제를 하세요. 만약 프록시 서버를 이용한다면 네트워크 설정에서 프록시 주소를 설정해 주세요. Windows 11을 사용하는데 앱 실행이 되지 않는다면 호환성 모드를 켠 상태에서 실행해 보세요. Windows Defender에 차단된 경우라면 허용으로 바꿔주세요.

MacOS 설치(지원 중지): .dmg 파일을 다운로드합니다. 만약 프록시 서버를 이용한다면 네트워크 설정에서 프록시 주소를 설정해 주세요.

Linux 설치(지원 중지): Linux_xxx.zip 파일을 다운로드하고 압축 해제를 하세요. 만약 프록시 서버를 이용한다면 네트워크 설정에서 프록시 주소를 설정해 주세요.

Fedora 기반 dnf Linux 배포판:

sudo rpm --import https://meeks233.github.io/Jhentai-rpm/fedora/RPM-GPG-KEY-jhentai
sudo curl -fsSL -o /etc/yum.repos.d/jhentai.repo https://meeks233.github.io/Jhentai-rpm/fedora/jhentai.repo
sudo dnf install -y jhentai

개발 동기

저의 첫 Flutter 프로젝트입니다. 저는 개발 중에 Flutter에 익숙해지는 것을 목표로 합니다. 제가 사용하는 기기는 Android 폰, iPad, Windows 컴퓨터입니다. 기존 E-hentai 앱들은 버그가 있고, Android, iOS의 개발 경험이 없어서 소스 코드를 이해할 수도 없어서 JHenTia를 제 첫 Flutter 프로젝트로 정했습니다.

2022.08.20 JHenTai는 5개월의 개발 기간을 거치며 점점 견고해졌고 초기 단계에서 작성된 갤러리 페이지, 보기 페이지, 다운로드 등의 일부 코드를 완전히 리팩토링했습니다. 새로운 기능 개발에 도움이 되도록 서로 다른 페이지와 스타일 간의 공통점을 추출해 결합을 줄이도록 노력했습니다. 코딩 스타일, 디자인 패턴 등 Flutter 개발에 관한 조언을 해주시거나 JHenTai 개발에 참여해 주시면 정말 감사하겠습니다.

2022.10.29 저는 이제 기본적인 Flutter 개발에 더 익숙해졌고 앞으로는 다른 영역에 집중할 것입니다. 그래서 JHenTai의 업데이트는 전보다는 줄어들겠지만 버그나 오류는 제때 처리하겠습니다.

참조 & 감사의 말씀

레이아웃과 스타일 참조:

• FEhviewer : 메인
• EHPanda
• EHViewer

태그 번역:

• EhTagTranslation

Tag order optimization:

• e-hentai-db
• e-hentai-tag-count
• EhSyringe

앱 번역:

• andyching168 kenny03211 NeKoOuO 繁體中文(台灣)
• lucas-04 Português brasileiro
• qlife1146 한국어
• bropines Russian

위의 프로젝트와 인원에게 감사드립니다🙇‍

스크린샷

모바일 레이아웃

태블릿 레이아웃

데스크톱 레이아웃

갤러리 & 검색

갤러리 세부 정보

설정 & 다운로드

보기

주 기능

• 모바일, 태블릿, 데스크톱 레이아웃(세 종류)
• 가로, 세로 각각 두 쪽 레이아웃(네 종류)
• 갤러리 페이지, 인기 있음, 즐겨찾기, 본 적 있음, 기록에 서로 다른 갤러리 목록 스타일 지원
• 검색, 검색 추천, 태그를 눌러 검색, 파일 검색, 특정 페이지로 이동
• 온라인 보기 및 다운롣, 다운로드 작업 복원 지원, 업로더가 새로운 버전을 업로드했을 때 업데이트 동기화 지원
• 아카이브 다운로드, 자동 압축 해제 후 보기
• 로컬 이미지 불러오기 및 보기 지원
• 다운로드 작업 우선순위 수동 지정 지원
• 갤러리 및 아카이브에 그룹 설정 지원
• 즐겨찾기, 점수, 토렌트, 아카이브, 통계, 공유
• 암호 로그인, 쿠키 로그인, 웹 로그인
• EX 사이트 지원(도메인 프론팅은 선택사항)
• 태그 추천/비추천, 태그 강조/숨김
• 댓글, 댓글 추천
• 지문 잠금 해제

번역

언어 코드

지역 코드

1. /lib/src/l18n/en_US.dart를 복사 후 이름을 {사용자의_언어_코드}_{사용자의_지역_코드}.dart로 바꾸세요
2. 새 파일의 클래스명을 바꾸세요(선택 사항)
3. 메서드 keys에서 k-v 쌍을 수정하고, 값을 사용자 언어로 번역하세요

여기까지 한 후에 풀 리퀘스트를 제출하시면 나머지 작업은 제가 합니다. 아니면 다음 사항을 계속 진행하셔도 됩니다:

1. /lib/src/l18n/locale_text.dart에 들어간 후, 새로운 k-v 쌍을 메서드 keys에 추가하세요. => {사용자의_언어_코드}_{사용자의_지역_코드} : {사용자의_클래스명}.keys()
2. Enter /lib/src/consts/locale_consts.dart에 들어간 후, localeCode2Description 속성에 새로운 k-v 쌍을 추가하세요 : {사용자의_언어_코드}_{사용자의_지역_코드} : {언어 설명} 형식으로 사용자 언어의 설명을 작성하세요.

컴파일 정보

1. Android 서명을 직접 관리하려면 다음 사이트를 확인하세요: https://docs.flutter.dev/deployment/android#signing-the-app

코드 기여 안내

1. 브랜치 이름에 대한 고정된 요구 사항은 없습니다. 로컬 master 브랜치에서 수정한 후 PR을 제출하시면 됩니다.
2. 변경 규모가 크거나 여러 모듈 간의 상호작용이 포함되는 경우, 코드 리뷰 능력이 없는 개발자가 Vibe Coding으로 작성한 코드는 받아들이지 않습니다. 이러한 코드는 프로젝트의 기존 코딩 규칙을 따르지 않는 경우가 많고, 코드 확장성에 큰 해를 끼치며, 정확성도 보장되지 않습니다.
3. 하나의 PR은 최소한의 기능 단위에 집중해야 합니다. 여러 기능이 포함된 경우에는 별도의 PR을 나누어 제출해 주세요.

개발자 문서

데스크톱 플랫폼(Windows/MacOS/Linux)에서는 명령줄 인수로 갤러리 URL을 전달할 수 있어, 외부 소프트웨어가 JHenTai를 리더로 사용하여 특정 갤러리를 바로 열 수 있습니다:

# 실행 시 갤러리 열기
JHenTai.exe -g "https://e-hentai.org/g/1234567/abcdef1234/"
JHenTai.exe --gallery="https://exhentai.org/g/1234567/abcdef1234/"

# 단일 이미지 페이지 URL도 지원
JHenTai.exe -g "https://e-hentai.org/s/abcdef1234/123456-0"

• -g / --gallery <url>: 실행 시 해당 갤러리(또는 이미지 페이지)를 열며, 다른 인수는 무시됩니다. 유효한 URL이 없으면 평소처럼 실행됩니다.
• 비밀번호/생체 인증 잠금이 활성화된 경우, 잠금 해제 후 갤러리가 열립니다.
• MacOS에서는 인수를 전달하려면 app bundle 내부의 실행 파일을 직접 실행해야 합니다, 예: /Applications/JHenTai.app/Contents/MacOS/JHenTai -g <url> (Finder에서 더블클릭 시에는 인수가 전달되지 않습니다).

Dart 주요 종속성

• get: 종속성 관리, 상태 관리, l18n, NoSQL
• dio: 네트워크
• extendedImage: 이미지
• drift: 데이터베이스