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

  • [アーティクル]

このリリースでは、表示幅 (および変更) を検出するための新しいプロパティ & イベントが Web パーツ API に導入され、Microsoft Teams ソリューションのサポートが強化され、サポートされているバージョンのNode.jsが更新されます。

リリース日: 2021 年 4 月 28 日

重要

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

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

v1.11.0 から v1.12.1 へのプロジェクトのアップグレード

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

    1. 既存の v1.11.0 パッケージをアンインストールします:

      npm uninstall @microsoft/{spfx-package-name}@1.11.0

    2. 更新された v1.12 {version-release} パッケージをインストールします:

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

ヒント

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

新機能

  • テナント アプリ カタログの [Teams に同期] ボタンは、ソリューションで定義されている Teams アプリ マニフェストが存在する場合はそれを使用して、Teams アプリ パッケージを作成し、Microsoft Teams に公開します。 アプリ マニフェスト ファイルが存在しない場合、SharePoint は動的に マニフェスト ファイルを生成します。
  • 新しい API が SPFx Web パーツ クラスに追加され、Web パーツのレンダリングされた幅を決定し、オプションでイベントが変更されたときに処理します。
  • リスト通知を展開して、リストとドキュメント ライブラリの両方で機能するようにします。
  • SharePoint Framework を使用してアプリに対応する Microsoft Teams の予備サポート - 完全なサポートはサーバー側のリグレッションの修正を保留中です

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

  • Node.js v12.13.x v14.15.x & のサポートを追加しました
    • 詳細については、「SharePoint Framework 開発環境の設定」を参照してください。
    • Gulp-CLI を強くお勧めします。 以前のガイダンスでは、Gulp v3 または v4 をグローバルにインストールすることでしたが、Gulp チームからのガイダンスでは、Gulp CLI のみをグローバルにインストールすることです。 Gulp CLI を使用すると、Gulp v3 を使用するプロジェクトや Gulp v4 を使用するプロジェクトを作成できます。
  • すべてのプロジェクトの場合:
  • React を使用するプロジェクトの場合:
    • React NPM パッケージ (react&react-dom) を v16.9.0 に更新します。
    • Office UI ファブリック React NPM パッケージ / Microsoft Fluent UI (office-ui-fabric-react) を v7.156.0 に更新します。
  • デプロイメントで使用されるリソースの既定の場所が ./temp/deploy から ./releases/assets に変更されました。 SPFx v1.12.1 より前に作成されたプロジェクトの場合、./config/deploy-azure-storage.json ファイル プロパティ workingDir を新しい場所に更新する必要があります: "workingDir": "./release/assets/"。 詳細については、「SharePoint クライアント側の Web パーツを Azure CDN に展開する: Azure Storage アカウントの詳細情報を構成する」を参照してください。

このリリースでの非推奨と削除されたアイテム

  • Node.js v12+ を使用する場合、Gulp v3 はサポートされません (グローバルにもローカルにもインストールされません)。

  • ローカル ワークベンチは非推奨になりました - これは、ローカル ワークベンチのサポートを含む最後のリリースです。

  • これは、オンプレミスと SharePoint Online で機能する単一のジェネレーターを含む最後のリリースです。 古いジェネレーターを使用するだけで、オンプレミス用のプロジェクトを作成できます。

  • Gulp Serve タスクは無効化され、「サービス無効化済み 」に名前が変更されました。 この問題を解決するため、新しい SPFile v1.12.1 プロジェクトの gulpfile.js が更新され、エイリアス サービス が、「サービス無効化済み」と名前変更されたタスクへ追加されました。 ただし、プロジェクトを SPFx v1.12.1 にアップグレードする場合は、gulpfile.js ファイルを編集して、タスク Gulp Serve が引き続き動作するようにする必要があります。

    SPFx プロジェクトを v1.12.1 にアップグレードする場合は、build.initialize(require('gulp')); 行目の前に次の情報を追加します。

    var getTasks = build.rig.getTasks;
build.rig.getTasks = function () {
  var result = getTasks.call(build.rig);

  result.set('serve', result.get('serve-deprecated'));

  return result;
};

Gulp バージョン Node.js & v12 以降

Gulp v3 は、Node.js v12+ ではサポートされていません (ref gulpjs/gulp/#2324)

これは SPFx での変更ではありません。 この SPFx リリースでは Node.js v12 のサポートが追加されているため、ここで注意を喚起するために言及しました。