プロジェクト内でビルド アセットとソース コードを整理するための一般的または最適な方法は何ですか?
9 に答える
私は持っている
/src - source files (test files are within a package 'test' here, or 'test' subpackage of what is being tested)
/lib - required libraries
/doc - text documentation and development notes
/build - where we build (each separate build item within a subfolder here)
/conf - configurations (each config, production, test, developer, etc gets a folder in here, and when building Jars and Wars the correct set is copied across)
/extras - other stuff
/extras/resources - resources that should be included within generated Jars, e.g., icons
と
/websites - Web related content and configurations (each website in its own folder here)
/websites/$site/webcontent - All the web content here
/websites/$site/conf - website related configuration files here (instead of /conf)
/websites/$site/build.xml - ANT build script for website that creates a war, etc
(remember you might have an admin site and a public site for a single project, hence the multi-site configuration within a single project, or even site v1 and site v2, etc)
最終的には、プロジェクト自体、および ANT と Maven のどちらを使用するかによって、多少柔軟にする必要があります。私は ANT を使用しており、ANT スクリプトを /build に配置していますが、一部のプロジェクトでは別の場所 (一部の /websites/ など) に表示されています。
一般に:
src/ - source files
src/tests - unit tests
doc/ - documentation
res/ - static resources (textures, locale database, level definitions etc)
build/ - tools needed to build the system
project specific libraries and compilers
Makefile - the makefile (make, test, clean etc)
たとえば、.Net スタイルのプロジェクトでは次のコードを使用します。
/build/reports - reports and logs from the build process
/build/artifacts - all output of the build process is copied here
/src/ - all solution source code
/lib/ - 3rd party or other build dependencies
/tools/... - all other helper tools used in the build process
/tools/nant - example tool
/tools/nunit - example tool
/myProject.sln - visual studio solution file (or other IDE)
/default.build - nant build file
私はJavaプロジェクトのみに取り組んでおり、それらはすべて「Maven化」されているため、プロジェクト構造についてMavenによって定義された規則を使用します。
基本的:
project
src/main/java --> source files
src/main/resources --> resources files (*.xml, *.properties, etc.)
src/test/java --> source files for tests.
src/test/resources --> resources files for tests.
このフォルダ構成は、xLim の概念の進化を表しています。
このオープン ソース プロジェクトで確認できます。
Build - ignored from version control
Artifact - build artifacts (grabbed by CC.NET from here)
Package - generated zip or install packages
Test - all assemblies for unit tests
Help - autogenerated documentation
Resource
Build - plugins and extensions for NAnt/MSBuild
Library - 3rd party dependencies
Tool
FxCop
ILMerge
NCover
NCoverExplorer
NUnit
SHFB
Wix
Samples
SampleProject1
SampleProject2
Source
Project1
Project2
GlobalAssemblyInfo.cs
VersionAssemblyInfo.cs - integration server updates this one
Test
Project1.Tests
Project2.Tests
Solution.build - primary build file
Solution.ccnet - CruiseControl adapter for the build file
Solution.sln - Visual Studio
go.cmd - shortcut for launching the build file locally
readme.txt - licenses and overview
SharedKey.snk - for strong naming
個人的に使ってる
/client/projectname/trunk/source/Solution Name.sln
/client/projectname/trunk/source/Project.One
/client/projectname/trunk/source/Project.Two
/client/projectname/trunk/source/Project.Three
/client/projectname/trunk/source/SQL/
/client/projectname/trunk/source/SQL/SomeScript.sql
/client/projectname/trunk/libraries
/client/projectname/trunk/resources/Nunit
/client/projectname/trunk/resources/LLBLGEN
/client/projectname/trunk/documentation
/client/projectname/trunk/builds
私たちにとってはうまくいきますが、それが最善だとは思いません。.net に関するものであれば、 treesurgeonも参照できます。彼らは次のように説明しています。
新しい開発ツリーのセットアップに数日を費やしたことはありますか? いくつかの開発ツリーをセットアップするのに数日を費やしたことがありますか? 一連のベスト プラクティスを使用して、すべての開発ツリーを完成させるために何週間も費やしたことはありますか?
上記の答えのいずれかに対する答えが「はい」なら、あなたは Tree Surgeon を好きになるでしょう!
Tree Surgeon は、.NET 開発ツリー ジェネレーターです。プロジェクトの名前を付けるだけで、数秒で開発ツリーがセットアップされます。それ以上に、新しいツリーには、何年にもわたる蓄積されたビルド エンジニアリングの経験が組み込まれています。
私は、Netbeans IDE がプロジェクトを編成する方法が気に入っています。新しいプロジェクトを開始するだけで、デフォルトの開発ツリーと Ant スクリプトがセットアップされます。