Scrivere un'app AVF

Un'app compatibile con AVF è costituita da due parti: la parte dell'app in esecuzione sul sistema operativo Android host e la parte dell'app in esecuzione su Microdroid all'interno di una pVM.

La parte dell'app in esecuzione su Android implementa l'interfaccia utente, la logica di business non riservata e crea e gestisce il ciclo di vita di una pVM.

La parte dell'app in esecuzione su Microdroid, all'interno di una pVM, è responsabile dell'esecuzione di tutte le attività che devono essere eseguite in modo sicuro.

Per avviare e comunicare con la parte pVM dell'app, l'applicazione host crea una pVM ed esegue una libreria condivisa nativa all'interno della pVM. Questa libreria implementa un servizio di binder che la parte host dell'app utilizza per comunicare con la parte dell'app all'interno di una pVM. La Figura 1 mostra le due parti dell'applicazione e il canale di comunicazione del binder:

Caricamento e comunicazione dell'app AVF

Figura 1. Caricamento e comunicazione dell'app AVF

Configurare il file di configurazione

Il file vm_config.json deve contenere una voce per il sistema operativo e la libreria condivisa della pVM. Il seguente file assets/vm_config.json mostra le voci del file di configurazione per Microdroid e una libreria nativa condivisa:

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

Implementare il servizio di binder

All'interno della libreria condivisa, implementa un servizio di binder. Ad esempio:

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

Creare il codice dell'app

Nella parte host dell'app, crea il codice che prepara il file di configurazione, carica (o crea) un handle per la VM ed esegue la VM. Ad esempio:

// 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();

Comunicare con la parte VM dell'app

Per comunicare con la parte VM dell'app, devi prima registrare un callback per ricevere una notifica quando il servizio di binder sulla VM è pronto. Quando ricevi la notifica, ti connetti al server di binder e poi comunichi con il server utilizzando l'interfaccia AIDL personalizzata. Ad esempio:

// 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();

Per scaricare il codice sorgente di un'app demo che illustra i passaggi descritti in questo documento, consulta MicrodroidDemo.