建てる

Gradle を実行している場合のみ、欠落している jniLibs は生成されません。初めてビルドする場合は、最初にネイティブビルドを完了してください。

環境要件

ツール	バージョン	目的
OpenJDK	24	Gradle と Android のコンパイル
Android SDK	API 37	コンパイルとターゲットプラットフォーム
Android NDK	30.0.14904198	Go、Rust、C/C++ ネイティブビルド
CMake	3.22.1	C/C++ コンポーネントの構築
パイソン	3.10以降	ビルドスクリプトを実行する
行く	1.26	ミホモコアの構築
さび	毎晩	ビルド構成コンパイラ
カーゴNDK	最新バージョン	Android 用の Rust のコンパイル
Git、パッチ	利用可能	カーネルとアプリケーションの Go パッチを同期する

現在のアプリケーションは arm64-v8a のみをビルドし、対応する Rust ターゲットは aarch64-linux-android です。

倉庫を準備する

ソースコードを取得する

git clone https://github.com/YumeYucca/YumeBox.git
cd YumeBox

Android SDKを構成する

API 37、NDK 30.0.14904198、および CMake 3.22.1 をインストールし、リポジトリのルートディレクトリに local.properties を作成します。

sdk.dir=C:/Android/Sdk

NDK は、gradle.properties の android.ndkVersion に従って自動的に検索します。

Go と Rust の準備

rustup toolchain install nightly --component rust-src
rustup target add --toolchain nightly aarch64-linux-android
cargo install cargo-ndk

Go コアをビルドする前に、.github/patch/ から go env GOROOT のパッチを適用する必要もあります。 CI は、ネイティブコンポーネントをビルドする前にこのステップを自動的に実行します。Git Bash または WSL で実行します。

