XiaoMiToolV2

XiaomiToolV2

これは、Xiaomi 改造ツール XiaomiTool V2 (www.xiaomitool.com) のソース コードです。

プロジェクトの状況

このプロジェクトは現在、さまざまな理由により半ば放棄されています。バグを修正したり何かをしたい場合は、リポジトリをフォークするだけです。このプロジェクトは学生レベルのプロジェクトとして始まりました。多くの悪い慣行が使用され、間違った選択が行われたため、このプロジェクトを維持するのにコストがかかりました。例えば：

1. 他のあまり冗長でない言語 (Kotlin、Python など) の代わりに Java (1.8) を使用する
2. CI や CD がないため、すべての OS のビルドをリリースするのは面倒で、バグが発生しやすいです。
3. 文書なし
4. テストなし
5. 悪いアーキテクチャ (モジュールが分離されていない、循環依存関係、適切に設計されていないクラスなど)
6. Xiaomi デバイスに限定

たとえこれらの点のいくつかはかなり簡単に修正できたとしても、基本プロジェクトはまだ私にとって価値があるほど十分ではありません。必要な変更は非常に根本的なものであるため、すべてを最初から書き直すのとほぼ同じくらいのコストがかかります。

構築と実行

このプロジェクトは gradle を使用しているため、リポジトリを複製して以下を使用できます。

gradlew buildとgradlew run

ビルドでは jar ファイルのみが作成されますが、これだけでは XiaoMiTool を動作させるには不十分です。必要なリソース (リポジトリ内のresディレクトリ) にそれをバンドルする必要もあります。リソース ファイルが異なるため、ターゲット プラットフォーム OS (Windows、Mac、Linux) に対応するリポジトリ ブランチを必ず選択してください。

バンドルと配布

相対ディレクトリres/toolsは、ターゲット OS 用の適切なツール ( adb 、各プラットフォームのfastboot 、Windows のドライバー関連ファイルも) が含まれている必要があります。このリポジトリのさまざまなブランチ (Windows、Linux、Mac) からツールを入手できます。 adbとfastbootインターネットからダウンロードできる汎用のものではなく、MIUI 用に特別にコンパイルされたカスタムのものであることに注意してください。このリポジトリのものを使用しない場合、ブートローダーのロックを解除したり、ストックリカバリを通じて MIUI rom をフラッシュしたりする可能性が失われます。

Windows リポジトリの場合は、XiaoMiTool がデバイスに接続できるように Windows にインストールするドライバーが含まれるres/driverディレクトリを保存しておくこともお勧めします。また、ドライバーをインストールできるように、管理者権限でプログラムを起動することをお勧めします (これには launch4j ランチャーを使用できます)。

この Gradle 構成に使用される Java バージョンは Java 11 ですが、ソース コードは Java 1.8 と互換性があるため、32 ビット jre 1.8 のバージョンをコンパイルすることができます。

XiaoMiTool V2 は GUI に JavaFX を使用するため、バンドルを作成する場合は、JavaFX モジュールを使用して JRE イメージを作成する必要があります。その方法の詳細については、公式 JavaFX ガイドを参照してください。 JRE 1.8 用にプロジェクトをコンパイルすると、JavaFX は標準 JRE にすでにバンドルされています。

コードを変更して配布可能なバンドルを作成する場合、最も簡単な方法はおそらく、以前のバンドル リリースを取得し、ファイルを抽出し、jar ファイルを置き換えて再パックすることです。

問題

State of the projectセクションで述べたように、このプロジェクトは半ば放棄されました。無視される可能性がありますので、あまり時間を費やさないでください。