mcpField
A
android-fastboot

android-fastboot

github.com/hyperb1iss開発49128 回インストール39 週間前に更新
リポジトリ

android-fastboot について

開発者やデバイス運用者向けのAndroid Fastboot操作リファレンススキルです。デバイス確認、ブートローダー管理、書き込み、リカバリー、rootの手順をまとめ、データ損失や端末が起動不能になるリスクも示します。

主な機能

  1. 01デバイスとブートローダーの確認
  2. 02アンロックとパーティション書き込みのコマンド
  3. 03A/Bスロットと動的パーティションの操作
  4. 04リカバリーとサイドロードの手順
  5. 05root、消去、ソフトブリック復旧の案内

活用シーン

  1. 01書き込み前の接続デバイス確認
  2. 02リカバリーイメージの一時起動テスト
  3. 03スロットや動的パーティションの管理
  4. 04ソフトブリックした端末の復旧

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hyperb1iss/hyperdroid-skill --skill android-fastboot

インストール後、Claude Code で/android-fastbootを入力して読み込まれたか確認します。

同梱ファイルreferences/partitions.md

詳細

Android Fastboot 操作

⚠️ 危険ゾーン - Fastboot 操作では、デバイスのパーティションに直接書き込みます。イメージを間違えたり、操作が中断されたりすると、デバイスが起動不能になるおそれがあります。必ず次の項目を確認してください。

  1. 正しいデバイスであること(fastboot getvar product を確認)
  2. 正確なデバイスモデルに対応したイメージであること
  3. ブートローダーがアンロックされていること(フラッシュする場合)
  4. バッテリー残量が 50% を超えていること

Fastboot モードに入る

# From ADB (device running)
adb reboot bootloader

# Hardware buttons (most devices)
# Power + Volume Down (hold until fastboot screen)

基本コマンド

fastboot devices                    # List connected devices
fastboot getvar all                 # All device variables
fastboot reboot                     # Reboot to system
fastboot reboot bootloader          # Stay in bootloader
fastboot reboot recovery            # Boot to recovery
fastboot reboot fastboot            # Boot to fastbootd (Android 10+)

フラッシュ前の確認

# ALWAYS run these first
fastboot devices                    # Verify connection
fastboot getvar product             # Verify device model
fastboot getvar unlocked            # Must be "yes" for flashing
fastboot getvar current-slot        # Know current A/B slot
fastboot getvar battery-level       # Should be > 50

ブートローダーのアンロック

Google Pixel
# 1. Enable OEM unlocking in Developer Options
# 2. Boot to fastboot
adb reboot bootloader

# 3. Unlock
fastboot flashing unlock

# 4. Confirm on device with volume keys + power
# WARNING: This wipes all data!
その他のメーカー
ブランド手順
OnePlusfastboot oem unlock
XiaomiMi Unlock Tool(待機期間あり)
SamsungOdin を使用します。fastboot は使用しません
MotorolaWeb サイトでコードを申請し、fastboot oem unlock <code> を実行
SonyWeb サイトでコードを申請
アンロック状態の確認
fastboot getvar unlocked            # yes/no
fastboot getvar device-state        # locked/unlocked
fastboot getvar unlock_ability      # Can be unlocked?

パーティションのフラッシュ

個別のパーティション
fastboot flash boot boot.img
fastboot flash recovery recovery.img      # Non-A/B only
fastboot flash dtbo dtbo.img
fastboot flash vbmeta vbmeta.img

# Disable verification (for custom ROMs)
fastboot flash --disable-verity --disable-verification vbmeta vbmeta.img
ブートローダーと無線ファームウェア(特に注意!)
# These can hard-brick if wrong!
fastboot flash bootloader bootloader.img
fastboot reboot bootloader    # REQUIRED after bootloader flash

fastboot flash radio radio.img
fastboot reboot bootloader    # Recommended after radio flash
一時的な起動(フラッシュなし)
# Test before committing - reboots to normal after restart
fastboot boot recovery.img
fastboot boot patched_boot.img

A/B スロットデバイス

