英語で読む

次の方法で共有


SharePoint Framework v1.6 のリリース ノート

このリリースには、次の 2 つの主な機能が含まれています。

  • 最初に v1.4.1 でプレビューされたWebAPI 機能の最終リリース
  • すべてのサイトをアクティブ化または構成することなく、拡張機能へのサポートをテナント全体に構成します。

リリース: 2018 年 9 月 5 日

重要

このページでは、特定の SPFx リリース バージョンに関連する詳細について説明します。 このページには、Node.js、Yeoman、その他のツールなど、SPFx ソリューションを開発するためにインストールする必要のある追加の SPFx 前提条件は含まれていません。

これらの前提条件の詳細については、「SharePoint Framework 開発環境を設定する」を参照してください。

vv1.5.1 から v1.6 へのプロジェクトのアップグレード

  1. プロジェクトの package.json ファイルで、すべての SPFx v1.5.1 パッケージを特定します。 各 SPFx パッケージの場合:
    1. 既存の v1.5.1 パッケージをアンインストールします:

      npm uninstall @microsoft/{spfx-package-name}@1.5.1
      
    2. 更新された v1.6 パッケージをインストールします:

      npm install @microsoft/{spfx-package-name}@1.6.0 --save --save-exact
      

ヒント

Microsoft 365 の CLI には、ソリューションを最新の SharePoint Framework バージョンに アップグレード するための簡単で段階的なガイダンスが用意されています。

新機能

Web API (一般提供)

WebAPI機能については、GA (一般提供) 作業で導入されたいくつかの変更があります。 AAD で保護されたリソースへのすべてのアクセスは、サード パーティ製の AAD アプリケーションとサービス プリンシパルによって処理されます。 アプリケーションは、テナント管理者がアクセス許可スコープを初めて承認すると作成され、アクセス許可が 0 で作成されます。 そのため、データへの接続 (Microsoft Graphまたはアクセス許可に AAD を使用するエンドポイントへの呼び出しのいずれかを使用) は、明示的に許可する必要があります。

重要

v1.6.0 リリースより前に付与されたアクセス許可は、使用される AAD アプリケーションが変更されたため、再付与する必要があります。

  • MSGraphClientを使用。 コンポーネント (Web パーツまたは拡張機能) のコンテキストに存在します。 パフォーマンス上の理由から、完全なコードはオンデマンドで読み込まれるため、Promise を介してアクセスされます。
  • GraphHttpClient の使用を停止します (まだ停止していない場合)。 来月中のいつか、コードから完全に削除します。 それを使用しているソリューションはすべて動作しなくなります。
  • AAD セキュリティで保護されたエンドポイントを呼び出すコンテキストから外れた一般的なAadHttpClientと、認証トークンを手動で取得するために使用できる AadTokenProvider もMSGraphClientと同様です。

拡張機能のテナント全体への展開

拡張機能のテナント全体の構成を作成できるようになりました。 テナント全体に展開する最も簡単な方法は、(新しい v1.6.0 ソリューションで作成された) \SharePoint\ClientInstance.xml ファイルを変更することです。 これにより、アプリ カタログ (テナント全体の拡張機能) の新しい一覧にエントリが作成されます。 その一覧は、アプリ カタログの所有者として直接変更することもできます。

このリリースに含まれる変更

ビルドとツールの変更

一般的なビルド ツールに関するラッパーの一部から移行しようとしています。 最初の 2 つは、tslint と ts コンパイラの手順です。 これらの変更により、いくつかの変更がないと、以前のコードはコンパイルされません。

  • まず、ソース ディレクトリのルートに *.ts ファイルを作成する必要があります (既定では、\src の下に index.ts という名前のファイルが空になります)。
  • 次に、tslint.json ファイルの場所 ( \config からプロジェクトのルート) と形式が変更されました。 これで、標準のtslint.json ファイルになりました。 最も簡単な操作は、新しいプロジェクトを作成し、 tslint.json ファイルをコピーすることです。
  • 3 番目に、手順 2 で新しいプロジェクトのルートから [tsconfig.json] ファイルを取得し、元のプロジェクトのルートにコピーします。 tsconfig.json ファイルに変更を加えた場合は、それらをマージします。

CSS クラスの一般提供への昇格

@microsoft/sp-dialog パッケージで、ベータ版としてマークされたクラスがいくつか見つかりました。 それらはパブリックに移動しました。

注意

これは、ビルド ツールが Node.js v6 をサポートする最後のリリースです。