Install a Project Siena app

To install a Project Siena app, you first publish it to create a set of installation files in a folder named PublishedPackageYourAppName. You can then install the app using installation files on any device (such as your development or test device) that meets these requirements:

• A valid developer license must be installed.

  To keep your app running, you must renew your license before it expires. You can renew your license by using the same method that you used to acquire it. If your license has expired, you'll be prompted to renew it the next time you try to publish or install a Project Siena app.

• The user who's logged on must have administrative permissions for the device.

• The device must be running Windows 8.1 Update 1 Pro or Windows 8.1 Update 1 Enterprise.

• Powershell must be enabled on the device.

  Powershell is enabled by default in Windows 8 and Windows 8.1.

• All previous versions of the app must be uninstalled from the device.

• If your app requires a custom certificate, it must be installed on the device.

  An enterprise organization might require a custom certificate to ensure that only authorized apps are installed. For more information, see your IT department.

To install the app more broadly (for example, on a device that's running Windows RT or on which no developer license is installed), you use the installation files to create a deployment package in a folder named DeploymentPackage, and then you install the app using the deployment package.

Publish your app

Prerequisites

To perform this task, you need administrative permissions and a valid developer license on a device that's running Windows 8.1 Update 1 Pro or Windows 8.1 Update 1 Enterprise. You also need a valid key for each data source/connection that requires one.

Steps

1. Press Alt-F, and then click Publish.

   Note

   If you're prompted to download an installer update, click Download.

   The Publish screen appears.

2. In the Display name text box, type a name for your app that starts with a letter, contains more than two characters, and doesn't contain spaces or special characters.

3. (optional) Perform one or more of these steps:

   • Change the tile color by clicking Edit  and then clicking the color that you want.

   • Specify a custom icon by clicking Browse (…), locating the file that you want, and then clicking Open.

   • Include copies of your resource files in the local folder by selecting Publish resources locally under Resources.

     If you're accessing resources from a live data source, you might not want to publish your resources locally.

4. Click Publish.

   

5. Browse to the location where you want to create the installation files, click Choose this folder, and then click OK.

   The PublishedPackage folder is created in the location that you specified.

Install your app using installation files

Prerequisites

For information about prerequisites, see the introduction for this topic.

Steps

1. If the PublishedPackage folder isn't already on the device on which you want to install the app, copy it there.

2. Open the PublishedPackage folder, and then run InstallApp.exe.

3. Click Install on this PC, click Next, and then click Done.

   The app is installed on the local device.

Create a deployment package

Prerequisites

To perform this task, you need administrative permissions and a valid developer license on a device that's running Windows 8.1 Update 1 Pro or Windows 8.1 Update 1 Enterprise.

Steps

1. Open the PublishedPackage folder, and then run InstallApp.exe.

2. Click Create an appx file for sharing, and specify where you want to create the deployment package.

3. (optional) If you have a custom certificate (for example, a certificate for your enterprise organization), specify it.

   For information about an enterprise certificate for your organization, see your IT department.

4. Click Next, and then click Done.

   The DeploymentPackage folder is created in the location that you specified.

Install your app using a deployment package

Prerequisites

The prerequisites for this section match those listed in the introduction for this topic, except you don't need a developer license and the device can run Windows RT.

Steps

1. Copy the DeploymentPackage folder to the target device, and then open that folder.

2. Right-click Add_AppxPackage, and then click Run with PowerShell.

   Tip

   If Windows Smart Screen is enabled on the target device, click OK in the message windows.

   The app is installed on the local device.