Cuttlefish: snapshot e restauração

O Android 15 apresenta como tirar e restaurar um snapshot de um dispositivo virtual Cuttlefish. Com um snapshot de um dispositivo Cuttlefish, você pode 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 seguintes, é possível fazer uma captura de tela para restaurar o dispositivo a um estado salvo após um teste, garantindo que os testes subsequentes sejam executados corretamente.

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 fazer um snapshot entre as ações enquanto o app está em execução para restaurar esse snapshot sem precisar reiniciar do 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 dispositivos são interrompidos, e todos os buffers enviam o estado para a VM. O snapshot salva o estado da vCPU, da memória e 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 de fazer uma captura de tela.

  1. Inicie um dispositivo enquanto desativa o VirtioFS. Você pode usar o dispositivo.

    cvd create --enable_virtiofs=false --gpu_mode=guest_swiftshader
    
  2. Faça 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 em que o snapshot foi feito 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 feito for diferente do número da instância base da instância atual do Cuttlefish, transmita esse número de instância base usando a flag --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