Mettre à jour vers la dernière bibliothèque d’API JavaScript Office et le schéma de manifeste de complément version 1.1

  • Article

Cet article décrit comment mettre à jour vers la version 1.1 les fichiers JavaScript pour Office (Office.js et fichiers .js propres aux applications) et le fichier de validation du manifeste du complément utilisés dans votre projet de complément Office.

Remarque

Les projets créés dans Visual Studio 2019 ou version ultérieure utilisent déjà la version 1.1. Toutefois, il existe des mises à jour mineures occasionnelles de la version 1.1 que vous pouvez appliquer à l’aide des techniques décrites dans cet article.

Utilisation des fichiers de projet les plus récents

Si vous utilisez Visual Studio pour développer votre complément, pour utiliser les membres d’API les plus récents de l’API JavaScript Office et les fonctionnalités v1.1 du manifeste XML du complément (qui est validé par rapport à offappmanifest-1.1.xsd), vous devez télécharger la dernière version de Visual Studio. Pour télécharger Visual Studio, consultez la page IDE Visual Studio. Lors de l’installation, vous devez sélectionner la charge de travail de développement Office/SharePoint.

Si vous utilisez un éditeur de texte ou un IDE autre que Visual Studio pour développer votre complément, vous devez mettre à jour les références au réseau de distribution de contenu (CDN) pour Office.js et la version du schéma référencée dans le manifeste de votre complément.

Mise à jour d’un projet de complément Office créé avec Visual Studio

Pour les projets créés avant la publication de la version 1.1 de l’API JavaScript Office et du schéma du manifeste de complément, vous pouvez mettre à jour les fichiers d’un projet à l’aide du Gestionnaire de package NuGet, puis mettre à jour les pages HTML de votre complément pour les référencer.

Notez que le processus de mise à jour est appliqué par projet : vous devez répéter le processus de mise à jour pour chaque projet de complément dans lequel vous souhaitez utiliser la version 1.1 du schéma de manifeste de Office.js et de complément.

Mettre à jour les fichiers de bibliothèque d’API JavaScript Office dans votre projet vers la version la plus récente

Les étapes suivantes mettent à jour vos fichiers de bibliothèque Office.js vers la dernière version. Les étapes utilisent Visual Studio 2019, mais elles sont similaires pour les versions précédentes de Visual Studio.

  1. Dans Visual Studio 2019, ouvrez ou créez un projet de complément Office .
  2. Choisissez Outils> Gestionnaire >de package NuGetGérer les packages Nuget pour la solution.
  3. Sélectionnez l’onglet Mises à jour.
  4. Sélectionnez Microsoft.Office.js. Vérifiez que la source du package provient de nuget.org.
  5. Dans le volet gauche, choisissez Installer et terminez le processus de mise à jour du package.

Vous devez effectuer quelques étapes supplémentaires pour terminer la mise à jour. Dans la balise head des pages HTML de votre complément, commentez ou supprimez les références de script office.js existantes, puis référencez la bibliothèque d’API JavaScript Office mise à jour comme suit :

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

Remarque

La valeur /1/ de office.js dans l’URL du CDN préconise l’utilisation de la dernière version incrémentielle comprise dans la version 1 d’Office.js.

Mise à jour du fichier manifeste dans votre projet afin d’utiliser la version 1.1 du schéma

Dans le fichier manifeste de votre complément, mettez à jour l’attribut xmlns de l’élément <OfficeApp> en remplaçant la valeur 1.1 de version par (en laissant inchangés les attributs autres que l’attribut 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>

Remarque

Après avoir mis à jour la version du schéma de manifeste de complément vers la version 1.1, vous devez supprimer les éléments Capabilities et Capability et les remplacer par les éléments Hosts et Host ou les éléments Requirements et Requirements.

Mise à jour d’un projet de complément Office créé avec un éditeur de texte ou une autre IDE

Pour les projets créés avant la publication de la version 1.1 de l’API JavaScript Office et du schéma de manifeste de complément, vous devez mettre à jour les pages HTML de votre complément pour référencer le CDN de la bibliothèque v1.1, et mettre à jour le fichier manifeste de votre complément pour utiliser le schéma v1.1.

Le processus de mise à jour est appliqué par projet : vous devez répéter le processus de mise à jour pour chaque projet de complément dans lequel vous souhaitez utiliser la version 1.1 du schéma de manifeste de Office.js et de complément.

Vous n’avez pas besoin de copies locales des fichiers d’API JavaScript Office (Office.js et fichiers .js spécifiques à l’application) pour développer un complément Office (référençant le CDN pour Office.js télécharge les fichiers nécessaires au moment de l’exécution), mais si vous souhaitez une copie locale des fichiers de bibliothèque, vous pouvez utiliser l’utilitaire NuGet Command-Line et la Install-Package Microsoft.Office.js commande pour les télécharger.

Remarque

Pour obtenir une copie du XSD (XML Schema Definition) pour le manifeste de complément v1.1, consultez la liste dans La référence de schéma pour les manifestes des compléments Office.

Mettre à jour les fichiers de bibliothèque d’API JavaScript Office dans votre projet pour utiliser la version la plus récente

  1. Ouvrez les pages HTML de votre complément dans un éditeur de texte ou une interface IDE.

  2. Dans la balise head des pages HTML de votre complément, commentez ou supprimez les références de script office.js existantes, puis référencez la bibliothèque d’API JavaScript Office mise à jour comme suit :

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

    Remarque

    la valeur /1/ devant office.js dans l’URL du CDN préconise l’utilisation de la dernière version incrémentielle comprise dans la version 1 d’Office.js.

Mise à jour du fichier manifeste dans votre projet afin d’utiliser la version 1.1 du schéma

Dans le fichier manifeste de votre complément, mettez à jour l’attribut xmlns de l’élément <OfficeApp> en remplaçant la valeur 1.1 de version par (en laissant inchangés les attributs autres que l’attribut 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>

Remarque

Après avoir mis à jour la version du schéma de manifeste de complément vers la version 1.1, vous devez supprimer les éléments Capabilities et Capability et les remplacer par les éléments Hosts et Host ou les éléments Requirements et Requirements.

Voir aussi