- Next.js
JSS 22.3のNext.jsアプリをバージョン22.4にアップグレードしてください
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このトピックでは、既存のJSS 22.3アプリケーションに対して、バージョン22.4の最新改善を享受するために必要とされるほとんどの変更点をカバーします。しかし、JavaScriptやNext.jsアプリケーション開発の性質上、既存のアプリケーションで可能なすべてのカスタマイズをこのトピックではカバーしていません。
JSSの22.4リリースでは、すべてのコア @sitecore-jssパッケージからAxios依存が削除されました。この依存関係はコアJSS機能に深く根付いており、その削除により、ネイティブNode fetch、代替のfetchライブラリ、最新のAxiosバージョン(最新のセキュリティ修正や機能を含む)を通じて、JSSアプリがSitecoreと通信する柔軟性が高まります。
!注デフォルトのフェッチャーとしてのAxiosの削除に関する変更の詳細は、関連する 変更ログエントリを参照してください。
アップグレードの際には、Next.jsアプリケーションを作成する際に使ったJSSテンプレートやアドオンを考慮してください。それらはpackage.jsonファイル内で見つけることができます。例えば、JSS 22.3アプリケーションでは以下のテンプレートやアドオンが使われることがあります。
- nextjs
- nextjs-styleguide
- nextjs-multisite
!注始める前に
まだでなければ、アプリをJSS 22.3にアップグレードしてください。
変更ログに慣れておきましょう。アプリケーションが大幅にカスタマイズされている場合、変更ログはこのトピックで扱われていない追加の変更点の指針を提供します。
このトピックでは、以下の方法を説明します:
:::walkthrough2。 nextjs-styleguide-trackingアドオンを更新してください:::
既存のアプリでアプリケーション依存関係を更新する
アップグレードされたアプリケーションを正しく動作させるには、依存関係を更新する必要があります。
依存関係を更新するには:
-
既存のアプリケーションのpackage.jsonファイルで、すべての @sitecore-jssパッケージをバージョン ~22.4.0に更新してください。
-
以下のコマンドで依存関係をインストールします:
npm install
nextjs-styleguide-trackingアドオンの更新
nextjs-styleguide-trackingアドオンのアップグレード:
- src/data-fetcher.tsでは、以下のことを行ってください。
-
AxiosDataFetcherを見つけてインポート明細AxiosResponse。
-
その文を削除し、次の文に置き換えてください。
import { NativeDataFetcher, NativeDataFetcherResponse } from '@sitecore-jss/sitecore-jss-nextjs';
-
dataFetcher機能を見つけてください。
-
その関数を削除し、次のものに置き換えてください:
export async function dataFetcher
( url: string, data?: unknown ): Promise { return new NativeDataFetcher().fetch (url, data); }
-
今後のステップ
アプリケーションの残りの部分では、他のAxiosインポート文を以下のように置き換えてください:
既存の輸入
代替輸入
AxiosDataFetcher
NativeDataFetcher
AxiosResponse
NativeDataFetcherResponse
AxiosDataFetcherConfig
NativeDataFetcherConfig
アップグレードプロセスを最終決定するには、発生したエラーや警告を必ず解決してください。必要に応じて、JSS固有の問題に対してデバッグログを有効にし てください。