Проверка манифеста надстройки Office

Может потребоваться проверить файл манифеста надстройки, чтобы убедиться в его правильности и полноте. Проверка может также выявлять проблемы, которые приводят к появлению ошибки "Манифест надстройки недействителен" при попытке загрузить неопубликованную надстройку. В этой статье описаны разные способы проверки файла манифеста.

Примечание

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

Проверка манифеста с помощью генератора Yeoman для надстроек Office

Если для создания надстройки использовался генератор Yeoman для надстроек Office, вы также можете использовать его для проверки файла манифеста проекта. Выполните следующую команду в корневом каталоге своего проекта.

npm run validate

Анимированный GIF, отображающий валидатор Yo Office, запускаемый в командной строке, и генерирующий результаты, отображающие пройденную проверку.

Примечание

Чтобы получить доступ к этой функции, необходимо создать проект надстройки с помощью генератора Yeoman для Office версии надстройки 1.1.17 или более поздней версии.

Office проверка магазина

Команда validate также Office проверку магазина, но позволяет получить сведения о разработчике, такие как URL-адреса localhost. Если вы хотите выполнить проверку Office Store на уровне Office, запустите следующую команду.

npm run validate -- -p

Проверка манифеста с помощью office-addin-manifest

Если для создания надстройки использовался не генератор Yeoman для надстроек Office, вы можете проверить манифест, используя office-addin-manifest.

  1. Установите Node.js.

  2. Откройте командную подсказку и установите валидатор со следующей командой.

    npm install -g office-addin-manifest
    
  3. Запустите следующую команду в корневом каталоге проекта.

    npm run validate
    

    Примечание

    Если эта команда недоступна или не работает, запустите следующую команду, чтобы заставить использовать последнюю версию средства office-addin-manifest ( MANIFEST_FILE заменив имя файла манифеста).

    npx office-addin-manifest validate MANIFEST_FILE
    

Office проверка магазина

Команда validate также Office проверку магазина, но позволяет получить сведения о разработчике, такие как URL-адреса localhost. Если вы хотите выполнить проверку Office Store на уровне Office, запустите следующую команду.

npm run validate -- -p

Если у вас возникли проблемы с этой командой, попробуйте следующее (заменив MANIFEST_FILE имя файла манифеста).

npx office-addin-manifest validate -p MANIFEST_FILE

Проверка манифеста на соответствие схеме XML

Вы можете проверить файл манифеста на соответствие файлам XML Schema Definition (XSD). Так вы сможете убедиться в том, что файл манифеста соответствует правильной схеме, включая любые пространства имен для используемых элементов. Если вы скопировали элементы из других примеров манифеста, еще раз проверьте, включены ли соответствующие пространства имен. Для этой проверки можно использовать средство проверки на соответствие схеме XML.

Как проверить манифест на соответствие схеме XML с помощью программы командной строки

  1. Установите tar и libxml, если вы еще этого не сделали.

  2. Выполните указанную ниже команду. Вместо XSD_FILE укажите путь к XSD-файлу манифеста, а вместо XML_FILE — путь к XML-файлу манифеста.

    xmllint --noout --schema XSD_FILE XML_FILE
    

См. также