本頁說明如何重新啟動及重設 Cuttlefish 虛擬裝置。將 Cuttlefish 裝置重設為初始磁碟狀態,在指令列工具中稱為「powerwashing」。
執行自動或手動工作流程時,如果有多個不同程序 (例如測試套件),請在程序之間重設 Cuttlefish 裝置,確保每個程序的行為互不影響。如果磁碟狀態未重設,一項程序可能會影響後續程序的行為。
本頁面所述的重新啟動和重設程序,假設您已建立 Cuttlefish 裝置,並在磁碟上設定某些狀態。
# Launch a devicelaunch_cvd
# Make some modifications to the deviceadb shell touch /storage/self/primary/Documents/hello
# Check the device stateadb shell ls /storage/self/primary/Documents
從這個起點開始,你可以使用下列重新啟動和重設流程:
- 如果裝置有回應,請使用
adb reboot
執行乾淨的重新啟動。 - 如果裝置沒有回應,請使用
restart_cvd
執行不乾淨的重新啟動。 - 使用
powerwash_cvd
重設裝置狀態。 - 停止裝置並變更
launch_cvd
引數,同時保留裝置狀態或強制清除裝置狀態。
Cuttlefish 快速重設實作
Cuttlefish 使用快速重設實作項目,這項實作項目取決於保護 qcow2 磁碟疊加層後方的磁碟。根據預設,Cuttlefish 會將原始磁碟視為唯讀,並使用疊加層擷取磁碟寫入內容。
不過,使用寫入時複製疊加層也有缺點。請注意,對基礎磁碟進行外部變更會導致現有疊加層不相容,並造成磁碟狀態不一致。Cuttlefish 偵測到不相容的變更時,會強制重新建立疊加層。
開發需要將部分磁碟保持在特定初始化狀態,同時換出磁碟其他部分的功能時,強制重新建立疊加層並不理想。舉例來說,您可以安裝具有特定使用者設定的應用程式,然後重複更換核心,測試應用程式與不同核心建構版本之間的互動。在這種情況下,建議停用疊加畫面。
重設裝置
以下各節說明如何將 Cuttlefish 裝置重設為初始磁碟狀態。
重設一部裝置
如要將 Cuttlefish 裝置重設為初始磁碟狀態,請執行下列指令:
powerwash_cvd
powerwash_cvd
會關閉虛擬機器、重設對虛擬機器磁碟所做的任何變更、重新啟動虛擬機器,並等待虛擬機器完成開機。執行個體會保留提供給 launch_cvd
的原始標記。
在多租戶設定中,powerwash_cvd
會重新啟動執行個體群組中的單一執行個體:
powerwash_cvd --instance_num=N
重設所有裝置
如要停止並將一或多部裝置重設為初始磁碟狀態,請執行:
stop_cvd
launch_cvd --resume=false
stop_cvd
會執行不乾淨的關機程序,並停止裝置運作。
將 --resume=false
新增至 launch_cvd
後,Cuttlefish 會在啟動下一次執行作業前,毀損與先前執行個體相關的所有檔案。您可以放心新增任何其他 launch_cvd
旗標。
在多租戶設定中,ß
stop_cvd
會關閉整個執行個體群組。
重新啟動裝置
以下章節說明如何重新啟動裝置,而不必將裝置重設為初始磁碟狀態。
乾淨重新啟動
如要在裝置有回應時執行乾淨重新啟動,請執行:
adb reboot
adb reboot
會讓裝置完成完整的關機程序,將變更同步到磁碟,並確保程序關閉。不涉及 Cuttlefish 主機程序。如果裝置進入錯誤狀態且沒有回應,可能就無法執行這項程序。
如要在多租戶設定中徹底重新啟動單一 Cuttlefish 裝置,請在執行 adb-reboot
時指定目標裝置的序號。如果未指定目標裝置,adb
不會重新啟動任何裝置。
adb -s SERIAL reboot
未正常重新啟動
如要在裝置沒有回應時執行不乾淨的重新啟動,請執行:
restart_cvd
restart_cvd
會立即關閉 Cuttlefish 裝置,執行不乾淨的關機程序。restart_cvd
等同於將電池從實體裝置上取下再裝回。如果磁碟寫入作業正在進行中,可能不會持續。restart_cvd
會等待裝置完全重新啟動後再結束。
在多租戶設定中,restart_cvd
會重新啟動執行個體群組中的單一執行個體。如要指定要重新啟動的 Cuttlefish 執行個體,請使用 instance_num
旗標。
restart_cvd --instance_num=N
如果未使用 --instance_num
,執行個體編號預設為 1
。
使用不同的 launch_cvd 旗標重新啟動
如要停止一或多個裝置,並使用不同的 launch_cvd
標記重新啟動,請執行下列指令:
stop_cvd
launch_cvd NEW_FLAG
stop_cvd
會執行類似 restart_cvd
的不乾淨關機作業。這會讓裝置處於休眠狀態,之後可使用其他 launch_cvd
指令重新啟動。與 restart_cvd
相同,如果磁碟寫入作業未完全同步到磁碟,可能不會持續進行。如要安全地將資料儲存至磁碟,請先執行 adb reboot
。
adb reboot
stop_cvd
launch_cvd NEW_FLAG
如果 launch_cvd
標記的變更強制變更磁碟配置,而該配置與寫入時複製實作項目不相容,launch_cvd
會忽略舊的磁碟修改內容,並重設為原始磁碟狀態。如需完整旗標清單,請參閱「旗標」。
不使用疊加層執行
如要停用快速重設支援功能,請執行下列指令:
launch_cvd --use_overlay=false
--use_overlay=false
會將 Cuttlefish 磁碟檔案視為讀寫檔案,並將變更傳播到這些檔案中。
在 --use_overlay=false
和預設值之間切換可能會導致相容性錯誤。如要強制清除先前的裝置狀態,請執行下列指令:
stop_cvd
rm $HOME/cuttlefish $HOME/cuttlefish_runtime $HOME/cuttlefish_assembly
Cuttlefish 無法安全地在有和沒有疊加層的流程之間轉換,因此這項變更會刪除所有 Cuttlefish 管理狀態。如果修改外部磁碟檔案,並在稍後與疊加層一起重複使用,先前的修改內容會視為基準狀態的一部分。
旗幟
使用 launch_cvd
啟動 Cuttlefish 裝置時,可以透過旗標新增引數。不過,如果 launch_cvd
指令之間變更了特定旗標 (必須保持不變的旗標),可能會導致資料遺失。如要確保在執行包含 launch_cvd
、stop_cvd
和 launch_cvd
的一連串指令時不會發生資料遺失情形,請為每個 launch_cvd
指令使用相同旗標。舉例來說,如果第一個 launch_cvd
旗標包含 --kernel_path=KERNEL_PATH
引數,則第二個 launch_cvd
呼叫也必須包含相同的 --kernel_path=KERNEL_PATH
引數,否則在第二個 launch_cvd
呼叫中,stop_cvd
之前所做的任何檔案系統變更都會遺失。KERNEL_PATH
參照的檔案也必須包含相同內容。
部分旗標可在 launch_cvd
呼叫之間安全變更。以下各節列出必須保持不變的標記,以免遺失資料,以及可安全變更且不會遺失資料的標記。如要瞭解個別標記的詳細資料,請參閱來源 (flags.cc
、disk_flags.cc
) 或執行 launch_cvd --help
。
必須維持不變的旗標
為避免資料遺失,這些旗標在每次 launch_cvd
呼叫時都必須保持不變:
--data_policy
--blank_data_image_mb
--kernel_path
--initramfs_path
--vm_manager
--enable_minimal_mode
--bootloader
--protected_vm
--userdata_format
--use_overlay
--system_image_dir
--boot_image
--init_boot_image
--data_image
--super_image
--misc_image
--misc_info_txt
--metadata_image
--vendor_boot_image
--vbmeta_image
--vbmeta_system_image
--linux_kernel_path
--linux_initramfs_path
--linux_root_image
--fuchsia_zedboot_path
--fuchsia_multiboot_bin_path
--fuchsia_root_image
--custom_partition_path
--blank_metadata_image_mb
可變更的旗標
這些旗標可以在 launch_cvd
呼叫之間安全地變更,不會造成資料遺失:
--displays_textproto
--displays_binproto
--cpus
--gdb_port
--display0
--display1
--display2
--display3
--x_res
--y_res
--dpi
--refresh_rate_hz
--extra_kernel_cmdline
--extra_bootconfig_args
--guest_enforce_security
--memory_mb
--serial_number
--use_random_serial
--gpu_mode
--hwcomposer
--gpu_capture_binary
--enable_gpu_udmabuf
--enable_gpu_angle
--use_allocd
--pause_in_bootloader
--enable_host_bluetooth
--rootcanal_instance_num
--rootcanal_args
--netsim
--netsim_bt
--bluetooth_controller_properties_file
--bluetooth_commands_file
--enable_sandbox
--seccomp_policy_dir
--start_webrtc
--webrtc_assets_dir
--webrtc_certs_dir
--start_webrtc_sig_server
--webrtc_sig_server_addr
--webrtc_sig_server_port
--tcp_port_range
--udp_port_range
--webrtc_sig_server_path
--webrtc_sig_server_secure
--verify_sig_server_certificate
--webrtc_device_id
--uuid
--daemon
--setupwizard_mode
--enable_bootanimation
--qemu_binary_dir
--crosvm_binary
--gem5_binary_dir
--gem5_checkpoint_dir
--gem5_debug_file
--gem5_debug_flags
--restart_subprocesses
--enable_vehicle_hal_grpc_server
--boot_slot
--num_instances
--report_anonymous_usage_stats
--ril_dns
--kgdb
--start_gnss_proxy
--gnss_file_path
--fixed_location_file_path
--enable_modem_simulator
--modem_simulator_sim_type
--console
--enable_kernel_log
--vhost_net
--vhost_user_mac80211_hwim
--wmediumd_config
--ap_rootfs_image
--ap_kernel_image
--record_screen
--smt
--vsock_guest_cid
--secure_hals
--use_sdcard
--enable_audio
--camera_server_port
--modem_simulator_count
--blank_sdcard_image_mb
--adb_mode