HyperChanger
HyperOS 4 を、あなた好みに。
简体中文 |
English |
日本語
リリース |
Telegram グループ |
QQ グループ：429188055
## 概要
HyperChanger は、Xiaomi HyperOS 4 向けの LSPosed モジュールです。付属の設定アプリから、システム UI、通知とコントロールセンター、ロック画面、ランチャー、システム設定、背面ディスプレイ、対応アプリの外観や動作を変更できます。Root 権限が必要で、既存のコンポーネントをフックして変更します。
現在のソースコードのバージョンは **1.2.0 RC2** です。[app/build.gradle.kts](app/build.gradle.kts) の `versionName` を基準としています。ダウンロードと更新内容は [Releases](https://github.com/ColdP/HyperChanger/releases) を参照してください。
本プロジェクトはテスト段階にあり、主な対応環境は **HyperOS 4（Android 17）** です。端末、地域、システムビルド、アプリのバージョンによって動作が異なります。インストール可能な最小バージョンを満たしていても、すべての機能が利用できるとは限りません。
## 機能
### 通知、コントロールセンター、音量パネル
- 通知センターとコントロールセンターの背景を個別に設定し、通常通知、メディア通知、フォーカス通知などのマテリアル、ぼかし、不透明度、角の丸みを調整できます。
- iOS 風通知センター：角丸の壁紙パネル、ロック画面の時計、深度効果に対応。ロック画面の壁紙の表示切り替え、クリアボタンの非表示、通知下端のオフセット調整が可能です。ライブ壁紙には現在対応していません。
- コントロールセンターの大きな時計、日付との間隔、赤色の「1」、通信事業者名、ネットワーク表示、ヘッダーの高さを変更できます。
- 音量パネルのぼかし、ガラス効果の強さ、背景の不透明度、角の丸みを調整できます。
- 内蔵プリセットやユーザープリセットを利用し、通知とコントロールセンターの設定を JSON または QR コードで共有できます。
### スーパーアイランド、ステータスバー、ジェスチャーバー
- スーパーアイランドの幅、大小アイランド間の距離、折りたたみ時の輪郭の滑らかさ、背景マテリアルを調整できます。
- フォーカス通知とスーパーアイランドの一部ホワイトリスト制限を解除し、通知背景やメディアカードを変更できます。通常通知、フォーカス通知、メディア通知のシミュレーションも利用できます。
- ステータスバーの2段式電波表示、ネットワーク種別の文字、アイコンの表示、倍率、位置、間隔を変更できます。
- システム全体のジェスチャーバーのスタイルとサイズを調整できます。
### ロック画面、音楽、壁紙
- ロック画面の時計と水平位置、深度効果、充電テキスト、下部ショートカット、指紋アイコン、PIN 入力画面の外観を変更できます。
- ロック画面編集ページの背景、テンプレート数の上限、ロック画面カプセル、顔認証アイランドを設定できます。高徳地図（AMap）のナビゲーションとカプセルの連携にも対応しています。
- ロック画面ウィジェットに天気、バッテリー、日の出・日の入り、歩数、アラーム、予定、署名画像を組み合わせ、並べ替えやレイアウト、色、マテリアルの調整ができます。
- 音楽カバーを使ったロック画面、ミニプレーヤー、歌詞表示を利用できます。歌詞ライブラリでローカルの歌詞を管理できます。
- ラスター効果のライブ壁紙を設定し、現在のホーム画面とロック画面の壁紙を書き出せます。
- グローバルテーマ適用後もソフトガラス効果を保持し、AOD 時計のガラス・重ね合わせマテリアルに対する OTA 変換制限を解除できます。
### ランチャーと最近使ったアプリ
- 対応する HyperOS 4 の Rust ランチャーに Dock を追加できます。単色、高度なマテリアル、ソフトガラスの背景と表示アニメーションに対応しています。
- Dock の高さ、左右と下部の余白、角の丸み、色、不透明度、ぼかしを調整できます。
- 最近使ったアプリのクリアボタンを非表示にし、ボタンの機能を残すか無効にするかを選べます。
- Dock にはシステムフレームワークとランチャーの両スコープが必要です。初回利用時は端末を手動で再起動してください。
### システム設定と背面ディスプレイ
- システム設定のホームページと端末情報ページで、背景、端末カード、ロゴ、端末画像、表示される仕様を変更し、モジュールへのショートカットを追加できます。
- 背面ディスプレイの一部 AI 機能を解除し、インポートしたアプリの管理や音楽ウィジェットで使用するアプリの選択ができます。
- 背面ディスプレイの壁紙数の上限を変更し、テーマ変更と背面ディスプレイのテーマ・壁紙の認証処理との競合を修正できます。これらの設定にはテーマのスコープが必要です。
### カメラ、ギャラリー、スーパー XiaoAi 入力方式
- 対応カメラで Leica LCC UI、標準の焦点距離の保持、「一瞬」モードを設定できます。
- ギャラリー編集の一部ウォーターマークや Xiaomi 18 シリーズの編集機能を解除できます。利用可否はギャラリーとメディアエディターのバージョンに依存します。
- スーパー XiaoAi 入力方式の一部ブラックリスト、クリップボード、AI、音声の安全制限を解除できます。
- キーボードのガラス効果、色、角の丸み、不透明度、ぼかしを調整できます。
### その他のアプリとシステム更新
- Apple Music、Weibo、小紅書、Xiaomi ショップ、Mi Wallet、Mi Fitness、Luckin Coffee の下部ナビゲーションのスタイル、ラベル、色を変更できます。
- Mi Fitness のウォッチフェイスの10分間試用制限を解除できます。
- MiShare の AirDrop 利用可否チェックを上書きできます。実際の転送にはシステムコンポーネント、ハードウェア、相手端末の対応が必要です。
- 画面録画のフレームレートとビットレートの選択肢を追加し、保存先を変更できます。
- システム更新の無効化、一部 OTA 制限の解除、表示上のシステムおよび SOTA バージョンの変更ができます。
### モジュールアプリ、言語、更新
- MIUIX ベースの設定画面で、ライト・ダーク・システム連動テーマ、複数の下部ナビゲーション、予測型「戻る」アニメーションに対応しています。
- 簡体字中国語、英語、日本語を内蔵し、言語パックのインポート、エクスポート、編集ができます。
- モジュール設定を JSON で入出力し、アプリ内でスコープ対象アプリの再起動を管理できます。
- GitHub または Gitee からモジュールの更新を確認・ダウンロードし、手動または Root によるサイレントインストールができます。
## 互換性と動作要件
| 項目 | 詳細 |
| --- | --- |
| 主な対応環境 | Xiaomi HyperOS 4（Android 17） |
| インストール可能な最小バージョン | Android 15（API 35）；全機能の互換性を保証するものではありません |
| コンパイル / ターゲット SDK | API 37 |
| モジュールフレームワーク | Root と、モダンな libxposed API に対応する LSPosed；最小 API 101、ターゲット API 102 |
| ネイティブライブラリのアーキテクチャ | 現在のリポジトリには `arm64-v8a/libhyperpatch.so` を同梱。ランチャーのネイティブパッチには ARM64 が必要です |
| オプションのコンポーネント | 各機能には、対応バージョンの対象アプリまたはシステムコンポーネントが必要です |
アプリは `ro.mi.os.version.code` を確認します。HyperOS が検出されない場合は終了し、HyperOS 4 以外では警告を表示します。この確認を通過しても、現在のシステムですべてのフックが動作するとは限りません。
## モジュールのスコープ
LSPosed でモジュールを有効にし、使用する機能に必要なスコープを選択してください。以下は [scope.list](app/src/main/resources/META-INF/xposed/scope.list) に対応する一覧です。
| スコープ | パッケージ名 / 識別子 |
| --- | --- |
| システム UI | `com.android.systemui` |
| システムフレームワーク（Dock） | `system` |
| システムランチャー | `com.miui.home` |
| 壁紙 | `com.miui.miwallpaper` |
| システム UI プラグイン | `miui.systemui.plugin` |
| 常時表示（AOD） | `com.miui.aod` |
| Xiaomi カメラ | `com.android.camera` |
| Xiaomi ギャラリー | `com.miui.gallery` |
| Hyper ギャラリープラグイン | `com.hyper.gallery.plugin` |
| メディアエディター | `com.miui.mediaeditor` |
| 画面録画 | `com.miui.screenrecorder` |
| スーパー XiaoAi 入力方式 | `com.xiaomi.type` |
| XiaoAi フレーズ | `com.miui.phrase` |
| システム設定 | `com.android.settings` |
| システム更新 | `com.android.updater` |
| 背面ディスプレイセンター | `com.xiaomi.subscreencenter` |
| パーソナルアシスタント | `com.miui.personalassistant` |
| テーマ | `com.android.thememanager` |
| Xiaomi ショップ | `com.xiaomi.shop` |
| Mi Wallet | `com.mipay.wallet` |
| Mi Fitness | `com.mi.health` |
| Apple Music | `com.apple.android.music` |
| Weibo | `com.sina.weibo` |
| 小紅書 | `com.xingin.xhs` |
| Luckin Coffee | `com.lucky.luckyclient` |
| 高徳地図（AMap） | `com.autonavi.minimap` |
| MiShare | `com.miui.mishare.connectivity` |
端末によっては存在しないパッケージもあります。実際に使用するスコープだけを選択してください。スコープの宣言は、対象アプリのすべてのバージョンへの対応を保証するものではありません。
## インストールと使い方
1. [Releases](https://github.com/ColdP/HyperChanger/releases) から署名済み APK をダウンロードし、インストールします。
2. LSPosed で HyperChanger を有効にし、必要なスコープを選択します。
3. 設定アプリを開き、環境チェックを完了して、初回利用時の説明と規約を確認します。
4. 必要な機能を有効にします。アプリの案内に従い、スコープ対象アプリの再起動機能を手動で操作して設定を反映します。
5. 初めて Dock を有効にする場合は、システムフレームワークとランチャーのスコープを確認し、端末を手動で再起動します。
## プリセットと言語パック
- **通知とコントロールセンターのプリセット**：内蔵・ユーザープリセットに対応しています。長押しで JSON または QR コードを書き出し、ファイルまたは QR コード画像から読み込めます。
- **モジュール設定プリセット**：アプリの「設定」ページで複数の設定グループを JSON として入出力できます。読み込み時には形式とバージョンを検証します。画像ファイル本体は含まれず、一部の画像参照フィールドも除外されるため、別の端末へ移行する際は素材を別途用意してください。
- **言語パック**：中国語、英語、日本語、システム言語に連動する設定を選べます。[languages/example.json](languages/example.json) を参考に作成し、アプリ内でインポート、編集、エクスポートできます。
プリセットの種類に合った読み込み画面を使用してください。読み込み後は設定を確認し、再起動が必要な項目は案内に従って反映してください。
## トラブルシューティング
| 症状 | 対処方法 |
| --- | --- |
| 設定が反映されない | 機能のスイッチ、LSPosed のスコープ、対象アプリのバージョンを確認し、案内に従って対象アプリを手動で再起動してください。 |
| Dock が表示されない | システムフレームワークとランチャーのスコープ、Rust ランチャーの互換性、初回有効化後の端末の手動再起動を確認してください。 |
| iOS 風通知センターに壁紙が表示されない | 壁紙の表示設定を確認してください。ライブ壁紙には現在対応していません。 |
| システム UI が繰り返しクラッシュする | LSPosed または Recovery からモジュールを無効にし、復旧後に設定や他のモジュールとの競合を一つずつ確認してください。 |
| 特定の機能が利用できない | システムやアプリの実装が非対応の可能性があります。端末、システム、対象アプリのバージョンを添えて報告してください。 |
| プリセットを読み込めない | プリセットの種類、読み込み画面、書き出したバージョンが一致し、ファイルや QR コードが破損していないか確認してください。 |
Issue には、端末モデル、Android / HyperOS のバージョン、モジュールと LSPosed のバージョン、対象アプリのバージョン、スコープ、再現手順、個人情報を除去した関連 Logcat ログを添えてください。
## ソースコードからのビルド
必要な環境は、JDK 21（CI と同じ）、Android SDK 37、および Android Gradle Plugin 9.2.1 に対応する Android Studio またはプロジェクトの Gradle Wrapper（9.6.1）です。[app/build.gradle.kts](app/build.gradle.kts) ではローカルの NDK r28c パスも指定されているため、ビルド前にそのパスが利用可能か確認してください。
```bash
git clone https://github.com/ColdP/HyperChanger.git
cd HyperChanger
./gradlew :app:assembleDebug
```
Windows PowerShell：
```powershell
.\gradlew.bat :app:assembleDebug
```
Debug APK の出力先：`app/build/outputs/apk/debug/app-debug.apk`。
Release の署名は Gradle プロパティ `releaseStoreFile`、`releaseStorePassword`、`releaseKeyAlias`、`releaseKeyPassword` で設定し、キーストアはリポジトリ外に保管してください。署名済みビルドは `app/build/outputs/apk/release/` に出力されます。公開するファイル名は `HyperChanger-v.apk` とし、バージョン内の空白をハイフンに置き換えます（例：`HyperChanger-v1.2.0-RC2.apk`）。キーストア、パスワード、ビルド生成物をコミットしないでください。
## ディレクトリ構成
```text
HyperChanger/
|-- app/
| |-- src/main/java/ Kotlin / Java のモジュールと UI のソース
| |-- src/main/assets/ 言語パック、法的文書、第三者の権利表記
| |-- src/main/jniLibs/ ARM64 ネイティブパッチライブラリ
| |-- src/main/res/ Android リソース
| `-- src/main/resources/ LSPosed エントリー、メタデータ、スコープ
|-- languages/example.json 言語パックのテンプレート
|-- gradle/ Gradle Wrapper
|-- README.md 中国語のメイン README
|-- README_en.md 英語版
|-- README_ja.md 日本語版
|-- README_zh.md 旧中国語リンクの案内ページ
|-- CONTRIBUTING_zh.md
|-- NOTICE
`-- LICENSE
```
## 貢献
不具合報告や改善を歓迎します。参加する前に [英語の貢献ガイド](CONTRIBUTING.md) または [中国語の貢献ガイド](CONTRIBUTING_zh.md) をお読みください。
## 免責事項
HyperChanger はコミュニティが開発する実験的なモジュールであり、Xiaomi との提携関係や公式の許諾はありません。システムへのフックにより、表示の異常、アプリのクラッシュ、起動不能が発生する可能性があります。互換性はシステムやアプリの更新によって変化します。テスト前に重要なデータをバックアップし、LSPosed または Recovery でモジュールを無効にできる手段を確保してください。利用は自己責任であり、特定の端末や将来のバージョンへの対応は保証しません。
## ライセンスと謝辞
本プロジェクトは [AGPL-3.0-or-later](LICENSE) で公開され、GNU Affero General Public License 第3版または任意の後続版を選択できます。過去の MIT・Apache-2.0 ライセンスおよび第三者の権利表記は [NOTICE](NOTICE) を参照してください。
- ロック画面の音楽カバー実装は [HyperMusicCover](https://github.com/zyl6932/HyperMusicCover)（Copyright 2026 zyl6932、Apache License 2.0）から導入・改変しています。
- 折りたたみ時のアイランドの輪郭、大小アイランド間の距離、顔認証アイランドの実装は [HyperIsland 3.1.8](https://github.com/1812z/HyperIsland)（Copyright 2026 1812z、MIT）を基にしています。全文は [HyperIsland-MIT.txt](app/src/main/assets/licenses/HyperIsland-MIT.txt) を参照してください。
- MIUIX、AndroidLiquidGlass / Backdrop、および各依存プロジェクトに感謝します。詳細はアプリ内のオープンソース表記を参照してください。
## Star History
