|
| 1 | +--- |
| 2 | +title: "Development best practices for COM, VSTO, and VBA add-ins in Office | Microsoft Docs" |
| 3 | +ms.custom: "" |
| 4 | +ms.date: "07/25/2017" |
| 5 | +ms.reviewer: "" |
| 6 | +ms.suite: "" |
| 7 | +ms.technology: |
| 8 | + - "office-development" |
| 9 | +ms.tgt_pltfrm: "" |
| 10 | +ms.topic: "article" |
| 11 | +dev_langs: |
| 12 | + - "" |
| 13 | +helpviewer_keywords: |
| 14 | + - "" |
| 15 | +ms.assetid: 810a6648-fece-4b43-9eb6-948d28ed2158 |
| 16 | +caps.latest.revision: 33 |
| 17 | +author: "reezali" |
| 18 | +ms.author: "reezali" |
| 19 | +manager: "lforman" |
| 20 | +--- |
| 21 | +# Development best practices for COM, VSTO, and VBA add-ins in Office |
| 22 | + If you are developing COM, VSTO or VBA add-ins for Office, follow the development best practices described in this article. This will help ensure: |
| 23 | + |
| 24 | +- Compatibility of your add-ins across different versions and deployments of Office. |
| 25 | +- Reduced complexity of add-in deployment for your users and IT administrators. |
| 26 | +- Unintended installation or runtime failures of your add-in do not occur. |
| 27 | + |
| 28 | +>Note: Using the [Desktop Bridge](https://docs.microsoft.com/en-us/windows/uwp/porting/desktop-to-uwp-root) to prepare your COM, VSTO or VBA add-in for the Windows Store is not supported. COM, VSTO and VBA add-ins cannot be distributed in the Windows Store or the Office Store. |
| 29 | + |
| 30 | +## Do not check for Office during installation |
| 31 | + We don’t recommend having your add-in detect whether Office is installed during the add-in installation process. If Office is not installed, you can install the add-in, and the user will be able to access it after Office is installed. |
| 32 | + |
| 33 | +## Use Embedded Interop Types (NoPIA) |
| 34 | +If your solution uses .NET 4.0 or later, use embedded interop types (NoPIA) instead of depending on the Office Primary Interop Assemblies (PIA) redistributable. Using type embedding reduces the installation size of your solution, and ensures future compatibility. Office 2010 was the last version of Office that shipped the PIA redistributable. For more information, see [Walkthrough: Embedding Type Information from Microsoft Office Assemblies](https://msdn.microsoft.com/en-us/library/ee317478.aspx) and [Type Equivalence and Embedded Interop Types](https://docs.microsoft.com/en-us/dotnet/framework/interop/type-equivalence-and-embedded-interop-types). |
| 35 | + |
| 36 | +If your solution uses an earlier version of .NET, we recommend that you update your solution to use .NET 4.0 or later. Using .NET 4.0 or later reduces runtime prerequisites on newer versions of Windows. |
| 37 | + |
| 38 | +## Avoid depending on specific Office versions |
| 39 | +If your solution uses functionality that is only available in newer versions of Office, verify that the capability exists (if possible, at the feature level) at runtime (for example, using exception handling or by checking the version). Validate minimum versions, rather than specific versions, using supported APIs in the object model, such as the [Application.Version property](https://msdn.microsoft.com/en-us/library/office/microsoft.office.interop.excel._application.version.aspx). We don’t recommend that you rely on Office binary metadata, installation paths, or registry keys because these can change between installations, environments, and versions. |
| 40 | + |
| 41 | +## Enable both 32-bit and 64-bit Office usage |
| 42 | +Your default build target should support both 32-bit (x86) and 64-bit (x64), unless your solution depends on libraries that are only available for a specific bitness. The 64-bit version of Office is increasing in adoption, especially in big data environments. Supporting both 32-bit and 64-bit makes it easier for your users to transition between 32-bit and 64-bit versions of Office. |
| 43 | + |
| 44 | +When writing VBA code, use 64-bit safe declare statements and convert variables as appropriate. Additionally, ensure that documents can be shared between users running either 32-bit or 64-bit versions of Office by providing code for each bitness. For more information, see [64-Bit Visual Basic for Applications Overview](https://msdn.microsoft.com/en-us/library/office/gg264421.aspx). |
| 45 | + |
| 46 | +## Support restricted environments |
| 47 | +Your solution should not require User Account Elevation or Administrator privileges. Additionally, the solution should not depend on setting or altering: |
| 48 | + |
| 49 | +- The current working directory. |
| 50 | +- DLL load directories. |
| 51 | +- The PATH variable. |
| 52 | + |
| 53 | +## Change the save location of shared data and settings |
| 54 | +If the solution consists of an add-in and a process that is external to Office, do not use the user’s application data folder or the registry to exchange data or settings between the add-in and the external process. Instead, consider using the user’s temporary folder, documents folder, or your solution’s installation directory. |
| 55 | + |
| 56 | +## Increment the version number with each update |
| 57 | +Set the version number of the binaries in your solution and increment it with each update. This will make it easier for users to identify changes between versions and assess compatibility. |
| 58 | + |
| 59 | +## Provide support statements for the latest versions of Office |
| 60 | +Customers are asking ISVs to provide support statements for their COM, VSTO and VBA add-ins that run in Office. Listing your explicit support statements helps customers using Office 365 ProPlus readiness tools understand your support. |
| 61 | + |
| 62 | +To provide support statements for Office client applications (for example, Word or Excel), first verify that your add-ins run in the current Office release, and then commit to providing updates if your add-in breaks in a future release. You do not have to test your add-ins when Microsoft releases a new build, or an update to Office. Microsoft rarely changes the COM, VSTO and VBA extensibility platform in Office, and these changes will be well documented. |
| 63 | + |
| 64 | +>Important: Microsoft maintains a list of supported add-ins for readiness reports, and ISV contact information. To get your add-in listed, see [https://aka.ms/readyforwindows](https://aka.ms/readyforwindows). |
| 65 | +
|
| 66 | +## Use Process Monitor to help debug installation or loading issues |
| 67 | +If your add-in has compatibility issues during installation or load, they might be related to issues with file or registry access. Use [Process Monitor](https://docs.microsoft.com/en-us/sysinternals/downloads/procmon) or a similar debugging tool to log and compare behavior against a working environment to help identify the problem. |
0 commit comments