Alur Pemindaian

main di apkleaks/cli.py adalah satu-satunya orkestrator pemindaian. Skrip konsol memasang nama perintah apkleaks ke apkleaks.cli:main lewat tabel [project.scripts] (pyproject.toml:16-17¹), dan berkas apkleaks.py di akar repository memanggil main yang sama ketika dijalankan sebagai skrip (apkleaks.py:1-5²). main sendiri tidak memuat logika pemindaian: ia mencetak banner lewat header (apkleaks/cli.py:10-20), membaca argumen lewat argument (apkleaks/cli.py:22-30), membuat objek APKLeaks, lalu memanggil empat metode secara berurutan di dalam satu blok try/finally (apkleaks/cli.py:32-41). Rincian tiap opsi CLI ada di Argumen CLI, sedangkan penyusunan atribut objeknya dijelaskan di Siklus Hidup Objek APKLeaks.

Urutan panggilan

Alur berjalan lurus: integrity, lalu decompile, lalu scanning, dan cleanup sebagai satu-satunya isi blok finally (apkleaks/cli.py:32-41⁵). Tidak ada klausa except di main, sehingga cleanup tetap dieksekusi meskipun salah satu tahap memanggil sys.exit.

sequenceDiagram
  autonumber
  participant CLI as cli.main
  participant APK as APKLeaks
  participant JADX as jadx
  participant TMP as tempdir
  participant UTIL as util.finder

  CLI->>CLI: header() lalu argument()
  CLI->>APK: APKLeaks(args)
  APK->>TMP: tempfile.mkdtemp dengan prefix apkleaks-
  CLI->>APK: integrity()
  alt jadx tidak ditemukan
    APK->>APK: "prompt Do you want to download jadx? (Y/n)"
    APK->>APK: dependencies() unduh jadx-1.2.0
  end
  APK->>APK: apk_info() lewat pyaxmlparser
  CLI->>APK: decompile()
  APK->>JADX: os.system jadx file -d tempdir
  JADX->>TMP: tulis hasil decompile
  CLI->>APK: scanning()
  APK->>UTIL: finder patok tempdir lalu Thread target extract
  UTIL-->>APK: matches masuk ke out_json
  CLI->>APK: cleanup() di blok finally
  APK->>TMP: shutil.rmtree tempdir
%% fig: Urutan panggilan main sampai cleanup
%% desc: main menyusun objek APKLeaks, menjalankan tiga tahap di dalam try, dan selalu menutup dengan cleanup di blok finally.

integrity lebih dulu memastikan binary jadx ada. Bila tidak ditemukan, ia menanyakan konfirmasi unduh dan menjalankan dependencies yang mengambil arsip jadx-1.2.0.zip dari GitHub (apkleaks/apkleaks.py:44-53⁶, apkleaks/apkleaks.py:55-77⁷). Setelah itu berkas APK divalidasi dengan os.path.isfile, lalu apk_info membungkusnya sebagai objek APK dari pyaxmlparser (apkleaks/apkleaks.py:41-42⁸, apkleaks/apkleaks.py:78-87⁹).

decompile menyusun daftar argumen [self.jadx, self.file, "-d", self.tempdir], menambahkan self.disarg lewat re.split(r"\s|=", self.disarg), lalu menjalankan satu perintah gabungan melalui os.system (apkleaks/apkleaks.py:89-98¹⁰). Karena os.system bersifat blocking, proses jadx selesai sebelum scanning dipanggil (apkleaks/cli.py:37-39¹¹).

scanning membaca config/regexes.json, memulai satu threading.Thread per pola dengan target self.extract, dan menyerahkan pencarian berkas ke util.finder (apkleaks/apkleaks.py:123-138¹², apkleaks/utils.py:17-31¹³). Cara util.finder mencocokkan pola dijelaskan di Mesin Pemindaian Pola.

Tahap demi tahap, efek samping utamanya adalah:

Direktori sementara

tempdir dibuat sekali di __init__ dengan tempfile.mkdtemp(prefix=self.prefix) dan prefix bernilai apkleaks- (apkleaks/apkleaks.py:30-31¹⁶). Direktori yang sama dipakai tiga kali: jadx menulis ke sana lewat opsi -d, util.finder membaca seluruh isinya dengan os.walk, dan cleanup menghapusnya dengan shutil.rmtree (apkleaks/apkleaks.py:91¹⁷, apkleaks/apkleaks.py:129¹⁸, apkleaks/apkleaks.py:141¹⁹). Tidak ada pembersihan di tengah jalan; satu tempdir berlaku untuk satu proses.

