HTML to APK Converter with Cordova

pip install html-to-apk

Running*

html-to-apk

Aplikasi Konversi Proyek Web ke Aplikasi Android (APK) dengan Apache Cordova

Open Project on PYPI

---

📋 Daftar Isi

1. Deskripsi Proyek
2. Fitur Utama
3. Algoritma & Arsitektur Cordova
4. Persyaratan Sistem
5. Panduan Instalasi
6. Cara Penggunaan
7. Troubleshooting
8. Kontribusi
9. Lisensi

---

📌 Deskripsi Proyek

HTML to APK Converter adalah alat berbasis Python yang mengubah proyek web (HTML, CSS, JS) menjadi aplikasi Android (APK) menggunakan Apache Cordova.

🔹 Keunggulan:
✔ Tanpa coding – GUI sederhana untuk konfigurasi
✔ Dukungan plugin Cordova (Kamera, GPS, Notifikasi, dll.)
✔ Build langsung dari folder HTML
✔ Customizable (Nama App, Package ID, Ikon, Splash Screen)

---

✨ Fitur Utama

✅ Konversi ke APK

• Build untuk Android (min SDK 21+)
• Optimasi dengan Gradle
• Signing APK otomatis (debug/release)

✅ Dukungan Cordova Plugin

• Akses Device API (Kamera, GPS, File System)
• Network Information, Vibration, StatusBar
• Tambahkan plugin via GUI

✅ Konfigurasi Aplikasi

• Nama Aplikasi & Package ID (e.g., com.example.app)
• Ikon & Splash Screen (multi-resolusi)
• Orientasi Layar (Portrait/Landscape)
• Versi App (Version Code & Name)

✅ Preview Mode

• Jalankan di Emulator Android
• Debug via Chrome DevTools

✅ Logging & Error Handling

• Log detail proses build
• Deteksi error Java SDK, Gradle, Cordova

---

⚙ Algoritma & Arsitektur Cordova

📂 Alur Kerja

graph TD
    A[Input: Folder HTML] --> B[Init Cordova Project]
    B --> C[Copy Web Assets to www/]
    C --> D[Konfigurasi config.xml]
    D --> E[Tambahkan Plugin Cordova]
    E --> F[Build APK via Cordova CLI]
    F --> G[Output APK]

Loading

🔧 Proses Konversi

1. Inisialisasi Proyek Cordova

   cordova create myapp com.example.myapp MyApp

2. Salin File HTML ke www/

   cp -R /path/to/html/* ./myapp/www/

3. Konfigurasi config.xml

   <widget id="com.example.myapp" version="1.0.0">
       <name>MyApp</name>
       <icon src="res/icon.png" />
       <splash src="res/splash.png" />
   </widget>

4. Tambahkan Platform Android

   cordova platform add android

5. Build APK

   cordova build android --release

---

�️ Persyaratan Sistem

Komponen	Versi Minimal	Catatan
OS	Windows 10 / macOS / Linux (x64)	-
Python	3.6+	Untuk GUI
Node.js	14.x+	Wajib untuk Cordova
Java JDK	8+	Diperlukan untuk Android SDK
Android SDK	API Level 21+	adb, gradle harus di PATH
RAM	4GB+	Lebih baik 8GB untuk emulator

---

📥 Panduan Instalasi Terminal

pip install html-to-apk
html-to-apk

📥 Panduan Instalasi Lengkap

1️⃣ Instal Python & PIP

python --version  # Pastikan Python 3.6+
pip --version

2️⃣ Instal Node.js & npm

node --version  # Minimal v14
npm --version

3️⃣ Instal Cordova Global

npm install -g cordova

4️⃣ Instal Android SDK

• Download Android Studio di sini
• Set PATH untuk adb, gradle:

  export PATH=$PATH:$ANDROID_HOME/platform-tools
  export PATH=$PATH:$ANDROID_HOME/tools/bin

5️⃣ Instal Java JDK

• Download JDK 8+
• Set JAVA_HOME:

  export JAVA_HOME=/path/to/jdk

6️⃣ Verifikasi Instalasi

cordova requirements  # Pastikan semua tercentang

---

🖱 Cara Penggunaan

1️⃣ Tab Settings

• HTML Folder: Pilih folder berisi index.html
• App Name: Nama aplikasi
• Package ID: Format com.nama.anda
• Output Folder: Lokasi penyimpanan APK

2️⃣ Tab Cordova Options

• Platform: Android (default)
• Plugins: Pilih plugin Cordova (e.g., Camera, Geolocation)
• Ikon & Splash Screen: Upload gambar (PNG)

3️⃣ Tab Preview

• Run on Emulator: Jalankan di emulator Android
• Debug via Browser: Buka di Chrome DevTools

4️⃣ Build APK

• Klik "Build APK"
• APK akan tersimpan di platforms/android/app/build/outputs/apk/

---

⚠ Troubleshooting

Masalah	Solusi
Cordova tidak terdeteksi	Jalankan npm install -g cordova
Error Android SDK	Pastikan ANDROID_HOME sudah benar
Gradle Build Failed	Update Gradle: gradlew wrapper --gradle-version 7.x
APK tidak terinstall	Aktifkan USB Debugging di perangkat

---

🤝 Kontribusi

• Laporkan bug di Issues
• Ajukan fitur via Pull Request

---

📜 Lisensi

MIT License – Bebas digunakan untuk proyek komersial & open source.

---

🚀 Selamat Membangun Aplikasi Android!

Catatan Tambahan:

• Untuk signing APK release, buat file keystore terlebih dahulu:

  keytool -genkey -v -keystore myapp.keystore -alias myapp -keyalg RSA -keysize 2048 -validity 10000

• Gunakan Android Studio untuk debugging lanjutan.