apkdev 2.0.0__py3-none-any.whl

apkdev/__init__.py

@@ -0,0 +1,13 @@
+"""
+apkdev — Android APK Development & Reverse Engineering Toolkit.
+
+One command for everything APK:
+  - Create Kotlin projects with Gradle
+  - Build, sign, and install APKs
+  - Decode APKs with apktool
+  - Decompile to Java with jadx
+  - Disassemble/assemble smali
+  - Convert DEX <-> JAR
+"""
+
+__version__ = "2.0.0"

apkdev/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as: python -m apkdev"""
+from .cli import cli
+
+if __name__ == "__main__":
+    cli()

apkdev/apkfile.py

@@ -0,0 +1,168 @@
+"""APK file operations — pure Python, no external dependencies."""
+
+import zipfile
+import os
+from pathlib import Path
+
+from rich.console import Console
+from rich.table import Table
+from rich.panel import Panel
+from rich.text import Text
+
+console = Console()
+
+
+def list_contents(apk: str) -> None:
+    """List files inside an APK using pure Python zipfile module."""
+    apk_path = Path(apk)
+    if not apk_path.exists():
+        console.print(f"[red]✘ File not found: {apk}[/]")
+        return
+
+    try:
+        with zipfile.ZipFile(str(apk_path), "r") as zf:
+            entries = zf.infolist()
+    except zipfile.BadZipFile:
+        console.print(f"[red]✘ Invalid APK file: {apk}[/]")
+        return
+
+    if not entries:
+        console.print("[dim]Empty APK[/]")
+        return
+
+    # Gather file info
+    files = []
+    dirs = {}
+    total_size = 0
+
+    for entry in entries:
+        name = entry.filename
+        size = entry.file_size
+        total_size += size
+        files.append((size, name, name.endswith("/")))
+
+        parts = name.rstrip("/").split("/")
+        if len(parts) > 1 and not name.endswith("/"):
+            dir_name = parts[0]
+            dirs.setdefault(dir_name, {"count": 0, "size": 0})
+            dirs[dir_name]["count"] += 1
+            dirs[dir_name]["size"] += size
+        elif name.endswith("/"):
+            # Directory entry
+            dir_name = name.rstrip("/")
+            dirs.setdefault(dir_name, {"count": 0, "size": 0})
+
+    # Add root files
+    root_count = sum(1 for s, n, d in files if "/" not in n and not d)
+    root_size = sum(s for s, n, d in files if "/" not in n and not d)
+    if root_count > 0:
+        dirs["(root)"] = {"count": root_count, "size": root_size}
+
+    # Summary
+    console.print(f"[bold cyan]📦 {apk_path.name}[/] — {len([f for f in files if not f[2]])} files, {total_size/1024/1024:.1f} MB")
+    console.print()
+
+    # Directory table
+    t = Table(border_style="blue")
+    t.add_column("Directory", style="bold")
+    t.add_column("Files", justify="right")
+    t.add_column("Size", justify="right")
+
+    for dir_name, info in sorted(dirs.items()):
+        size_str = f"{info['size']/1024:.0f} KB" if info['size'] < 1024*1024 else f"{info['size']/1024/1024:.1f} MB"
+        t.add_row(f"📁 {dir_name}", str(info["count"]), size_str)
+    console.print(t)
+
+    # Notable files
+    console.print()
+    notable_extensions = {".dex", ".so", ".apk", ".xml", ".arsc", ".png", ".jar", ".ttf", ".ogg", ".mp4"}
+    notable_names = {"AndroidManifest.xml", "resources.arsc", "classes.dex", "classes2.dex", "classes3.dex", "classes4.dex"}
+
+    notable = [(s, n) for s, n, d in files if not d and 
+               (Path(n).suffix in notable_extensions or Path(n).name in notable_names)]
+    notable.sort(key=lambda x: -x[0])
+
+    if notable:
+        t2 = Table(border_style="cyan")
+        t2.add_column("File", style="bold")
+        t2.add_column("Size", justify="right")
+
+        icons = {".dex": "⚙️", ".so": "🦀", ".arsc": "🎨", ".xml": "📋", ".png": "🖼️", 
+                 ".jar": "📦", ".ttf": "🔤", ".ogg": "🎵", ".mp4": "🎬"}
+        name_icons = {"AndroidManifest.xml": "📋", "resources.arsc": "🎨"}
+
+        for size, name in notable[:40]:
+            ext = Path(name).suffix
+            icon = name_icons.get(Path(name).name) or icons.get(ext, "📄")
+            size_str = f"{size/1024:.0f} KB" if size < 1024*1024 else f"{size/1024/1024:.1f} MB"
+            t2.add_row(f"{icon} {name}", size_str)
+        console.print(t2)
+
+
+def extract_apk(apk: str, output: str | None = None) -> None:
+    """Extract APK contents using pure Python zipfile module."""
+    apk_path = Path(apk)
+    if not apk_path.exists():
+        console.print(f"[red]✘ File not found: {apk}[/]")
+        return
+
+    out_dir = Path(output or apk_path.stem)
+    out_dir.mkdir(parents=True, exist_ok=True)
+
+    try:
+        with zipfile.ZipFile(str(apk_path), "r") as zf:
+            console.print(f"[yellow]📦 Extracting {apk_path.name} → {out_dir}/...[/]")
+            zf.extractall(path=str(out_dir))
+
+        count = sum(1 for _ in out_dir.rglob("*") if _.is_file())
+        console.print(f"[green]✔ Extracted {count} files → {out_dir}/[/]")
+    except Exception as e:
+        console.print(f"[red]✘ Extraction failed: {e}[/]")
+
+
+def certificate(apk: str) -> None:
+    """Show APK signing certificate info using pure Python + apksigner if available."""
+    import shutil
+    import subprocess
+
+    apk_path = Path(apk)
+    if not apk_path.exists():
+        console.print(f"[red]✘ File not found: {apk}[/]")
+        return
+
+    # Try apksigner first (requires Java)
+    apksigner = shutil.which("apksigner") or shutil.which("apksigner.jar")
+    if apksigner:
+        r = subprocess.run(
+            [apksigner, "verify", "--print-certs", str(apk_path)],
+            capture_output=True, text=True, timeout=15
+        )
+        if r.returncode == 0 and r.stdout.strip():
+            lines = [l for l in r.stdout.strip().split("\n") if l.strip()]
+            for line in lines:
+                if ":" in line:
+                    key, val = line.split(":", 1)
+                    console.print(f"  [bold]{key.strip()}:[/] {val.strip()}")
+                else:
+                    console.print(f"  {line}")
+            return
+
+    # Fallback: extract RSA from META-INF using pure Python
+    try:
+        with zipfile.ZipFile(str(apk_path), "r") as zf:
+            # Find signature files
+            sig_files = [n for n in zf.namelist() if n.startswith("META-INF/") and 
+                        (n.endswith(".RSA") or n.endswith(".DSA") or n.endswith(".EC") or 
+                         n.endswith(".SF") or "SIG" in n)]
+            
+            if sig_files:
+                console.print(f"[yellow]Certificate info (extracted from APK metadata):[/]")
+                for sf in sig_files:
+                    info = zf.getinfo(sf)
+                    size_kb = info.file_size / 1024
+                    console.print(f"  📜 {sf}  ({size_kb:.1f} KB)")
+                console.print("\n[dim]For detailed cert info, install Java + apksigner[/]")
+            else:
+                console.print("[yellow]No signature files found — APK may be unsigned[/]")
+    except zipfile.BadZipFile:
+        console.print(f"[red]✘ Invalid APK file[/]")