FirstRunTask (Standard 8 Module Reference)
7/8/2014
Review the applicable Embedded Core modules and any examples for the FirstRunTask setting in Windows Embedded 8 Standard (Standard 8).
This setting specifies the background task that is active, or live, by default for a tile when a user signs in to Windows Embedded 8 Standard (Standard 8) for the first time. The background task must register the user with Windows Notification Service and start sending notifications to the app’s live tile.
To make a tile live, you must do one of the following:
- If your background task is in JavaScript, specify the .js file that implements the IBackgroundTask interface.
- If your background task is in XAML or C++, specify the class.
Regional Override
RegionalOverrides specify apps that appear on the Start and Lock screens for different regions. You can use a regional override for multiple regions. For example, you could add apps that are designed for South American business travel that only appear for your users in South America. You can override apps for WideTiles, SquareTiles, and LockScreen.
The user can select a region during OOBE, or you can specify a region by using UserLocale settings in International-Core. If a region is selected, the following occurs:
- If the selected region matches a region in RegionalOverrides, then the system displays the apps from that override.
- If the selected region does not match any of these regions, then Standard 8 displays the apps from StartTiles for WideTiles, SquareTiles, and LockScreen.
Modules
The following table shows the modules that you can apply this setting to. In Image Configuration Editor (ICE), you can follow the corresponding path to set this setting for a module.
Module |
Path |
|---|---|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareOrDesktopTile1/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareOrDesktopTile2/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareOrDesktopTile3/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareOrDesktopTile4/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareOrDesktopTile5/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareOrDesktopTile6/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile1/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile10/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile11/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile12/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile2/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile3/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile4/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile5/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile6/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile7/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile8/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/SquareTiles/SquareTile9/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/WideTiles/WideTile1/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/WideTiles/WideTile2/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/WideTiles/WideTile3/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/WideTiles/WideTile4/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/WideTiles/WideTile5/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/RegionalOverrides/RegionalOverride/WideTiles/WideTile6/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareOrDesktopTile1/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareOrDesktopTile2/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareOrDesktopTile3/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareOrDesktopTile4/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareOrDesktopTile5/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareOrDesktopTile6/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile1/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile10/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile11/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile12/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile2/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile3/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile4/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile5/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile6/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile7/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile8/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/SquareTiles/SquareTile9/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/WideTiles/WideTile1/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/WideTiles/WideTile2/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/WideTiles/WideTile3/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/WideTiles/WideTile4/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/WideTiles/WideTile5/FirstRunTask |
|
Products/Embedded Core/Shell-Setup/StartTiles/WideTiles/WideTile6/FirstRunTask |
XML Example
These XML examples show how to configure FirstRunTask on various Tile types.
Square or SquareOrDesktop Tiles
The following example shows how to specify the background task to run for Square or SquareOrDesktop Tiles.
<SquareTiles>
<SquareOrDesktopTile1>
<AppIdOrPath>C:\programdata\microsoft\windows\start menu\programs\desktoptile1.lnk</AppIdOrPath>
<FirstRunTask>backgroundtask.js</FirstRunTask>
</SquareOrDesktopTile1>
<SquareOrDesktopTile2>
<AppIdOrPath>67890ChannelFabrikam.channel-JKL_mnop1234789!App</AppIdOrPath>
<FirstRunTask>Fabrikam.FirstRunTask</FirstRunTask>
</SquareOrDesktopTile2>
<SquareOrDesktopTile3>
<AppIdOrPath>C:\programdata\microsoft\windows\start menu\programs\desktoptile3.lnk</AppIdOrPath>
</SquareOrDesktopTile3>
<SquareTile1>
<AppId>12345ChannelFabrikam.channel-ABC_defghij6789!App</AppId>
<FirstRunTask>backgroundtask.js</FirstRunTask>
</SquareTile1>
<SquareTile2>
<AppId>34567ChannelFabrikam.channel-DEF_012ghijk345!App</AppId>
<FirstRunTask>Fabrikam.FirstRunTask</FirstRunTask>
</SquareTile2>
<SquareTile3>
<AppId>56789ChannelFabrikam.channel-GHI_67890jklmno!App</AppId>
</SquareTile3>
</SquareTiles>
WideTiles
The following XML example shows how to specify the background task to run for WideTiles. In this example, the background task for WideTile1 is in JavaScript, and the background task for WideTile2 is XAML or C++.
<WideTiles>
<WideTile1>
<AppId>12345ChannelFabrikam.channel-ABC_defghij6789!App</AppId>
<FirstRunTask>backgroundtask.js</FirstRunTask>
</WideTile1>
<WideTile2>
<AppId>34567ChannelFabrikam.channel-DEF_012ghijk345!App</AppId>
<FirstRunTask>Fabrikam.FirstRunTask</FirstRunTask>
</WideTile2>
</WideTiles>