apk-download-helper - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #react #typescript #golang #android #machine-learning #rust #docker #nodejs #macos #java #awesome-list #pytorch

apk-download-helper

(★ 112)

Standalone APK download helper for Morphe Manager

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.yml
  - feature_request.yml
- - release.yml
- build.gradle.kts
- proguard-rules.pro
- logo.png
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- audit_helper_sources.py
.gitignore
build.gradle.kts
gradle.properties
gradlew
gradlew.bat
LICENSE
README.md
settings.gradle.kts

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/rushiranpise/apk-download-helper

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd apk-download-helper

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

cd app

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# APK Download Helper

<p align="center">
  <img src="docs/logo.png" alt="APK Download Helper for Morphe" width="180" />
</p>

APK Download Helper is a standalone Android helper app for finding and returning original APK files requested by Morphe Manager.

The helper receives a package/version request through an Android intent, lets the user choose a supported APK source, downloads a matching file when direct download is available, and returns a readable `content://` URI back to the caller.

This project is independent from the APK source websites listed below. Source availability, package versions, download formats, and region/device access can change at any time.

## Features

- Handles `app.morphe.manager.action.DOWNLOAD_ORIGINAL_APK` requests.
- Shows the requested app's real icon (Android default when not installed), name, package, version, build, format, and ABI hints in a compact stat-card header.
- Lets you narrow the request to a single file format (APK/APKM/APKS/XAPK) when Morphe allows several.
- **Fast Mode**: auto-searches sources in order for the exact requested version + version code and returns it to Morphe without manual taps.
- Four version types per source: **Manual** (open the source site), **Recommended** (exact requested version), **Latest** (newest compatible), and **History** (browse every version).
- Collapsible source grid — pick a source and the list collapses so the page stays clean.
- Returns APK, APKS, APKM, or XAPK files when the selected source provides a compatible direct download, and validates downloaded files before returning them.
- Shows **live download speed and ETA** in the progress notification and the in-app card (`38% · 6.3 MB/s · 0:55 left`).
- **Themes**: dark, light, or follow-the-system, plus an optional **Material You** mode that tints accents and card surfaces from the wallpaper (Android 12+). A quick theme toggle sits in the home header, no need to open Settings.
- **In-app captcha browser**: sources that gate files behind Cloudflare-style challenges open a real WebView; the download it produces is captured back into the helper.
- Falls back to web/manual flows when direct download is not available.
- Keeps Play Store listing opens separate from Aurora's Play-backed download flow.
- Tabs in settings (Settings / Health / History / Logs) with an in-app log of every request and HTTP exchange, plus a Share button to export it for bug reports.

## Supported Sources

- APKMirror
- Uptodown
- APKPure
- APKCombo
- Aptoide
- Evozi
- Mi9
- APK Downloader
- Aurora / Google Play
- Play Store listing

Every source can be individually enabled or disabled from Settings → Sources. Not every source can provide every requested version or file format: some only expose latest versions, some require manual web interaction, and some split formats may not match the patch request.

## Helper Settings

The helper has a tabbed settings screen:

- **Save downloads**: store in Helper's cache (honoring the auto-clear toggle) or keep a validated copy in `Downloads/APK Download Helper`; a storage card shows cache and Downloads sizes and clears both with one tap.
- **Connection**: allow Wi-Fi only, mobile data only, or both Wi-Fi and mobile data.
- **Sources**: toggle each APK source on or off — disabled sources disappear from the picker, manual links, and Fast Mode.
- **Fast Mode**: enable auto-search of the exact requested version across sources.
- **Appearance**: pick **System / Dark / Light** and toggle **Material You colors** (wallpaper-tinted accents and surfaces on Android 12+).
- **Logging**: mirror request/HTTP details to Logcat.
- **Health / History / Logs** tabs: per-source health, past hand-offs, and the full in-app log.

Temporary hand-off is the default because Morphe Manager copies the returned APK URI into its own private workspace before patching.

## Debugging & Bug Reports

