Vai al contenuto principale
X

apk-reverse-skill

xiaotianya14/apk-reverse-skill

Skill di reverse engineering APK Android per DSH, pensata prima per mobile: decodifica con jadx/apktool, individua SDK pubblicitari e logica dei permessi, modifica smali o values, ricrea/allinea/firma e verifica su un dispositivo reale. Installa apk-reverse; gli strumenti girano localmente in proot Ubuntu sul telefono o su Linux PC.

Installazione

dsh plugin --profile web add github:xiaotianya14/apk-reverse-skill

README

apk-reverse

apk-reverse · 手机版逆向skill

Android APK Reverse Engineering Skill

Unpack it, understand it, patch it, prove it works.

version license android CI

About · Capabilities · Quick start · Usage · Layout · Docs · Verify · Contributing · License

🌐 English · 中文

apk-reverse banner


About

If you are an AI agent, open SKILL.md and follow its routing, consent and patch rules before touching any target.

A practical Android APK reverse-engineering skill for phone-based work. It turns “I have an APK” into a repeatable loop instead of guessed commands:

APK
  → toolcheck / install_tools        (is the toolchain ready?)
  → decode + manifest_summary        (unpack, decompile, map components)
  → scan_premium / find_api_calls    (find the logic and the ads)
  → patch smali / manifest / .so     (make the smallest change)
  → build_sign                       (repack, align, sign)
  → device verify                    (install, launch, check behaviour)
  → field-journal                    (write down cause → fix)

Why this exists

  • APK tasks need a different playbook from generic coding tasks
  • jadx / apktool / Frida / IDA are easy to install but easy to misuse
  • Phone-only workflows (proot Ubuntu on ARM64) have their own pitfalls
  • The same “why did it crash after repacking?” problems get solved twice

At a glance

VersionScriptsReference docsCILicense
v0.5.1332 + 12 Frida24GitHub ActionsMIT

⭐ Star this repo · 🍴 Fork · 🐛 Report an issue

(back to top)

Capabilities

AreaWhat it does
Decompilationjadx sources, apktool resources/smali, smali3, CFR
Components & adsSDK signatures, manifest / layout / resource inspection
Logic analysispaid & entitlement checks, numeric logic, storage (SharedPreferences / SQLite)
Patchingsmali patches, static fields, native .so instruction patches
Protectionpackers, signature checks, integrity checks
Dynamic & networkFrida, objection, mitmproxy, certificate-pinning adaptation
Deliveryrepack, align, sign, install and verify on device

(back to top)

Quick start

SK=/path/to/apk-reverse

bash $SK/scripts/toolcheck.sh                 # tool check
bash $SK/scripts/install_tools.sh             # install missing tools

bash $SK/scripts/decode.sh app.apk --out ./work   # decode
python3 $SK/scripts/manifest_summary.py ./work    # manifest summary
python3 $SK/scripts/scan_premium.py ./work        # paid/entitlement candidates
python3 $SK/scripts/find_api_calls.py ./work      # API and credential hints
bash $SK/scripts/build_sign.sh ./work out.apk     # repack + sign

Tool downloads are verified against scripts/download-sha256.txt (SHA256); a mismatch aborts the install, and an unpinned version prints its hash with a warning.

(back to top)

Usage

  • The workflow rules and patch patterns live in SKILL.md; reference docs under references/ explain each step in depth.
  • Everything runs in proot Ubuntu on ARM64; a regular Linux machine works too.
  • Build a release: bash scripts/make_release.sh --name apk-reverse --public → zip(+ 本地 .sha256,发布附件只传 SHA256SUMS), then the extracted copy is re-checked.
  • Verify a release: bash scripts/verify_release.sh <zip> (reads .sha256 or SHA256SUMS).
  • Publish to GitHub: bash scripts/publish_github.sh --tag v<version> --release; the token comes from $GITHUB_TOKEN or ~/.config/dsh-go/github-token and never enters the repo.

(back to top)

Repository layout

apk-reverse/
├── SKILL.md          # routing / workflow / patch patterns / rules
├── references/       # topic docs
├── scripts/          # executable tools
├── field-journal/    # reusable problem → cause → fix notes
├── assets/           # banner, icon and social preview images
├── AGENTS.md         # agent activation and consent boundaries
├── SECURITY.md       # trust model and reporting
├── CONTRIBUTING.md
├── CHANGELOG.md
├── VERSION
└── LICENSE           # MIT

(back to top)

Documentation

(back to top)

Release integrity

Every release ships a SHA256SUMS file; recipients verify with:

sha256sum -c SHA256SUMS
# or
bash scripts/verify_release.sh apk-reverse.zip SHA256SUMS

(back to top)

Contact

Contributing

Contributions are welcome — issues, better patch patterns, new reference docs, field-journal notes.

  1. Fork the repository
  2. git checkout -b feature/your-idea
  3. Commit your change (git commit -m 'Add your idea')
  4. git push origin feature/your-idea
  5. Open a pull request

Please keep changes inside the consent and authorization boundaries described in AGENTS.md and SECURITY.md.

Contributors

Contributors — PRs welcome.

(back to top)

Built with

jadx · apktool · Frida · IDA Pro · Ghidra

Acknowledgments

Thanks to the open-source tool authors behind jadx, apktool, Frida, radare2, Ghidra and every tool this skill relies on. This project is a workflow layer on top of their work.

License

MIT — see LICENSE. Read the disclaimer below before use.

Disclaimer: this project is for learning/research on applications you own or are authorized to test. You are responsible for data loss, device damage and legal risk. Do not use it against other people's devices, unauthorized apps, or in violation of platform terms. No warranty; the authors accept no liability.

(back to top)

License & assets

  • Code & docs: MIT (see LICENSE).
  • Visual assets are NOT MIT-licensed: avatars, banners, icon, social image and badge styles in assets/ remain © xiaotianya14, all rights reserved — no commercial use, no redistribution, no relicensing.
  • Private packages (game-mod material, working notes) are not published and not licensed.
  • Third-party tools, SDKs and trademarks remain under their own terms. See NOTICE for details.

Plugin correlati