Манифест приложения

Манифест приложения описывает ресурсы, также называемые возможностями приложения, которые требуется приложению. У каждого приложения имеется манифест приложения.

Приложения должны согласиться использовать возможности, указав необходимые ресурсы в разделе Capabilities (возможности) манифеста приложения. Никакие возможности не включены по умолчанию. Если приложение запрашивает возможность, которая отсутствует в списке, запрос отклоняется. Если файл манифеста приложения содержит ошибки, попытки загрузки неопубликованного приложения завершаются сбоем. Манифест каждого приложения должен быть сохранен как файл app_manifest.json в корневом каталоге папки приложения на компьютере.

Шаблоны Azure Sphere автоматически создают манифест приложения по умолчанию при создании приложения. Необходимо изменить манифест по умолчанию, чтобы указать список возможностей, которые требуются вашему приложению. Каждый пример Azure Sphere также содержит манифест приложения. Если приложение основано на примере, вам, вероятно, потребуется изменить манифест.

Различные устройства Azure Sphere могут предоставлять функции микросхемы различными способами. Таким образом, значение, используемое в манифесте для обнаружения определенной функции, например вывод GPIO, может различаться в зависимости от оборудования, для которого выполняется разработка. Управление зависимостями целевого оборудования предоставляет дополнительные сведения о целевых объектах оборудования для высокоуровневого приложения. В манифесте приложения высокого уровня используйте константы, определенные в JSON-файле в папке HardwareDefinitions каталога установки пакета SDK Microsoft Azure Sphere. Точное расположение каталога установки будет отличаться в Windows и Linux. В приложении, поддерживающем режим реального времени (RTApp), используйте необработанные значения, перечисленные в разделе Содержимое манифеста приложения.

Когда приложение загружается без публикации или разворачивается на устройстве, среда выполнения Azure Sphere считывает манифест приложения, чтобы выяснить, какие возможности приложению разрешено использовать. Попытки получить доступ к ресурсам, которые не перечислены в манифесте, приведут к ошибкам API, например EPERM (отказ в доступе). Только одно приложение на устройстве может использовать ресурс. Если установить приложение, которое запрашивает уже используемый ресурс, попытка завершится сбоем.

Содержимое манифеста приложения

Манифест приложения содержит следующие элементы.

Раздел Capabilities поддерживает следующие элементы.

Раздел MutableStorage поддерживает следующие элементы.

Пример

Ниже приведен пример файла app_manifest.json для высокоуровневого приложения, предназначенного для оборудования MT3620 RDB:

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

Пример файла app_manifest.json для MyTestApp выполняет следующие функции:

• Передает четыре аргумента командной строки в приложение.
• Разрешает подключение только к таким узлам DNS: my hub.example.net, contoso.azure-devices.net и global.azure-devices-provisioning.net.
• Разрешает входящий трафик TCP через порты 1024 и 65535.
• Разрешает входящий трафик UDP через порты 1024 и 50000.
• Указывает UUID клиента Azure Sphere (устаревшая версия) для проверки подлинности устройства и разрешает подключения к службе подготовки устройств.
• Указывает, что используются три контакта GPIO.
• Позволяет приложению настроить аппаратный адрес сетевого интерфейса.
• Указывает, что используется одно периферийное устройство с UART.
• Обеспечивает использование изменяемого хранилища объемом 64 КиБ.
• Позволяет приложению использовать API WifiConfig для изменения настроек Wi-Fi.
• Указывает, что используется один главный интерфейс SPI.
• Указывает, что используется один главный интерфейс I2C.
• Позволяет приложению настраивать системное время с помощью API RTC.
• Включает mallocng для разработки приложений.