Pixel Prop Builder: OTAからBuild.propへの効率的な変換

この堅牢な自動化スイートを使用して、Pixel OTAアップデートからシステムプロパティを簡単に抽出および管理できます。開発者と愛好家の両方を対象として設計されており、Androidビルドプロパティへのアクセスとカスタマイズのプロセスを簡素化します。

🚀 クイックスタート

前提条件

• Unix系環境: Bashを使用したLinuxまたはmacOS。

• コアユーティリティ: 以下のインストールを確認してください：

  • dos2unix, aria2, zip, unzip, p7zip, curl

• Python ^3.8：

  root@kitploit:~

  sudo apt-get update -y
  sudo apt-get install python3 python3-pip python3-venv -y
  

インストール

1. リポジトリをクローン（サブモジュールを含む）：

   root@kitploit:~

   git clone --recurse https://github.com/Pixel-Props/build.prop && cd build.prop
   

2. 仮想環境を作成して有効化（オプションですが推奨）：

   root@kitploit:~

   python3 -m venv .venv
   . .venv/bin/activate
   

3. 依存関係をインストール：

   root@kitploit:~

   python3 -m pip install payload_dumper --break-system-packages
   

使用方法

1. Pixelイメージを入手: Google Android Images または Beta OTA Pages から目的のファクトリーまたはOTAイメージをダウンロードします。
2. 最新情報を維持:
   • ./download_latest_ota_build.sh <device_name1> <device_name2> ... で最新のOTAイメージを取得します（例：husky, felix_beta, cheetah, akita_beta15）。
3. 簡単な抽出:
   • ダウンロードしたイメージファイルをプロジェクトのワークスペース内に配置します。
   • ./extract_images.sh を実行すると、イメージとそのビルドプロパティが自動的に result/Codename_ID ... に抽出されます。
4. 簡単なモジュール統合:
   • ./build_module.sh を実行すると、result/ ディレクトリからモジュールが自動的に結合・ビルドされます。

✨ 主な機能

• 自動OTA取得: Google公式ソースから最新ビルドを直接ダウンロードします。
• シームレスなイメージ抽出: ファクトリーイメージとOTAアップデートの両方からシステムイメージを抽出します。
• Build Prop生成: 抽出したシステムイメージから自動的に build.prop ファイルを生成します。
• Magiskモジュール機能：
  • service.sh:
    • セーフモード: モジュールのプロパティを既存のシステム値と比較することで、重要なシステム設定の誤った変更を防ぎます。
    • 統合 Sensitive Props Mod機能: すべてのSensitive Props Mod機能を組み込み、スタンドアロンモジュールも存在する場合は競合を避けるためにそれらを無効にします。
    • PIHooks (PropImitationHooks): MOD_PROP_CONTENTで定義されたスプーフィング対象モジュールのプロパティに基づいて重要なプロパティを動的に設定する、強力な内部プロパティスプーフィングシステムです。
      • 自動PIHooks無効化: PIHooksは、適切に構成されたPlay Integrity Fixモジュールを検出すると、自動的に自身を無効にします。
      • 選択的 build.prop 統合: PIHooksは、初期SDKバージョンなど、安全かつ必要な特定のプロパティを設定する場合にのみ、デバイスの実際の build.prop の値を利用します。
  • action.sh:
    • PlayIntegrityFix: Beta OTAを使用する場合、自動的に PIF.json 構成をビルドします。事前構築済み設定のダウンロード、またはGoogleのOTAページをクロールして構成をビルドするデバイスリストを生成するオプションを提供します。
    • TrickyStore: ターゲットアプリのパッケージリストを自動的にビルドし、壊れたTEEステータスを処理します。
• GitHub Actions統合:

📝 責任ある使用ガイドライン

このプロジェクトは教育および実験目的で提供されています。効率性を考慮して設計されていますが、このツールを責任を持って使用することが重要です。

• コードレビュー: 任意の環境に展開する前に、コードを徹底的にレビューし理解してください。
• セキュリティのベストプラクティス: セキュリティと法令遵守に関する業界標準に従ってください。

このプロジェクトの作成者は、その使用に起因する誤用や損害について一切の責任を負いません。

---

Androidカスタマイズのワークフローを効率化する準備はできましたか？自動化されたbuild.prop抽出の力を活用しましょう！プロジェクトの機能と範囲を拡張するためのコントリビューションを歓迎します。