刚开始使用unity做开发时,拿到一个范例工程先上传SVN,之后再自己做一些修改后,发现有非常多文件都有变化,这才知道有很多本地生成的文件,是不用上传的,但是不知道哪些才是需要共用的。之后又困扰于修改提交时看不到diff,无法把握每次修改内容。在网上多方查找,找到以下几篇算是比较系统的介绍unity的文件介绍,翻译转载过来备忘

 

1、本文主要介绍工程文件结构,哪些目录、文件需要放在版本控制系统中。

http://developers.nravo.com/mastering-unity-project-folder-structure-level-0-vcs/#.U0yXvPmSyNw

 

2、.meta文件介绍

http://3dgep.com/?p=5105

 

3、Asset目录下的系统保留目录

http://docs.unity3d.com/Documentation/Manual/ScriptCompileOrderFolders.html

 


从新建工程中查看unity文件系统

      新建一个“test”的工程,导入“Standard Assets (Mobile)”这个包,新建一个"Tets.cs"的脚本文件,绑定到主摄像机上。做完这些后来看看生成的目录结构,如下图:

这么多文件和目录中,只有两个目录是需要放入版本控制中的:Assets 和 ProjectSettings。其他所有文件都是从这两个目录文件中生成出来的:

 

Assembly-CSharp-vs.csproj / Assembly-CSharp.csproj:

为C#脚本生成的Visual Studio和MonoDevelop的工程文件。

Assembly-UnityScript-vs.unityproj / Assembly-UnityScript.unityproj

JS的工程文件

testproject.sln / testproject-csharp.sln

IDE的solution,第一个包含c#、JS、Boo,第二个是纯C#工程,用VS打开,因为VS不处理JS和Boo工程

testproject.userprefs / testproject-csharp.userprefs

MonoDevelop用来存放当前打开的文件、断点、监视点等信息的配置文件。

 

备注:

     上面列出的这些文件中除了.userprefs外,其他文件都会在执行unity菜单Assets -> Sync MonoDevelop Project后重新生成

 

Assets:

       所有游戏资源全都放在这个目录下,包括脚本、纹理、声音、自定义编辑器等。这是工程中最重要的文件夹

 

ProjectSettings:

       存放工程设置。包括物理、标签、玩家设置等。换句话说,你在菜单Edit → Project Settings中做过的所有设置都放在这个目录下

 

Library

       重要Assets的本地缓存,不用放在版本控制中

 

obj / Temp

       unity运行过程中生成的临时文件。obj是MonoDevelop用的,Temp是unity用的

 

 

建立版本控制系统:

     unity官方推荐开发者用unity原生的Unity Asset Server来进行版本控制。我们团队用了一个月之后,觉得这个原生本版控制不够强大,没有分支、锁定,要付费(团队牌照$500),感觉像是个简化版的SVN。

     之后采取的方法是将Assets转换为文本格式保存,用Git进行版本控制

 

assets转换为文本的设置(unity 4.3):

1、Edit→ Preferences → Packages → Repository中设为External

2、Edit → Project Settings → Editor → Version Control Mode设为Hidden Meta Files(非必须)

3、最重要的:Edit → Project Settings → Editor → Asset Serialization Mode中设为Force Text,这里是选择用二进制还是文本格式保存。

4、保存配置

 

.meta文件介绍

http://3dgep.com/?p=5105

      当你在场景中引用一个资源(asset)时,unity不使用名字或路径,而用一个全局唯一的GUID来指向工程中的资源。这个GUID就放在meta文件中,unity会为Assets目录下的所有文件夹和资源文件生成一个meta文件。

       GUID有优点也有缺点

       优点:移动、重命名、改动资源文件,都对GUID没有影响,GUID还是指向这个资源文件。

       缺点:注意不要随意删除资源文件相关的meta文件。如果删除了meta文件,unity会认为原始的资源文件被删除了,并给此资源重新生成一个新的GUID。这就是为什么有时候场景中资源的引用会突然断开。

 

       除了GUID,meta文件还有重新导入资源的信息。比如纹理资源可设为以标准纹理、普通地图、GUI纹理、cookie、纹理、光照贴图导入。这些导入设置是放在meta文件中的。

 

 

Assets目录下的系统保留目录

http://docs.unity3d.com/Documentation/Manual/ScriptCompileOrderFolders.html

 

脚本编译顺序:

1、Standard Assets, Pro Standard Assets , Plugins 目录下的脚本

2、Standard Assets/Editor, Pro Standard Assets/Editor and Plugins/Editor 目录下的脚本

3、名字为Editor的目录之外的所有脚本

4、名字为Editor的目录下的脚本

Assets根目录下的WebPlayerTemplates 目录内的脚本不会编译。

 

比如一个UnityScript文件需要引用一个C#文件中定义的类。你可以将C#文件放在Plugin目录下,UnityScript文件放在一个非特殊目录下。如果不这样做,会提示C#类找不到。

 

http://wiki.unity3d.com/index.php/Special_Folder_Names_in_your_Assets_Folder

Standard Assets:其中的脚本最早被编译

 

Pro Standard Assets:与Standard Assets一样,是付费版的内容,比如纹理渲染、屏幕特效等

 

Editor:这个目录名字比较特殊(不一定在Assets根目录下),此目录下的脚本是unity编辑器的脚本API。如果你的脚本需要用到UnityEditor命名空间中的内容,就需要放在名为Editor的目录下。整个工程中可以有多个Editor目录。

     备注:普通目录下可随意放置Editor目录层级,但在Standard Assets, Pro Standard Assets , Plugins这三个保留目录中则必须在根目录下。比如普通目录下为My Extension/Scripts/Editor,如果需要放在系统目录下则必须Standard Assets/Editor/My Extension/Scripts

 

Plugins:放置脚本使用的本地插件,编译时会被自动包含。必须放在Assets根目录下。Windows下的本地插件后缀为.dll,MAC下为.bundle,Linux下为.so

 

Resources:此目录下的资源可由脚本直接引用文件路径和名字,而不是常用(推荐)的直接引用(编辑器中拖放)。所以编译时此目录下的所有文件都会被自动包含(包括没有用过的资源)。工程中可以有多个Resources文件夹。不推荐在多个Resources目录下存放同名文件。一旦编译,所有Resources目录下的所有资源都会被一起打包。

运行时导入资源请参考官方说明http://docs.unity3d.com/Documentation/Manual/LoadingResourcesatRuntime.html

 

Gizmos:此目录下的纹理/图标用于Gizmos.DrawIcon(),按名字调用,在编辑器中绘制在屏幕上。

 

WebPlayerTemplates :网页版,略过

Streaming Assets:Application.streamingAssetsPath中使用的资源,略过