1. その他の開発タスク

SitecoreとVisual Studioを開発用に設定する

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Visual Studioは、より高度な開発タスクやVisual Studioプロジェクトの操作に使用します。このトピックでは、次のバージョンに基づいてSitecoreとVisual Studioを設定する方法について説明します。

  • Visual Studio 2019 (英語)

  • Sitecore 9.0以降のローカル インスタンス

このトピックには、次の2つのセクションがあります。

概念

Sitecore開発用のVisual Studioプロジェクトは、さまざまな方法で設定できます。このトピックでは、次の設定について説明します。

  • MVCの使用

  • Sitecoreインストールのルート外でVisual Studioプロジェクトを作成する

  • NuGetパッケージ マネージャーとSitecoreフィードの使用

ASP.NET MVCは、MicrosoftのWebアプリケーション フレームワークで、MVC (Model-View-Controller) パターンを実装しています。このアーキテクチャ パターンでは、アプリケーションをモデル、ビュー、コントローラーの3つの主要なコンポーネントに分けます。ASP.NET MVCを初めて使用する開発者は、Microsoftから入手できるリソースを使用して、このWebアプリケーション フレームワークの操作の基本について学習する必要があります。

Sitecoreでは、MVCをレンダリング エンジンとして使用できます。Sitecoreは、ASP.NET WebFormsとMVCの両方をサポートしています。両方のレンダリング エンジンを使用できますが、1つの要求をWebFormsまたはMVCでレンダリングする必要があります。Sitecoreは、将来的にMVCを使用することを約束します。

SitecoreインストールのWebルート内にVisual Studioプロジェクトを作成することができます。これには、Visual Studioプロジェクトへの変更がWebサイトですぐに利用できるという利点があります。

ただし、Webルートの外部にプロジェクトを作成することには多くの利点があり、推奨される方法です。

  • これにより、ソリューションのファイルとSitecoreファイルの間に明確な分離が作成されます。

  • Sitecoreをアップグレードするか、新しいSitecoreインスタンスを作成して、同じVisual Studioプロジェクトを簡単に使用できます。

  • プロジェクトのバックアップ、復元、移動は簡単です。

Webルートの外部でプロジェクトを作成する場合、Sitecoreインスタンスの変更を確認するために、ビルド後にソリューションを積極的に公開する必要があります。

NuGetは、.NETを含むMicrosoft開発プラットフォームのパッケージ マネージャーです。 Sitecoreの公開NuGetパッケージ に関するFAQには、Sitecoreが提供するNuGetパッケージの詳細が記載されています。NuGetの使用は、Sitecoreアセンブリとこれらのアセンブリへの参照をプロジェクトに追加するための推奨される方法です。

考慮すべきその他のプラクティス

このトピックの範囲を超えて、大規模な開発や大規模なチームでの開発にはソース管理が必要であり、作業の一部でSitecoreアイテムが作成されるため、Sitecoreアイテムはファイルシステム自体に存在しないため、ソース管理ソフトウェアでは使用できません。

Sitecoreアイテムをシリアル化および逆シリアル化して、これらのアイテムをソース管理システムに出し入れする必要があります。これにはいくつかのツールがあります。最も人気のある2つは次のとおりです。

これら2つのソリューションの範囲は大きく異なり、ニーズに最も適したものを調査する必要があります。

Sitecoreでの開発には、Sitecore Rocks Visual Studioプラグインの使用を検討してください。Sitecore Rocksは、豊富な機能で開発者の生産性を向上させます。

そして最後に、Sitecoreの開発を大規模に行うためのベストプラクティスがいくつか登場しています。この方法論はHelixと呼ばれ、HabitatはHelixを使用して構築された広範なWebサイトの一例です。

Visual Studioプロジェクトを設定する

Sitecore MVCのVisual Studio 2017プロジェクトを設定するには:

  1. 管理者としてVisual Studio 2017を開き、File、New、Project… の順にクリックし、New ProjectダイアログでTemplates、Visual C#、Webを参照します。ASP.NET Web Applicationを選択:

    Create a new application
    メモ

    お使いのSitecoreのバージョンで使用する .NET Frameworkの正確なバージョンについては 、互換性テーブル を確認してください。

  2. 「 OK」をクリックします。 New ASP.Net Projectダイアログで、MVCのフォルダと参照を含む空のプロジェクトを作成します。

    Select a project template

  3. 作成したプロジェクト フォルダVisual Studio、SitecoreインストールのWebsiteフォルダからglobal.asaxファイルをコピーし、プロジェクトの作成時に追加したglobal.asaxファイルを上書きVisual Studio。ファイルには次の内容のみを含める必要があります。

    %@Application Language='C#' Inherits="Sitecore.Web.Application" %

  4. Visual StudioプロジェクトのWeb.configファイルは非常に最小限ですが、SitecoreインスタンスのWeb.configファイルには重要な設定が含まれています。この手順は、パブリッシュ時にVisual StudioのファイルがSitecoreのファイルを上書きしないようにするためのものです。

    Visual StudioのSolution Explorerで、プロジェクトのルートにあるWeb.configファイルを右クリックし、Propertiesを選択します。 Build ActionプロパティをNoneに設定し、Copy to Output DirectoryプロパティをDo not copyに設定します。

    Web.config properties

  5. Visual StudioのNuGet Package Managerで、次のSitecoreパッケージをプロジェクトに追加します。

    Sitecore.Kernel

    Sitecore.Mvc

    Sitecore.Mvc.Analytics

    手記

    Microsoft.AspNet.Mvcパッケージへの参照が既にある場合は、それを削除するか、開発対象のSitecoreインスタンスのMicrosoft.AspNet.Mvcパッケージのバージョンに合わせてみてください。

  6. Visual StudioのSolution Explorerで、NuGet Package ManagerがFalseに追加した各DLL参照のCopy Localプロパティを設定します。

  7. Visual StudioプロジェクトのViews/web.configファイルで、次のSitecore名前空間を名前空間の一覧に追加します。

    <add namespace="Sitecore.Mvc" />

    <add namespace="Sitecore.Mvc.Presentation" />

  8. 発行デプロイメントを設定するには、Visual StudioツールバーのCreate Publish Settingsドロップダウンで、<New Custom Profile>.

  9. Publish Webダイアログの「Publish method」フィールドで「File System」をクリックし、「Target location」フィールドでSitecoreインスタンスのWebsiteフォルダを参照して、「Publish」をクリックします。

NuGetフィードの詳細については、「 Sitecore公開NuGetフィードに関するFAQ」を参照してください。

NuGetパッケージの詳細については、「 Sitecoreアセンブリ リストNuGetパッケージ」を参照してください。

この記事を改善するための提案がある場合は、 お知らせください!