Обновление библиотеки API JavaScript для Office до последней версии и схемы манифеста надстройки до версии 1.1Update to the latest JavaScript API for Office library and version 1.1 add-in manifest schema

В этой статье рассказывается, как обновить файлы JavaScript (Office.js и JS-файлы для конкретной надстройки) и файл проверки манифеста надстройки в проекте надстройки Office до версии 1.1.This article describes how to update your JavaScript files (Office.js and app-specific .js files) and add-in manifest validation file in your Office Add-in project to version 1.1.

Примечание

Проекты, создаваемые в Visual Studio 2017, уже используют версию 1.1.Projects created in Visual Studio 2017 will already use version 1.1. Однако для версии 1.1 периодически выпускаются незначительные обновления, которые можно применить с помощью методов, описанных в этой статье.However there are occasional minor updates to version 1.1 that you can apply by using the techniques in this article.

Использование последних версий файлов в проектеUse the most up-to-date project files

Если для разработки надстройки вы используете Visual Studio, то чтобы можно было применять самые новые элементы API в API JavaScript для Office и возможности манифеста надстройки версии 1.1 (который проверяется на соответствие offappmanifest-1.1.xsd), вам потребуется скачать Visual Studio 2017.If you use Visual Studio to develop your add-in, to use the newest API members of the JavaScript API for Office and the v1.1 features of the add-in manifest (which is validated against offappmanifest-1.1.xsd), you need to download Visual Studio 2017. Чтобы скачать Visual Studio 2017, перейдите на страницу интегрированной среды разработки Visual Studio.To download Visual Studio 2017, see the Visual Studio IDE page. Во время установки потребуется выбрать рабочую нагрузку разработки Office и SharePoint.During installation you'll need to select the Office/SharePoint development workload.

Если вы используете текстовый редактор или другую интегрированную среду разработки, отличную от Visual Studio, чтобы разработать надстройка, обновите ссылки на CDN для файла Office.js и версию схемы, на которую ссылается манифест приложения для Office.If you use a text editor or IDE other than Visual Studio to develop your add-in, you need to update the references to the CDN for Office.js and the version of schema referenced in your add-in's manifest.

Чтобы запустить надстройку, разработанную с использованием новых и обновленных компонентов манифеста надстройки и интерфейса API Office.js, ваши клиенты должны использовать локальные продукты Office 2013 с пакетом обновления 1 (SP1) или более поздней версии, а также при необходимости SharePoint Server 2013 с пакетом обновления 1 (SP1) и связанными серверными продуктами, Пакет обновления 1 (SP1) для Exchange Server 2013 или аналогичные размещенные в сети продукты: Office 365, SharePoint Online и Exchange Online.To run an add-in developed using new and updated Office.js API and add-in manifest features, your customers must be running Office 2013 SP1 or later version on-premises products, and where applicable, SharePoint Server 2013 SP1 and related server products, Exchange Server 2013 Service Pack 1 (SP1), or the equivalent online hosted products: Office 365, SharePoint Online, and Exchange Online.

Сведения о том, как скачать Office, SharePoint и Exchange с пакетом обновления 1, см. в следующих статьях:To download Office, SharePoint, and Exchange SP1 products, see the following:

Обновление проекта надстройки Office, созданного в Visual StudioUpdating an Office Add-in project created with Visual Studio

Для проектов, созданных до выпуска версии 1.1 библиотеки JavaScript API для Office и схемы манифеста надстройки, вы можете обновить файлы проекта, используя диспетчер пакетов NuGet, а затем добавить ссылки на них в HTML-страницы надстройки.For projects created before the release of v1.1 of the JavaScript API for Office and add-in manifest schema, you can update a project's files using the NuGet Package Manager, and then update your add-in's HTML pages to reference them.

Обратите внимание, что процесс обновления применяется к проектам по отдельности. Вам потребуется повторить его для каждого проекта надстройки, в котором вы хотите использовать Office.js и схему манифеста надстройки версии 1.1.Note that the update process is applied on a per-project basis - you'll need to repeat the updating process for each add-in project in which you want to use v1.1 of Office.js and add-in manifest schema.

Обновление файлов библиотеки API JavaScript для Office в проекте до последней версииUpdate the JavaScript API for Office library files in your project to the newest release

Обновить файлы библиотеки Office до последней версии можно с помощью указанных ниже действий.The following steps will update your Office library files to the latest version. В них используется Visual Studio 2017, но они аналогичны для Visual Studio 2015.The steps use Visual Studio 2017, but they are similar for Visual Studio 2015.

  1. В Visual Studio 2017 откройте или создайте проект Надстройка Office.In Visual Studio 2017, open or create a new Office Add-in project.
  2. Выберите Средства > Диспетчер пакетов NuGet > Управление пакетами Nuget для решения.Choose Tools > NuGet Package Manager > Manage Nuget Packages for Solution.
  3. В диспетчере пакетов NuGet выберите nuget.org для параметра Источник пакетов.In the NuGet Package Manager, select nuget.org for Package source.
  4. Выберите вкладку Обновления.Choose the Updates tab.
  5. Выберите Microsoft.Office.js.Select Microsoft.Office.js.
  6. В области слева выберите Обновить и завершите обновление пакета.In the left pane, choose Update and complete the package update process.

