Пакет приложения для Microsoft 365

Пакет приложения для Microsoft 365 представляет собой ZIP-файл, содержащий файл манифеста, два значка приложения и, возможно, дополнительные файлы конфигурации или локализации. Логика приложения и хранилище данных размещаются в другом месте и получают доступ к ведущему приложению Microsoft 365 по протоколу HTTPS. Вы отправите пакет приложения администратору для публикации в организации или в Центр партнеров для публикации в Microsoft Marketplace.

Как минимум, пакет приложения содержит:

  • Манифест приложения (manifest.json), описывающий конфигурацию приложения, возможности, необходимые ресурсы и важные атрибуты.
  • Большой полноцветный значок (color.png), размером 192 x 192 пикселя, для отображения агента в пользовательском интерфейсе и хранилище Microsoft 365 Copilot.
  • Небольшой значок контура (outline.png), 32 x 32 пикселя, с прозрачным фоном (в настоящее время не используется в Copilot, но требуется для прохождения проверки).

Пакет приложения также может содержать декларативные определения агента и подключаемого модуля API, а также файлы локализации для других поддерживаемых языков.

Схема, показывающая структуру пакета приложения Microsoft 365: манифест приложения (.json файл) + значки (цвет и контур .png файлы), заключенные в файл .zip.

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

Манифест унифицированного приложения для Microsoft 365 представляет собой JSON-файл, в котором описываются функции и характеристики надстройки, например:

  • Отображаемое имя, описание, идентификатор, версию и языковой стандарт по умолчанию надстройки.

  • Способ интеграции надстройки с Office.  

  • Как надстройка интегрируется с Copilot (предварительная версия).

  • Уровень разрешений и требования для доступа к данным для надстройки.

Подробный обзор манифеста см. в статье Надстройки Office с манифестом унифицированного приложения для Microsoft 365. Справочную документацию см. в справочнике по схеме манифеста приложения Microsoft 365.

Значки приложений

Пакет приложения должен содержать цветную и структурную версию значка приложения, так как .png файлы. Эти значки имеют определенные требования к размеру для прохождения проверки в магазине. Подробные рекомендации по проектированию цветных и контурных значков для пакета приложений Microsoft 365 см. в разделе Конструктор значков для приобретения надстроек и управления ими.

Другие файлы конфигурации и локализации

Помимо манифеста и двух файлов значков, пакет приложения также может содержать некоторые из следующих файлов.

  • Файлы локализации, на которые ссылается "localizationInfo" свойство манифеста.
  • Файлы декларативного агента Copilot, на которые ссылается "copilotAgents" свойство .
  • Любые дополнительные файлы второго уровня. Например, декларативные файлы конфигурации агента Copilot иногда ссылались на дополнительные файлы второго уровня, например файлы конфигурации подключаемого модуля Copilot.

Создание файла пакета приложения вручную

Этот файл пакета приложения обычно создается с помощью средств, используемых для создания и тестирования приложения для Microsoft 365, но в некоторых сценариях его создание выполняется вручную. Для этого используйте любую служебную программу ZIP, чтобы создать ZIP-файл, содержащий следующие файлы.

  • Унифицированный манифест, который входит в корень ZIP-файла.
  • Два файла изображений, на которые ссылается "icons" свойство манифеста.
  • Все файлы локализации, на которые ссылается "localizationInfo" свойство манифеста.
  • Все декларативные файлы агента, на которые ссылается "copilotAgents" свойство .
  • Любые дополнительные файлы второго уровня. Например, декларативные файлы конфигурации агента Copilot иногда ссылались на дополнительные файлы второго уровня, например файлы конфигурации подключаемого модуля Copilot. Они также должны быть включены.

Важно!

Все эти файлы должны иметь тот же относительный путь в ZIP-файле, как указано в манифесте. Например, если путь к двум файлам изображений — assets/color.png и assets/outline.png, необходимо включить папку assets с двумя файлами в ZIP-пакет. Файлы второго уровня, например файлы конфигурации подключаемого модуля для декларативных агентов, должны иметь тот же относительный путь в ZIP-файле, что и в файле первого уровня, который ссылается на них. Например, если относительный путь к декларативному файлу агента, указанному в манифесте, — agents/myAgent.json, необходимо включить папку агентов в ZIP-пакет и поместить в нее myAgent.json файл. Если декларативный файл агента, в свою очередь, предоставляет относительный путь подключаемых модулей/myPlugin.json для файла конфигурации подключаемого модуля, необходимо включить вложенную папку plugins в папку agents и поместить в нее файл myPlugin.json .

Чтобы обеспечить максимальную совместимость со средствами разработки Microsoft 365, рекомендуется хранить файлы, которые будут включены в пакет, в папке appPackage в корневой папке проекта, а файл пакета поместить во вложенную папку build в папку appPackage .

Ниже приведены примеры рекомендуемой структуры. Структура внутри файла\build\appPackage.zip должна зеркало структуру папки appPackage, за исключением самой папки сборки.

\appPackage
    \assets
        color.png
        outline.png
    \build
        appPackage.zip
    manifest.json

\appPackage
    \agents
        myAgent.json
        \plugins
            myPlugin.json
    \assets
        color.png
        outline.png
    \build
        appPackage.zip
    \languages
        fr-FR.json
        es-MX.json
    manifest.json

Примечание.

Файлы JSON, на которые ссылается свойство манифеста "extensions.keyboardShortcuts.keyMappingFiles" , не включаются в пакет приложения. Они развертываются с файлами веб-приложения надстройки. Дополнительные сведения см. в статье Поддержка обратной совместимости надстроек с унифицированным манифестом в Microsoft Marketplace.

  • Last updated on