This sample shows you how to get package info by using the Windows Runtime packaging API (Windows.ApplicationModel.Package and Windows.ApplicationModel.PackageId).
Note This sample was created using one of the universal app templates available in Visual Studio. It shows how its solution is structured so it can run on both Windows 8.1 and Windows Phone 8.1. For more info about how to build apps that target Windows and Windows Phone with Visual Studio, see Build apps that target Windows and Windows Phone 8.1 by using Visual Studio.
Users acquire your Windows Runtime app as an app package. The operating system uses the info in an app package to install the app on a per-user basis, and ensure that all traces of the app are gone from the device after all users who installed the app uninstall it. Each package consists of the files that constitute the app, along with a package manifest file that describes the app to the operating system.
Each package is defined by a globally unique identifier known as the package identity. Each package is described through package properties such as the display name, description, and logo.
The sample covers these key tasks:
- Getting the package identity using Package.Id
- Getting the package directory using Package.InstalledLocation
- Getting package dependencies using Package.Dependencies
The sample covers these new tasks for Windows 8.1:
- Getting the package description using Package.Description
- Getting the package display name using Package.DisplayName
- Determining whether the package is a bundle package using Package.IsBundle
- Determining whether the package is installed in development mode using Package.IsDevelopmentMode
- Determining whether the package is a resource package using Package.IsResourcePackage
- Getting package logo using Package.Logo
- Getting publisher display name of the package using Package.PublisherDisplayName
To obtain an evaluation copy of Windows 8.1, go to Windows 8.1.
To obtain an evaluation copy of Microsoft Visual Studio 2013 Update 2, go to Microsoft Visual Studio 2013.
Related topics
- Windows 8 app samples
- Conceptual
- App packages and deployment
- Reference
- Windows.ApplicationModel.Package
- Windows.ApplicationModel.PackageId
Operating system requirements
| Client | |
|---|---|
| Server | |
| Phone |
Build the sample
- Start Visual Studio 2013 Update 2 and select File > Open > Project/Solution.
- Go to the directory to which you unzipped the sample. Then go to the subdirectory named for the sample and double-click the Visual Studio 2013 Update 2 Solution (.sln) file.
- Follow the steps for the version of the sample you want:
-
To build the Windows version of the sample:
- Select PackageSample.Windows in Solution Explorer.
- Press Ctrl+Shift+B, or use Build > Build Solution, or use Build > Build PackageSample.Windows.
-
To build the Windows Phone version of the sample:
- Select PackageSample.WindowsPhone in Solution Explorer.
- Press Ctrl+Shift+B or use Build > Build Solution or use Build > Build PackageSample.WindowsPhone.
-
Run the sample
The next steps depend on whether you just want to deploy the sample or you want to both deploy and run it.
Deploying the sample
-
To deploy the built Windows version of the sample:
- Select PackageSample.Windows in Solution Explorer.
- Use Build > Deploy Solution or Build > Deploy PackageSample.Windows.
-
To deploy the built Windows Phone version of the sample:
- Select PackageSample.WindowsPhone in Solution Explorer.
- Use Build > Deploy Solution or Build > Deploy PackageSample.WindowsPhone.
Deploying and running the sample
-
To deploy and run the Windows version of the sample:
- Right-click PackageSample.Windows in Solution Explorer and select Set as StartUp Project.
- To debug the sample and then run it, press F5 or use Debug > Start Debugging. To run the sample without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.
-
To deploy and run the Windows Phone version of the sample:
- Right-click PackageSample.WindowsPhone in Solution Explorer and select Set as StartUp Project.
- To debug the sample and then run it, press F5 or use Debug > Start Debugging. To run the sample without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.