UPack Documentation

Universal Package Explorer

The Universal Package Explorer is a Windows desktop application that makes it easy to create, view, and publish universal packages. You can load a .upack file from disk, or directly from a ProGet universal feed.

Download, Installation, & Source Code

Visit the GitHub Releases section to download the latest installer.

The source code for Universal Package Explorer is hosted on GitHub.

Creating and Publishing a Universal Package

Prerequisites:

Overview

In this tutorial, we will take an existing website and package it into a Universal Package using the Universal Package Explorer. The files in Accounts.zip are just the build output of a basic .NET web application. For those unfamiliar with .NET, it could just as easily be a Java WAR file, a collection of PHP files, or even static HTML.

Creating a Package

In this step, we will create a Universal Package. To begin, we will download the Accounts.zip file and extract its contents into a temporary directory (in this example, we will use C:\tmp\accounts).

Open the Universal Package Explorer and select "Create a new package" option:

Create New Package

From here, we can add the files in C:\tmp\accounts into the package via the Contents > Add > Existing Folder option:

Add Files

Once the files are added to the package, we can modify the metadata. Click the "Edit" button, and enter the following values:

  • Name: Accounts
  • Version: 1.0.0
  • Title: Accounts Website
  • Description: This package contains the build output for the Accounts demo website

Switching back to View mode will now display the metadata:

Display Metadata

Now the package is complete. Select File > Save to save the package to disk as a .upack file.

Pushing a Package to a Universal Feed in ProGet

Once a package is created, we are now able to publish it to a Universal feed. Before we can push the package, we must determine the endpoint of the ProGet feed to use it as the push source. After logging into ProGet and browsing to the feed, take note of the endpoint URL:

API Endpoint URL

Using this value, we can now push our newly generated package to the feed. From the Universal Package Explorer main menu, select File > Publish… to open the Publish window:

Publish Window

Enter the feed endpoint URL and credentials configured to push packages, then click "Log in", and if the credentials are valid, click "Publish". Once successful, browsing to the feed within ProGet will display the package:

Display Package in ProGet