Información general acerca del proceso de compilación de soluciones de Office

Artículo
08/10/2011

La compilación de una solución de Microsoft Office es muy similar a la compilación de otras aplicaciones en Visual Studio. Sin embargo, existen varios elementos que se deben tener en cuenta específicos de las soluciones de Office.

Para obtener información general acerca de cómo generar aplicaciones, vea Generar aplicaciones en Visual Studio.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Microsoft Office 2010 y 2007 Microsoft Office System. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Resultados de los proyectos de Office

La ubicación de salida de los proyectos de Office es nombreDeProyecto\bin\release o nombreDeProyecto\bin\debug. La generación no se puede realizar en los directorios de implementación.

Proyectos de nivel de documento

Cuando se genera un proyecto de nivel de documento, se incluyen los elementos siguientes en el resultado del proyecto:

Una copia del documento del proyecto.
El ensamblado de proyecto y todos los ensamblados a los que se hace referencia que tienen la propiedad Copia local establecida en true.
El manifiesto de aplicación, que tiene la extensión de nombre de archivo .manifest. Para obtener más información, consulte Manifiestos de aplicación para soluciones de Office.
El manifiesto de implementación, que tiene la extensión de nombre de archivo .vsto. Para obtener más información, consulte Manifiestos de implementación para soluciones de Office.
Un archivo de base de datos de programa (PDB).

Proyectos de nivel de aplicación

Cuando se genera un proyecto de nivel de aplicación, se incluyen los elementos siguientes en el resultado del proyecto:

El ensamblado de proyecto y todos los ensamblados a los que se hace referencia que tienen la propiedad Copia local establecida en true.
El manifiesto de aplicación, que tiene la extensión de nombre de archivo .manifest. Para obtener más información, consulte Manifiestos de aplicación para soluciones de Office.
El manifiesto de implementación, que tiene la extensión de nombre de archivo .vsto. Para obtener más información, consulte Manifiestos de implementación para soluciones de Office.
Un archivo de base de datos de programa (PDB) para el ensamblado de proyecto.

El proceso de compilación de los proyectos de nivel de aplicación también crea en el equipo de desarrollo un conjunto de entradas del Registro que son necesarias para cargar el complemento. Para obtener más información, vea Entradas del Registro de complementos de nivel de aplicación.

Si genera un proyecto de complemento de Outlook que contiene áreas de formulario, el proceso de compilación agrega la siguiente información adicional al Registro:

Una clave para cada clase de mensaje asociada con una o varias áreas de formulario.
Una entrada para cada área de formulario y un valor asociado que representa el nombre del complemento de Outlook.

Outlook necesita esta información para cargar las áreas de formulario.

Referencias a ensamblados

Puede hacer referencia a los ensamblados (incluidos los proyectos de biblioteca de clases) desde el proyecto de Visual Studio Tools para Office. Todos los ensamblados a los que se hace referencia incluyen una propiedad llamada Copia local. El valor de Copia local indica si el ensamblado se debe copiar en el directorio de resultados. De manera predeterminada, tiene el valor true. Todos los ensamblados a los que se haga referencia y que tengan la propiedad Copia local establecida en true se copiarán en el directorio de resultados.

Seguridad durante el proceso de generación

Visual Studio establece automáticamente la configuración de seguridad en el equipo de desarrollo para conceder la confianza a la solución durante el proceso de compilación. Esto permite ejecutar la solución mientras se depura.

Los proyectos de Office utilizan certificados para comprobar al publicador. Visual Studio crea automáticamente un certificado temporal para identificar las soluciones de Office y configura el equipo de desarrollo para confiar en este certificado temporal.

Para obtener más información, vea Asegurar las soluciones de Office.

Proyectos de red

Si la ubicación del ensamblado o el documento se encuentra en un recurso compartido de red, la actualización de la directiva de seguridad local (nivel de usuario) no es suficiente para permitir la ejecución de la solución. Un administrador debe conceder plena confianza desde el nivel de equipo a los ensamblados y documentos que se encuentren en un recurso compartido de red para que se pueda ejecutar la solución. Para obtener más información sobre cómo establecer la directiva de seguridad, vea Asegurar las soluciones de Office.

En los proyectos de nivel de documento también debe agregar la ubicación completa del documento en la lista de carpetas de confianza de Office. Para obtener más información, vea Otorgar confianza a los documentos.

Cambiar el destino de la plataforma

De forma predeterminada, el destino de la plataforma para los proyectos de Office es Any CPU. Normalmente, no debería cambiar este valor. Las soluciones de Office que se compilan con el valor de destino de plataforma Any CPU se ejecutan en 2007 Microsoft Office system y en las versiones de 32 y 64 bits de Microsoft Office 2010.

Debería establecer el destino de la plataforma en x64 solamente si está creando una solución que se va a ejecutar solo en las versiones de 64 bits de Microsoft Office 2010 y la solución llama a las API de 64 bits nativas. Para obtener más información sobre cómo cambiar el valor de destino de la plataforma, vea Cómo: Optimizar una aplicación para un tipo específico de CPU.

Si establece el destino de la plataforma en x64, la solución no se ejecutará en las versiones de 32 bits de Windows o de Office, incluido 2007 Microsoft Office system. El destino de plataforma x64 requiere que la solución se ejecute en un proceso de 64 bits.

Utilizar el comando Limpiar

Para quitar los archivos de proyecto generados del equipo de desarrollo, puede utilizar el comando Limpiar del menú Generar en Visual Studio. El comando Limpiar elimina todos los archivos de la ubicación de salida de la versión. En los proyectos de nivel de aplicación, el comando Limpiar también quita las entradas del Registro creadas por el proceso de compilación.

Vea también