Información general acerca del proceso de compilación de soluciones de Office
Actualización: noviembre 2007
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.
Resultado del proyecto en proyectos de 2007 System
La ubicación de salida para un proyecto de la versión 2007 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 (2007 System).
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 (2007 System).
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 (2007 System).
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 (2007 System).
Un archivo de base de datos de programa (PDB) para el ensamblado de proyecto.
El proceso de generació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.
Resultado del proyecto en proyectos de 2003 System
La ubicación de salida para un proyecto de la versión 2003 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 (incrustado en el documento). Para obtener más información, vea Manifiestos de implementación y aplicación en soluciones de Office.
Un archivo de base de datos de programa (PDB).
En el caso de soluciones de Excel, no se puede cambiar la ruta de acceso de los resultados ni el directorio de trabajo. Si establece la opción del directorio de trabajo en el panel Depuración del Diseñador de proyectos en una ubicación distinta, Excel la volverá a establecer en tiempo de ejecución cuando se abra el documento. Sin embargo, si se trata de soluciones de Word, es posible cambiar la ruta de acceso de los resultados de la forma habitual.
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. Para obtener más información, vea Manifiestos de implementación y aplicación en soluciones de Office.
Un archivo de base de datos de programa (PDB).
El proceso de generació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.
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. La configuración de seguridad de los proyectos se controla de manera diferente para las distintas versiones de Office.
Proyectos de 2007 System
En los proyectos de Microsoft Office System 2007, Visual Studio Tools para Office utiliza una lista de inclusión y certificados para comprobar al editor. Visual Studio crea automáticamente un certificado temporal para identificar las soluciones de Office y agrega una entrada a la lista de inclusión para confiar en dicho certificado.
Para obtener más información, consulte Seguridad en las soluciones de Office (2007 System).
Proyectos de 2003 System
En los proyectos de Microsoft Office 2003, Visual Studio Tools para Office incluye una propiedad booleana denominada Ubicación de los ensamblados de confianza. Esta propiedad aparece en la ventana Propiedades de Visual Studio. De forma predeterminada, esta propiedad está establecida en True. Si la propiedad se establece en True, al generar el proyecto, Visual Studio concede plena confianza al ensamblado del proyecto con la dirección URL como evidencia.
Los permisos de confianza total también se conceden a los ensamblados mencionados y satélite que están en la carpeta de resultados. En los ensamblados que se encuentran en el equipo local, la confianza se concede en el nivel de usuario. Por tanto, no necesita credenciales administrativas para estos proyectos. Si se vuelve a generar el proyecto en una ubicación distinta, se quitan los permisos de plena confianza de la ubicación anterior. Para obtener más información sobre la seguridad, vea Requisitos de seguridad para ejecutar las soluciones de Office (2003 System).
La comprobación de la ubicación y la concesión de confianza en cada compilación permite mover y compartir proyectos sin necesidad de cambiar manualmente la configuración de seguridad del equipo cada vez. Sin embargo, debe utilizar las herramientas que proporciona Visual Studio para cambiar la ubicación del proyecto. Si utiliza una herramienta externa, como el Explorador de Windows, Visual Studio no puede actualizar los permisos.
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 Cómo: Conceder permisos a carpetas y ensamblados (2003 System).
En los proyectos de nivel de documento de 2007 System, 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 Otorgar confianza a los documentos (2007 System).
Probar una personalización de nivel de documento
Presione F5 para generar y depurar una solución. Si desea probar una solución de Word 2003 o 2007 sin depurarla, generando el documento y abriéndolo después desde fuera de Visual Studio, cierre el proyecto antes de abrir el documento. Cuando abre un documento de Word en Visual Studio, se establece un marcador en el proceso de Word para que no ejecute personalizaciones. Al abrir un documento personalizado de Word desde fuera de Visual Studio haciendo doble clic en el archivo correspondiente en el Explorador de Windows, el marcador también puede impedir que este documento ejecute personalizaciones. Si hace doble clic en el archivo para abrirlo, Word abre el documento en el mismo proceso que el de cualquier otro documento que esté en ejecución en ese momento. Puesto que ya hay un documento abierto en Visual Studio, el nuevo documento se abre en ese mismo proceso y recibe el marcador para que no ejecute personalizaciones.
Probar un complemento de nivel de aplicación
Presione F5 para generar y depurar una solución. Si prueba el complemento de nivel de aplicación publicando e instalando la solución, desinstale la solución antes de volver a publicar o antes de realizar otros cambios en el código y volver a realizar la prueba presionando F5. Al instalar una solución publicada, el ensamblado del complemento se instala en la caché de ClickOnce. El programa de instalación también crea claves del Registro para que la aplicación de Office pueda buscar y cargar el ensamblado. Dado que al volver a generar la solución se actualizan las claves del Registro, es necesario desinstalar la primera versión antes de publicar o ejecutar la segunda versión.
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.
.gif "Nota") Nota: |
|---|
El comando Limpiar no quita los permisos que concedió el proceso de generación a los ensamblados de solución. Para obtener información acerca de cómo quitar permisos, vea Cómo: Quitar permisos a carpetas y ensamblados (2003 System). |
Cambiar el destino de la plataforma a x64
De forma predeterminada, el destino de la plataforma es Cualquier CPU. Si establece el destino de la plataforma en x64, puede compilar el proyecto, pero la solución no se ejecutará. El destino de plataforma x64 exige que la solución se ejecute en un proceso de 64 bits. Office se ejecuta en un proceso de 32 bits. Por tanto, Office no podrá cargar la solución.
Vea también
Tareas
Cómo: Generar soluciones de Office
Conceptos
Depurar proyectos de nivel de documento