XiaoMiToolV2

XiaomiAlatV2

Ini adalah kode sumber alat modding Xiaomi XiaomiTool V2 (www.xiaomitool.com)

Keadaan proyek

Proyek ini saat ini setengah terbengkalai karena berbagai alasan. Jika Anda ingin memperbaiki bug atau melakukan sesuatu, cukup fork reponya. Proyek ini dimulai sebagai proyek tingkat siswa: banyak praktik buruk telah digunakan dan pilihan buruk telah dibuat, menjadikan proyek ini mahal untuk dipelihara. Misalnya:

1. Penggunaan Java (1.8) dibandingkan bahasa lain yang tidak terlalu bertele-tele (misalnya Kotlin, Python)
2. Tanpa CI atau CD, merilis build untuk semua OS adalah hal yang merepotkan, dan bug mudah muncul.
3. Tidak ada dokumentasi
4. Tidak ada pengujian
5. Arsitektur buruk (tidak ada modul terpisah, ketergantungan melingkar, kelas tidak dirancang dengan baik, ...)
6. Terbatas untuk perangkat Xiaomi

Meskipun beberapa poin ini dapat diperbaiki dengan cukup mudah, proyek dasarnya masih belum cukup baik untuk menjadikannya layak bagi saya. Perubahan yang diperlukan sangatlah radikal sehingga biayanya hampir sama dengan menulis ulang semuanya dari awal.

Membangun dan Menjalankan

Proyek ini menggunakan gradle, oleh karena itu Anda cukup mengkloning repo dan menggunakan:

gradlew build dan gradlew run

Pembuatannya hanya akan membuat file jar, yang tidak cukup untuk membuat XiaoMiTool berfungsi: Anda juga perlu menggabungkannya dengan sumber daya yang diperlukan (direktori res di repo). Pastikan untuk memilih cabang repositori yang sesuai dengan OS platform target Anda (Windows, Mac, Linux), karena file sumber dayanya berbeda.

Membundel dan mendistribusikan

Direktori relatif res/tools harus berisi alat yang tepat ( adb , fastboot untuk setiap platform, juga file terkait driver untuk Windows) untuk OS target. Anda bisa mendapatkan alatnya dari berbagai cabang repositori ini (Windows, Linux, Mac). Harap diingat bahwa adb dan fastboot BUKAN yang generik yang dapat Anda unduh dari Internet, tetapi yang khusus dikompilasi khusus untuk MIUI. Jika Anda tidak menggunakan yang ada di repo ini, Anda akan kehilangan kemungkinan membuka kunci bootloader dan mem-flash ROM MIUI melalui pemulihan stok.

Untuk repo Windows, disarankan juga untuk menyimpan direktori res/driver karena berisi driver yang akan diinstal XiaoMiTool di Windows agar dapat terhubung ke perangkat. Selain itu, disarankan untuk memulai program dengan hak administratif (Anda dapat menggunakan peluncur launch4j untuk melakukannya) agar dapat menginstal driver.

Versi java yang digunakan untuk konfigurasi gradle ini adalah java 11, namun kode sumbernya kompatibel dengan java 1.8, sehingga memungkinkan untuk mengkompilasi versi 32bit jre 1.8.

XiaoMiTool V2 menggunakan JavaFX untuk guinya, oleh karena itu jika ingin membuat bundle harus membuat image JRE dengan modul JavaFX. Anda dapat memperoleh detail lebih lanjut tentang cara melakukannya di panduan resmi JavaFX. Jika Anda mengkompilasi proyek untuk JRE 1.8, JavaFX sudah dipaketkan dalam JRE standar.

Jika Anda ingin mengubah kode dan membuat bundel yang dapat didistribusikan, cara termudah mungkin adalah dengan mengambil rilis bundel sebelumnya, mengekstrak file, mengganti file jar, dan mengemasnya kembali.

Masalah

Sebagaimana dinyatakan di bagian State of the project , proyek ini semi-terbengkalai. Jangan menghabiskan terlalu banyak waktu untuk mereka, mereka mungkin akan diabaikan begitu saja.