Come dichiarare le attività in background nel manifesto dell'applicazione (HTML)

Articolo
12/11/2015

[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]

Puoi abilitare l'uso delle attività in background dichiarandole come estensioni nel manifesto dell'app. Ogni attività in background deve essere dichiarata come un'estensione nel manifesto dell'applicazione. Senza questa dichiarazione, la tua app non sarà in grado di registrare le attività in background e verrà generata un'eccezione. Inoltre, le attività in background devono essere dichiarate nel manifesto dell'applicazione per superare la certificazione.

Cosa sapere

Tecnologie

Microsoft Visual Studio Manifest Designer

Prerequisiti

Questo argomento presuppone che tu abbia già creato uno o più processi di lavoro di attività in background e che la tua app registri ogni processo di lavoro di attività in background in modo che vengano eseguiti in risposta a uno o più trigger.

Istruzioni

Passaggio 1: Aggiungi le estensioni manualmente

Apri il manifesto dell'applicazione e passa all'elemento Application. Crea un elemento Extensions (se non ne esiste già uno).

Il frammento seguente è estratto da BackgroundTaskSample:


<Application Id="App" StartPage="default.html">
  <VisualElements DisplayName="BackgroundTask JS sample" Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" Description="BackgroundTask JS sample" ForegroundText="light" BackgroundColor="#00b2f0" ToastCapable="false">
    <LockScreen Notification="badgeAndTileText" BadgeLogo="images\badgelogo-sdk.png" />
    <DefaultTile ShortName="BGTask JS" ShowName="allLogos" WideLogo="images\tile-sdk.png" />
    <SplashScreen BackgroundColor="#00b2f0" Image="images\splash-sdk.png" />
  </VisualElements>

  <Extensions>

    <!-- In the next step, we'll add elements here. -->

  </Extensions>

</Application>

Passaggio 2: Aggiungi l'estensione per le attività in background

Dichiara la prima attività in background.

Copia questo codice nell'elemento Extensions (aggiungerai gli attributi nei passaggi successivi).


<Application Id="App" StartPage="default.html">
  <VisualElements DisplayName="BackgroundTask JS sample" Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" Description="BackgroundTask JS sample" ForegroundText="light" BackgroundColor="#00b2f0" ToastCapable="false">
    <LockScreen Notification="badgeAndTileText" BadgeLogo="images\badgelogo-sdk.png" />
    <DefaultTile ShortName="BGTask JS" ShowName="allLogos" WideLogo="images\tile-sdk.png" />
    <SplashScreen BackgroundColor="#00b2f0" Image="images\splash-sdk.png" />
  </VisualElements>

  <Extensions>
    <Extension Category="windows.backgroundTasks" StartPage="">
      <BackgroundTasks>
        <Task Type="" />
      </BackgroundTasks>
    </Extension>
  </Extensions>

</Application>

Modifica l'attributo EntryPoint in modo che la stringa sia uguale a quella usata per registrare la tua attività in background (path.filename).

In questo esempio, il punto di ingresso è Tasks.SampleBackgroundTask:
```
<Extension Category="windows.backgroundTasks" StartPage="js\backgroundtask.js">
```
Modifica l'attributo del tipo di attività in modo da indicare il tipo di registrazione attività usato con questa attività in background. Se l'attività in background è stata registrata con più tipi di trigger, aggiungi altri elementi Task e attributi Type per ognuno.

Nota Non dimenticare di elencare ogni tipo di trigger che stai usando, altrimenti l'attività in background non verrà registrata con i tipi di trigger non dichiarati (il metodo Register non riuscirà e genererà un'eccezione).

Questo esempio di frammento indica l'uso di SystemEventTrigger:
```
<Task Type="systemEvent" />
```
Nota In JavaScript non è necessario (né appropriato) usare l'elemento Executable. Tutti i processi di lavoro in background JavaScript vengono eseguiti nell'host predefinito fornito dal sistema.

Passaggio 3: Aggiungere altre estensioni per le attività in background

Ripeti il passaggio 2 per ogni ulteriore classe di attività in background registrata dalla tua app.

L'esempio seguente è l'elemento Application completo tratto dall'esempio di attività in background. Questo esempio mostra l'uso di 3 attività in background. Copia la sezione Extensions di questo esempio e modificala secondo le esigenze, per dichiarare le attività in background nel manifesto della tua applicazione.

<Application Id="App" StartPage="default.html">
  <VisualElements DisplayName="BackgroundTask JS sample" Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" Description="BackgroundTask JS sample" ForegroundText="light" BackgroundColor="#00b2f0" ToastCapable="false">
    <LockScreen Notification="badgeAndTileText" BadgeLogo="images\badgelogo-sdk.png" />
    <DefaultTile ShortName="BGTask JS" ShowName="allLogos" WideLogo="images\tile-sdk.png" />
    <SplashScreen BackgroundColor="#00b2f0" Image="images\splash-sdk.png" />
  </VisualElements>
  <Extensions>
    <Extension Category="windows.backgroundTasks" StartPage="js\backgroundtask.js">
      <BackgroundTasks>
        <Task Type="systemEvent" />
      </BackgroundTasks>
    </Extension>
    <Extension Category="windows.backgroundTasks" EntryPoint="Tasks.SampleBackgroundTask">
      <BackgroundTasks>
        <Task Type="systemEvent" />
        <Task Type="timer" />
      </BackgroundTasks>
    </Extension>
    <Extension Category="windows.backgroundTasks" EntryPoint="Tasks.ServicingComplete">
      <BackgroundTasks>
        <Task Type="systemEvent" />
      </BackgroundTasks>
    </Extension>
  </Extensions>
</Application>