Écrire une application AVF

Une application compatible avec AVF se compose de deux parties: la partie de l'application s'exécutant sur l'OS Android hôte et la partie s'exécutant sur Microdroid dans une pVM.

La partie de l'application exécutée sur Android implémente l'interface utilisateur, la logique métier non confidentielle, et crée et gère le cycle de vie d'une pVM.

La partie de l'application exécutée sur Microdroid, dans une pVM, est chargée d'effectuer toutes les tâches qui doivent être effectuées de manière sécurisée.

Pour lancer et communiquer avec la partie pVM de votre application, votre application hôte crée une pVM et exécute une bibliothèque partagée native dans la pVM. Cette bibliothèque implémente un service de liaison que la partie hôte de l'application utilise pour communiquer avec la partie de l'application dans une pVM. La figure 1 montre les deux parties de l'application et le canal de communication du liaisonneur:

Créer le fichier de configuration

Votre fichier vm_config.json doit contenir une entrée pour le système d'exploitation et la bibliothèque partagée de la pVM. Le fichier assets/vm_config.json suivant présente les entrées de fichier de configuration pour Microdroid et une bibliothèque native partagée:

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

Implémenter le service de liaison

Dans votre bibliothèque partagée, implémentez un service de liaison. Exemple :

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

Créer du code d'application

Dans la partie hôte de votre application, créez du code qui prépare le fichier de configuration, charge (ou crée) un gestionnaire de la VM et exécute la VM. Exemple :

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

Communiquer avec la partie VM de votre application

Pour communiquer avec la partie VM de votre application, vous devez d'abord enregistrer un rappel pour être averti lorsque le service de liaison sur la VM est prêt. Lorsque vous êtes averti, vous vous connectez au serveur de liaison, puis communiquez avec le serveur à l'aide de l'interface AIDL personnalisée. Exemple :

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

Pour télécharger le code source d'une application de démonstration illustrant les étapes décrites dans ce document, consultez MicrodroidDemo.