このトピックでは、 Ignite UI for jQuery™ を使用するプロジェクトを、現在のバージョンの Ignite UI for jQuery ライブラリにアップグレードする方法の詳細を説明します。
以下のリストは、このトピックを理解するための前提条件として必要なトピックを示しています。
Ignite UI for jQuery で JavaScript リソースを使用: このトピックでは、Web アプリケーションで Ignite UI for jQuery JavaScript を操作して、必要なリソースを管理する方法について説明します。
Ignite UI for jQuery のスタイル設定とテーマ設定: このトピックでは、デザイン段階でのアプリケーションのセットアップ手順について説明し、実稼働環境で CSS を使用するためのオプションを紹介すると同時に、テーマの作成またはカスタマイズについての概要を示します。
Ignite UI for jQuery での JavaScript ファイル: このトピックは、Ignite UI for jQuery に含まれるコントロールを使用して作業するために必要な JavaScript ファイルへの参照です。
各新しい Ignite UI for jQuery ボリューム リリースに新機能およびバグ修正を含みます。最新の変更を導入する場合は、すべての JavaScript およびテーマ ファイルをアップグレードすることによって、プロジェクトをアップグレードする必要があります。Ignite UI for jQuery には自動化されたアップグレード ユーティリティはないため、これらのファイルを手動で置き換える必要があります。これを行うには、まず新しいファイルおよび新しいフォルダー構造をよく理解する必要があります。これは、新しいリリースでは通常、ファイル構造が大きく変更されているためです。
アップグレードする必要があるものは、以下の表に説明するように、アプリケーションが使用するものによって異なります。
| アプリケーションが使用するもの | 更新するもの |
|---|---|
| JavaScript ファイルおよび jQuery UI テーマ | スクリプトおよびテーマ ファイル |
| JavaScript ファイルおよび jQuery UI テーマ + ASP.NET MVC | スクリプトおよびテーマ ファイル + アセンブリ参照ファイル |
Ignite UI for jQuery を使用するプロジェクトの更新手順には、JavaScript ファイルおよび jQuery UI テーマの更新が含まれます。ASP.NET MVC を使用する場合は、アセンブリへの参照も更新します。
この手順を実行するには、以下のリソースが必要です。
npm install ignite-ui
または、ライセンス版のフィードを使用している場合:
npm install @infragistics/ignite-ui-full
注: プロジェクトで
package.jsonファイルを使用している場合は、プロジェクトが依存するバージョンをそこで更新する必要があります。
JavaScript ファイルは <IgniteUI_NPM_Directory>/js/ にあります。
CSS ファイルは <IgniteUI_NPM_Directory>/css/ にあります。
これらを取得するには、Visual Studio の Nuget パッケージ マネージャーでプロジェクトの依存関係を更新します。
以下はプロセスの概念的概要です。
プロジェクトをアップグレードするには、以下のステップに従います。
1. 現在のスクリプトおよびテーマをバックアップします。
現在のリソースをバックアップするには、バックアップ フォルダーを作成し、古い JavaScript ファイルおよび jQuery UI テーマ ファイルをそのフォルダーに移動します。そのためには次の手順を実行します。
プロジェクトまたはハード ドライブで、 古い JavaScript ファイルおよび jQuery UI テーマを移動する新しいフォルダーを作成します。
JavaScript ファイルをバックアップします。“ig.” で始まるすべての Infragistics スクリプト ファイルを新しいフォルダーにコピーします。プロジェクトが結合 JavaScript ファイルを使用する場合、このファイルのみを移動する必要があります。プロジェクトが個々の JavaScript ファイルを使用する場合、すべてのファイルを移動する必要があります。
jQuery UI テーマをバックアップします。ベースおよび ig テーマを新しいフォルダーにコピーします。ig テーマの代わりにカスタムの ThemeRoller テーマを使用する場合、または縮小されたテーマを使用する場合、これらのデーまのファイルもバックアップ フォルダーにコピーします。
2. 最新バージョンのスクリプトおよびテーマへ切り替えます。
最新バージョンのリソースへ切り替えるには、既存のインフラジスティックス JavaScript および jQuery UI テーマ ファイルおよびフォルダー構造と共に削除し、新しいファイルを所定の場所にコピーします。そのためには次の手順を実行します。
既存のインフラジスティックス JavaScript ファイルおよびそのフォルダーを削除します。
(これらはすべて ig で始まるスクリプト ファイルです。)
既存の jQuery UI テーマ ファイルおよびそのフォルダーを削除します。新しいバージョンの JavaScript ファイルを、 そのフォルダー構造と共にプロジェクトの JavaScript フォルダーにコピーします。
注: JavaScript ファイルおよびフォルダー構造には最新の変更があります。変更に関する詳細については、Ignite UI for jQuery で JavaScript リソースを使用するを参照してください。
新しいバージョンの Query UI テーマ ファイルを、 そのフォルダー構造と共に、プロジェクトの themes フォルダーにコピーします。
注: バックアップ ディレクトリを参照し、バックアップした各 jQuery UI テーマに、対応する新しいテーマをコピーしたことを確認してください。
注: CSS ファイルおよびフォルダー構造には最新の変更があります。変更に関する詳細については、「Ignite UI for jQuery のスタイル設定とテーマ設定」を参照してください。
3. (条件付き) アセンブリのアップグレード
アプリケーションで ASP.NET MVC ヘルパーまたは Document アセンブリを使用している場合、新バージョンのアセンブリをアプリケーションに追加する必要があります。以下は、追加する必要のあるアセンブリのリストです。
Infragistics.Web.Mvc.dllInfragistics.WebUI.Documents.Core.dll または Infragistics.Web.Documents.Core.dllInfragistics.WebUI.Documents.IO.dll または Infragistics.Web.Documents.IO.dllInfragistics.WebUI.Documents.Reports.dll または Infragistics.Web.Documents.Reports.dllInfragistics.WebUI.Documents.Excel.dll または Infragistics.Web.Documents.Excel.dllInfragistics.WebUI.Documents.Word.dll または Infragistics.Web.Documents.Word.dll注: ドキュメント アセンブリの新バージョンは、Infragistics.Web.Documents の命名規則を使用します。
以下のようにアセンブリをアップグレードします。
Visual Studio では、Infragistics アセンブリに対する既存の参照をプロジェクトから削除します。
注: アセンブリをプロジェクトに追加する方法は、配備のタイプによって変わります。多くの場合、古いアセンブリを bin フォルダーから削除し、新しいアセンブリを bin フォルダーに追加することで十分ですが、異なる配備方法をお使いの場合には手順が異なる場合があります (たとえば、アセンブリが Global Assembly Cache (GAC) にある場合など)。
4. 結果を確認します。
結果を検証するには、アプリケーションを実行して問題を検証します。
このトピックの追加情報については、以下のトピックも合わせてご参照ください。
オンラインで表示: GitHub