Procedimientos recomendados de desarrollo para complementos COM, VSTO y VBA en Office

Si está desarrollando complementos COM, VSTO o VBA para Office, siga los procedimientos recomendados de desarrollo descritos en este artículo. Esto le ayudará a garantizar:

• Compatibilidad de los complementos en diferentes versiones e implementaciones de Office.
• Complejidad reducida de la implementación de complementos para los usuarios y administradores de TI.
• No se producen errores de instalación o tiempo de ejecución no deseados del complemento.

Nota: No se admite el uso del Puente de dispositivo de escritorio para preparar el complemento COM, VSTO o VBA para la Tienda Windows. Los complementos COM, VSTO y VBA no se pueden distribuir en la Tienda Windows ni en la Tienda Office.

No compruebe si Office durante la instalación

No se recomienda que el complemento detecte si Office está instalado durante el proceso de instalación del complemento. Si Office no está instalado, puede instalar el complemento y el usuario podrá acceder a él después de instalar Office.

Usar tipos de interoperabilidad incrustados (NoPIA)

Si la solución usa .NET 4.0 o posterior, use tipos de interoperabilidad incrustados (NoPIA) en lugar de en función del redistribuible de ensamblados de interoperabilidad primarios (PIA) de Office. El uso de la inserción de tipos reduce el tamaño de instalación de la solución y garantiza la compatibilidad futura. Office 2010 fue la última versión de Office que envió el PIA redistribuible. Para obtener más información, vea Walkthrough: Embedding type information from Microsoft Office assemblies and Type equivalence and embedded interop types.

Si la solución usa una versión anterior de .NET, se recomienda actualizar la solución para usar .NET 4.0 o posterior. El uso de .NET 4.0 o posterior reduce los requisitos previos del entorno de ejecución en versiones más recientes de Windows.

Evitar en función de versiones específicas de Office

Si la solución usa la funcionalidad que solo está disponible en versiones más recientes de Office, compruebe que la funcionalidad existe (si es posible, en el nivel de característica) en tiempo de ejecución (por ejemplo, mediante el control de excepciones o comprobando la versión). Valide las versiones mínimas, en lugar de versiones específicas, mediante las API admitidas en el modelo de objetos, como la propiedad Application.Version. No se recomienda confiar en metadatos binarios de Office, rutas de acceso de instalación o claves del Registro, ya que pueden cambiar entre instalaciones, entornos y versiones.

Habilitar el uso de Office de 32 y 64 bits

El destino de compilación predeterminado debe admitir tanto de 32 bits (x86) como de 64 bits (x64), a menos que la solución dependa de bibliotecas que solo estén disponibles para un bit específico. La versión de 64 bits de Office aumenta en la adopción, especialmente en entornos de macrodatos. La compatibilidad con versiones de 32 y 64 bits facilita a los usuarios la transición entre versiones de 32 y 64 bits de Office.

Al escribir código VBA, use instrucciones declare seguras de 64 bits y convierta variables según corresponda. Además, asegúrese de que los documentos se pueden compartir entre los usuarios que ejecutan versiones de 32 o 64 bits de Office proporcionando código para cada bit. Para obtener más información, consulte Introducción a Visual Basic de 64 bits para aplicaciones.

Compatibilidad con entornos restringidos

La solución no debe requerir privilegios de elevación de cuentas de usuario ni de Administración istrator. Además, la solución no debe depender de la configuración o modificación:

• El directorio de trabajo actual.
• Directorios de carga dll.
• Variable PATH.

Cambiar la ubicación de guardado de los datos compartidos y la configuración

Si la solución consta de un complemento y un proceso externo a Office, no use la carpeta de datos de la aplicación del usuario ni el Registro para intercambiar datos o configuraciones entre el complemento y el proceso externo. En su lugar, considere la posibilidad de usar la carpeta temporal del usuario, la carpeta de documentos o el directorio de instalación de la solución.

Incrementar el número de versión con cada actualización

Establezca el número de versión de los archivos binarios de la solución e incremente con cada actualización. Esto facilitará a los usuarios identificar los cambios entre versiones y evaluar la compatibilidad.

Proporcionar instrucciones de soporte técnico para las versiones más recientes de Office

Los clientes solicitan a los ISV que proporcionen instrucciones de soporte técnico para sus complementos COM, VSTO y VBA que se ejecutan en Office. Enumerar las instrucciones de soporte técnico explícitas ayuda a los clientes a usar aplicaciones de Microsoft 365 para herramientas de preparación empresarial para comprender su soporte técnico.

Para proporcionar instrucciones de soporte técnico para las aplicaciones cliente de Office (por ejemplo, Word o Excel), compruebe primero que los complementos se ejecuten en la versión actual de Office y, a continuación, confirme proporcionar actualizaciones si el complemento se interrumpe en una versión futura. No es necesario probar los complementos cuando Microsoft publica una nueva compilación o una actualización de Office. Microsoft rara vez cambia la plataforma de extensibilidad COM, VSTO y VBA en Office, y estos cambios se documentarán bien.

Importante: Microsoft mantiene una lista de complementos admitidos para informes de preparación e información de contacto de ISV. Para obtener el complemento en la lista, consulte /configmgr/desktop-analytics/ready-for-windows.

Uso del Monitor de procesos para ayudar a depurar problemas de instalación o carga

Si el complemento tiene problemas de compatibilidad durante la instalación o carga, es posible que estén relacionados con problemas con el acceso al archivo o al registro. Use el Monitor de procesos o una herramienta de depuración similar para registrar y comparar el comportamiento con un entorno de trabajo para ayudar a identificar el problema.