title | description | ms.date | ms.localizationpriority |
---|---|---|---|
Publish your add-in using Visual Studio |
How to deploy your web project and package your add-in by using Visual Studio 2019. |
01/23/2023 |
medium |
Your Office Add-in package contains an XML manifest file that you'll use to publish the add-in. You'll have to publish the web application files of your project separately. This article describes how to deploy your web project and package your add-in by using Visual Studio 2019.
Note
For information about publishing an Office Add-in that you created using the Yeoman generator and developed with Visual Studio Code or any other editor, see Publish an add-in developed with Visual Studio Code.
Complete the following steps to deploy your web project using Visual Studio 2019.
-
From the Build tab, choose Publish [Name of your add-in].
-
In the Pick a publish target window, choose one of the options to publish to your preferred target. Each publish target requires you to include more information to get started, such as an Azure Virtual Machine or folder location. Once you have specified a publish location and filled in all of the information required, select Publish
[!NOTE] Picking a publish target specifies the server you are deploying to, the credentials needed to sign in to the server, the databases to deploy, and other deployment options.
-
For more information about deployment steps for each publish target option, see First look at deployment in Visual Studio.
Complete the following steps to package your add-in using Visual Studio 2019.
-
From the Build tab, choose Publish [Name of your add-in].
-
In the Pick a publish target window, choose IIS, FTP, etc, and select Configure. Next, select Publish.
-
A wizard appears that will help guide you through the process. Ensure the publish method is your preferred method, such as Web Deploy.
-
In the Destination URL box, enter the URL of the website that will host the content files of your add-in, and then select Next. If you plan to submit your add-in to AppSource, you can choose the Validate Connection button to identify any issues that will prevent your add-in from being accepted. You should address all issues before you submit your add-in to the store.
-
Confirm any settings desired including File Publish Options and select Save.
[!IMPORTANT] [!includeHTTPS guidance] Azure websites automatically provide an HTTPS endpoint.
You can now upload your manifest to the appropriate location to publish your add-in. You can find the manifest in OfficeAppManifests
in the app.publish
folder. For example:
%UserProfile%\Documents\Visual Studio 2019\Projects\MyApp\bin\Debug\app.publish\OfficeAppManifests
[!INCLUDE General statements about updating an add-in]