Update auf die neueste Office JavaScript-API-Bibliothek und Version 1.1 des Add-In-Manifestschemas

In diesem Artikel wird beschrieben, wie Sie die JavaScript-Dateien (Office.js und App-spezifische .js-Dateien) und die Add-In-Manifestvalidierungsdatei im Office-Add-In-Projekt auf Version 1.1 aktualisieren.

Hinweis

Projekte, die in Visual Studio 2019 oder höher erstellt wurden, verwenden bereits Version 1.1. Es gibt jedoch gelegentlich kleinere Updates für Version 1.1, die Sie mithilfe der in diesem Artikel beschriebenen Techniken anwenden können.

Aktuelleste Projektdateien verwenden

Wenn Sie Visual Studio zum Entwickeln Ihres Add-Ins verwenden, müssen Sie die neueste Version von Visual Studio herunterladen, um die neuesten API-Member der Office-JavaScript-API und die v1.1-Features des Add-In-XML-Manifests (das anhand von offappmanifest-1.1.xsd überprüft wird) zu verwenden. Informationen zum Herunterladen von Visual Studio finden Sie auf der Seite Visual Studio-IDE. Während der Installation müssen Sie die Arbeitslast für die Office/SharePoint-Entwicklung auswählen.

Wenn Sie zum Entwickeln Ihres Add-Ins einen anderen Text-Editor oder eine andere IDE als Visual Studio verwenden, müssen Sie die Verweise auf das Content Delivery Network (CDN) für Office.js und die Schemaversion aktualisieren, auf die im Manifest Ihres Add-Ins verwiesen wird.

Aktualisieren eines Office-Add-In-Projekts mithilfe von Visual Studio

Für Projekte, die vor der Veröffentlichung von Version 1.1 der Office JavaScript-API und des Add-In-Manifestschemas erstellt wurden, können Sie die Dateien eines Projekts mithilfe des NuGet-Paket-Managers aktualisieren und dann die HTML-Seiten Ihres Add-Ins aktualisieren, um darauf zu verweisen.

Beachten Sie, dass der Aktualisierungsprozess projektbezogen angewendet wird. Sie müssen den Aktualisierungsvorgang für jedes Add-In-Projekt wiederholen, in dem Sie v1.1 des Office.js- und Add-In-Manifestschemas verwenden möchten.

Aktualisieren der Office JavaScript-API-Bibliotheksdateien in Ihrem Projekt auf die neueste Version

Die folgenden Schritte aktualisieren Ihre Office.js-Bibliotheksdateien auf die neueste Version. Die Schritte verwenden Visual Studio 2019, aber sie sind für frühere Versionen von Visual Studio ähnlich.

  1. Öffnen oder erstellen Sie in Visual Studio 2019 ein neues Office-Add-In-Projekt .
  2. Wählen Sie Tools>NuGet-Paket-Manager>NuGet-Pakete für Projektmappe verwalten aus.
  3. Wählen Sie die Registerkarte Updates.
  4. Wählen Sie „Microsoft.Office.js“ aus. Stellen Sie sicher, dass die Paketquelle aus nuget.org stammt.
  5. Wählen Sie im linken Bereich Installieren aus, und schließen Sie den Paketupdatevorgang ab.

Sie müssen ein paar weitere Schritte ausführen, um das Update abzuschließen. Kommentieren Oder löschen Sie im Head-Tag der HTML-Seiten Ihres Add-Ins vorhandene office.js Skriptverweise, und verweisen Sie wie folgt auf die aktualisierte Office JavaScript-API-Bibliothek:

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

Hinweis

Die Notation /1/ in office.js in der CDN-URL gibt an, dass die neueste inkrementelle Version innerhalb von Version 1 von „Office.js“ verwendet werden soll.

Aktualisieren der Manifestdatei in Ihrem Projekt für die Verwendung von Schemaversion 1.1

Aktualisieren Sie in der Manifestdatei Ihres Add-Ins das xmlns-Attribut des <OfficeApp-Elements> , indem Sie den Versionswert in 1.1 ändern (andere Attribute als das xmlns-Attribut bleiben unverändert).

<?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>

Hinweis

Nachdem Sie die Version des Add-In-Manifestschemas auf 1.1 aktualisiert haben, müssen Sie die Capabilities - und Capability-Elemente entfernen und durch die Elemente Hosts und Host oder Requirements und Requirement ersetzen.

Aktualisieren eines mit einem Text-Editor oder einer anderen integrierten Entwicklungsumgebung erstellten Office-Add-In-Projekts

Für Projekte, die vor der Veröffentlichung von v1.1 der Office JavaScript-API und des Add-In-Manifestschemas erstellt wurden, müssen Sie die HTML-Seiten Ihres Add-Ins aktualisieren, um auf das CDN der v1.1-Bibliothek zu verweisen, und die Manifestdatei Ihres Add-Ins aktualisieren, um Schema v1.1 zu verwenden.

Der Aktualisierungsprozess wird pro Projekt angewendet. Sie müssen den Aktualisierungsprozess für jedes Add-In-Projekt wiederholen, in dem Sie v1.1 des Office.js- und Add-In-Manifestschemas verwenden möchten.

Sie benötigen keine lokalen Kopien der Office JavaScript-API-Dateien (Office.js und app-spezifischen .js-Dateien), um einOffice-Add-In zu entwickeln (unter Verweisen auf das CDN für Office.js lädt die erforderlichen Dateien zur Laufzeit herunter). Wenn Sie jedoch eine lokale Kopie der Bibliotheksdateien benötigen, können Sie das NuGet Command-Line Utility und den Install-Package Microsoft.Office.js Befehl verwenden, um sie herunterzuladen.

Hinweis

Informationen zum Abrufen einer Kopie der XSD (XML-Schemadefinition) für das v1.1-Add-In-Manifest finden Sie in der Liste in der Schemareferenz für Office-Add-Ins-Manifeste.

Aktualisieren der Office JavaScript-API-Bibliotheksdateien in Ihrem Projekt zur Verwendung der neuesten Version

  1. Öffnen Sie die HTML-Seiten Ihres Add-Ins in Ihrem Texteditor oder Ihrer IDE.

  2. Kommentieren Oder löschen Sie im Head-Tag der HTML-Seiten Ihres Add-Ins vorhandene office.js Skriptverweise, und verweisen Sie wie folgt auf die aktualisierte Office JavaScript-API-Bibliothek:

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

    Hinweis

    Die Notation /1/ vor office.js in der CDN-URL legt fest, dass die neueste inkrementelle Version innerhalb von Version 1 von „Office.js“ verwendet werden soll.

Aktualisieren der Manifestdatei in Ihrem Projekt für die Verwendung von Schemaversion 1.1

Aktualisieren Sie in der Manifestdatei Ihres Add-Ins das xmlns-Attribut des <OfficeApp-Elements> , indem Sie den Versionswert in 1.1 ändern (andere Attribute als das xmlns-Attribut bleiben unverändert).

<?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>

Hinweis

Nachdem Sie die Version des Add-In-Manifestschemas auf 1.1 aktualisiert haben, müssen Sie die Capabilities - und Capability-Elemente entfernen und durch die Elemente Hosts und Host oder Requirements und Requirement ersetzen.

Siehe auch