最新の Office JavaScript API ライブラリとバージョン 1.1 アドイン マニフェスト スキーマに更新する

  • [アーティクル]

この記事では、Office アドイン プロジェクトに含まれる JavaScript ファイル (Office.js およびアプリに固有の .js ファイル) とアドイン マニフェスト検証ファイルをバージョン 1.1 に更新する方法について説明します。

注:

Visual Studio 2019 以降で作成されたプロジェクトでは、バージョン 1.1 が既に使用されています。 ただし、バージョン 1.1 には、この記事の手法を使用して適用できるマイナー更新プログラムが時折存在します。

最新のプロジェクト ファイルを使用する

Visual Studio を使用してアドインを開発する場合は、Office JavaScript API の最新の API メンバーと アドイン XML マニフェストの v1.1 機能 (offappmanifest-1.1.xsd に対して検証) を使用するには、最新バージョンの Visual Studio をダウンロードする必要があります。 Visual Studio をダウンロードするには、 Visual Studio IDE ページを参照してください。 インストール時には、Office/SharePoint 開発ワークロードを選択する必要があります。

Visual Studio 以外のテキスト エディターまたは IDE を使用してアドインを開発する場合は、Office.jsのコンテンツ配信ネットワーク (CDN) への参照と、アドインのマニフェストで参照されているスキーマのバージョンを更新する必要があります。

Visual Studio で作成した Office アドイン プロジェクトを更新する

Office JavaScript API とアドイン マニフェスト スキーマの v1.1 のリリース前に作成されたプロジェクトの場合は、 NuGet パッケージ マネージャーを使用してプロジェクトのファイルを更新し、アドインの HTML ページを更新して参照できます。

更新プロセスは プロジェクトごとに 適用されることに注意してください。Office.js マニフェスト スキーマとアドイン マニフェスト スキーマの v1.1 を使用するアドイン プロジェクトごとに、更新プロセスを繰り返す必要があります。

プロジェクト内の Office JavaScript API ライブラリ ファイルを最新のリリースに更新する

次の手順では、Office.js ライブラリ ファイルを最新バージョンに更新します。 この手順では Visual Studio 2019 を使用しますが、以前のバージョンの Visual Studio でも同様です。

  1. Visual Studio 2019 で、新しい Office アドイン プロジェクトを開くか作成します。
  2. [ツール>] [NuGet パッケージ マネージャー>][ソリューションの Nuget パッケージの管理] の順に選択します。
  3. [更新] タブを選択します。
  4. Microsoft.Office.js を選択します。 パッケージ ソースが nuget.org からであることを確認します。
  5. 左側のウィンドウで、[ インストール ] を選択し、パッケージの更新プロセスを完了します。

更新を完了するには、さらにいくつか手順を実行する必要があります。 アドインの HTML ページの ヘッド タグで、既存の office.js スクリプト参照をコメントアウトまたは削除し、更新された Office JavaScript API ライブラリを次のように参照します。

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

注:

CDN URL の office.js の /1/ は、Office.js のバージョン 1 内で最新の増分リリースを使用するように指定します。

プロジェクト内のマニフェスト ファイルがバージョン 1.1 のスキーマを使用するように更新する

アドインのマニフェスト ファイルで、バージョン値を に変更する OfficeApp> 要素の<xmlns 属性を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 要素のいずれかに置き換える必要があります。

テキスト エディターまたは他の IDE で作成した Office アドイン プロジェクトを更新する

Office JavaScript API とアドイン マニフェスト スキーマの v1.1 のリリース前に作成されたプロジェクトの場合は、アドインの HTML ページを更新して v1.1 ライブラリの CDN を参照し、スキーマ v1.1 を使用するようにアドインのマニフェスト ファイルを更新する必要があります。

更新プロセスは プロジェクトごとに適用されます 。Office.jsマニフェスト スキーマとアドイン マニフェスト スキーマの v1.1 を使用するアドイン プロジェクトごとに更新プロセスを繰り返す必要があります。

Office アドインを開発するために Office JavaScript API ファイル (Office.jsおよびアプリ固有の.js ファイル) のローカル コピーは必要ありません (Office.jsの CDN を参照すると、必要なファイルが実行時にダウンロードされます)、ライブラリ ファイルのローカル コピーが必要な場合は 、NuGet Command-Line ユーティリティ と Install-Package Microsoft.Office.js コマンドを使用してダウンロードできます。

注:

v1.1 アドイン マニフェストの XSD (XML スキーマ定義) のコピーを取得するには、「Office アドイン マニフェスト のスキーマ リファレンス」の一覧を参照してください。

最新のリリースを使用するように、プロジェクト内の Office JavaScript API ライブラリ ファイルを更新します

  1. テキスト エディターまたは IDE でアドインの HTML ページを開きます。

  2. アドインの HTML ページの ヘッド タグで、既存の office.js スクリプト参照をコメントアウトまたは削除し、更新された Office JavaScript API ライブラリを次のように参照します。

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

    注:

    CDN URL で office.js の前にある /1/ は、Office.js のバージョン 1 内で最新の増分リリースを使用するように指定します。

プロジェクト内のマニフェスト ファイルがバージョン 1.1 のスキーマを使用するように更新する

アドインのマニフェスト ファイルで、バージョン値を に変更する OfficeApp> 要素の<xmlns 属性を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 要素のいずれかに置き換える必要があります。

関連項目