RuntimeCompatibilityOptions Classe

Définition

public ref class RuntimeCompatibilityOptions sealed

/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.ApplicationModel.WindowsAppRuntime.RuntimeCompatibilityContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.ApplicationModel.WindowsAppRuntime.RuntimeCompatibilityContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RuntimeCompatibilityOptions final

[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.ApplicationModel.WindowsAppRuntime.RuntimeCompatibilityContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.ApplicationModel.WindowsAppRuntime.RuntimeCompatibilityContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class RuntimeCompatibilityOptions

function RuntimeCompatibilityOptions()

Public NotInheritable Class RuntimeCompatibilityOptions

Héritage

Object Platform::Object IInspectable RuntimeCompatibilityOptions

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Remarques

Il existe deux façons de déployer le SDK d'application Windows : dépendant de l’infrastructure ou autonome. Pour plus d’informations et des avantages et des problèmes, consultez SDK d'application Windows vue d’ensemble du déploiement.

La classe RuntimeCompatibilityOptions vous offre une compatibilité configurable par l’application. Il est destiné à empêcher les problèmes liés au déploiement dépendant du framework, ce qui permet à votre application d’utiliser cette option avec confiance qu’elle ne sera pas rompue.

En outre, si vous trouvez un problème de compatibilité dans une version de maintenance, vous pourrez toujours avancer en désactivant temporairement les modifications problématiques. Même une application autonome peut être mise à jour vers un nouveau package avec confiance que la compatibilité configurable par l’application garantit une mise à jour réussie.

RuntimeCompatibilityOptions a des API pour contrôler le comportement des modifications de maintenance. Il existe également des propriétés qui peuvent être définies dans le fichier projet de votre application pour utiliser automatiquement les nouvelles API avec les valeurs spécifiées.

RuntimeCompatibilityOptions configure les modifications apportées aux versions de maintenance SDK d'application Windows activées. Par défaut, toutes les modifications sont activées, mais vous pouvez utiliser RuntimeCompatibilityOptions pour verrouiller le comportement d’exécution à un niveau de correctif spécifié ou pour désactiver des modifications spécifiques :

1. Choisissez le niveau de correctif : Vous pouvez spécifier le comportement de la version de maintenance que vous souhaitez utiliser. Par exemple, votre application peut spécifier qu’elle souhaite le comportement de niveau de correctif 1.7.2, ce qui aura la SDK d'application Windows s’exécuter dans ce niveau de correctif, même si la version 1.7.3 ou ultérieure est installée. Cette fonctionnalité vous permet de contrôler quand votre application obtient de nouveaux correctifs ou modifications de comportement, même si vous n’utilisez pas le mode autonome.
2. Désactivez temporairement des modifications spécifiques : Si votre application rencontre un problème avec une modification spécifique dans une mise à jour de maintenance, vous pouvez désactiver cette modification tout en bénéficiant toujours des autres modifications ou fonctionnalités de cette mise à jour. Toutes les modifications sont activées par défaut pour le niveau de correctif utilisé. La désactivation d’une modification est une mesure temporaire, qui donne le temps à un correctif d’être publié dans une prochaine mise à jour SDK d'application Windows, ou pour vous permettre d’implémenter une mise à jour dans votre application.

Voici un exemple pour spécifier un niveau de correctif et désactiver une modification spécifique :

void ApplyRuntimeCompatibilityOptions() 
{
    var compatibilityOptions = new RuntimeCompatibilityOptions();
    compatibilityOptions.PatchLevel1 = new WindowsAppRuntimeVersion(1,7,3);
    compatibilityOptions.PatchLevel2 = new WindowsAppRuntimeVersion(1,8,2);
    compatibilityOptions.DisabledChanges.Add(RuntimeCompatibilityChange.SampleApiCrashFix);
    compatibilityOptions.Apply();
}

Vous devez appliquer RuntimeCompatibilityOptions au début du processus, avant que d’autres API SDK d'application Windows soient appelées ; ou juste après l’initialisation du runtime application Windows.

PatchLevel1 et PatchLevel2 sont simplement deux champs pour définir les niveaux de correctif appropriés. Celles-ci ne correspondent pas à une version spécifique du runtime application Windows, ni à un ordre spécifique. Par conséquent, il est valide pour définir PatchLevel1 sur 1.8.2 et PatchLevel2 sur 1.7.3, par exemple. Dans l’exemple ci-dessus, lors de la mise à jour de l’application vers la version 1.9, vous pouvez choisir de simplement mettre à jour PatchLevel1 vers 1.9.3 et de laisser PatchLevel2 comme 1.8.2.

Spécification de RuntimeCompatibilityOptions dans le fichier projet de votre application

Vous pouvez également utiliser le fichier projet de votre application pour spécifier le niveau de correctif et les modifications désactivées, au lieu d’utiliser directement RuntimeCompatibilityOptions. Cette approche présente l’avantage de s’assurer que les options sont appliquées tôt au bon moment. Voici un exemple de spécification du niveau de correctif et de désactivation des modifications dans votre fichier projet (par .csproj.vcxprojexemple) :

<PropertyGroup>
  <WindowsAppSDKRuntimePatchLevel1>1.7.3</WindowsAppSDKRuntimePatchLevel1>
  <WindowsAppSDKRuntimePatchLevel2>1.8.2</WindowsAppSDKRuntimePatchLevel2>
  <WindowsAppSDKDisabledChanges>SampleApiCrashFix, OtherSampleApiCrashFix</WindowsAppSDKDisabledChanges>
</PropertyGroup>

La propriété WindowsAppSDKDisabledChanges est une liste séparée par des virgules des valeurs RuntimeCompatibilityChange à désactiver.

Comportement sans PatchLevel spécifié

Si aucun PatchLevel1 ou PatchLevel2 n’est spécifié, ou si aucune valeur ne correspond à la version principale.minor du runtime utilisée, le runtime utilise le dernier niveau de correctif. En d'autres termes, le runtime s'exécute avec toutes les modifications de maintenance activées (tout comme le fonctionnement du SDK d'application Windows si vous n'utilisez pas cette API).