Penanganan KeyboardInterrupt

Interupsi ditangani di dua tempat saja, dan keduanya berujung pada sys.exit sehingga cleanup tetap berjalan lewat finally.

Perhatikan perbedaan tanda baca pesannya: integrity memakai satu titik, scanning memakai tiga titik. Di luar dua titik itu, misalnya saat os.system sedang menjalankan jadx, KeyboardInterrupt tidak ditangkap siapa pun di main; interupsi merambat keluar tetapi cleanup tetap dieksekusi karena berada di blok finally (apkleaks/cli.py:32-41⁵).

Cabang keluar dan sisa berkas

Setiap tahap punya jalan keluar sendiri. Diagram berikut memetakan kondisinya beserta keadaan akhir berkas keluaran.

graph TD
  Start["main"] --> Init["APKLeaks(args)"]
  Init --> Tmp["tempdir = tempfile.mkdtemp"]
  Tmp --> Int["integrity"]
  Int -->|"jadx tidak ditemukan"| Prompt["prompt unduh jadx"]
  Prompt -->|"n"| Abort["sys.exit: ** Aborted."]
  Prompt -->|"y"| Dep["dependencies"]
  Dep --> Valid
  Int -->|"bukan berkas APK"| Invalid["sys.exit: It's not a valid file!"]
  Int -->|"apk_info gagal"| ParseErr["sys.exit setelah pesan error"]
  Int --> Valid["apk = apk_info()"]
  Valid --> Dec["decompile dengan os.system"]
  Dec --> Scan["scanning"]
  Scan -->|"apk None"| Undef["sys.exit: ** Undefined package. Exit!"]
  Scan --> Thr["Thread target extract per pola"]
  Thr --> Clean["cleanup di blok finally"]
  Clean -->|"scanned True"| Saved["out_json ditulis, Results saved"]
  Clean -->|"scanned False"| Removed["os.remove(output), Done with nothing"]
  style Tmp fill:#336791,color:#fff
  style Saved fill:#2d7d46,color:#fff
  style Thr fill:#8b5cf6,color:#fff
  style Prompt fill:#f59e0b,color:#000
  style Removed fill:#f59e0b,color:#000
  style Abort fill:#dc2626,color:#fff
  style Invalid fill:#dc2626,color:#fff
  style ParseErr fill:#dc2626,color:#fff
  style Undef fill:#dc2626,color:#fff
%% fig: Cabang keluar setiap tahap
%% desc: integrity dan scanning dapat menghentikan proses lewat sys.exit, sementara cleanup memutuskan apakah hasil disimpan atau berkas keluaran dihapus.

Isi tiap kondisi keluar:

Setelah itu cleanup menentukan nasib berkas keluaran. Bila self.scanned bernilai benar, out_json ditulis sebagai JSON dengan indent=4 ketika opsi --json aktif, berkas ditutup, dan pesan ** Results saved into ... dicetak. Bila tidak, berkas ditutup, self.output dihapus, dan pesan ** Done with nothing. dicetak (apkleaks/apkleaks.py:140-149¹⁵). Format keluarannya dibahas di Format Keluaran.

⚠️ Nilai balik os.system di decompile tidak diperiksa sama sekali (apkleaks/apkleaks.py:96-98²⁷). Jika jadx gagal, tempdir tetap kosong, scanning tidak menemukan apa pun, dan proses berakhir dengan pesan ** Done with nothing. (apkleaks/apkleaks.py:146-149²⁸).

⚠️ scanning memulai threading.Thread untuk self.extract tetapi tidak pernah memanggil join (apkleaks/apkleaks.py:123-138¹²). util.finder sendiri berjalan di main thread karena argumen args dievaluasi lebih dulu pada baris yang sama (apkleaks/apkleaks.py:129¹⁸). Akibatnya cleanup dapat menutup self.fileout atau menghapus output saat extract belum selesai, dan self.scanned masih False ketika cleanup membacanya (apkleaks/apkleaks.py:140-149¹⁵).

⚠️ Ketika tidak ada hasil yang cocok, cleanup menghapus self.output (apkleaks/apkleaks.py:146-149²⁸). self.output sama dengan args.output bila opsi -o diberikan (apkleaks/apkleaks.py:33²⁹), sehingga berkas tujuan yang Anda tentukan sendiri ikut terhapus.