How to: Publish an app for Office

apps for Office

How to

Learn how to publish your app for Office.

Before you can publish your app for Office, you’ll have to package it first. The package contains an XML file that you’ll use to publish the app. You’ll have to publish the web application files of your project separately.

Last modified: August 13, 2014

Applies to: Access app for SharePoint | Excel 2013 | Excel 2013 RT | Excel 2013 SP1 | Excel Online | Outlook 2013 | Outlook 2013 RT | Outlook 2013 SP1 | Outlook Web App | OWA for Devices | PowerPoint 2013 | PowerPoint 2013 RT | PowerPoint 2013 SP1 | PowerPoint Online | Project 2013 | Project 2013 SP1 | Word 2013 | Word 2013 RT | Word 2013 SP1

   Office.js: v1.0, v1.1

   Apps for Office manifests schema: v1.0, v1.1

In this article
Prerequisites
Publish an app for Office that you create by using the "Napa" Office 365 Development Tools app
Publish an app for Office that you create by using Visual Studio 2013
Publish an app for Office that you create by using Visual Studio 2012
Additional resources

To package an app for Office that you create by using "Napa" Office 365 Development Tools:

  • Office 365 account

  • "Napa" Office 365 Development Tools app

To package an app for Office that you create by using by using Visual Studio:

  • Microsoft Visual Studio 2013

    -or-

    Visual Studio 2012 and the Microsoft Office Developer Tools for Visual Studio 2012. To download the Microsoft Office Developer Tools for Visual Studio 2012, see "Tools" on the Download page.

  • Office 2013

Package the app, publish the web content files, and then publish the app.

Step 1: Package the app

  1. On the side of the page, choose the Publish button (Publish button).

  2. In the Publish settings dialog box, choose the Next button.

  3. Provide the URL of the website that will host the content files of your app (for example, the default html and JavaScript files of your project), and then choose the Publish button.

  4. In the Publish successful dialog box, choose the Publish location link.

    A document library appears that contains the XML manifest file of your app, and the web content files.

Step 2: Publish the Web content files

Manually copy the web content files of (style sheets, JavaScript files, and HTML files) to the web server that hosts the website that you provided in the Publish settings dialog box.

Step 3: Publish your app for Office

To publish your app, upload the XML manifest file of your app to the Office Store, Apps for Office catalog, SharePoint, file share, or Exchange catalog. For more information about how to publish the manifest file, see Publishing your app for Office.

Publish the web application files, package the app, and then publish the app

Step 1: Publish the Web Application

Open the Publish your app page, select or create a new profile, and then deploy your web project.

To open the Publish your app page

  • In Solution Explorer, open the shortcut menu for the app project, and then choose Publish.

    The Publish your app page appears.

To select or create a profile

  • In the Current profile drop-down list, select a profile or choose <New …> to create a new profile.

    Note Note

    A publish profile specifies the server you are deploying to, the credentials needed to log on to the server, the databases to deploy, and other deployment options.

    If you choose <New …>, the Create publishing profile wizard appears. You can use this wizard to import a publishing profile from a web site hosting provider such as Microsoft Azure or create a new profile and add your server, credentials, and other settings in the next procedure.

    For more information about importing publishing profiles or creating new publishing profiles, see Creating a Publish Profile.

To deploy your web project

Step 2: Package the App

  1. In the Publish your app page, choose the Package the app link.

    The Publish apps for Office and SharePoint wizard appears.

  2. In the Where is your website hosted? dropdown list, select or enter the URL of the website that will host the content files of your app, and then choose the Finish button.

    You have to specify an address that begins with the "https" prefix. For more information, see Why do my apps have to be SSL-secured?.

    Note Note

    Azure websites automatically provide an https end-point.

    In general, using an https endpoint for your website is the best approach, but if you don’t plan to publish your app to the Office Store, you don’t have to use one. However, to complete this wizard, you must specify an address that begins with the https prefix. After the package is created, you can open the manifest in Notepad and replace the "https" prefix of your website with an "http" prefix.

    Visual Studio generates the files that you need to publish your app and then opens the publish output folder.

Step 3: Publish your app for Office

If you plan to submit your app to the Office store, you can choose the Perform a validation check link to identify issues that will prevent your app from being accepted. You should address all issues before submitting your app to the store.

When you’re ready to publish your app, upload the XML manifest file of your app to the Office Store, Apps for Office catalog, SharePoint, file share, or Exchange catalog. You can find the XML manifest of your app in OfficeAppManifests folder in the app.publish folder (For example, %UserProfile%\Documents\Visual Studio 2012\Projects\MyApp\bin\Debug\app.publish\OfficeAppManifests).

For more information about how to publish the manifest file, see Publishing your app for Office.

Package the app, publish the web application files, and then publish the app.

Step 1: Package the app

  1. In Solution Explorer, open the shortcut menu for the app project, and then choose Publish.

    The Publish Office Apps wizard appears.

  2. In the Which Publish Profile do you want to publish? dropdown list, enter the name of a new profile, and then choose the Next button.

    A publish profile specifies the server you are deploying to, the credentials needed to log on to the server, the databases to deploy, and other deployment options.

  3. In the Where is your website hosted? dropdown list, select or enter the URL of the website that will host the content files of your app (for example, the default html and JavaScript files of your project), and then choose the Publish button.

    You have to specify an address that begins with the "https" prefix. For more information, see Why do my apps have to be SSL-secured?.

    Note Note

    Azure websites automatically provide an https end-point.

    In general, using an https endpoint for your website is the best approach, but if you don’t plan to publish your app to the Office Store, you don’t have to use one. However, to complete this wizard, you must specify an address that begins with the https prefix. After the package is created, you can open the manifest in Notepad and replace the "https" prefix of your website with an "http" prefix.

  4. Verify the information that appears in the summary page, and then choose the Finish button.

    Visual Studio generates all of the files that you need to publish your app and then opens the publish output folder. If you accidentally close that folder, you can find your publishing files in the app.Publish folder of your project output folder (For example, %UserProfile%\Documents\Visual Studio 2012\Projects\MyApp\bin\Debug\app.publish).

Step 2: Publish the Web Application

When you complete the wizard, Visual Studio creates a deployment package for your web application project. The deployment package of the web application project appears in a ZIP file that is located in the app.publish folder along with several other supportive files.

For more information about how to install the deployment package on the destination web server, see the Installing the Package section in the topic How to: Create a Web Deployment Package in Visual Studio.

Step 3: Publish your app for Office

To publish your app, upload the XML manifest file of your app to the Office Store, Apps for Office catalog, SharePoint, file share, or Exchange catalog. You can find the XML manifest of your app in OfficeAppManifests folder in the app.publish folder (For example, %UserProfile%\Documents\Visual Studio 2012\Projects\MyApp\bin\Debug\app.publish\OfficeAppManifests).

For more information about how to publish the manifest file, see Publishing your app for Office.

Show:
© 2014 Microsoft