From 5a111632e43e16ffd8cdc0d5cc9f7e257cfa8130 Mon Sep 17 00:00:00 2001 From: Rick Kirkham Date: Tue, 20 Aug 2024 15:13:22 -0700 Subject: [PATCH 1/4] [All Hosts] (devx) update DevX articles for WXP unified manifest --- docs/includes/publish-add-in.md | 6 +++--- .../host-an-office-add-in-on-microsoft-azure.md | 12 ++++++------ docs/publish/publish-add-in-vs-code.md | 12 ++++++------ docs/publish/publish.md | 8 +++++--- docs/testing/troubleshoot-development-errors.md | 15 +++++++++------ 5 files changed, 29 insertions(+), 24 deletions(-) diff --git a/docs/includes/publish-add-in.md b/docs/includes/publish-add-in.md index a0bf301e8..099b5a9c2 100644 --- a/docs/includes/publish-add-in.md +++ b/docs/includes/publish-add-in.md @@ -1,4 +1,4 @@ -An Office Add-in consists of a web application and a manifest file. The web application defines the add-in's user interface and functionality, while the manifest specifies the location of the web application and defines settings and capabilities of the add-in. +An Office Add-in includes two basic components: a manifest file and your own web application. The manifest defines various settings, including how your add-in integrates with Office clients. Your web application serves the HTML, JavaScript, and other files that provide the add-in's functionality and UI. While you're developing your add-in, you can run the add-in on your local web server (`localhost`), but when you're ready to publish it for other users to access, you'll need to deploy the web application to a web server or web hosting service (for example, Microsoft Azure) and update the manifest to specify the URL of the deployed application. @@ -14,6 +14,6 @@ When your add-in is working as desired and you're ready to publish it for other 2. Upload the contents of the **dist** folder to the web server that'll host your add-in. You can use any type of web server or web hosting service to host your add-in. -3. In VS Code, open the add-in's manifest file, located in the root directory of the project (`manifest.xml`). Replace all occurrences of `https://localhost:3000` with the URL of the web application that you deployed to a web server in the previous step. +3. In VS Code, open the add-in's manifest file, located in the root directory of the project. Replace all occurrences of `https://localhost:3000` with the URL of the web application that you deployed to a web server in the previous step. -4. Choose the method you'd like to use to [deploy your Office Add-in](../publish/publish.md), and follow the instructions to publish the manifest file. +4. Choose the method you'd like to use to [deploy your Office Add-in](../publish/publish.md), and follow the instructions to publish the add-in. diff --git a/docs/publish/host-an-office-add-in-on-microsoft-azure.md b/docs/publish/host-an-office-add-in-on-microsoft-azure.md index aacad46b6..88f46586e 100644 --- a/docs/publish/host-an-office-add-in-on-microsoft-azure.md +++ b/docs/publish/host-an-office-add-in-on-microsoft-azure.md @@ -1,18 +1,18 @@ --- -title: Stage an Office Add-in on Microsoft Azure -description: Learn how to deploy an add-in web app to Azure and sideload the add-in for testing in an Office client application. -ms.date: 08/09/2024 +title: Stage an Office Add-in on Microsoft Azure with Visual Studio +description: Learn how to deploy an add-in web app to Azure and sideload the add-in for testing in an Office client application using Visual Studio. +ms.date: 09/19/2024 ms.localizationpriority: medium --- -# Stage an Office Add-in on Microsoft Azure +# Stage an Office Add-in on Microsoft Azure with Visual Studio The simplest Office Add-in is made up of an manifest file and an HTML page. The manifest file describes the add-in's characteristics, such as its name, what Office desktop clients it can run in, and the URL for the add-in's HTML page. The HTML page is contained in a web app that users interact with when they install and run your add-in within an Office client application. You can host the web app of an Office Add-in on any web hosting platform, including Azure. -This article describes how to deploy an add-in web app to Azure and [sideload the add-in](../testing/test-debug-non-local-server.md) for testing in an Office client application. +This article describes how to deploy an add-in web app to Azure and [sideload the add-in](../testing/test-debug-non-local-server.md) for testing in an Office client application using Visual Studio. For information about publishing an Office Add-in that you created using Visual Studio Code to Azure, see [Publish an add-in using Visual Studio Code and Azure](publish-add-in-vs-code.md). > [!IMPORTANT] -> The process described in this article doesn't apply to Outlook Add-ins. +> The process described in this article doesn't apply to Outlook Add-ins or to add-ins that use the [unified manifest for Microsoft 365](../develop/unified-manifest-overview.md). For information about publishing an Office Add-in that you created using Teams Toolkit (which use the unified manifest), see [Deploy Teams app to the cloud](/microsoftteams/platform/toolkit/deploy?pivots=visual-studio-code) and [Deploy your first Teams app](/microsoftteams/platform/sbs-gs-javascript?tabs=vscode%2Cvsc%2Cviscode). The latter article is about Teams tab apps, but it is applicable to Office Add-ins created with Teams Toolkit. ## Prerequisites diff --git a/docs/publish/publish-add-in-vs-code.md b/docs/publish/publish-add-in-vs-code.md index 92149b1bb..bdf476a33 100644 --- a/docs/publish/publish-add-in-vs-code.md +++ b/docs/publish/publish-add-in-vs-code.md @@ -1,7 +1,7 @@ --- title: Publish an add-in using Visual Studio Code and Azure description: How to publish an add-in using Visual Studio Code and Azure Active Directory -ms.date: 03/27/2023 +ms.date: 09/19/2023 ms.custom: vscode-azure-extension-update-completed ms.localizationpriority: medium --- @@ -13,11 +13,11 @@ This article describes how to publish an Office Add-in that you created using th > [!NOTE] > > - For information about publishing an Office Add-in that you created using Visual Studio, see [Publish your add-in using Visual Studio](package-your-add-in-using-visual-studio.md). -> - For information about publishing an Office Add-in that you created using Teams Toolkit, see [Deploy Teams app to the cloud](/microsoftteams/platform/toolkit/deploy?pivots=visual-studio-code) and [Deploy your first Teams app](/microsoftteams/platform/sbs-gs-javascript?tabs=vscode%2Cvsc%2Cviscode). This article is about Teams tab apps, but it is applicable to Office Add-ins created with Teams Toolkit. +> - The process described in this article doesn't apply to add-ins that use the [unified manifest for Microsoft 365](../develop/unified-manifest-overview.md). For information about publishing an Office Add-in that you created using Teams Toolkit (which use the unified manifest), see [Deploy Teams app to the cloud](/microsoftteams/platform/toolkit/deploy?pivots=visual-studio-code) and [Deploy your first Teams app](/microsoftteams/platform/sbs-gs-javascript?tabs=vscode%2Cvsc%2Cviscode). The latter article is about Teams tab apps, but it is applicable to Office Add-ins created with Teams Toolkit. ## Publishing an add-in for other users to access -An Office Add-in consists of a web application and a manifest file. The web application defines the add-in's user interface and functionality, while the manifest specifies the location of the web application and defines settings and capabilities of the add-in. +The simplest Office Add-in is made up of an manifest file and an HTML page. The manifest file describes the add-in's characteristics, such as its name, what Office desktop clients it can run in, and the URL for the add-in's HTML page. The HTML page is contained in a web app that users interact with when they install and run your add-in within an Office client application. You can host the web app of an Office Add-in on any web hosting platform, including Azure. While you're developing, you can run the add-in on your local web server (`localhost`). When you're ready to publish it for other users to access, you'll need to deploy the web application and update the manifest to specify the URL of the deployed application. @@ -26,7 +26,7 @@ When your add-in is working as desired, you can publish it directly through Visu ## Using Visual Studio Code to publish >[!NOTE] -> These steps only work for projects created with the Yeoman generator, and that use the add-in only manifest. They do not apply if you created the add-in using the Teams Toolkit or created it with the Yeoman generator and it uses the unified manifest for Microsoft 365. +> These steps only work for projects created with the Yeoman generator, and that use the add-in only manifest. They don't apply if you created the add-in using the Teams Toolkit or created it with the Yeoman generator and it uses the unified manifest for Microsoft 365. 1. Open your project from its root folder in Visual Studio Code (VS Code). 1. Select **View** > **Extensions** (Ctrl+Shift+X) to open the Extensions view. @@ -40,9 +40,9 @@ When your add-in is working as desired, you can publish it directly through Visu :::image type="content" source="../images/azure-extension-create-storage-account.png" alt-text="Selecting Storage accounts > Create Storage Account in the Azure extension."::: -1. Right-click (or select and hold) your storage account and select **Configure Static Website**. You'll be asked to enter the index document name and the 404 document name. Change the index document name from the default `index.html` to **`taskpane.html`**. You may also change the 404 document name but are not required to. +1. Right-click (or select and hold) your storage account and select **Configure Static Website**. You'll be asked to enter the index document name and the 404 document name. Change the index document name from the default `index.html` to **`taskpane.html`**. You may also change the 404 document name but aren't required to. 1. Right-click (or select and hold) your storage account again and this time select **Browse Static Website**. From the browser window that opens, copy the website URL. -1. Open your project's manifest file (`manifest.xml`) and change all references to your localhost URL (such as `https://localhost:3000`) to the URL you've copied. This endpoint is the static website URL for your newly created storage account. Save the changes to your manifest file. +1. Open your project's manifest file and change all references to your localhost URL (such as `https://localhost:3000`) to the URL you've copied. This endpoint is the static website URL for your newly created storage account. Save the changes to your manifest file. 1. Open a command line prompt or terminal window and go to the root directory of your add-in project. Run the following command to prepare all files for production deployment. ```command line diff --git a/docs/publish/publish.md b/docs/publish/publish.md index 5318dffa0..fe2943c3c 100644 --- a/docs/publish/publish.md +++ b/docs/publish/publish.md @@ -1,7 +1,7 @@ --- title: Deploy and publish Office Add-ins description: Methods and options to deploy your Office Add-in for testing or distribution to users. -ms.date: 07/13/2024 +ms.date: 09/19/2024 ms.localizationpriority: high --- @@ -56,12 +56,14 @@ For more information on the Integrated Apps deployment process, see [Test and de ### SharePoint app catalog deployment -A SharePoint app catalog is a special site collection that you can create to host Word, Excel, and PowerPoint add-ins. Because SharePoint catalogs don't support new add-in features implemented in the `VersionOverrides` node of the manifest, including add-in commands, we recommend that you use Centralized Deployment via the admin center if possible. Add-in commands deployed via a SharePoint catalog open in a task pane by default. +A SharePoint app catalog is a special site collection that you can create to host Word, Excel, and PowerPoint add-ins. Because SharePoint catalogs don't support many add-in features, including add-in commands, we recommend that you use Centralized Deployment via the admin center if possible. If you are deploying add-ins in an on-premises environment, use a SharePoint catalog. For details, see [Publish task pane and content add-ins to a SharePoint catalog](publish-task-pane-and-content-add-ins-to-an-add-in-catalog.md). > [!NOTE] -> SharePoint catalogs don't support Office on Mac. To deploy Office Add-ins to Mac clients, you must submit them to [AppSource](/partner-center/marketplace-offers/submit-to-appsource-via-partner-center). +> - SharePoint catalogs don't support Outlook add-ins. +> - SharePoint catalogs don't support add-ins that use the [unified manifest for Microsoft 365](../develop/unified-manifest-overview.md). +> - SharePoint catalogs don't support Office on Mac. To deploy Office Add-ins to Mac clients, you must submit them to [AppSource](/partner-center/marketplace-offers/submit-to-appsource-via-partner-center). ### Outlook add-in Exchange server deployment diff --git a/docs/testing/troubleshoot-development-errors.md b/docs/testing/troubleshoot-development-errors.md index 44309a275..a84716274 100644 --- a/docs/testing/troubleshoot-development-errors.md +++ b/docs/testing/troubleshoot-development-errors.md @@ -2,7 +2,7 @@ title: Troubleshoot development errors with Office Add-ins description: Learn how to troubleshoot development errors in Office Add-ins. ms.topic: troubleshooting-problem-resolution -ms.date: 08/15/2024 +ms.date: 09/19/2024 ms.localizationpriority: medium --- @@ -80,9 +80,12 @@ The following are some of the causes of this error. If you discover additional c - If you are using Visual Studio, there may be a problem with the sideloading. Close all instances of the Office host and Visual Studio. Restart Visual Studio and try pressing F5 again. - The add-in's manifest has been removed from its deployment location, such as Centralized Deployment, a SharePoint catalog, or a network share. -- The value of the [ID](/javascript/api/manifest/id) element in the manifest has been changed directly in the deployed copy. If for any reason, you want to change this ID, first remove the add-in from the Office host, then replace the original manifest with the changed manifest. You many need to clear the Office cache to remove all traces of the original. See the [Clear the Office cache](clear-cache.md) article for instructions on clearing the cache for your operating system. -- The add-in's manifest has a `resid` that is not defined anywhere in the [Resources](/javascript/api/manifest/resources) section of the manifest, or there is a mismatch in the spelling of the `resid` between where it is used and where it is defined in the **\** section. -- There is a `resid` attribute somewhere in the manifest with more than 32 characters. A `resid` attribute, and the `id` attribute of the corresponding resource in the **\** section, cannot be more than 32 characters. +- If the add-in only manifest is being used, one of the following may apply. + + - The value of the [ID](/javascript/api/manifest/id) element in the manifest has been changed directly in the deployed copy. If for any reason, you want to change this ID, first remove the add-in from the Office host, then replace the original manifest with the changed manifest. You many need to clear the Office cache to remove all traces of the original. See the [Clear the Office cache](clear-cache.md) article for instructions on clearing the cache for your operating system. + - The add-in's manifest has a `resid` that isn't defined anywhere in the [Resources](/javascript/api/manifest/resources) section of the manifest, or there is a mismatch in the spelling of the `resid` between where it is used and where it is defined in the **\** section. + - There is a `resid` attribute somewhere in the manifest with more than 32 characters. A `resid` attribute, and the `id` attribute of the corresponding resource in the **\** section, cannot be more than 32 characters. + - The add-in has a custom Add-in Command but you are trying to run it on a platform that doesn't support them. For more information, see [Add-in commands requirement sets](/javascript/api/requirement-sets/common/add-in-commands-requirement-sets). ## Add-in doesn't work on Edge but it works on other browsers @@ -97,9 +100,9 @@ See [Troubleshoot Excel add-ins](../excel/excel-add-ins-troubleshooting.md) for See [Troubleshoot Word add-ins](../word/word-add-ins-troubleshooting.md) for possible causes. -## Manifest schema validation errors in Visual Studio projects +## Add-in only manifest schema validation errors in Visual Studio projects -If you're using newer features that require changes to the manifest file, you may get validation errors in Visual Studio. For example, when adding the **\** element to implement the [shared runtime](runtimes.md#shared-runtime), you may see the following validation error. +If you're using newer features that require changes to the add-in only manifest file, you may get validation errors in Visual Studio. For example, when adding the **\** element to implement the [shared runtime](runtimes.md#shared-runtime), you may see the following validation error. **The element 'Host' in namespace 'http://schemas.microsoft.com/office/taskpaneappversionoverrides' has invalid child element 'Runtimes' in namespace 'http://schemas.microsoft.com/office/taskpaneappversionoverrides'** From 8af3705effe8b594da8316fcdc5d4796cdb76211 Mon Sep 17 00:00:00 2001 From: Rick Kirkham Date: Tue, 20 Aug 2024 15:32:17 -0700 Subject: [PATCH 2/4] clarification --- docs/publish/host-an-office-add-in-on-microsoft-azure.md | 2 +- docs/publish/publish-add-in-vs-code.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/publish/host-an-office-add-in-on-microsoft-azure.md b/docs/publish/host-an-office-add-in-on-microsoft-azure.md index 88f46586e..19b383d09 100644 --- a/docs/publish/host-an-office-add-in-on-microsoft-azure.md +++ b/docs/publish/host-an-office-add-in-on-microsoft-azure.md @@ -12,7 +12,7 @@ The simplest Office Add-in is made up of an manifest file and an HTML page. The This article describes how to deploy an add-in web app to Azure and [sideload the add-in](../testing/test-debug-non-local-server.md) for testing in an Office client application using Visual Studio. For information about publishing an Office Add-in that you created using Visual Studio Code to Azure, see [Publish an add-in using Visual Studio Code and Azure](publish-add-in-vs-code.md). > [!IMPORTANT] -> The process described in this article doesn't apply to Outlook Add-ins or to add-ins that use the [unified manifest for Microsoft 365](../develop/unified-manifest-overview.md). For information about publishing an Office Add-in that you created using Teams Toolkit (which use the unified manifest), see [Deploy Teams app to the cloud](/microsoftteams/platform/toolkit/deploy?pivots=visual-studio-code) and [Deploy your first Teams app](/microsoftteams/platform/sbs-gs-javascript?tabs=vscode%2Cvsc%2Cviscode). The latter article is about Teams tab apps, but it is applicable to Office Add-ins created with Teams Toolkit. +> The process described in this article doesn't apply to Outlook Add-ins or to add-ins that use the [unified manifest for Microsoft 365](../develop/unified-manifest-overview.md). Add-ins created using Teams Toolkit use the unified manifest. For information about publishing an add-in that you created using Teams Toolkit, see [Deploy Teams app to the cloud](/microsoftteams/platform/toolkit/deploy?pivots=visual-studio-code) and [Deploy your first Teams app](/microsoftteams/platform/sbs-gs-javascript?tabs=vscode%2Cvsc%2Cviscode). The latter article is about Teams tab apps, but it is applicable to Office Add-ins created with Teams Toolkit. ## Prerequisites diff --git a/docs/publish/publish-add-in-vs-code.md b/docs/publish/publish-add-in-vs-code.md index bdf476a33..b58f2cbbe 100644 --- a/docs/publish/publish-add-in-vs-code.md +++ b/docs/publish/publish-add-in-vs-code.md @@ -13,7 +13,7 @@ This article describes how to publish an Office Add-in that you created using th > [!NOTE] > > - For information about publishing an Office Add-in that you created using Visual Studio, see [Publish your add-in using Visual Studio](package-your-add-in-using-visual-studio.md). -> - The process described in this article doesn't apply to add-ins that use the [unified manifest for Microsoft 365](../develop/unified-manifest-overview.md). For information about publishing an Office Add-in that you created using Teams Toolkit (which use the unified manifest), see [Deploy Teams app to the cloud](/microsoftteams/platform/toolkit/deploy?pivots=visual-studio-code) and [Deploy your first Teams app](/microsoftteams/platform/sbs-gs-javascript?tabs=vscode%2Cvsc%2Cviscode). The latter article is about Teams tab apps, but it is applicable to Office Add-ins created with Teams Toolkit. +> - The process described in this article doesn't apply to add-ins that use the [unified manifest for Microsoft 365](../develop/unified-manifest-overview.md). Add-ins created using Teams Toolkit use the unified manifest. For information about publishing an add-in that you created using Teams Toolkit, see [Deploy Teams app to the cloud](/microsoftteams/platform/toolkit/deploy?pivots=visual-studio-code) and [Deploy your first Teams app](/microsoftteams/platform/sbs-gs-javascript?tabs=vscode%2Cvsc%2Cviscode). The latter article is about Teams tab apps, but it is applicable to Office Add-ins created with Teams Toolkit. ## Publishing an add-in for other users to access From 58e627e1280615fccbaca6ebff601f6ff5bc0a79 Mon Sep 17 00:00:00 2001 From: Rick Kirkham Date: Tue, 20 Aug 2024 15:47:58 -0700 Subject: [PATCH 3/4] link fixes --- docs/develop/configure-your-add-in-to-use-a-shared-runtime.md | 2 +- docs/develop/debug-office-add-ins-in-visual-studio.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/develop/configure-your-add-in-to-use-a-shared-runtime.md b/docs/develop/configure-your-add-in-to-use-a-shared-runtime.md index 7e2a31575..378a3d03c 100644 --- a/docs/develop/configure-your-add-in-to-use-a-shared-runtime.md +++ b/docs/develop/configure-your-add-in-to-use-a-shared-runtime.md @@ -27,7 +27,7 @@ Run the command `yo office --projectType taskpane --name "my office add in" --ho You can use different options for the **--projecttype**, **--name**, and **--js** command-line options. For the full list of options, see [Yeoman generator for Office Add-ins](https://github.com/OfficeDev/generator-office). -The generator will create the project and install supporting Node components. You can also use the steps in this article to update a Visual Studio project to use the shared runtime. However, you may need to update the XML schemas for the manifest. For more information, see [Troubleshoot development errors with Office Add-ins](../testing/troubleshoot-development-errors.md#manifest-schema-validation-errors-in-visual-studio-projects). +The generator will create the project and install supporting Node components. You can also use the steps in this article to update a Visual Studio project to use the shared runtime. However, you may need to update the XML schemas for the manifest. For more information, see [Troubleshoot development errors with Office Add-ins](../testing/troubleshoot-development-errors.md#add-in-only-manifest-schema-validation-errors-in-visual-studio-projects). ## Configure the manifest diff --git a/docs/develop/debug-office-add-ins-in-visual-studio.md b/docs/develop/debug-office-add-ins-in-visual-studio.md index 0ebbb55a5..2c8948ca3 100644 --- a/docs/develop/debug-office-add-ins-in-visual-studio.md +++ b/docs/develop/debug-office-add-ins-in-visual-studio.md @@ -93,7 +93,7 @@ Next, Visual Studio does the following: 1. Validates the manifest. > [!IMPORTANT] - > If you get validation errors for the manifest, it may be that Visual Studio's manifest schema files haven't been updated to support the latest features. Your first troubleshooting step should be to replace one or more of these files with the latest versions. For detailed instructions, see [Manifest schema validation errors in Visual Studio projects](../testing/troubleshoot-development-errors.md#manifest-schema-validation-errors-in-visual-studio-projects). + > If you get validation errors for the manifest, it may be that Visual Studio's manifest schema files haven't been updated to support the latest features. Your first troubleshooting step should be to replace one or more of these files with the latest versions. For detailed instructions, see [Manifest schema validation errors in Visual Studio projects](../testing/troubleshoot-development-errors.md#add-in-only-manifest-schema-validation-errors-in-visual-studio-projects). 1. Opens the Office application and sideloads your add-in. @@ -182,7 +182,7 @@ Next, Visual Studio does the following: 1. Validates the manifest. > [!IMPORTANT] - > If you get validation errors for the manifest, it may be that Visual Studio's manifest schema files haven't been updated to support the latest features. Your first troubleshooting step should be to replace one or more of these files with the latest versions. For detailed instructions, see [Manifest schema validation errors in Visual Studio projects](../testing/troubleshoot-development-errors.md#manifest-schema-validation-errors-in-visual-studio-projects). + > If you get validation errors for the manifest, it may be that Visual Studio's manifest schema files haven't been updated to support the latest features. Your first troubleshooting step should be to replace one or more of these files with the latest versions. For detailed instructions, see [Manifest schema validation errors in Visual Studio projects](../testing/troubleshoot-development-errors.md#add-in-only-manifest-schema-validation-errors-in-visual-studio-projects). 1. Opens the Office application host page of your Microsoft 365 tenancy in Microsoft Edge. From f951a67e0695bf0372a2d2e5650196064dfa96a1 Mon Sep 17 00:00:00 2001 From: Rick Kirkham Date: Thu, 19 Sep 2024 12:14:38 -0700 Subject: [PATCH 4/4] Apply suggestions from code review Co-authored-by: Alison McKay --- docs/publish/publish-add-in-vs-code.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/publish/publish-add-in-vs-code.md b/docs/publish/publish-add-in-vs-code.md index b58f2cbbe..c5583c387 100644 --- a/docs/publish/publish-add-in-vs-code.md +++ b/docs/publish/publish-add-in-vs-code.md @@ -1,7 +1,7 @@ --- title: Publish an add-in using Visual Studio Code and Azure description: How to publish an add-in using Visual Studio Code and Azure Active Directory -ms.date: 09/19/2023 +ms.date: 09/19/2024 ms.custom: vscode-azure-extension-update-completed ms.localizationpriority: medium --- @@ -17,7 +17,7 @@ This article describes how to publish an Office Add-in that you created using th ## Publishing an add-in for other users to access -The simplest Office Add-in is made up of an manifest file and an HTML page. The manifest file describes the add-in's characteristics, such as its name, what Office desktop clients it can run in, and the URL for the add-in's HTML page. The HTML page is contained in a web app that users interact with when they install and run your add-in within an Office client application. You can host the web app of an Office Add-in on any web hosting platform, including Azure. +The simplest Office Add-in is made up of a manifest file and an HTML page. The manifest file describes the add-in's characteristics, such as its name, what Office applications it can run in, and the URL for the add-in's HTML page. The HTML page is contained in a web app that users interact with when they install and run your add-in within an Office application. You can host the web app of an Office Add-in on any web hosting platform, including Azure. While you're developing, you can run the add-in on your local web server (`localhost`). When you're ready to publish it for other users to access, you'll need to deploy the web application and update the manifest to specify the URL of the deployed application.