Cómo: Organizar archivos de resultados de proyectos para la generación
Actualización: noviembre 2007
En este tema se describen los procedimientos recomendados para organizar los archivos de resultado del proyecto. Pueden aparecer errores de compilación cuando los archivos de resultado del proyecto se preparan incorrectamente. Este tema también esquematiza las ventajas y desventajas de cada alternativa para organizar los archivos de resultado del proyecto.
Hacer referencia a ensamblados CLR
Para hacer referencia a ensamblados con #using
Puede hacer referencia a un ensamblado directamente desde el código utilizando la directiva #using, como en #using <System.Data.dll>. Para obtener más información, vea The #using Directive.
El archivo especificado puede ser .dll, .exe, .netmodule u .obj, siempre que esté en MSIL. El componente al que se hace referencia puede generarse en cualquier lenguaje. Con esta opción tendrá acceso a Intellisense, puesto que los metadatos se extraerán del MSIL. El archivo en cuestión debe estar en la ruta de acceso para el proyecto; de lo contrario, el proyecto no se compilará y no estará disponible Intellisense. Una forma fácil de determinar si el archivo está en la ruta de acceso es hacer clic con el botón secundario del mouse en la línea #using y elegir el comando Abrir documento. Se le notificará si no se encuentra el archivo.
Si no desea poner la ruta completa de acceso al archivo, puede utilizar la opción /AI del compilador para editar la ruta de búsqueda de referencias #using. Para obtener más información, vea /AI (Especificar directorios de metadatos).
Para hacer referencia a ensamblados con /FU
En lugar de hacer referencia directamente a un ensamblado desde un archivo de código, como se describió anteriormente, puede utilizar la opción /FU del compilador. La ventana de este método es que no necesitará agregar una instrucción #using separada a cada archivo que haga referencia a un ensamblado dado.
Para establecer esta opción, abra las Páginas de propiedades del proyecto. Expanda el nodo Propiedades de configuración, expanda el nodo C/C++ y seleccione Avanzadas. Agregue los ensamblados deseados junto Forzar #using. Para obtener más información, vea /FU (Asignar nombre al archivo #using obligatorio).
Para hacer referencia a ensamblados con Agregar nueva referencia
Ésta es la manera más fácil de utilizar los ensamblados CLR. Primero, asegúrese de que el proyecto se compila con la opción del compilador /clr. A continuación, haga clic con el botón secundario del mouse el proyecto en el Explorador de soluciones y seleccione Referencias. Aparecerá el cuadro de diálogo Páginas de propiedades.
En el cuadro de diálogo Páginas de propiedades, seleccione Agregar nueva referencia. Aparecerá un cuadro de diálogo que muestra todos los ensamblados .NET, COM y otros disponibles en el proyecto actual. Seleccione el ensamblado que desee y haga clic en Aceptar. Para obtener más información, vea Agregar referencia (Cuadro de diálogo).
Cuando se establece una referencia de proyecto, las dependencias correspondientes se controlan automáticamente. Además, puesto que los metadatos forman parte de un ensamblado, no es necesario agregar un archivo de encabezado ni crear prototipos de los elementos que se utilizan desde ensamblados administrados.
Hacer referencia a archivos DLL o bibliotecas estáticas nativas
Para hacer referencia a archivos DLL o bibliotecas estáticas nativas
Haga referencia al archivo de encabezado adecuado en el código utilizando la directiva #include. El archivo de encabezado debe estar en la ruta de inclusión o formar parte del proyecto actual. Para obtener más información, vea The #include Directive.
También puede establecer dependencias de proyecto. La configuración de dependencias de proyecto garantiza dos cosas. Primero, garantiza que los proyectos se generan en el orden correcto de modo que un proyecto siempre encuentre los archivos dependientes que necesite. Segundo, agrega implícitamente el directorio de salida del proyecto dependiente a la ruta de acceso, para que los archivos se puedan encontrar con facilidad en tiempo de vinculación.
Para implementar la aplicación, deberá colocar el archivo DLL en un lugar adecuado. Puede ser cualquiera de los siguientes:
La misma ruta de acceso que el ejecutable.
Cualquier punto de la ruta de acceso del sistema (la variable de entorno path).
En el ensamblado simultáneo. Para obtener más información, vea Generar ensamblados simultáneos de C/C++.
Trabajar con varios proyectos
De forma predeterminada, los proyectos se generan de modo que todos los archivos de resultados se crean en un subdirectorio del directorio de proyecto. El directorio se denomina en función de la configuración de generación (por ejemplo Depuración o Lanzamiento). Para que los proyectos relacionados se hagan referencia entre sí, cada uno de ellos debe agregar explícitamente a su ruta de acceso los directorios de salida del otro proyecto, para que la vinculación sea correcta. Esto se hace automáticamente cuando se establecen las dependencias del proyecto. Sin embargo, si no utiliza dependencias, debe controlar esto cuidadosamente porque las generaciones pueden hacerse muy difíciles administrar. Por ejemplo, cuando un proyecto tiene configuraciones de Depuración y Lanzamiento, e incluye una biblioteca externa de un proyecto relacionado, debe utilizar un archivo de biblioteca diferente en función de la configuración generada. Así, la inclusión en el código de estas rutas de acceso puede ser difícil.
A partir de Visual C++ 2005, todos los archivos de resultados esenciales (tales como los ejecutables, los archivos de vinculador incremental y los archivos PDB) se copian en un directorio de soluciones común. Así, cuando se trabaja con una solución que contiene varios proyectos C++ con configuraciones equivalentes, todos los archivos de salida se centralizan para simplificar la vinculación y la implementación. Sabrá con seguridad que las aplicaciones y bibliotecas funcionan según lo esperado si mantiene juntos estos archivos (dado que se garantiza que los archivos están en la ruta de acceso).
La ubicación de archivos de resultados puede ser un problema importante cuando se implemente un entorno de producción. Mientras se ejecutan proyectos en el IDE, las rutas de acceso a las bibliotecas incluidas no son necesariamente las mismas que en el entorno de producción. Por ejemplo, si tiene #using "../../lib/debug/mylib.dll" en el código pero implementa mylib.dll en una posición relativa diferente, se producirá un error en la aplicación en el tiempo de ejecución. Para evitarlo, es recomendable evitar el uso de rutas de acceso relativas en instrucciones #include en el código. Es mejor asegurarse de que los archivos necesarios se encuentran en la ruta de acceso de generación del proyecto y, de forma similar, que los archivos de producción correspondientes están colocados correctamente.
Cómo especificar dónde van los archivos de resultados
- La configuración de la ubicación de los resultados del proyecto se encuentra en las Páginas de propiedades del proyecto. Expanda el nodo situado junto a Propiedades de configuración y seleccione General. La ubicación de salida se especifica junto a Directorio de resultados. Para obtener más información, vea Página de propiedades General (Proyecto).