O Android 15 apresenta como fazer e restaurar um snapshot de um dispositivo virtual Cuttlefish. Tirar um snapshot de um dispositivo Cuttlefish permite salvar o estado dele em uma imagem no disco. Em seguida, é possível restaurar o snapshot para trazer um dispositivo Cuttlefish ao estado salvo anteriormente.
É possível usar snapshots em vários fluxos de trabalho automatizados ou manuais. Ao realizar um procedimento que modifica o dispositivo, é possível fazer um snapshot dele para garantir que ele possa ser restaurado para um estado especificado. Por exemplo, ao executar conjuntos de testes que modificam o estado do dispositivo e podem causar problemas ou instabilidades nos testes a seguir, é possível criar um snapshot para restaurar o dispositivo para um estado salvo após um teste, garantindo que os testes subsequentes sejam executados sem problemas.
Outro exemplo de fluxo de trabalho em que os snapshots são úteis é ao testar o comportamento de um app. Ao testar o comportamento de um app com base em um conjunto de ações, é possível tirar um snapshot entre as ações enquanto o app está em execução para permitir que você o restaure sem precisar reiniciar desde o início. Por exemplo, se o lançamento de um jogo tiver um tempo de exibição longo, tire uma captura de tela depois de acessar o menu principal para restaurar o dispositivo a esse estado, pulando o tempo de exibição.
Fazer um snapshot de um dispositivo Cuttlefish
Ao fazer um snapshot de um dispositivo, o Cuttlefish precisa ser suspenso para garantir que ele esteja em um estado estável. Quando o dispositivo é suspenso, todas as vCPUs e todos os dispositivos são interrompidos, e todos os buffers enviam o estado para a VM. Em seguida, o snapshot salva o estado da vCPU, a memória e o estado do dispositivo no disco em uma pasta de destino especificada.
O VirtiosFS não é compatível e precisa ser desativado durante a captura de um snapshot. Para
desativar o VirtioFS, transmita o argumento
--enable_virtiofs=false
ao executar cvd create
ou cvd start
.
Somente o modo de GPU SwiftShader (guest_swiftshader
) é compatível com
instantâneos. Outros modos gráficos acelerados
não têm suporte.
As etapas a seguir descrevem o processo de inicialização de um dispositivo Cuttlefish e criação de um snapshot.
Iniciar um dispositivo enquanto desativa o VirtioFS. Depois disso, você poderá usar o dispositivo.
cvd create --enable_virtiofs=false --gpu_mode=guest_swiftshader
Capture um snapshot executando
cvd snapshot_take
com as seguintes flags:--force
: se uma pasta existir no caminho de snapshot especificado, essa flag vai garantir que a pasta atual seja excluída e que uma nova pasta seja criada no caminho de snapshot que contém o snapshot.--auto_suspend
: suspende o dispositivo antes que o snapshot seja capturado e o retoma depois que o snapshot é capturado.--snapshot_path
: o caminho especificado em que uma nova pasta é criada com o snapshot.
cvd snapshot_take --force --auto_suspend \ --snapshot_path=PATH
Restaurar um dispositivo Cuttlefish
Ao restaurar um snapshot de dispositivo Cuttlefish, a instância do Cuttlefish para que o snapshot foi capturado precisa ser interrompida. Se a instância já estiver interrompida, nenhuma outra ação será necessária e o snapshot poderá ser restaurado.
Para restaurar um snapshot de um dispositivo Cuttlefish, inicie um dispositivo com cvd create
e inclua o caminho do snapshot. Se o número da instância base do dispositivo
Cuttlefish em que o snapshot foi capturado for diferente do número da instância
base da instância do Cuttlefish atual, transmita esse número da instância
base usando a sinalização --base_instance_num
.
cvd create --snapshot_path=PATH \
--base_instance_num=ID
Suspender um dispositivo Cuttlefish
É possível suspender um dispositivo Cuttlefish sem fazer um snapshot (nenhum espaço em disco é usado para salvar o estado). Para suspender um dispositivo Cuttlefish, execute:
cvd suspend
Retomar um dispositivo Cuttlefish
Para retomar um dispositivo Cuttlefish suspenso, execute:
cvd resume
Validar o recurso de snapshot/restauração
O recurso de snapshot/restauração pode ser validado executando o seguinte teste:
atest SnapshotTest