Automatic installation for Windows Store device apps
In Windows 8.1, device manufacturers can configure their Windows Store device apps to automatically install when the user connects their device to the PC. This topic describes how automatic installation works and how the app, metadata, and drivers can be updated and uninstalled. For more info about device apps, see Meet Windows Store device apps.
Automatic installation is enabled when you specify your device app's package details in the Windows Store device app portion of the App Info page of the Device Metadata Authoring Wizard. For more info, see Step 2: Create device metadata.
A Windows Store device app can be acquired by the user in one of three ways:
- Automatic installation: The app is automatically acquired and installed the first time a peripheral device is connected to the PC. This is the most common way a Windows Store device app is installed.
- Manual install: The user finds an app in the Windows Store and installs it from there. This is typically how app updates and other Windows Store apps are installed.
- OEM preinstall: An app for a PC internal device or system component can be preinstalled by an OEM as part of a new PC. For more info, see Preinstall Apps Using DISM.
In order for automatic installation to work, the user needs to:
Opt in to the Recommended Settings during Windows installation.
Be signed in to the Windows Store.
This allows Windows to automatically acquire the metadata, app, and drivers (if needed). If no Internet connection is available, the automatic installation will happen at a later time, when it can access the Internet.
There are four stages to automatic installation:
Device is connected: When the device is plugged in or paired with the PC, Windows requests the device metadata from Windows Metadata and Internet Services (WMIS) and, if needed, the device drivers from Windows Update.
Device metadata is downloaded: Windows downloads the device metadata from WMIS and parses it to identify the app that's associated with the device. This triggers the download of the app.
Device drivers are downloaded: If drivers are needed, Windows downloads them from Windows Update and automatically installs them.
Device app is installed: Windows downloads the app and installs it to the All Apps screen of the currently logged-in user.
If there's an error during any of these steps, the user will see an error message on the Devices page of the Settings app.
If the PC isn't connected to the Internet or is on a metered connection, Windows will wait to perform the automatic installation. The next time the PC has an unrestricted Internet connection, Windows will automatically try again. The installation is performed silently in the background, without interruption to the user.
If the user isn't logged in to the Windows Store with a Microsoft account, Windows will wait to perform the automatic installation. The next time the user logs in to the Windows Store with a Microsoft account, Windows will automatically try again. The installation is performed silently in the background, without interruption to the user.
Driver updates are distributed through Windows Update as optional updates, as long as the user has opted in to receiving updates from Windows Update. Driver updates aren't automatically distributed to devices if the user has completed device setup and already has metadata and drivers installed.
Driver updates aren't coupled to app updates, so driver updates should be designed to ensure compatibility with existing apps. If a driver update is distributed through Windows Update, or if the user manually reinstalls or updates the driver, the app should handle this appropriately. If your app uses a custom driver, be sure to maintain compatibility and functional contracts. For more info, see Windows Store device apps for internal devices.
The metadata that’s distributed by WMIS can be updated to point to a new or different Windows Store device app. About 8 to 15 days after the submission of updated metadata that indicates a new app, new devices that are connected and set up for the first time will get the new app. But a new app indicated in updated metadata isn't automatically distributed to PCs for which the device setup is already complete, because the users have previously received device metadata for the device.
The Windows Store device app is automatically downloaded only once, when the device is initially set up. If the device metadata is updated to point to a different app, the old app should advertise the new one to the user, so that users can acquire it from the Windows Store manually. Eventually, the old app should be removed from the Windows Store. Users can also get to the new app by going to the Devices page on the Settings app and clicking the Get app link for that device.
Special note for adding privileged access: If newer metadata grants a Windows Store device app privileged access to a device (when access did not exist before), submit your metadata at least 20 days before you submit your app. The new metadata will be available to new users 8-15 days after it is submitted. Then, publish the app update to the Windows Store. When the user gets the app update, assuming that the user updated any required driver, the app will have privileged access to the device.
Windows Store device app updates are manually triggered by users, just like any other Windows Store app updates. The Windows Store shows all available app updates to the user. The user manually chooses to update the app. You should design apps to be compatible with older metadata and drivers. The device metadata or driver might not be up-to-date with the app, since manual installation of a Windows Store device app from the Windows Store doesn’t automatically trigger distribution of metadata or drivers.
The device driver and device metadata are uninstalled independently of the Windows Store device app. When a user uninstalls a device, only the driver and metadata are automatically uninstalled as part of the device uninstall.
The Windows Store device app must be manually uninstalled by the user. When that's done, the device driver and device metadata are not automatically uninstalled.