Compilar soluciones de Office

En general, compilar y depurar proyectos de Office es lo mismo que compilar y depurar otros tipos de proyectos en Visual Studio, como Windows Forms.Los temas de esta sección explican las diferencias que existen.Para obtener información general acerca de cómo compilar aplicaciones, vea Compilar aplicaciones en Visual Studio.

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 compilación no se puede realizar en los directorios de implementación.

Proyectos de nivel de documento

Cuando se compila 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, vea 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, vea Manifiestos de implementación para soluciones de Office.

• Un archivo de base de datos de programa (PDB).

[!NOTA]

Si compila una solución de nivel de documento en una ubicación remota en lugar de en el equipo local, agregue la ruta de acceso completa a la lista Ubicaciones de confianza en el Centro de confianza de la aplicación.Para obtener más información, consulte la sección Otorgar confianza a los documentos en Asegurar las soluciones de Office.

Proyectos de nivel de aplicación

Cuando se compila 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, vea 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, vea 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) del proyecto de las Soluciones de Office que compila.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 compilació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.Soluciones de Office que se compilan con el destino de la plataforma Cualquier CPU que se ejecutan en versiones de 32 bits y de 64 bits de Microsoft Office 2013 o Office 2010.

Debe establecer el destino de la plataforma en x64 solamente si está creando una solución que se ejecute solo en las versiones de 64 bits de Microsoft Office 2013 o Office 2010, y la solución llama a las API nativo de 64 bits.Para obtener más información sobre cómo cambiar el valor de destino de la plataforma, vea How to: Optimize an Application for a Specific CPU Type.

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.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 compilados del equipo de desarrollo, puede utilizar el comando Limpiar del menú Compilar en Visual Studio.El comando Limpiar elimina todos los archivos de la ubicación de salida de la compilació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.

Temas relacionados

Título	Descripción
Depurar proyectos de Office	Presenta los problemas implicados en depurar proyectos de Office.
Tutorial: Crear la primera personalización en el nivel del documento para Excel	Muestra cómo crear una personalización en el nivel del documento básica para Excel.
Cómo: Volver a habilitar un complemento que se ha deshabilitado	Describe cómo volver a habilitar un complemento que se ha deshabilitado parcial o completamente.
Diseñar y crear soluciones de Office	Proporciona vínculos a información sobre la creación de soluciones de Office y el rol de los ensamblados en una solución.