HTML to APK Converter with Cordova
pip install html-to-apk
Aplikasi Konversi Proyek Web ke Aplikasi Android (APK) dengan Apache Cordova
📋 Daftar Isi
- Deskripsi Proyek
- Fitur Utama
- Algoritma & Arsitektur Cordova
- Persyaratan Sistem
- Panduan Instalasi
- Cara Penggunaan
- Troubleshooting
- Kontribusi
- 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]
🔧 Proses Konversi
- Inisialisasi Proyek Cordova
cordova create myapp com.example.myapp MyApp
- Salin File HTML ke
www/cp -R /path/to/html/* ./myapp/www/
- 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>
- Tambahkan Platform Android
cordova platform add android
- 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
keystoreterlebih dahulu:keytool -genkey -v -keystore myapp.keystore -alias myapp -keyalg RSA -keysize 2048 -validity 10000
- Gunakan Android Studio untuk debugging lanjutan.
Metadata
Release files for html-to-apk 1.2.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| html_to_apk-1.2.5.tar.gz | 16.3 kB | Without provenance | Details for html_to_apk-1.2.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| html_to_apk-1.2.5-py3-none-any.whl | Python 3 | none | any | Details for html_to_apk-1.2.5-py3-none-any.whl |
Total release size: 205.9 kB
Release files / html_to_apk-1.2.5.tar.gz
| Download URL | html_to_apk-1.2.5.tar.gz |
|---|---|
| Size | 16.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3ab84872c18c4ffe7b06b7ae77fb3f184515b2e50b05de1b8d6e16909531837e
|
|
BLAKE2b-256 checksum How to use checksums |
abbfe06ee69b4497608308a0414df318b8f17c3b8398d9d806e64eb17926e031
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.4
|
Release files / html_to_apk-1.2.5-py3-none-any.whl
| Download URL | html_to_apk-1.2.5-py3-none-any.whl |
|---|---|
| Size | 189.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
86efbe189bb7bcbf64d5083cb3b5ec34936f9e6df65a77ea1c97a975109b08cf
|
|
BLAKE2b-256 checksum How to use checksums |
98518187484c4871eb3ebff52db2363253b65238a4fb8055735849a665d1a127
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.4
|
Security for html-to-apk 1.2.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.