project_root="$PWD"
go_root="$(go env GOROOT)"
for patch_file in "$project_root"/.github/patch/*.patch; do
  if (cd "$go_root" && patch --forward --dry-run -p 1 < "$patch_file") >/dev/null 2>&1; then
    (cd "$go_root" && patch --forward -p 1 < "$patch_file")
  elif (cd "$go_root" && patch --reverse --dry-run -p 1 < "$patch_file") >/dev/null 2>&1; then
    echo "已应用：$patch_file"
  else
    echo "无法应用：$patch_file" >&2
    exit 1
  fi
done

同期ミホモ

カーネルチャネルを選択します。デフォルトではアルファが使用されます。

python scripts/sync_kernel.py alpha

メタを使用することもできます。

python scripts/sync_kernel.py meta

ネイティブコンポーネントを構築する

完全なビルド

完全なビルドでは、すべてのネイティブライブラリが生成され、地理データがダウンロードされます。

python scripts/native-build.py --all

###コンポーネントによるビルド

パラメータ	出力または関数
`--go`	mihomo 共有コア、プレビューライブラリ、PIE 起動シェル
`--rust`	Rust 構成コンパイラ `liboverride.so`
`--compat`	コアプロセス通信ブリッジ `libcompat.so`
`--ebpf`	ルート eBPF ソケットブリッジ
`--loader`	APK ペイロードローダー `libloader.so`
`--shell`	mihomo PIE 起動シェルのみをビルドする
`--geo`	BundleMRS を使用して地理データをダウンロードして圧縮する
`--clean`	ネイティブ、地域、バージョンのタグをクリーンアップ

ネイティブデバッグでは、現在の ABI のみがビルドされます。

ABI_APP_LIST=arm64-v8a python scripts/native-build.py --go --rust --compat --loader --ebpf

$env:ABI_APP_LIST = "arm64-v8a"
python scripts/native-build.py --go --rust --compat --loader --ebpf

ビルドが成功すると、jniLibs/arm64-v8a/ には次の内容が含まれるはずです。

ドキュメント	目的
`libmihomo.so`	mihomo PIE 起動シェル
`libmihomocore.so`	mihomo Go 共有コア
`libpreview.so`	構成プレビュー
`liboverride.so`	コンパイルをオーバーライドする
`libcompat.so`	コアコミュニケーションブリッジ
`libebpfbridge.so`	eBPF モードブリッジ
`libloader.so`	APK ネイティブペイロードの読み込み
`core-version.properties`	カーネルブランチ、コミット、ビルド情報

地理データは build/generated/assets/geo/ にあります。

geoip.metadb.xz
geosite.dat.xz
ASN.mmdb.xz
BundleMRS.7z

APK をビルドする

###デバッグデバッグは、ローカルのインストールとデバッグに適しています。

./gradlew :app:assembleDebug
./gradlew -Pgeo.bundle=true :app:assembleDebug

.\gradlew.bat :app:assembleDebug
.\gradlew.bat -Pgeo.bundle=true :app:assembleDebug

リリース

解放すると、圧縮とリソースの縮小が可能になります。

./gradlew -Pgeo.bundle=false :app:assembleRelease
./gradlew -Pgeo.bundle=true :app:assembleRelease

.\gradlew.bat -Pgeo.bundle=false :app:assembleRelease
.\gradlew.bat -Pgeo.bundle=true :app:assembleRelease

地理データのバリアント

バリエーション	コンテンツ	該当するシナリオ
`external`	組み込みの地理データはありません	サイズが小さいため、最初の起動時にダウンロードする必要があります
`builtin`	内蔵地理データ	初めてのインストールまたはオフラインでの使用

どちらの亜種も同じアプリケーションコードとカーネルを使用します。唯一の違いは、Geo リソースが APK にパッケージ化されているかどうかです。 APK は次の場所に出力します。

app/build/outputs/apk/debug/
app/build/outputs/apk/release/

ローカルビルドでは通常、YumeBox-external.apk または YumeBox-builtin.apk が生成されます。実際のファイル名は出力ディレクトリに基づいています。

リリース署名

ローカル検証を正式な署名で構成する必要はありません。 APK を公開するには、ウェアハウスのルートディレクトリに release.keystore と signing.properties が必要です。

keystore.password=你的仓库密码
key.alias=yumebox
key.password=你的密钥密码

フィールド	説明
`keystore.password`	キーストアのパスワード
`key.alias`	署名キーのエイリアス
`key.password`	署名キーのパスワード

release.keystore または signing.properties は送信しないでください。

CI ビルド

ステージ	主な仕事	結果
ネイティブビルド	カーネルの同期、Go、Rust、C/C++、eBPF、ローダーのビルド	`native-*` ビルドアーティファクト
APKビルド	それぞれ `builtin` および `external` パッケージ化されたネイティブ製品をダウンロードします。 2 つのリリース APK
リリースの準備	バージョンを計算し、SHA-256 とメタデータを生成します。リリースディレクトリとアップデート情報
リリース	APK とメタデータをアップロードする	GitHub リリース

CI は arm64-v8a を使用し、build.number、build.hash、および build.branch を介してビルドバージョン情報を書き込みます。

インストールを確認する

adb install -r app/build/outputs/apk/debug/YumeBox-external.apk

ファイル名が異なる場合は、app/build/outputs/apk/ で実際の製品を確認してください。

よくある質問

現象	治療
`jniLibs/arm64-v8a` が欠落しています `.so`	最初に `python scripts/native-build.py --all` を実行します。
Android SDK が見つかりません	`local.properties` または `ANDROID_SDK_ROOT` をチェックします。
NDK が見つかりません	`30.0.14904198` をインストールします。代わりに他のバージョンを使用しないでください。
`cargo-ndk` または Rust ターゲットがありません	`rust-src` および `aarch64-linux-android` を毎晩再インストールします。
Go パッチが適用できない	パッチが適用されているかどうかを確認するか、代わりに専用の Go SDK を使用してください。
`builtin` 地域ファイルがありません	最初に `python scripts/native-build.py --geo` を実行します。
ABI はサポートされていません	現在のプロジェクトは `arm64-v8a` のみをサポートしています。

その他のビルドエラーについては、FAQ を参照してください。

はじめに

ガイド

オーバーライド

その他

環境要件

倉庫を準備する

ネイティブコンポーネントを構築する

完全なビルド

APK をビルドする

リリース

地理データのバリアント

リリース署名

CI ビルド

インストールを確認する

よくある質問

​環境要件

​倉庫を準備する

​ネイティブコンポーネントを構築する

​完全なビルド

​APK をビルドする

​リリース

​地理データのバリアント

​リリース署名

​CI ビルド

​インストールを確認する

​よくある質問

環境要件

倉庫を準備する

ネイティブコンポーネントを構築する

完全なビルド

APK をビルドする

リリース

地理データのバリアント

リリース署名

CI ビルド

インストールを確認する

よくある質問