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は、モデル ビュー コントローラー (MVC) パターンを実装するMicrosoftのWebアプリケーション フレームワークです。このアーキテクチャ パターンでは、アプリケーションをモデル、ビュー、コントローラーの3つの主要なコンポーネントに分けます。MVCを初めて使用する開発者はASP.NET 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アイテムをシリアル化および逆シリアル化して、これらのアイテムをソース管理システムに出し入れする必要があります。これにはいくつかのツールがあります。最も人気のある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ファイルをコピーし、プロジェクトの作成時にVisual Studioが追加したglobal.asaxファイルを上書きします。ファイルには次の内容のみを含める必要があります。

    %@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で、Falseに追加されたNuGet Package Manager各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パッケージ」を参照してください。

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