# xiaojieonly/ehviewer_cn_sxj architecture

> Architecture diagram of the GitHub repository xiaojieonly/ehviewer_cn_sxj, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xiaojieonly/ehviewer_cn_sxj
- Repository: https://github.com/xiaojieonly/ehviewer_cn_sxj
- Video tour (about a minute): https://gitdiagram.com/xiaojieonly/ehviewer_cn_sxj/video

## Overview

EhViewer is an Android browser for E-Hentai. The user-facing journey is to search or browse galleries, open a gallery and read its images, with downloads available for offline use. The app also documents archive downloads, torrent downloads, local-album import, and Wi-Fi download migration. The tree and excerpts show client/parser, download, and native image-decoding components, but do not expose every UI-to-service call; unverified workflow links are therefore dashed and uncited.

Main entry points: [`app/src/main/java/com/hippo/ehviewer/download/DownloadManager.java`](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/download/DownloadManager.java) (Download manager), [`app/src/main/java/com/hippo/ehviewer/ui/scene/GalleryPreviewsScene.java`](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/scene/GalleryPreviewsScene.java) (Gallery reader), [`app/src/main/java/com/hippo/ehviewer/ui/GalleryActivity.java`](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/GalleryActivity.java) (Gallery detail), [`app/src/main/java/com/hippo/ehviewer/ui/MainActivity.java`](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/MainActivity.java) (Main screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browse["Gallery browsing"]
  node_main["Main screen<br/>[MainActivity.java]"]
  node_search["Quick search"]
  node_gallery["Gallery detail"]
  node_client["E-Hentai client<br/>[EhClient.java]"]
  node_engine["Request engine<br/>[EhEngine.java]"]
  node_parsers["Gallery parsers"]
  node_gallerydata["Gallery data"]
end

subgraph group_download["Download management"]
  node_downloadui["Download screen"]
  node_manager["Download manager"]
  node_downloadservice["Download service<br/>[DownloadService.kt]"]
  node_downloadstate[("Download records<br/>[DownloadInfo.java]")]
  node_archiver["Archive downloads"]
  node_torrent["Torrent downloads"]
end

subgraph group_transfer["Import and transfer"]
  node_wifi["Wi-Fi transfer"]
  node_storage["File access<br/>[UniFile.java]"]
end

subgraph group_media["Image and reading"]
  node_reader["Gallery reader"]
  node_nativeimage["Image decoding<br/>[image.c]"]
  node_gif["GIF decoding<br/>[native-lib.cpp]"]
end

node_user(("Android user"))

node_user -.->|"opens"| node_main
node_main -.->|"navigates"| node_search
node_search -.->|"searches galleries"| node_client
node_client -.->|"dispatches requests"| node_engine
node_engine -.->|"parses responses"| node_parsers
node_parsers -.->|"produces previews"| node_gallerydata
node_gallery -.->|"opens previews"| node_reader
node_reader -.->|"decodes images"| node_nativeimage
node_reader -.->|"decodes GIF"| node_gif
node_user -.->|"manages downloads"| node_downloadui
node_downloadui -.->|"controls queue"| node_manager
node_manager -->|"persists records"| node_downloadstate
node_manager -.->|"ensures service"| node_downloadservice
node_user -.->|"requests archive"| node_archiver
node_gallery -.->|"starts torrent"| node_torrent
node_user -.->|"starts transfer"| node_wifi
node_wifi -.->|"accesses files"| node_storage

click node_main "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/MainActivity.java"
click node_search "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/scene/gallery/list/QuickSearchScene.java"
click node_gallery "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/GalleryActivity.java"
click node_client "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/client/EhClient.java"
click node_engine "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/client/EhEngine.java"
click node_parsers "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/client/parser/GalleryListParser.java"
click node_gallerydata "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/client/data/GalleryPreview.java"
click node_reader "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/scene/GalleryPreviewsScene.java"
click node_nativeimage "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/cpp/jni/image/image.c"
click node_gif "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/cpp/gif/native-lib.cpp"
click node_downloadui "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/fragment/DownloadFragment.java"
click node_manager "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/download/DownloadManager.java"
click node_downloadservice "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/download/DownloadService.kt"
click node_downloadstate "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/dao/DownloadInfo.java"
click node_archiver "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/download/ArchiverDownloadService.kt"
click node_torrent "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/download/DownloadTorrentManager.kt"
click node_wifi "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/wifi/WiFiClientActivity.java"
click node_storage "https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/unifile/UniFile.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_search,node_gallery,node_client,node_engine,node_parsers,node_gallerydata,node_user toneBlue
class node_downloadui,node_manager,node_downloadservice,node_downloadstate,node_archiver,node_torrent toneAmber
class node_wifi,node_storage toneMint
class node_reader,node_nativeimage,node_gif toneRose
```

## Components

### Gallery browsing

- [Main screen](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/MainActivity.java): `app/src/main/java/com/hippo/ehviewer/ui/MainActivity.java`
- [Quick search](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/scene/gallery/list/QuickSearchScene.java): `app/src/main/java/com/hippo/ehviewer/ui/scene/gallery/list/QuickSearchScene.java`
- [Gallery detail](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/GalleryActivity.java): `app/src/main/java/com/hippo/ehviewer/ui/GalleryActivity.java`
- [E-Hentai client](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/client/EhClient.java): `app/src/main/java/com/hippo/ehviewer/client/EhClient.java`
- [Request engine](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/client/EhEngine.java): `app/src/main/java/com/hippo/ehviewer/client/EhEngine.java`
- [Gallery parsers](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/client/parser/GalleryListParser.java): `app/src/main/java/com/hippo/ehviewer/client/parser/GalleryListParser.java`
- [Gallery data](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/client/data/GalleryPreview.java): `app/src/main/java/com/hippo/ehviewer/client/data/GalleryPreview.java`

### Download management

- [Download screen](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/fragment/DownloadFragment.java): `app/src/main/java/com/hippo/ehviewer/ui/fragment/DownloadFragment.java`
- [Download manager](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/download/DownloadManager.java): `app/src/main/java/com/hippo/ehviewer/download/DownloadManager.java`
- [Download service](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/download/DownloadService.kt): `app/src/main/java/com/hippo/ehviewer/download/DownloadService.kt`
- [Download records](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/dao/DownloadInfo.java): `app/src/main/java/com/hippo/ehviewer/dao/DownloadInfo.java`
- [Archive downloads](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/download/ArchiverDownloadService.kt): `app/src/main/java/com/hippo/ehviewer/download/ArchiverDownloadService.kt`
- [Torrent downloads](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/download/DownloadTorrentManager.kt): `app/src/main/java/com/hippo/ehviewer/download/DownloadTorrentManager.kt`

### Import and transfer

- [Wi-Fi transfer](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/wifi/WiFiClientActivity.java): `app/src/main/java/com/hippo/ehviewer/ui/wifi/WiFiClientActivity.java`
- [File access](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/unifile/UniFile.java): `app/src/main/java/com/hippo/unifile/UniFile.java`

### Image and reading

- [Gallery reader](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/java/com/hippo/ehviewer/ui/scene/GalleryPreviewsScene.java): `app/src/main/java/com/hippo/ehviewer/ui/scene/GalleryPreviewsScene.java`
- [Image decoding](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/cpp/jni/image/image.c): `app/src/main/cpp/jni/image/image.c`
- [GIF decoding](https://github.com/xiaojieonly/ehviewer_cn_sxj/blob/BiLi_PC_Gamer/app/src/main/cpp/gif/native-lib.cpp): `app/src/main/cpp/gif/native-lib.cpp`

### Other components

- **Android user**

## Connections

- Android user → Main screen: opens
- Main screen → Quick search: navigates (evidence: `app/src/main/java/com/hippo/ehviewer/ui/MainActivity.java`)
- Quick search → E-Hentai client: searches galleries
- E-Hentai client → Request engine: dispatches requests
- Request engine → Gallery parsers: parses responses (evidence: `app/src/main/java/com/hippo/ehviewer/client/EhEngine.java`)
- Gallery parsers → Gallery data: produces previews
- Gallery detail → Gallery reader: opens previews
- Gallery reader → Image decoding: decodes images
- Gallery reader → GIF decoding: decodes GIF
- Android user → Download screen: manages downloads
- Download screen → Download manager: controls queue
- Download manager → Download records: persists records (evidence: `app/src/main/java/com/hippo/ehviewer/download/DownloadManager.java`)
- Download manager → Download service: ensures service (evidence: `app/src/main/java/com/hippo/ehviewer/download/DownloadService.kt`)
- Android user → Archive downloads: requests archive
- Gallery detail → Torrent downloads: starts torrent
- Android user → Wi-Fi transfer: starts transfer
- Wi-Fi transfer → File access: accesses files (evidence: `app/src/main/java/com/hippo/ehviewer/ui/wifi/WiFiClientActivity.java`)
