SharePoint Framework v1.0.0 のリリース ノート
SPFx 1.0 の一般提供へようこそ。 これまでのワクワクするような面白い旅が、これからも続きます。 今回はまだ初のリリースで、今後も継続的に改良や機能追加を行っていく予定です。
リリース日: 2017 年 2 月 22 日
重要
このページでは、特定の SPFx リリース バージョンに関連する詳細について説明します。 このページには、Node.js、Yeoman、その他のツールなど、SPFx ソリューションを開発するためにインストールする必要のある追加の SPFx 前提条件は含まれていません。
これらの前提条件の詳細については、「SharePoint Framework 開発環境を設定する」を参照してください。
プレビュー版のプロジェクトを v1.0.0 にアップグレードする
- プロジェクトの package.json ファイルで、すべての SPFx pre-v1 パッケージを特定します。 各 SPFx パッケージの場合:
既存の pre-v1 パッケージをアンインストールします:
npm uninstall @microsoft/{spfx-package-name}
更新された v1.0.0 パッケージをインストールします:
npm install @microsoft/{spfx-package-name}@1.0.0.0 --save --save-exact
ヒント
Microsoft 365 の CLI には、ソリューションを最新の SharePoint Framework バージョンに アップグレード するための簡単で段階的なガイダンスが用意されています。
新機能
更新された npm パッケージを入手して、ローカル ワークベンチで使用することにより、すべてが順調に進むはずです。 ただし、このコードのサーバーへの展開は、数日かけて段階的に行われます。 来週中には、100% のファームで利用できるようになるはずです。 これを実行して展開を監視し、問題がないことを確認します。
SPFX やクライアント側の Web パーツは使えるようになりますか?
本当に知らなければならないことが 2 つあります。 1 つは、コードがすべてのファームで利用できること、もう 1 つは特定のテナントで機能が有効になることです。
コードがファーム全体に展開されるのと同様に、この機能はテナントにも展開されます。 現在 SPFX を所有する同じ初回リリースのテナント (ユーザーではなく、テナント) で開始します。 数週間ほどで、すべてのテナントに展開されるはずです。
一定のテナントに達しているかどうかは、アプリ カタログにパッケージをアップロードすることで、それが有効であることがわかります。 パッケージをアップロードできないテナントでも、SPFx を試すことができますが、その場合は、ローカルおよびホストされているワークベンチ (_layouts/15/workbench.aspx をご覧ください) に限定されます。
このリリースに含まれる変更
- 実際の SharePoint Framework コードにはわずかな変更しかありません。 RC0 から GA までの間に行った作業の大部分は、安定性と将来性の確保に関わるものでした。 今日作成したパーツが長年にわたって使用できるようになることが、Microsoft の明確な目標です。 ただし、基盤となるサービスの修正は問題なく提供され続け、読み込まれるフレームワーク コードなどのマイナー バージョンとパッチ バージョンが 7 種類も読み込まれることはありません。 この分野では、いくつかのコンポーネントでまだ作業が残っており、取り組んでいます。
- コード自体の最大の変更点は、SPFX に厳密な null チェック フラグを組み込んだことで、プロジェクトでもこのフラグを有効にできるようになりました。 これにより、API が若干変更されましたが、ご自身で厳密な null チェックを有効にしている場合にのみ気がつくはずです。
- その他の顕著な変更点は、Yeoman ジェネレーターを実行した場合に生成される既定値のコードにあります。 v1.0.0 は、パッケージのバージョンです。 厳密なバージョン で@types/* を参照するようになりました (lodash エラーはなくなりました)。
- (アップグレードに伴い) XML をサポートする機能があります。 これは、「昇格」モードの Web パーツに必要なフィールド、コンテンツ タイプ、リストをプロビジョニングするために使用できます。 これについては、詳細を記事にする予定です。
- クラシック ページでのシリアル化形式を最終処理しました。 Web パーツを削除して、再度追加する必要があります。 しばらくの間は、従来のシリアル化形式をサポートしますが、その後は機能を停止します。
require('./config/docs.config.html');
は、RC0 のように文字列ではなく GA でオブジェクトを返すようになりました。
既知の問題
パッケージを将来性を確保した形に移行できるようになるまで、一時的に office-ui-fabric-react を応答テンプレートから削除しました。 それには数週間ほどかかることが予想されます。