應用程式資訊清單

應用程式指令清單描述應用程式所需的資源，也稱為 應用程式功能。 每個應用程式都有應用程式指令清單。

應用程式必須加入加入功能，方法是在應用程式指令清單的 [功能 ] 區段中列出每個必要資源;預設不會啟用任何功能。 如果應用程式要求未列出的功能，要求就會失敗。 如果應用程式指令清單檔案包含錯誤，則嘗試側載應用程式失敗。 每個應用程式的指令清單都必須儲存為計算機上的應用程式資料夾根目錄中app_manifest.json。

當您建立應用程式時，Azure Sphere 樣本會自動建立預設應用程式指令清單。 您必須編輯預設指令清單，以列出應用程式所需的功能。 每個 Azure Sphere 範例也都包含應用程式指令清單。 如果您將應用程式以範例為基礎，您可能也需要編輯指令清單。

不同的 Azure Sphere 裝置可能會以不同方式公開晶片的功能。 因此，您在指令清單中用來識別特定功能的值，例如 GPIO 針腳，可能會因您正在開發的硬體而有所不同。 管理目標硬體相依性 提供高階應用程式硬體目標的詳細資訊。 在高階應用程式的應用程式指令清單中，使用Microsoft Azure Sphere SDK 安裝目錄之 HardwareDefinitions 資料夾中 JSON 檔案中定義的常數。 安裝目錄的確切位置在 Windows 和 Linux 上會有所不同。 在即時可用的應用程式 （RTApp） 中，使用應用程式指令清單內容中所列的原始值。

當任何應用程式側載或部署至裝置時，Azure Sphere 執行時間會讀取應用程式指令清單，以確定應用程式允許使用哪些功能。 嘗試存取指令清單中未列出的資源會導致 API 錯誤，例如 EPERM（許可權遭拒）。 裝置上只有一個應用程式可以使用資源。 如果您安裝要求已在使用中的資源的應用程式，嘗試將會失敗。

應用程式指令清單的內容

應用程式指令清單包含下列專案：

[功能] 區段支援下列專案：

MutableStorage 區段支援下列專案：

範例

以下顯示目標為 MT3620 RDB 硬體的高階應用程式範例app_manifest.json檔案：

{
    "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
}

MyTestApp 的範例app_manifest.json檔案會執行下列動作：

• 將四個命令行自變數傳遞至應用程式。
• 只允許連線到 DNS 主機 my-hub.example.net、contoso.azure-devices.net 和 global.azure-devices-provisioning.net。
• 允許埠 1024 和 65535 上的傳入 TCP 流量。
• 允許埠 1024 和 50000 上的連入 UDP 流量。
• 指定要用於裝置驗證的 Azure Sphere（舊版）租使用者 UUID，並允許連線到裝置布建服務。
• 指定三個 GPO 的使用。
• 允許應用程式設定網路介面的硬體位址。
• 指定一個 UART 周邊的使用。
• 啟用具有 64 kibibytes 儲存空間的可變動記憶體。
• 可讓應用程式使用 WifiConfig API 來變更 Wi-Fi 組態。
• 指定使用一個 SPI 主要介面。
• 指定一個 I2C 主要介面的使用。
• 可讓應用程式使用 RTC API 設定系統時間。
• 啟用應用程式開發的 mallocng。