最新のデバイスでは、各パーティションのコピーが 2 つ(A と B)あります。

# Check current slot
fastboot getvar current-slot        # Returns: a or b

# Set active slot
fastboot set_active a
fastboot set_active b

# Flash to specific slot
fastboot flash boot_a boot.img
fastboot flash boot_b boot.img

# Flash to both slots
fastboot --slot=all flash boot boot.img

動的パーティション(Android 10 以降)

大きなパーティション(system、vendor、product)は、「super」パーティション内にあります。

Fastbootd モード
# Enter userspace fastboot
fastboot reboot fastboot

# Check if in fastbootd
fastboot getvar is-userspace        # Should return: yes
動的パーティションのフラッシュ
# Must be in fastbootd mode!
fastboot reboot fastboot

fastboot flash system system.img
fastboot flash vendor vendor.img
fastboot flash product product.img
仮想 A/B スナップショット
# Check snapshot status
fastboot getvar snapshot-update-status

# Cancel stuck update (CAREFUL!)
fastboot snapshot-update cancel

リカバリー操作

リカバリーを起動する
adb reboot recovery
# Or: Power + Volume Up (varies by device)
ADB サイドロード
# 1. In recovery, select "Apply update from ADB"
# 2. Run:
adb sideload update.zip
カスタムリカバリー(TWRP)のフラッシュ
# Test first (temporary boot)
fastboot boot twrp.img

# If it works, flash permanently
# Non-A/B devices:
fastboot flash recovery twrp.img

# A/B devices (recovery in boot):
fastboot flash boot twrp.img

Magisk(ルート化)

インストール
# 1. Extract boot.img from your firmware
# 2. Transfer to device, patch with Magisk app
# 3. Pull patched image
adb pull /sdcard/Download/magisk_patched_*.img

# 4. Flash patched boot
fastboot flash boot magisk_patched_*.img

# 5. Reboot
fastboot reboot
Magisk の便利なコマンド(ルート化後)
adb shell su -c "magisk --version"
adb shell su -c "resetprop ro.debuggable 1"

工場出荷時設定へのリセット/消去

fastboot erase userdata             # Wipe user data
fastboot erase cache                # Wipe cache (if exists)
fastboot -w                         # Format data + cache

# Full flash with wipe
fastboot -w flashall
fastboot -w update image.zip

危険度

レベル操作
✅ SAFEdevices、getvar、reboot、boot(一時起動)
⚠️ MEDIUMflash boot/recovery/dtbo、set_active
🔴 HIGHflash system/vendor、erase、-w
☠️ CRITICALflash bootloader、flash radio、カスタム OS での flashing lock

起動不能の防止

絶対にしないでください:

  • 別のデバイスモデル向けのイメージをフラッシュする
  • フラッシュ操作を中断する
  • カスタム ROM をインストールした状態でブートローダーをロックする
  • バージョンが一致しないブートローダー/無線ファームウェアをフラッシュする

必ず実行してください:

  • fastboot getvar product でデバイスを確認する
  • 復旧用に純正イメージを用意しておく
  • fastboot flash の前に fastboot boot でテストする
  • バッテリー残量を 50% 超に保つ

ソフトブリックからの復旧

# 1. Enter fastboot (Power + Vol Down)
fastboot devices

# 2. Flash stock boot
fastboot flash boot boot.img

# 3. For dynamic partitions
fastboot reboot fastboot
fastboot flash system system.img
fastboot flash vendor vendor.img

# 4. Wipe if needed
fastboot -w

# 5. Reboot
fastboot reboot

ハードブリック(fastboot にアクセスできない状態)の場合は、EDL モード(Qualcomm)またはメーカーのサービスツールが必要です。


クイックリファレンス

タスクコマンド
接続の確認fastboot devices
デバイス情報fastboot getvar all
ブートローダーのアンロックfastboot flashing unlock
boot のフラッシュfastboot flash boot boot.img
リカバリーのテストfastboot boot twrp.img
現在のスロットfastboot getvar current-slot
スロットの切り替えfastboot set_active a
データの消去fastboot -w
再起動fastboot reboot

コメント