Вам потребуется выполнить несколько дополнительных действий, чтобы завершить обновление.You'll need to take a few additional steps to complete the update. В теге head HTML-страниц надстройки закомментируйте или удалите все ссылки на скрипт office.js и добавьте ссылки на обновленную библиотеку API JavaScript для Office, как показано ниже.In the head tag of your add-in's HTML pages, comment out or delete any existing office.js script references, and reference the updated JavaScript API for Office library as follows:

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

Примечание

/1/ в office.js в URL-адресе CDN указывает на то, что необходимо использовать последний добавочный выпуск Office.js версии 1.The /1/ in the office.js in the CDN URL specifies to use the latest incremental release within version 1 of Office.js.

Обновление схемы манифеста в проекте до версии 1.1Update the manifest file in your project to use schema version 1.1

В файле манифеста надстройки обновите атрибут xmlns элемента OfficeApp, заменив значение версии на 1.1 и оставив все атрибуты, кроме xmlns, без изменений.In your add-in's manifest file, update the xmlns attribute of the OfficeApp element changing the version value to 1.1 (leaving attributes other than the xmlns attribute unchanged).

<?xml version="1.0" encoding="utf-8"?>
<OfficeApp xsi:type="ContentApp"
    xmlns:xsi="https://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 и Requirement.After updating the version of the add-in manifest schema to 1.1, you will need to remove the Capabilities and Capability elements, and replace them with either the Hosts and Host elements or the Requirements and Requirement elements.

Обновление проекта надстройки Office, созданного с помощью текстового редактора или другой среды IDEUpdating an Office Add-in project created with a text editor or other IDE

Если вы создали проект до выпуска схемы манифеста надстройки и API JavaScript для Office версии 1.1, обновите HTML-страницы вашей надстройки, чтобы они ссылались на CDN библиотеки версии 1.1, а также обновите файл манифеста надстройки, чтобы использовалась схема версии 1.1.For projects created before the release of v1.1 of the JavaScript API for Office and add-in manifest schema, you need to update your add-in's HTML pages to reference CDN of the v1.1 library, and update your add-in's manifest file to use schema v1.1.

Процесс обновления применяется к проектам по отдельности. Вам потребуется повторить его для каждого проекта надстройки, в котором вы хотите использовать файл Office.js и схему манифеста надстройки версии 1.1.The update process is applied on a per-project basis - you'll need to repeat the updating process for each add-in project in which you want to use v1.1 of Office.js and add-in manifest schema.

Вам не нужны локальные копии файлов API JavaScript для Office (Office.js и JS-файлов для конкретной надстройки), чтобы разрабатывать надстройку Office (ссылки на CDN для Office.js позволяют скачивать необходимые файлы во время выполнения). Если вам нужны файлы библиотеки, то вы можете скачать их с помощью служебной программы командной строки NuGet и Install-Package Microsoft.Office.js.You don't need local copies of the JavaScript API for Office files (Office.js and app-specific .js files) to develop anOffice Add-in (referencing the CDN for Office.js downloads the necessary files at runtime), but if you want a local copy of the library files you can use the NuGet Command-Line Utility and the Install-Package Microsoft.Office.js command to download them.

Примечание

Чтобы получить копию XSD (определения схемы XML) для манифеста надстройки версии 1.1, см. статью Справочник по схеме манифестов надстроек Office (версия 1.1).To get a copy of the XSD (XML Schema Definition) for the v1.1 add-in manifest, see the listing in Schema reference for Office Add-ins manifests (v1.1).

Обновление файлов библиотеки API JavaScript для Office в проекте до последней версииUpdate the JavaScript API for Office library files in your project to use the newest release

  1. Откройте HTML-страницы надстройки в текстовом редакторе или интегрированной среде разработки.Open the HTML pages for your add-in in your text editor or IDE.

  2. В теге head HTML-страниц надстройки закомментируйте или удалите все ссылки на скрипт office.js и добавьте ссылки на обновленную библиотеку API JavaScript для Office, как показано ниже.In the head tag of your add-in's HTML pages, comment out or delete any existing office.js script references, and reference the updated JavaScript API for Office library as follows:

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

    Примечание

    /1/ перед office.js в URL-адресе CDN указывает на то, что необходимо использовать последний добавочный выпуск Office.js версии 1.The /1/ in front of office.js in the CDN URL specifies to use the latest incremental release within version 1 of Office.js.

Обновление схемы манифеста в проекте до версии 1.1Update the manifest file in your project to use schema version 1.1

В файле манифеста надстройки обновите атрибут xmlns элемента OfficeApp, заменив значение версии на 1.1 и оставив все атрибуты, кроме xmlns, без изменений.In your add-in's manifest file, update the xmlns attribute of the OfficeApp element changing the version value to 1.1 (leaving attributes other than the xmlns attribute unchanged).

<?xml version="1.0" encoding="utf-8"?>
<OfficeApp xsi:type="ContentApp"
  xmlns:xsi="https://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 и Requirement.After updating the version of the add-in manifest schema to 1.1, you will need to remove the Capabilities and Capability elements, and replace them with either the Hosts and Host elements or the Requirements and Requirement elements.

См. такжеSee also