SharePoint Framework v1.4.1 のリリース ノート
リリース日: 2018 年 2 月 15 日
重要
このページでは、特定の SPFx リリース バージョンに関連する詳細について説明します。 このページには、Node.js、Yeoman、その他のツールなど、SPFx ソリューションを開発するためにインストールする必要のある追加の SPFx 前提条件は含まれていません。
これらの前提条件の詳細については、「SharePoint Framework 開発環境を設定する」を参照してください。
v1.4 から v1.4.1 へのプロジェクトのアップグレード
- プロジェクトの package.json ファイルで、すべての SPFx v1.4 パッケージを特定します。各 SPFx パッケージについて、次を実行します。
既存の v1.4 パッケージをアンインストールします。
npm uninstall @microsoft/{spfx-package-name}@1.4
更新された v1.4.1 パッケージをインストールします。
npm install @microsoft/{spfx-package-name}@1.4.1.0 --save --save-exact
ヒント
Microsoft 365 の CLI には、ソリューションを最新の SharePoint Framework バージョンにアップグレードするための簡単で段階的なガイダンスが用意されています。
新機能
Node v8 (LTS) と NPM v5 のサポート
Node.js v8 (LTS) と NPM v5 のサポートが SPFx で利用可能になりました。
ここで報告される問題: https://github.com/SharePoint/sp-dev-docs/issues/1002
記事「SharePoint Framework 開発環境の設定」も更新しました。
新しい API (開発者プレビュー)
SharePoint Online 内でプレビューに使用できる新しい API を次に示します。 これらは、まだ 運用環境で使用するためのものでは ありません。
@microsoft/sp-http
- AadHttpClient クラスの初期ベータ リリース
- AadTokenProvider クラスの初期ベータ リリース
@microsoft/sp-client-preview
- MSGraphClient クラスの初期ベータ リリース
これらの新しい API のチュートリアルは、Office SharePoint 開発ドキュメントから入手できます。
AadHttpClient (開発者プレビュー)
AadHttpClient は、Azure でホストされているサードパーティの WebAPI など、Azure AD アプリケーションに対して REST 呼び出しを実行するために使用されます。
- SharePoint と通信する場合は、代わりに
SPHttpClient
クラスを使用します。 - Microsoft Graph と通信する場合は、
MSGraphClient
クラスを使用します。
この新しい API に関する詳細情報は、Office SharePoint 開発ドキュメントを参照してください。
MSGraphClient (開発者プレビュー)
MSGraphClient
は、Microsoft Graph に対して REST 呼び出しを実行するために使用されます。 Microsoft Graph JavaScript クライアント ライブラリは、Microsoft Graph API の軽量ラッパーです。 このクラスを使用すると、開発者は MSGraph クライアント ライブラリを初期化することなく、MSGraph の REST 呼び出しを開始できます。
カスタム構成が必要な場合は、要求ごとに MSGraphClient
API 関数にそのカスタム構成を指定する必要があります。
重要
この API によって、以前にリリースされた GraphHttpClient
が置き換えられることに注意してください。これは現在、非推奨とされています。
AadTokenProvider
このクラスは、AadHttpClient と MSGraphClient によって Azure AD から OAuth2 トークンを取得するために使用される内部クラスです。 このクラスは現在パブリックとしてマークされていますが、内部として変更される予定です。 そのため、ソリューションは AadHttpClient
と MSGraphClient
クラスにのみ依存する必要があります。
このリリースに含まれる変更
- 新しいバージョンの SPFx パッケージのアクティブ化を妨げていたジェネレーターの問題を修正しました。
- 現象 - 新しいバージョンの SharePoint Framework パッケージを展開すると、Web パーツ ピッカーに Web パーツが表示されなくなる。
修正: この問題を完全に修正するには、SharePoint Online テナントで次の手順を実行する必要があります。
- サイト レベルから既存の SharePoint Framework ソリューションのすべてのインスタンスを削除する
- アプリ カタログから SharePoint Framework ソリューションを削除する
- 1.4.1 バージョンでビルドされた新しい SharePoint Framework ソリューションをアプリ カタログにアップロードする
- SharePoint Framework ソリューションをサイトにインストールし直す
注意
この問題は、テナントを対象とする SharePoint Framework ソリューションでは発生 しません。また、SharePoint アドインでは発生しません。
ヒント
アプリケーション ライフサイクル管理 (ALM) API を利用して、この必要なプロセスを自動化できます。
このリリースでの非推奨と削除アイテム
- このリリースで
GraphHttpClient
API は非推奨になり、代わりに新しいMSGraphClient
が導入されました。GraphHttpClient
は、今後のリリースで削除される予定です。