Distribuire un'app tramite la registrazione di file separati

Questa guida mostra come usare il layout di file separati per convalidare e condividere le app di Windows 10 senza la necessità di inserirle in un pacchetto. La registrazione di layout di file separati consente agli sviluppatori di convalidare rapidamente le proprie app senza la necessità di inserirle in un pacchetto e installarle.

Che cos'è un layout di file separati?

Un layout di file separati significa semplicemente che il contenuto dell'app viene inserito in una cartella anziché passare attraverso il processo di creazione del pacchetto. Il contenuto del pacchetto è disponibile "separatamente" in una cartella e non è incluso in un pacchetto.

Avviso

La registrazione di layout di file separati è destinata agli sviluppatori e ai progettisti per convalidare rapidamente le app durante lo sviluppo attivo. Questo approccio non deve essere usato per creare versioni interne o pacchetti in anteprima dell'app. Si consiglia di eseguire la convalida finale in un'app in pacchetto firmata con un certificato attendibile.

Vantaggi della registrazione di file separati

• Convalida rapida: poiché i file dell'app sono già decompressi, gli utenti possono registrare rapidamente il layout di file separati e avviare l'app. Proprio come una normale app, l'utente potrà usare l'app così com'è stata progettata.
• Distribuzione in rete semplificata: se i file separati si trovano in una condivisione di rete anziché in un'unità locale, gli sviluppatori possono inviare il percorso della condivisione di rete ad altri utenti che hanno accesso alla rete e possono registrare il layout di file separati ed eseguire l'app. Questo consente a più utenti di convalidare l'app contemporaneamente.
• Collaborazione: la registrazione di file separati consente a sviluppatori e progettisti di continuare a lavorare sugli asset visivi mentre l'app è registrata. Gli utenti vedranno queste modifiche all'avvio dell'app. È possibile modificare solo gli asset statici con questa modalità. Se occorre modificare il codice o il contenuto creato dinamicamente, è necessario ricompilare l'app.

Come registrare un layout di file separati

Windows offre più strumenti di sviluppo per registrare layout di file separati in dispositivi locali e remoti. Puoi scegliere tra WinAppDeployCmd (strumento Windows SDK), Portale di dispositivi di Windows, PowerShell e Visual Studio. Di seguito descriveremo come registrare file separati con questi strumenti. Ma prima di tutto, assicurati di avere la configurazione seguente:

• Sui dispositivi deve essere installato Windows 10 Creators Update (Build 14965) o versioni successive.
• Dovrai abilitare la modalità sviluppatore e l'individuazione dei dispositivi su tutti i dispositivi.

Importante

La registrazione di file separati è disponibile solo nei dispositivi che supportano il protocollo Network Share (SMB): Desktop e Xbox.

Eseguire la registrazione con WinAppDeployCmd

Se stai usando gli strumenti SDK corrispondenti a Windows 10 Creators Update (Build 14965) o versioni successive, puoi usare il comando WinAppDeployCmd in un prompt dei comandi.

WinAppDeployCmd.exe registerfiles -remotedeploydir <Network Path> -ip <IP Address> -pin <target machine PIN>

Network Path: il percorso dei file separati dell'app.

IP Address: l'indirizzo IP del computer di destinazione.

target machine PIN: l'eventuale PIN necessario per stabilire una connessione al dispositivo di destinazione. Ti verrà chiesto di riprovare con l'opzione -pin se è necessaria l'autenticazione. Per informazioni su come ottenere un PIN, vedi Individuazione dispositivo.

Portale di dispositivi di Windows

Portale di dispositivi di Windows è disponibile in tutti i dispositivi Windows 10 e viene usato dagli sviluppatori per verificare e convalidare il lavoro. È pensato per tutti i destinatari della community degli sviluppatori con gli endpoint UX e REST del browser. Per altre informazioni su Portale di dispositivi, vedi Panoramica di Portale di dispositivi di Windows.

Per registrare il layout di file separati in Portale di dispositivi, segui questa procedura.

1. Connettiti a Portale di dispositivi seguendo la procedura illustrata nella sezione Installazione di Panoramica di Portale di dispositivi di Windows.
2. Nella scheda Apps Manager (Gestione app) seleziona Register from Network Share (Registra dalla condivisione di rete).
3. Immetti il percorso della condivisione di rete per il layout di file separati.
4. Se il dispositivo host non ha accesso alla condivisione di rete, ti verrà chiesto di immettere le credenziali necessarie.
5. Al termine della registrazione, potrai avviare l'app.

Nella pagina Apps Manager (Gestione app) di Portale di dispositivi puoi anche registrare layout di file separati facoltativi per l'app principale selezionando la casella di controllo I want to specify optional packages (Voglio specificare pacchetti facoltativi) e quindi specificando i percorsi della condivisione di rete delle app facoltative.

PowerShell

Anche con Windows PowerShell puoi registrare layout di file separati, ma solo sul dispositivo locale. Se è necessario registrare un layout in un dispositivo remoto, dovrai usare uno degli altri metodi.

Per registrare il layout di file separati, avvia PowerShell e immetti quanto segue.

Add-AppxPackage -Register <path to manifest file>

Risoluzione dei problemi

Unità di rete mappate

Attualmente, le unità di rete mappate non sono supportate per le registrazioni di file separati. Fai riferimento all'unità mappata con il percorso completo della condivisione di rete.

Errore di registrazione

Il dispositivo in cui avviene la registrazione dovrà avere accesso al layout dei file. Se il layout dei file è ospitato in una condivisione di rete, assicurati che il dispositivo abbia accesso.

Le modifiche agli asset visivi non vengono caricate nell'app

L'app caricherà gli asset visivi al momento dell'avvio. Se sono state apportate modifiche agli asset visivi dopo l'avvio dell'app, dovrai riavviare l'app per visualizzare le modifiche più recenti.