Crear soluciones de Office

En general, compilar y depurar proyectos de Office se hace de la misma manera que al compilar y depurar otros tipos de proyectos en Visual Studio, como Windows Forms. Los temas de esta sección explican las diferencias que existen entre ellos. Para obtener información general sobre cómo compilar aplicaciones, vea Compilar y compilar en Visual Studio.

Nota:

¿Le interesa desarrollar soluciones que amplíen la experiencia de Office en varias plataformas? Consulte el nuevo modelo de complementos de Office. Los complementos de Office tienen una superficie pequeña en comparación con los complementos y soluciones de VSTO, y puede compilarlos mediante casi cualquier tecnología de programación web, como HTML5, JavaScript, CSS3 y XML.

Salida del proyecto para proyectos de Office

La ubicación de salida de los proyectos de Office es nombreDeProyecto\bin\release o nombreDeProyecto\bin\debug. Tenga en cuenta que 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 siguientes elementos 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 y 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 denominada Conceder confianza a documentos en soluciones de Secure Office.

Proyectos de nivel de aplicación

Al compilar un proyecto de complemento de VSTO, los siguientes elementos se incluyen en la salida del proyecto:

• El ensamblado de proyecto y todos los ensamblados a los que se hace referencia y 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 del proyecto.

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

  Si compila un proyecto de complemento VSTO 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 a una o varias áreas de formulario.

• Una entrada para cada área de formulario y un valor asociado que representa el nombre del complemento de VSTO de Outlook.

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

Ensamblados a los que se hace referencia

Puede hacer referencia a los ensamblados (incluidos los proyectos de biblioteca de clases), desde el proyecto Compilar soluciones de Office. Todos los ensamblados a los que se hace referencia incluyen una propiedad llamada Copia local. La propiedadCopia 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 del equipo de desarrollo para hacer que la solución sea fiable durante el proceso de compilación. Esto permite ejecutar la solución mientras se depura.

Los proyectos de Office usan certificados para comprobar los datos del publicador. Para ello, Visual Studio crea automáticamente un certificado temporal para identificar las soluciones de Office, y configura el equipo de desarrollo para conceder cierto grado de fiabilidad a este certificado temporal.

Para obtener más información, consulte Soluciones seguras de Office.

Proyectos de red

Si la ubicación del ensamblado o del documento se encuentra en un recurso compartido de red, la actualización de las directivas de seguridad local (a nivel de usuario) no es suficiente para permitir la ejecución de la solución. En cuanto a los ensamblados y a los documentos que se encuentren en un recurso compartido de red, es el administrador quien debe conceder plena confianza a nivel de equipo, para que se pueda ejecutar la solución. Para obtener más información sobre cómo establecer la directiva de seguridad, consulte Soluciones seguras 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, consulte Concesión de confianza a documentos.

Cambio del destino de la plataforma

De forma predeterminada, el destino de la plataforma para los proyectos de Office es Cualquier CPU. No debería cambiar esta configuración si no es necesario. Las soluciones de Office creadas con la configuración de destino Cualquier plataforma de CPU se ejecutan en versiones de 32 y 64 bits de Microsoft Office 2013 u Office 2010.

Solo debe establecer el destino de la plataforma en x64 si va a crear una solución que solo se ejecutará en versiones de 64 bits de Microsoft Office 2013 u Office 2010, y la solución llama a las API nativas de 64 bits. Para obtener más información sobre cómo cambiar la configuración de destino de la plataforma, vea Cómo: Configurar proyectos para plataformas de destino.

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.

Uso del comando Clean

Para quitar los archivos de proyecto compilado del equipo de desarrollo, puede usar el comando Limpiar en el menú Compilar de 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 de registro creadas por el proceso de compilación.

Temas relacionados

Title	Descripción
Depuración de proyectos de Office	Indica los problemas implicados en la depuración de proyectos de Office.
Tutorial: Creación de la primera personalización de nivel de documento para Excel	Muestra cómo crear una personalización básica de nivel de documento para Excel.
Cómo: Volver a habilitar un complemento de VSTO que se ha deshabilitado	Describe cómo volver a habilitar un complemento de VSTO que se ha deshabilitado de forma difícil o temporal.
Diseño y creación de soluciones de Office	Proporciona vínculos a información sobre la creación de soluciones de Office y sobre el rol de los ensamblados en la solución.