When a source fails to resolve or a download stalls, the **Logs** tab shows the full story — the request data, every URL fetched, HTTP status codes, redirects, and timing — with no adb needed. Use **Share** to export the log (including the app/device info) to any app.

GitHub issues use a bug report template that asks for this exported log, so reports arrive with the exact failing request and HTTP trace.

## Release Signing

Release APKs must be signed with a private release certificate. Debug signing is only for local test builds and must not be used for public releases.

GitHub Actions expects these repository secrets:

- `HELPER_RELEASE_KEYSTORE_BASE64`: base64-encoded release keystore
- `HELPER_RELEASE_STORE_PASSWORD`
- `HELPER_RELEASE_KEY_ALIAS`
- `HELPER_RELEASE_KEY_PASSWORD`

For local release builds, place the same values in `local.properties` or pass them as Gradle properties/environment variables. Do not commit keystores or signing passwords.

## Source Audit Script

Use `tools/audit_helper_sources.py` to test source availability for every app declared in a Morphe `Constants.kt` file without launching the Android app:

```powershell
python tools\audit_helper_sources.py --output reports\source-audit.csv
```

Useful targeted checks:

```powershell
python tools\audit_helper_sources.py --package club.boxbox.android --sources apkpure,aptoide,apkcombo
python tools\audit_helper_sources.py --limit 20 --sources apkmirror,uptodown,apkpure,apkcombo,aptoide
```

The CSV/JSON output reports whether each source matched the requested version, only found latest, found the wrong file format, or failed to resolve the package.

## Intent Contract

Request action:

```text
app.morphe.manager.action.DOWNLOAD_ORIGINAL_APK
```

Important request extras:

```text
app.morphe.manager.extra.CALLER_PACKAGE
app.morphe.manager.extra.PROTOCOL_VERSION
app.morphe.manager.extra.PACKAGE_NAME
app.morphe.manager.extra.APP_NAME
app.morphe.manager.extra.VERSION_NAME
app.morphe.manager.extra.VERSION_CODES
app.morphe.manager.extra.COMPATIBLE_VERSION_NAMES
app.morphe.manager.extra.SUPPORTED_ABIS
app.morphe.manager.extra.FILE_TYPE
app.morphe.manager.extra.ALLOW_SPLIT_ARCHIVE
app.morphe.manager.extra.STOCK_INSTALL_REQUIRED
app.morphe.manager.extra.FALLBACK_WEB_URL
```

The helper also accepts older local draft keys for compatibility, including `REQUESTED_FILE_TYPE`, `INSTALL_STOCK_AFTER_DOWNLOAD`, `VERSION_CODE`, `COMPATIBLE_VERSION_CODES`, and `SOURCE_HINT_URLS`.

Successful result:

- `Activity.RESULT_OK`
- `Intent.data` points to the downloaded file URI
- `Intent.FLAG_GRANT_READ_URI_PERMISSION` is granted to the caller

## Credits

- [APKUpdater](https://github.com/rumboalla/apkupdater)
- [Aurora Store](https://gitlab.com/AuroraOSS/AuroraStore)
- Public web pages and APIs exposed by APKMirror, Uptodown, APKPure, APKCombo, and Aptoide

This helper does not claim ownership of source website data, packages, trademarks, or services.

## Support APK Sources

APK hosting and indexing costs money. If this helper saves you time, consider supporting the services it relies on:

- [APKMirror](https://www.apkmirror.com/premium/)
- [Uptodown](https://en.uptodown.com/turbo)
- [APKPure](https://apkpure.com/premium)
- [APKCombo](https://apkcombo.com/premium/)
- [Aptoide](https://en.aptoide.com/premium)
- [Aurora Store](https://gitlab.com/AuroraOSS/AuroraStore/#donations)

## License

APK Download Helper is licensed under the GNU General Public License v3.0. See [LICENSE](LICENSE).

## Notes

- Only download apps you are allowed to access.
- This helper does not bypass paid apps, license checks, account restrictions, or DRM.
- Always verify downloaded files before installing them on a device you care about.
- Source matching is best-effort because APK providers can change their sites and APIs without notice.