APK Tool Documentation v3.0.3

1. Overview $99 one‑time

APK Tool is a powerful web‑based toolkit for reverse‑engineering, customising, rebuilding, and signing Android APK files. It provides a clean, modern Vue.js interface and a full suite of developer features:

• Decompile any APK to editable Smali/XML/resources.
• Edit strings, replace launcher icons, and modify files directly in the browser.
• Rebuild and sign APKs with your own keystore.
• Integrate Google Gemini AI to fix build errors and generate launcher icons.
• Cloud Debug Logging – inject a crash/network logger into your app so it reports errors directly to your server over the internet – no ADB, USB, or port forwarding required.
• Built‑in ADB support for wireless/USB installs and real‑time logcat viewing.
• User management with usage limits, admin panel, and email verification.

2. System Requirements

• Web Server: Apache, Nginx, or any PHP‑capable server.
• PHP: 7.4+ (8.x recommended) with extensions: mysqli, curl, json, gd, mbstring, dom, zip.
• MySQL / MariaDB: 5.7+ or 10.3+.
• Disk Space: At least 500 MB (more for large APK projects).
• Supported OS: Linux (recommended), macOS, or Windows (with WSL).

3. Installation (Auto‑Installer)

The script comes with a one‑click auto‑installer that handles all dependencies and database setup automatically.

1. Upload Files – Upload the entire script folder to your web server.
2. Run the Installer – Navigate to https://yourdomain.com/path/to/apktool/install.php.
3. Follow On‑Screen Steps – The installer checks PHP extensions, write permissions, database credentials, admin account setup, and SMTP (optional).
4. Finish – After success, you'll be redirected to login. The installer creates app-installed.lock – remove it only to re‑run the installer.

4. Configuration

All settings are stored in app-config.php (generated by the installer). You can edit this file manually or via the admin panel.

Core Paths

• paths.upload_folder – project storage (default: ./uploads).
• paths.apktool_path, paths.jarsigner_path, paths.apksigner_path, etc. – ensure these binaries exist and are executable. The installer automatically downloads them for Linux x86_64.

Database

• db.host, db.port, db.user, db.pass, db.name – your MySQL credentials.

Admin Account

• admin.email, admin.mobile, admin.username, admin.password – used during installation.

SMTP (Email)

• Enable to send verification and password reset emails. Supports tls or ssl. Falls back to PHP's mail() if disabled.

Billing

• billing.purchase_link – URL to buy the script (customisable).
• billing.support_email – displayed when limits are reached.

5. User Guide

5.1. Registration & Login

• Register with email, phone, username, and password.
• Email verification is required (if SMTP configured).
• Admins have access to the Admin Panel.

5.2. Dashboard

• View usage limits for Decompile, Compile, Key Generation, and Sign.
• Limits are set by admin; email notification when limit is reached.

5.3. My Projects (Workflow)

Step 1: Upload APK

• Click New Project and upload an APK.
• Decompiles automatically using apktool.

Step 2: Edit Strings

• Select a strings.xml locale.
• Edit app name and strings.
• Upload google-services.json to auto‑fill Firebase values.
• Auto‑saves after a few seconds.

Step 3: Change Logo

• Upload PNG/JPG/WEBP – automatically resized to all launcher densities.
• AI Generator: Describe an icon and Gemini creates it.

Step 4: File Manager & Editor

• Browse decompiled folders.
• Search for text/file names across all text files.
• Open any file in CodeMirror editor (XML, Java, Smali, JSON, etc.).
• Edits auto‑saved.

Step 5: Build APK

• Click Build Unsigned APK – recompiles with apktool.

Step 6: Keystore

• Create new JKS keystore or select existing one.
• Keys are stored per user and reusable.

Step 7: Sign APK

• Enter keystore password.
• Aligns and signs using zipalign and apksigner (or jarsigner).
• Download final signed APK.

5.4. AI Features (Gemini)

• Add your Gemini API key in AI Settings (top of project view). Get free key from Google AI Studio.
• AI Error Fix: On build failure, click AI Fix Errors – Gemini analyses the error log and suggests a fix, optionally with file content.
• AI Icon Generator: Describe an icon, Gemini generates it, and it’s automatically applied.

5.5. Cloud Debug Logging (No ADB Required)

• Injects a small reporter into your app’s Smali.
• After enabling and rebuilding, the app sends crashes, logcat output, and network requests to your server over the internet.
• Use the Debugger Companion APK (provided) to pair any Android device via QR code or code.
• Once paired, logs appear in the Developer Tools tabs – no USB or network setup needed.

5.6. ADB Device Tools

• List connected devices (USB or wireless).
• Connect wirelessly by entering IP:port.
• Install APK directly on device.
• View real‑time logcat with filtering.

6. Admin Panel

• View all registered users and usage stats.
• Create new users with custom limits.
• Edit limits (decompile, compile, key generation, sign).
• Promote/demote admin rights.
• Manage keystores.

7. Troubleshooting

8. Support & Billing

• Purchase: One‑time payment of $99 – includes full source and lifetime updates.
• Support: Contact via the support email in your purchase confirmation, or open an issue on our support portal.
• Updates: You will be notified of new versions and can download from your customer account.

9. License & Credits

• Proprietary software – installation on any number of servers you own is allowed, but redistribution or resale of source code is prohibited.
• Uses open‑source components: apktool, jarsigner, apksigner, CodeMirror, Vue.js, Bootstrap, QRCode.js, and others under their respective licenses.