Commit Graph

13 Commits

Author SHA1 Message Date
Simone Avogadro f8658fd974 Merge master into trackers-and-ads
Integrates upstream contributions from master:
- PowerShell support (#8): check-deps.ps1, install-dep.ps1, decompile.ps1, find-api-calls.ps1
- dex2jar fork migration (#12): pxb1988 -> ThexXTURBOXx
- Decompile partial-success + Fernflower timeout (#10)
- Chinese localization (#4)
- README badges, TOC, Acknowledgments

Conflict resolutions:
- README.md: keep extended description (privacy + neutralization), adopt master's badges/TOC; merge "What it does" into table format with extra rows for tracker/ad detection and SDK neutralization; combine PS1 scripts under android-reverse-engineering/scripts/ and keep neutralizer scripts under sdk-neutralizer/scripts/ (added missing merge-splits.sh and registry-scan.py)
- decompile.sh: combine global --timeout (trackers-and-ads CLI option) with master's status-capture pattern for partial-success (return 2). Keep auto-sized HEAP_SIZE for Fernflower. Drop FERNFLOWER_TIMEOUT_SECONDS env var (superseded by --timeout).
- install-dep.sh: auto-merged (verified: bash -n OK, function boundaries intact, master's URL changes inside install_dex2jar applied, trackers-and-ads' new install_smali/apksigner/zip/neutralize-all preserved)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-27 12:43:21 +02:00
YIPEI WEI cedc1a3368 docs: improve README with badges, TOC, and features table 2026-04-27 10:53:49 +02:00
Simone Avogadro 87388d06b3 docs: add PowerShell support disclaimer and Acknowledgments section
Add a top-level note flagging PS1 scripts as experimental and pointing
issues to this repo. Add an Acknowledgments section crediting the four
external contributors of the recent PR wave (#4, #8, #10, #12).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-27 10:23:31 +02:00
Phil Nachreiner f8d394a69e
Feature/windows powershell support (#8)
* feat: add Windows/PowerShell support

Add PowerShell equivalents of all bash scripts for Windows users:
- check-deps.ps1: Dependency verification with PATH refresh
- install-dep.ps1: Install via winget/scoop/choco or direct download
- decompile.ps1: APK/XAPK/JAR/AAR decompilation with split APK detection
- find-api-calls.ps1: API endpoint extraction (Retrofit, URLs, auth)

Update SKILL.md with Windows-specific instructions and notes for
each workflow phase.

PowerShell scripts support the same options as their bash counterparts
and automatically refresh PATH after installations.

* fix: check-deps.ps1 jadx fallback path version check, decompile.md lint fixes
2026-04-27 10:14:59 +02:00
Roshan Warrier 5a810d94b3
fix: use maintained dex2jar fork (#12)
Co-authored-by: txhno <198242577+txhno@users.noreply.github.com>
2026-04-27 09:59:14 +02:00
Simone Avogadro e70920cf87 SDK Neutralizer v3: full XAPK round-trip, auto-keystore, neutralize-all installer
- decode-apk.sh preserves XAPK structure (.xapk-origin/) with splits, manifest, and metadata for automatic reassembly
- rebuild-apk.sh detects .xapk-origin/, re-signs all split APKs, and assembles final .xapk output
- Add --auto-keystore flag: prioritizes ~/.android/debug.keystore → previous debug key → generated key
- Add neutralize-all compound target to install-dep.sh (java + apktool + apksigner + zip in one command)
- Add apktool version check (>= 2.9.0) with automatic upgrade from GitHub releases
- Add install_zip() and zip dependency check for XAPK rebuild
- All scripts now prepend ~/.local/bin to PATH for user-local tool installs
- Update SKILL.md Phase 3 with built-in catalog detection workflow and custom SDK discovery using Claude Code tools
- Update neutralize.md, CLAUDE.md, and README.md with XAPK and auto-keystore documentation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 14:37:06 +01:00
Simone Avogadro e06f794112 SDK Neutralizer v2: fix duplicate attrs, XAPK support, version check, build fallback, new patterns, replay
Six improvements from real-world testing on Water Sort Puzzle XAPK:

- Fix manifest patching creating duplicate android:enabled attributes when
  the component already has android:enabled="true" (3-way check logic)
- Add decode-apk.sh with XAPK support (auto-extracts base APK, skips splits)
- Add apktool >= 2.9.0 minimum version check in check-neutralize-deps.sh
- Add --no-res fallback in rebuild-apk.sh when apktool build fails on resources
- Add 13 missing manifest components (Vungle new SDK, Meta AN provider,
  AppLovin/BidMachine/IronSource init providers, Amazon APS, Pangle/Mintegral
  activities, Smaato, AppsFlyer internal receiver)
- Add patch persistence via neutralize-manifest.json and --replay flag

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 19:03:40 +01:00
Simone Avogadro f216ec0914 Add tracker-analysis and ad-analysis skills with active vs passive SDK detection
Introduces two new skills for privacy auditing of decompiled Android apps:

- tracker-analysis: 4-phase workflow detecting Firebase, Adjust, AppsFlyer,
  Mixpanel, Amplitude, Segment, Braze, CleverTap, Flurry with init/events/
  consent/data exfiltration analysis
- ad-analysis: 3-phase workflow detecting AdMob, Unity, IronSource, AppLovin,
  Meta AN, Vungle, InMobi, Chartboost, Pangle, Mintegral with ad format
  mapping, mediation analysis, and consent framework detection

Key addition: --entrypoints flag in find-ads.sh distinguishes SDKs actively
called by app code from passive mediation adapter dependencies, enabling
accurate "Ad Architecture" classification (single mediator / multiple direct /
hybrid).

Also improves install-dep.sh sudo detection for non-interactive environments
(Claude Code, CI, pipes) and adds CLAUDE.md project instructions.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-02 15:10:47 +01:00
Simone Avogadro bcbe078c52 Clarified this is a Skill 2026-02-02 21:34:07 +01:00
Simone Avogadro 3a87948331 Fix GitHub username in all repository URLs and LICENSE
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 21:06:15 +01:00
Simone Avogadro b092b3aeea Add legal disclaimer to README
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 20:25:08 +01:00
Simone Avogadro d7fefe54f2 Update README to highlight API extraction, fix author name in metadata
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 20:19:18 +01:00
Simone Avogadro 5ec451e352 commit iniziale 2026-02-02 16:18:11 +01:00