Обновление до последней версии библиотеки API JavaScript для Office и схемы манифеста надстройки версии 1.1

  • Статья

В этой статье рассказывается, как обновить файлы JavaScript (Office.js и JS-файлы для конкретной надстройки) и файл проверки манифеста надстройки в проекте надстройки Office до версии 1.1.

Примечание.

Проекты, созданные в Visual Studio 2019 или более поздней версии, уже будут использовать версию 1.1. Однако иногда существуют незначительные обновления версии 1.1, которые можно применить с помощью методов, описанных в этой статье.

Использование последних версий файлов в проекте

Если вы используете Visual Studio для разработки надстройки, чтобы использовать новейшие члены API Office JavaScript и функции XML-манифеста надстройки версии 1.1 (который проверяется на соответствие offappmanifest-1.1.xsd), необходимо скачать последнюю версию Visual Studio. Чтобы скачать Visual Studio, перейдите на страницу интегрированной среды разработки Visual Studio. Во время установки потребуется выбрать рабочую нагрузку разработки Office и SharePoint.

Если для разработки надстройки используется текстовый редактор или интегрированная среда разработки, отличные от Visual Studio, необходимо обновить ссылки на сеть доставки содержимого (CDN) для Office.js и версию схемы, на которую ссылается манифест надстройки.

Обновление проекта надстройки Office, созданного в Visual Studio

Для проектов, созданных до выпуска версии 1.1 API JavaScript для Office и схемы манифеста надстройки, можно обновить файлы проекта с помощью диспетчера пакетов NuGet, а затем обновить HTML-страницы надстройки, чтобы сослаться на них.

Обратите внимание, что процесс обновления применяется для каждого проекта . Необходимо повторить процесс обновления для каждого проекта надстройки, в котором вы хотите использовать версию 1.1 Office.js и схему манифеста надстройки.

Обновление файлов библиотеки API JavaScript для Office в проекте до новейшего выпуска

Следующие действия помогут обновить файлы библиотеки Office.js до последней версии. В этих шагах используется Visual Studio 2019, но они аналогичны предыдущим версиям Visual Studio.

  1. В Visual Studio 2019 откройте или создайте проект надстройки Office .
  2. Выберите Инструменты> Диспетчер >пакетов NuGetУправление пакетами Nuget для решения.
  3. Выберите вкладку Обновления.
  4. Выберите Microsoft.Office.js. Убедитесь, что источник пакета получен из nuget.org.
  5. В левой области выберите Установить и завершите процесс обновления пакета.

Вам потребуется выполнить несколько дополнительных действий, чтобы завершить обновление. В теге head html-страниц надстройки закомментируйте или удалите все существующие ссылки на скрипты office.js и составьте ссылку на обновленную библиотеку API JavaScript для Office следующим образом:

<script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>

Примечание.

/1/ в office.js в URL-адресе CDN указывает на то, что необходимо использовать последний добавочный выпуск Office.js версии 1.

Обновление схемы манифеста в проекте до версии 1.1

В файле манифеста надстройки обновите атрибут <xmlns элемента OfficeApp>, изменив значение версии на 1.1 (оставив атрибуты, отличные от атрибута xmlns, без изменений).

<?xml version="1.0" encoding="utf-8"?>
<OfficeApp xsi:type="ContentApp"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://schemas.microsoft.com/office/appforoffice/1.1">
  
  <!-- manifest contents -->

</OfficeApp>

Примечание.

После обновления версии схемы манифеста надстройки до версии 1.1 необходимо будет удалить элементы Capabilities и Capability и заменить их элементами Hosts и Host либо элементами Requirements и Requirements.

Обновление проекта надстройки Office, созданного с помощью текстового редактора или другой среды IDE

Для проектов, созданных до выпуска версии 1.1 API JavaScript для Office и схемы манифеста надстройки, необходимо обновить HTML-страницы надстройки, чтобы они ссылались на CDN библиотеки версии 1.1, а файл манифеста надстройки — для использования схемы версии 1.1.

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

Для разработки надстройки Office не требуются локальные копии файлов API JavaScript для Office (Office.js и файлов .js приложений) (ссылка на CDN для Office.js скачивает необходимые файлы во время выполнения), но если вам нужна локальная копия файлов библиотеки, можно использовать служебную программу Command-Line NuGet и Install-Package Microsoft.Office.js команду для их скачивания.

Примечание.

Сведения о том, как получить копию XSD (определение схемы XML) для манифеста надстройки версии 1.1, см. в разделе Справочник по схемам для манифестов надстроек Office.

Обновите файлы библиотеки API JavaScript для Office в проекте, чтобы использовать новейший выпуск.

  1. Откройте HTML-страницы надстройки в текстовом редакторе или интегрированной среде разработки.

  2. В теге head html-страниц надстройки закомментируйте или удалите все существующие ссылки на скрипты office.js и составьте ссылку на обновленную библиотеку API JavaScript для Office следующим образом:

    <script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>

    Примечание.

    /1/ перед office.js в URL-адресе CDN указывает на то, что необходимо использовать последний добавочный выпуск Office.js версии 1.

Обновление схемы манифеста в проекте до версии 1.1

В файле манифеста надстройки обновите атрибут <xmlns элемента OfficeApp>, изменив значение версии на 1.1 (оставив атрибуты, отличные от атрибута xmlns, без изменений).

<?xml version="1.0" encoding="utf-8"?>
<OfficeApp xsi:type="ContentApp"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns="http://schemas.microsoft.com/office/appforoffice/1.1">
  
  <!-- manifest contents -->

</OfficeApp>

Примечание.

После обновления версии схемы манифеста надстройки до версии 1.1 необходимо будет удалить элементы Capabilities и Capability и заменить их элементами Hosts и Host либо элементами Requirements и Requirements.

См. также