Svn Collaboration

SVNでの共同開発におけるBINディレクトリ管理のベストプラクティス

共同開発環境において、プロジェクトのBINディレクトリを効果的に管理することは、スムーズな運用にとって重要な要素です。SVN（Subversion）を使用する際、特にDotNetNuke（DNN）サイトのようなマルチ開発者のコンテキストでは、一貫性を維持することが難しい場合があります。このブログポストでは、BINディレクトリのチェックインとプロジェクトレベルの参照を効率的に管理するためのベストプラクティスを明確にします。

課題：環境のセットアップ

新しい開発者がチームに参加する際、彼らが直面する最も大きな障害の一つは、既存のチームのインフラに合わせて環境をセットアップすることです。理想的には、新しい開発者はSVNからトランクをチェックアウトし、DNNデータベースを復元し、すべてがシームレスに機能することができる必要があります。しかし、次のような一般的な疑問が生じます：

  • プロジェクトレベルの参照はチェックインから除外すべきか？
  • すべてのbinディレクトリを追加することが実用的か？

これらの質問は、共同環境での依存関係や参照を管理するための明確な戦略の必要性を示しています。

SVNでのBINディレクトリチェックインのためのベストプラクティス

以下は、SVNで作業する際にBINディレクトリと参照を効果的に管理するためのお勧めのベストプラクティスです。

1. グローバル無視パスを使用

  • BINおよびOBJフォルダーを無視:
    • グローバル無視パスを設定して、チェックインからbin、obj、または同様にコンパイルされたフォルダーを除外します。
    • これにより不要な混乱を防ぎ、リポジトリ内で重要なファイルのみが追跡されるようになります。

2. アセンブリを適切に管理

  • GACのアセンブリ:

    • Global Assembly Cache（GAC）に展開の予定があるアセンブリは、そこに留めておくべきです。これには、System.web.dllや、本番環境でデプロイするサードパーティDLLなどの標準アセンブリが含まれます。
    • 新しい開発者は、互換性を保つために、これらのアセンブリを自分のローカルマシンにインストールする必要があります。

  • 相対パスでサードパーティアセンブリを参照:

    • プロジェクトファイルを構成し、サードパーティアセンブリを絶対パスではなく相対パスで参照します。このプラクティスは、移植性を高め、ハードコーディングされた依存関係を減らします。

    プロジェクト構造の例:

    -Project
 --Project.sln
 --References
  ---StructureMap.dll
  ---NUnit.dll
  ---System.Web.Mvc.dll
 --Project.Web
  ---Project.Web.Proj
  ---Project.Web.Proj ファイル
 --Project
  ---Project.Proj
  ---Project.Proj ファイル

3. 一貫性を確保

  • プロジェクトが必要なアセンブリをGACまたはプロジェクトルートの中央「References」フォルダーから参照するようにします。
  • このようにアセンブリを整理することで、新しい開発者は依存関係を迅速に特定し、チームの他のメンバーと一緒に環境をセットアップできます。

4. セットアップを確認

新しい開発者を迎える前に、セットアップの検証を行います：

  • チェックアウトプロセスをテスト: 自分自身でチェックアウトとセットアッププロセスを実行し、新しい開発者が問題なく復製できることを確認します。
  • ドキュメンテーション: DNNデータベースの復元方法や必要な設定を含む、開発環境のセットアップ方法についてのドキュメントを提供します。

結論

上述したベストプラクティスに従うことで、プロジェクト管理が簡素化され、開発チーム内のコラボレーションが向上します。BINディレクトリのクリーンな構造を維持し、アセンブリ参照を効果的に管理することで、新しい開発者が通常のセットアップの頭痛なしでスピードを上げられるようにします。これらのプラクティスを優先することで、個々の生産性が向上するだけでなく、よりシームレスな共同環境に貢献します。

これらの戦略が整えば、あなたとチームは環境の不整合をトラブルシューティングするのではなく、素晴らしい機能を開発することにより集中できます。