Manifesto dell'applicazione

Il manifesto dell'applicazione descrive le risorse, chiamate anche funzionalità, richieste da un'applicazione. Tutte le applicazioni dispongono di un manifesto.

Le applicazioni devono fornire il consenso esplicito all'uso delle funzionalità elencando ogni risorsa necessaria nella sezione Capabilities del manifesto dell'applicazione. Nessuna funzionalità è abilitata per impostazione predefinita. Se un'applicazione richiede una funzionalità non elencata, la richiesta ha esito negativo. Se il file manifesto dell'applicazione contiene errori, i tentativi di eseguire il trasferimento locale dell'applicazione hanno esito negativo. Il manifesto di ogni applicazione deve essere archiviato come app_manifest.json nella directory radice della cartella dell'applicazione nel PC.

Il modello di Azure Sphere genera automaticamente un manifesto dell'applicazione predefinito quando si crea un'applicazione. È necessario modificare il manifesto predefinito per elencare le funzionalità richieste dall'applicazione. Ogni esempio per Azure Sphere include anche un manifesto dell'applicazione. Se si basa l'applicazione su un esempio, sarà probabilmente necessario modificare anche il manifesto.

Dispositivi Azure Sphere diversi possono esporre le funzionalità del chip in modi diversi. Il valore usato nel manifesto per identificare una determinata funzionalità, ad esempio un pin del GPIO, può pertanto variare a seconda dell'hardware per cui si stanno eseguendo le attività di sviluppo. In Gestire le dipendenze hardware di destinazione sono disponibili altre informazioni sulle destinazioni hardware per un'applicazione di alto livello. Nel manifesto dell'applicazione per un'applicazione di alto livello usare le costanti definite nel file JSON nella cartella HardwareDefinitions della directory di installazione di Microsoft Azure Sphere SDK. Il percorso esatto della directory di installazione sarà diverso in Windows e Linux. In un'applicazione con operazioni in tempo reale (RTApp) usare i valori non elaborati elencati in Contenuto del manifesto dell'applicazione.

Quando un'applicazione qualsiasi viene trasferita localmente o distribuita nel dispositivo, il runtime di Azure Sphere legge il manifesto dell'applicazione per verificare quali funzionalità può usare l'applicazione. I tentativi di accesso a risorse non elencate nel manifesto provocheranno errori di API, ad esempio EPERM (autorizzazione negata). Una risorsa può essere usata solo da un'applicazione nel dispositivo. Se si installa un'applicazione che richiede una risorsa già in uso, il tentativo avrà esito negativo.

Contenuto del manifesto dell'applicazione

Il manifesto dell'applicazione include gli elementi seguenti:

La sezione Capabilities supporta quanto segue:

La sezione MutableStorage supporta quanto segue:

Esempio

Di seguito è riportato un file app_manifest.json di esempio per un'applicazione di alto livello che ha come destinazione l'hardware della scheda di sviluppo di riferimento MT3620:

{
    "SchemaVersion": 1,
    "Name": "MyTestApp",
    "ComponentId": "072c9364-61d4-4303-86e0-b0f883c7ada2",
    "EntryPoint": "/bin/app",
    "CmdArgs": ["-m", "262144", "-t", "1"],
    "Capabilities": {
        "AllowedConnections" : [
            "my-hub.example.net",
            "contoso.azure-devices.net",
            "global.azure-devices-provisioning.net" ],
        "AllowedTcpServerPorts": [ 1024, 65535 ],
        "AllowedUdpServerPorts": [ 1024, 50000 ],
        "DeviceAuthentication": "77304f1f-9530-4157-8598-30bc1f3d66f0",
        "Gpio": [ "$MT3620_RDB_HEADER1_PIN6_GPIO", "$MT3620_RDB_LED1_RED", "$MT3620_RDB_BUTTON_A" ],
        "HardwareAddressConfig": true,
        "I2cMaster": [ "ISU2" ],
        "MutableStorage" : {
            "SizeKB": 64,
        },
        "SpiMaster": [ "ISU1" ],
        "SystemTime" : true,
        "Uart": [ "ISU0" ],
        "WifiConfig" : true
    },
    "ApplicationType": "Default",
    "MallocVersion": 2
}

Il file di esempio app_manifest.json per MyTestApp esegue le operazioni seguenti:

• Passa quattro argomenti della riga di comando all'app.
• Consente solo le connessioni agli host DNS my-hub.example.net, contoso.azure-devices.net e global.azure-devices-provisioning.net.
• Consente il traffico TCP in ingresso sulle porte 1024 e 65535.
• Consente il traffico UDP in ingresso sulle porte 1024 e 50000.
• Specifica un UUID tenant di Azure Sphere (legacy) da usare per l'autenticazione del dispositivo e consente le connessioni al servizio Device Provisioning.
• Specifica l'uso di tre GPIO.
• Consente all'applicazione di configurare l'indirizzo hardware dell'interfaccia di rete.
• Specifica l'uso di una periferica UART.
• Abilita l'archiviazione modificabile con 64 kibibyte di spazio di archiviazione.
• Consente all'app di usare l'API WifiConfig per modificare la configurazione del Wi-Fi.
• Specifica l'uso di un'interfaccia master SPI.
• Specifica l'uso di un'interfaccia master I2C.
• Consente all'app di configurare l'ora di sistema tramite l'API RTC.
• Abilita il mallocng per lo sviluppo di app.