Using external version control systems with Unity

Unity ofrece un producto agregado Asset Server para una integración fácil de las versiones de sus proyectos, y también puede utilizar Perforce y PlasticSCM como herramientas externas ( mire Version Control Integration para más detalles). Si usted por alguna razón no puede utilizar estos sistemas, es posible almacenar su proyecto en cualquier otro sistema de control de versiones, tal como Subversion o Bazaar. Esto requiere algunas configuraciones manuales iniciales de su proyecto.

Antes de hacer checking a su proyecto, usted debe decirle a Unity en modificar un poco la estructura del proyecto para hacerlo compatible con assets almacenados en un sistema de control de versiones externo. Esto se realiza seleccionando Edit->Project Settings->Editor en el menú de aplicación y activando el soporte para External Version Control seleccionando Visible Meta Files en el menú desplegable de Version Control. Esto va a mostrar un archivo de texto para cada asset en el directorio Assets conteniendo la información administrativa necesaria requerida por Unity. Los archivos tendrán una extensión de archivo .meta, con la primera parte siendo el nombre completo del archivo Asset que está asociado a él. Mover y re-nombrar los assets dentro de Unity debería también actualizar los archivos relevantes .meta. No obstante, si usted mueve o re-nombra los assets desde una herramienta externa, asegúrese de sincronizar los archivos .meta relevantes también.

When checking the project into a version control system, you should add the Assets, Packages and the ProjectSettings directories to the system. The Library directory should be completely ignored - when using .meta files, it’s only a local cache of imported assets.

Cuando cree nuevos assets, asegúrese que ambos el asset en sí y el archivo .meta asociado sean agregados al control de versiones.

Ejemplo: Crear un nuevo proyecto e importarlo a un repositorio de subversion.

Primero, asumamos que tenemos un repositorio de subversion en svn://my.svn.server.com/ y queremos crear un proyecto en svn://my.svn.server.com/MyUnityProject. Entonces siga estos pasos para crear la importación inicial en el sistema:

1. Cree un nuevo proyecto dentro Unity y llámelo InitialUnityProject. Usted puede agregar cualquier assets iniciales aquí o agregarlos más adelante.
2. Active Visible Meta files en Edit->Project Settings->Editor
3. Sálgase de Unity (esto asegura que todos los archivos están guardados).
4. Borre el directorio Library dentro su directorio de proyecto.
5. Importe el directorio del proyecto a Subversion. Si está utilizando el cliente de linea de comando, esto es hecho así desde el directorio de dónde su proyecto inicial está ubicado: svn import -m"Initial project import" InitialUnityProject svn://my.svn.server.com/MyUnityProject Si tiene éxito, el proyecto debería ser importado a subversion y usted puede borrar el directorio InitialUnityProject si desea.
6. Check out the project back from subversion svn co svn://my.svn.server.com/MyUnityProject and check that the Assets, Packages and ProjectSettings directory are versioned.
7. Abra el proyecto checked out con Unity lanzándolo mientras mantiene oprimido las teclas Option o el Alt izquierdo. Abrir el proyecto va a recrear el directorio Library en el paso 4 de arriba.
8. Opcional: Configure un filtro de omisión para el directorio unversioned Library : svn propedit svn:ignore MyUnityProject/ Subversion va abrir un editor de texto. Agregue el directorio Library.
9. Finalmente, commit los cambios. El proyecto ahora debe estar configurado y listo: svn ci -m"Finishing project import" MyUnityProject