次の方法で共有

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

  • [アーティクル]

主な変更点は、新しい plusbeta モデルの導入、その他の多くの改善と追加機能です。

リリース日: 2018 年 7 月 5 日

重要

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

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

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

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

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

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

    2. 更新された v1.5 パッケージをインストールします:

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

  2. 次の TypeScript 型宣言パッケージをインストールします。

    npm install **\@types/webpack-env@1.13.1
npm install **\@types/es6-promise@0.0.33

  3. tsconfig.json ファイルの types 配列に次のエントリを追加します。

    {
  // omitted for brevity
  "types": [
    // omitted for brevity
    "webpack-env",
    "es6-promise"
  ]
  // omitted for brevity
}

ヒント

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

新機能

出荷 API と ベータ API が別々のパッケージになりました

v1.5.0 リリース以降、パッケージには *.d.ts ファイル内の最終的なパブリック API のみが含まれます。 すべてのベータ API が削除され、ベータ API を含むパッケージを明示的に選択する必要があります。 これらのベータ API を使用するには、パッケージの 1.5.0-plusbeta バージョンを使用する必要があります。 @microsoft/generator-sharepoint のバージョンは 1 つだけであり、ベータ版とベータ版ソリューションの両方を作成できます。

次の 2 つの方法のいずれかでベータ API を使用するソリューションを作成できます。 yeoman ジェネレーターを実行してコマンドラインに --plusbeta フラグを追加すると、-plusbeta バージョンが既に含まれている package.json ファイルが作成されます。または、package.json の参照を更新して -plusbeta バージョンを使用することもできます。

これは通常のアプローチとは異なります。ベータ版のパッケージ全体が存在する場合もあるものの、一部のベータ版 API が既存の出荷パッケージに含まれることも一般的であるためです。 また、機能が複数のリリースでプレビューに残る可能性があるため、それが次のリリースのベータ版であるとは限りません。

動的データ (開発者プレビュー)

このリリースの主な部分は、動的データの開発者プレビューです。 これは、従来のページの Web パーツ接続機能を現代的に取り入れたものと考えることができます。

この機能の最終目標は、開発者とユーザーがプロパティをより動的にできるようにすることと、他のWebパーツ (ドキュメントライブラリWebパーツで現在選択されているドキュメントによって駆動されるユーザーカードなど)、ページの状態 (ユーザーカードに作成者が表示される)、またはページコンテキスト (ユーザーカードに現在のユーザーが表示される) をプロパティにバインドできるようにすることです。

この開発プレビューは、主に基盤となるデータ モデルに焦点を当てています。 現在、プロパティを公開しているファースト パーティの Web パーツはありません。 サンプルページ コンテキスト オブジェクトと、Web パーツプ ロパティをバインドする動的プロパティへのパスを入力できる大まかな (開発者向け) プロパティ ウィンドウ コントロールがあります。

私たちは現在もエンド ユーザー エクスペリエンスに取り組んでいますが、それまでの間、開発者にこちらを試してもらいたいと考えています。 次の場所からチュートリアルと例を見つけることができます。

追加のパッケージ マネージャーのサポート (Yarn & PNPM)

Yeoman ジェネレーターとビルドツールは、PNPM と Yarn パッケージ マネージャー、および npm のサポートを開始しました。

これを使用するには、ジェネレーターの --package-manager コマンドライン オプションを使用し、npm、**pnpm、または yarn を指定できます。

例:

yo @microsoft/sharepoint --package-manager pnpm

カスタマイズされた Yeoman ジェネレーターのサポート

ベスト プラクティスに準拠するように、ジェネレーターを作り直しました。 これにより、独自のカスタム ジェネレーターにジェネレーターを活用できるようになります。 SharePoint Dev コミュニティ (PnP) の下で、これに関する新しいオープンソースイニシアチブを開始し、Angular Elements や Vue.js などの新しいサポートされているプラットフォームを提供します。

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

フレームワークの更新の多くは、実際には npm パッケージの更新を必要としません。 たとえば、Web API 開発者プレビュー コードの初期リリースで認証ポップアップを削除しましたが、変更はサービスでホストされているフレームワークにロールアウトされるため、開発者は変更する必要がありません。

パッケージの更新を明示的に必要とする更新がいくつかあります。

  • PageContext (aadInfo) に AAD 情報を追加しました
  • ワークベンチで sp-dialog やその他のパッケージが正しく機能しない問題を修正しました
  • 一般的なセキュリティの脆弱性を検出するために、tslint-microsoft-config から 10 個の追加の tslint ルールを追加しました
  • 警告が原因でビルドが誤って失敗するパッケージ ソリューションの問題を修正しました