Criar um app AVF

Um app compatível com AVF tem duas partes: a parte do app executada no SO Android host e a parte do app executada no Microdroid em uma pVM.

A parte do app que é executada no Android implementa a interface do usuário, a lógica de negócios não confidencial e cria e gerencia o ciclo de vida de uma pVM.

A parte do app executada no Microdroid, dentro de uma pVM, é responsável por realizar todas as tarefas que precisam ser feitas com segurança.

Para iniciar e se comunicar com a parte pVM do app, o aplicativo host cria uma pVM e executa uma biblioteca compartilhada nativa nela. Essa biblioteca implementa um serviço de binder que a parte host do app usa para se comunicar com a parte do app em uma pVM. A Figura 1 mostra as duas partes do aplicativo e o canal de comunicação do binder:

Configurar o arquivo de configuração

O arquivo vm_config.json precisa ter uma entrada para o sistema operacional e a biblioteca compartilhada da pVM. O arquivo assets/vm_config.json a seguir mostra entradas de arquivo de configuração para o Microdroid e uma biblioteca nativa compartilhada:

{
  "os": {
    "name": "microdroid"
  },
  "task": {
    "type": "microdroid_launcher",
    "command": "MicrodroidTestNativeLib.so"
  }
}

Implementar o serviço de vinculador

Na biblioteca compartilhada, implemente um serviço de binder. Exemplo:

extern "C"
int android_native_main(int, char**) {
  // Implement your binder service here
}

Criar código do app

Na parte do host do app, crie um código que prepare o arquivo de configuração, carregue (ou crie) um identificador para a VM e execute a VM. Exemplo:

// Prepare the configuration file
VirtualMachineConfig config = new VirtualMachineConfig
  .Builder(getApplication(), "assets/vm_config.json")
  .build();

// Load (or create) the handle to a VM
VirtualMachine vm = VirtualMachineManager
  .getInstance(getApplication())
  .getOrCreate("my_vm", config);

// Run the VM
vm.run();

Comunicar-se com a parte da VM do app

Para se comunicar com a parte da VM do seu app, primeiro registre um callback para receber uma notificação quando o serviço de binder na VM estiver pronto. Quando notificado, você se conecta ao servidor binder e se comunica com ele usando a interface AIDL personalizada. Exemplo:

// Register the callback
vm.setCallback(Executors.newSingleThreadExecutor(),
  new VirtualmachineCallback() {
  @Override
  public void onPayloadReady(VirtualMachine vm) {
    // Connect to the binder server
    IBinder binder = vm.connectToVsockServer(PORT).get();
    IMyService svc = IMyService.Stub.asInterface(binder);
    // Talk with server using custom AIDL interface
    Result res = svc.doSomething();
  }
}); //exception handling & proper threading omitted
vm.run();

Para fazer o download do código-fonte de um app de demonstração que mostra as etapas deste documento, consulte MicrodroidDemo.