Condividi tramite

Vedere Guida alla distribuzione di SDK per app di Windows per le app autonome.

  • Articolo

Per impostazione predefinita, un progetto di SDK per app di Windows dipende dal framework. Per passare alla distribuzione autonoma, seguire questa procedura (i termini dipendenti dal framework e autonomo sono descritti in panoramica della distribuzione di SDK per app di Windows).

  • In Visual Studio fare clic con il pulsante destro del mouse sul nodo del progetto dell'app e scegliere Modifica file di progetto per aprire il file di progetto dell'app per la modifica. Per un progetto C++, fare prima clic su Scarica progetto.
  • Nel file di progetto dell'app, all'interno del PropertyGroup principale, aggiungere <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained> come illustrato nello screenshot seguente.

Screenshot che mostra la proprietà WindowsAppSDKSelfContained impostata in un file di progetto.

  • Per i progetti in pacchetto, nel file di progetto dell'app, alla fine del file prima della chiusura </Project>, aggiungere quanto Target illustrato di seguito.
  <Target Name="_RemoveFrameworkReferences" BeforeTargets="_ConvertItems;_CalculateInputsForGenerateCurrentProjectAppxManifest">
    <ItemGroup>
      <FrameworkSdkReference Remove="@(FrameworkSdkReference)" Condition="$([System.String]::Copy('%(FrameworkSdkReference.SDKName)').StartsWith('Microsoft.WindowsAppRuntime.'))" />
    </ItemGroup>
  </Target>

Nota

Si tratta di una soluzione alternativa per un bug in SDK per app di Windows 1.1 e non sarà necessario con SDK per app di Windows 1.2. È necessario solo per i progetti in pacchetto.

  • Salva e chiudi il file di progetto.
  • Fare clic su Ricarica progetto.
  • Se si usa un progetto di creazione pacchetti di applicazioni Windows (anziché con MSIX a progetto singolo che si ottiene con App vuota, In pacchetto (WinUI 3 in Desktop), apportare anche tutte le modifiche precedenti nel file di progetto per il progetto di creazione del pacchetto.

Nota

I progetti di librerie non devono essere modificati. La distribuzione autonoma deve essere configurata solo nei progetti di app (e, ove applicabile, in un progetto di creazione pacchetti di applicazioni Windows).

Per le app di esempio, vedere esempi di distribuzione autonoma di SDK per app di Windows.

Dopo aver impostato la WindowsAppSDKSelfContained proprietà su true nel file di progetto, il contenuto del pacchetto di Framework SDK per app di Windows verrà estratto nell'output di compilazione e distribuito come parte dell'applicazione.

Nota

Le app .NET devono essere pubblicate come autonome per essere completamente autonome. Vedere questo esempio per informazioni su come configurare .NET autonoma con i profili di pubblicazione. dotnet publish non è ancora supportato con SDK per app di Windows 1.1.

Nota

Le app C++ devono usare anche CRT ibrido per essere completamente autonome. L'importazione di HybridCRT.props da Directory.Build.props è il modo consigliato per configurarla per tutti i progetti in una soluzione (vedere un esempio in Directory.Build.props). Un'app in pacchetto deve essere impostata <UseCrtSDKReferenceStaticWarning>false</UseCrtSDKReferenceStaticWarning> anche nel file di progetto. Per informazioni sull'uso di CRT ibrido, vedere l'app di esempio di distribuzione autonoma.

Se l'app è inclusa in un pacchetto (per altre informazioni, vedere Panoramica della distribuzione), le dipendenze SDK per app di Windows verranno incluse come contenuto all'interno del pacchetto MSIX. La distribuzione dell'app richiede comunque la registrazione del pacchetto MSIX come qualsiasi altra app in pacchetto.

Se l'app viene inserita in un pacchetto con percorso esterno o senza pacchetti, le dipendenze SDK per app di Windows vengono copiate accanto a .exe nell'output di compilazione. È possibile sottoporre a distribuzione (xcopy) i file risultanti o includerli in un programma di installazione personalizzato.

Dipendenze da pacchetti MSIX aggiuntivi

Un numero ridotto di API nella SDK per app di Windows si basa su pacchetti MSIX aggiuntivi che rappresentano funzionalità critiche del sistema operativo.

Ciò significa che se si vuole utilizzare queste API in un'app autonoma, si hanno le opzioni seguenti:

  1. È possibile rendere facoltativa la funzionalità e ottimizzarla solo se e quando possibile. Chiamando il metodo IsSupported dell'API (PushNotificationManager.IsSupported e AppNotificationManager.IsSupported) sarà possibile controllare in modo dinamico in fase di esecuzione se le API sono disponibili per l'app chiamante nel sistema su cui è in esecuzione.
    • Ciò consente l'uso sicuro, condizionale e facoltativo delle API senza compromettere la semplicità della distribuzione autonoma.
    • Solo se i servizi del sistema operativo vengono installati all'esterno della distribuzione dell'app, l'app ottimizzerà le funzionalità appropriate. Tuttavia, esistono alcuni casi in cui le API funzioneranno anche senza che il pacchetto Singleton sia presente, quindi chiamare IsSupported per controllare è spesso una buona idea.
  2. Distribuire i pacchetti MSIX necessari come parte dell'installazione dell'app.
    • Ciò consente di dipendere dall'API in tutti gli scenari. Tuttavia, la distribuzione di pacchetti MSIX delle dipendenze come parte della distribuzione dell'app può compromettere la semplicità della distribuzione autonoma.
  3. Non utilizzare l'API.
    • Prendere in considerazione API alternative che forniscono funzionalità simili senza requisiti di distribuzione aggiuntivi.

Vedere Rifiuto esplicito (o accettazione) del supporto automatico di UndockedRegFreeWinRT.

La proprietà del progetto WindowsAppSdkUndockedRegFreeWinRTInitialize è stata introdotta nella versione 1.2 dell'SDK per app di Windows (dal canale stabile). Se tale proprietà è impostata su vero, garantisce che l'implementazione della SDK per app di Windows di Windows Runtime senza registrazione non ancorato (UndockedRegFreeWinRT) venga abilitata automaticamente all'avvio dell'app. Tale supporto è necessario per le app indipendenti senza pacchetti.

L'impostazione predefinita di WindowsAppSdkUndockedRegFreeWinRTInitialize è vero se WindowsAppSDKSelfContained è vero e WindowsPackageType è Nessuno e (a partire dalla versione 1.2 del SDK per app di Windows) la proprietà di progetto OutputType è impostata su Exe o WinExe (ovvero il progetto produce un eseguibile). L'ultima condizione consiste nell'impedire l'aggiunta del supporto automatico UndockedRegFreeWinRT nelle DLL della libreria di classi e in altri file non eseguibili per impostazione predefinita. Se è necessario il supporto automatico UndockedRegFreeWinRT in un elemento non eseguibile, ad esempio una DLL di test caricata da un eseguibile del processo host che non inizializza UndockedRegFreeWinRT, è possibile abilitarla in modo esplicito nel progetto con <WindowsAppSdkUndockedRegFreeWinRTInitialize>true</WindowsAppSdkUndockedRegFreeWinRTInitialize>.