Cuttlefish: snapshot e restauração

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.

  1. Iniciar um dispositivo enquanto desativa o VirtioFS. Depois disso, você poderá usar o dispositivo.

    cvd create --enable_virtiofs=false --gpu_mode=guest_swiftshader
  2. 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