Add support for UnsupportedArguments

schemas/JSON/manifests/v1.2.0/manifest.installer.1.2.0.json

@@ -571,6 +571,9 @@
         "UnsupportedOSArchitectures": {
           "$ref": "#/definitions/UnsupportedOSArchitectures"
         },
+        "UnsupportedArguments": {
+          "$ref": "#/definitions/UnsupportedArguments"
+        },
         "AppsAndFeaturesEntries": {
           "$ref": "#/definitions/AppsAndFeaturesEntries"
         },
@@ -668,6 +671,9 @@
     "UnsupportedOSArchitectures": {
       "$ref": "#/definitions/UnsupportedOSArchitectures"
     },
+    "UnsupportedArguments": {
+      "$ref": "#/definitions/UnsupportedArguments"
+    },
     "AppsAndFeaturesEntries": {
       "$ref": "#/definitions/AppsAndFeaturesEntries"
     },

schemas/JSON/manifests/v1.2.0/manifest.singleton.1.2.0.json

@@ -609,6 +609,9 @@
         "UnsupportedOSArchitectures": {
           "$ref": "#/definitions/UnsupportedOSArchitectures"
         },
+        "UnsupportedArguments": {
+          "$ref": " #/definitions/UnsupportedArguments"
+        },
         "AppsAndFeaturesEntries": {
           "$ref": "#/definitions/AppsAndFeaturesEntries"
         },
@@ -822,6 +825,9 @@
     "UnsupportedOSArchitectures": {
       "$ref": "#/definitions/UnsupportedOSArchitectures"
     },
+    "UnsupportedArguments": {
+      "$ref": "#/definitions/UnsupportedArguments"
+    },
     "AppsAndFeaturesEntries": {
       "$ref": "#/definitions/AppsAndFeaturesEntries"
     },

src/AppInstallerCLICore/Commands/InstallCommand.cpp

@@ -148,6 +148,7 @@ namespace AppInstaller::CLI
             Workflow::GetManifest <<
             Workflow::SelectInstaller <<
             Workflow::EnsureApplicableInstaller <<
+            Workflow::CheckForUnsupportedArgs <<
             Workflow::InstallSinglePackage;
     }
 }

src/AppInstallerCLICore/Resources.h

@@ -360,6 +360,7 @@ namespace AppInstaller::CLI::Resource
         WINGET_DEFINE_RESOURCE_STRINGID(UninstallFlowStartingPackageUninstall);
         WINGET_DEFINE_RESOURCE_STRINGID(UninstallFlowUninstallSuccess);
         WINGET_DEFINE_RESOURCE_STRINGID(UnrecognizedCommand);
+        WINGET_DEFINE_RESOURCE_STRINGID(UnsupportedArgument);
         WINGET_DEFINE_RESOURCE_STRINGID(UpdateAllArgumentDescription);
         WINGET_DEFINE_RESOURCE_STRINGID(UpdateNotApplicable);
         WINGET_DEFINE_RESOURCE_STRINGID(UpgradeCommandLongDescription);

src/AppInstallerCLICore/Workflows/InstallFlow.cpp

@@ -57,6 +57,19 @@ namespace AppInstaller::CLI::Workflow
             }
         }
 
+        Execution::Args::Type GetUnsupportedArgumentType(UnsupportedArgumentEnum unsupportedArg)
+        {
+            switch (unsupportedArg)
+            {
+            case UnsupportedArgumentEnum::Log:
+                return Execution::Args::Type::Log;
+            case UnsupportedArgumentEnum::Location:
+                return Execution::Args::Type::InstallLocation;
+            default:
+                THROW_HR(E_UNEXPECTED);
+            }
+        }
+
         struct ExpectedReturnCode
         {
             ExpectedReturnCode(ExpectedReturnCodeEnum installerReturnCode, HRESULT hr, Resource::StringId message) :
@@ -128,6 +141,22 @@ namespace AppInstaller::CLI::Workflow
         }
     }
 
+    void CheckForUnsupportedArgs(Execution::Context& context)
+    {
+        const auto& unsupportedArgs = context.Get<Execution::Data::Installer>().value().UnsupportedArguments;
+
+        if (!unsupportedArgs.empty())
+        {
+            for (auto unsupportedArg : unsupportedArgs)
+            {
+                if (context.Args.Contains(GetUnsupportedArgumentType(unsupportedArg)))
+                {
+                    context.Reporter.Error() << Resource::String::UnsupportedArgument << " --" << UnsupportedArgumentToString(unsupportedArg) << std::endl;
+                }
+            }
+        }
+    }
+
     void ShowInstallationDisclaimer(Execution::Context& context)
     {
         auto installerType = context.Get<Execution::Data::Installer>().value().InstallerType;

src/AppInstallerCLICore/Workflows/InstallFlow.h

@@ -28,6 +28,12 @@ namespace AppInstaller::CLI::Workflow
     // Inputs: InstallationNotes
     // Outputs: None
     void DisplayInstallationNotes(Execution::Context& context);
+
+    // Checks if there are any included arguments that are not supported for the package.
+    // Required Args: None
+    // Inputs: Installer, UnsupportedArguments
+    // Outputs: None
+    void CheckForUnsupportedArgs(Execution::Context& context);
 
     // Shows the license agreements if the application has them.
     // Required Args: None

src/AppInstallerCLIPackage/Shared/Strings/en-us/winget.resw

@@ -1349,4 +1349,7 @@ Please specify one of them using the `--source` option to proceed.</value>
   <data name="ShowLabelInstallationNotes" xml:space="preserve">
     <value>InstallationNotes:</value>
   </data>
+  <data name="UnsupportedArgument" xml:space="preserve">
+    <value>This argument is not supported for this package:</value>
+  </data>
 </root>

src/AppInstallerCLITests/AppInstallerCLITests.vcxproj

@@ -276,6 +276,9 @@
     <CopyFileToFolders Include="TestData\InstallFlowTest_Portable_WithCommand.yaml">
       <DeploymentContent>true</DeploymentContent>
     </CopyFileToFolders>
+    <CopyFileToFolders Include="TestData\InstallFlowTest_UnsupportedArguments.yaml">
+      <DeploymentContent>true</DeploymentContent>
+    </CopyFileToFolders>
     <CopyFileToFolders Include="TestData\ImportFile-Bad-Invalid.json">
       <DeploymentContent>true</DeploymentContent>
     </CopyFileToFolders>

src/AppInstallerCLITests/AppInstallerCLITests.vcxproj.filters

@@ -453,6 +453,9 @@
     <CopyFileToFolders Include="TestData\InstallFlowTest_Portable_WithCommand.yaml">
       <Filter>TestData</Filter>
     </CopyFileToFolders>
+    <CopyFileToFolders Include="TestData\InstallFlowTest_UnsupportedArguments.yaml">
+      <Filter>TestData</Filter>
+    </CopyFileToFolders>   
     <CopyFileToFolders Include="TestData\InstallerArgTest_Msi_WithSwitches.yaml">
       <Filter>TestData</Filter>
     </CopyFileToFolders>

src/AppInstallerCLITests/TestData/InstallFlowTest_UnsupportedArguments.yaml

@@ -0,0 +1,18 @@
+PackageIdentifier: AppInstallerCliTest.TestInstaller
+PackageVersion: 1.0.0.0
+PackageLocale: en-US
+PackageName: AppInstaller Test Installer
+ShortDescription: AppInstaller Test Installer
+Publisher: Microsoft Corporation
+Moniker: AICLITestExe
+License: Test
+UnsupportedArguments:
+    - log
+    - location
+Installers:
+    - Architecture: x86
+      InstallerUrl: https://ThisIsNotUsed
+      InstallerType: exe
+      InstallerSha256: 65DB2F2AC2686C7F2FD69D4A4C6683B888DC55BFA20A0E32CA9F838B51689A3B
+ManifestType: singleton
+ManifestVersion: 1.2.0

src/AppInstallerCLITests/TestData/ManifestV1_2-Singleton.yaml

@@ -103,7 +103,6 @@ ExpectedReturnCodes:
     ReturnResponseUrl: https://DefaultReturnResponseUrl.com
 UnsupportedArguments:
   - log
-  - location
 
 Installers:
   - Architecture: x86
@@ -159,7 +158,6 @@ Installers:
     DisplayInstallWarnings: false
     ElevationRequirement: elevationRequired
     UnsupportedArguments:
-      - log
       - location
     UnsupportedOSArchitectures:
       - arm64

src/AppInstallerCLITests/TestData/MultiFileManifestV1_2/ManifestV1_2-MultiFile-Installer.yaml

@@ -74,7 +74,6 @@ ExpectedReturnCodes:
     ReturnResponseUrl: https://DefaultReturnResponseUrl.com
 UnsupportedArguments:
   - log
-  - location
 
 Installers:
   - Architecture: x86
@@ -156,5 +155,7 @@ Installers:
      - InstallerReturnCode: 11
        ReturnResponse: custom
        ReturnResponseUrl: https://defaultReturnResponseUrl.com
+    UnsupportedArguments:
+      - location    
 ManifestType: installer
 ManifestVersion: 1.2.0

src/AppInstallerCLITests/WorkFlow.cpp

@@ -815,6 +815,29 @@ TEST_CASE("InstallFlow_InstallationNotes", "[InstallFlow][workflow]")
     REQUIRE(installOutput.str().find("testInstallationNotes") != std::string::npos);
 }
 
+TEST_CASE("InstallFlow_UnsupportedArguments", "[InstallFlow][workflow]")
+{
+    TestCommon::TempFile installResultPath("TestExeInstalled.txt");
+
+    std::ostringstream installOutput;
+    TestContext context{ installOutput, std::cin };
+    auto previousThreadGlobals = context.SetForCurrentThread();
+    OverrideForShellExecute(context);
+    context.Args.AddArg(Execution::Args::Type::Manifest, TestDataFile("InstallFlowTest_UnsupportedArguments.yaml").GetPath().u8string());
+    context.Args.AddArg(Execution::Args::Type::Log);
+    context.Args.AddArg(Execution::Args::Type::InstallLocation);
+
+    InstallCommand install({});
+    install.Execute(context);
+    INFO(installOutput.str());
+
+    // Verify Unsupported arguments error message is shown
+    REQUIRE(context.GetTerminationHR() == S_OK);
+    REQUIRE(std::filesystem::exists(installResultPath.GetPath()));
+    REQUIRE(installOutput.str().find(Resource::LocString(Resource::String::UnsupportedArgument).get() + " --log") != std::string::npos);
+    REQUIRE(installOutput.str().find(Resource::LocString(Resource::String::UnsupportedArgument).get() + " --location") != std::string::npos);
+}
+
 TEST_CASE("InstallFlow_ExpectedReturnCodes", "[InstallFlow][workflow]")
 {
     TestCommon::TempFile installResultPath("TestExeInstalled.txt");

src/AppInstallerCLITests/YamlManifest.cpp

@@ -466,9 +466,8 @@ void VerifyV1ManifestContent(const Manifest& manifest, bool isSingleton, Manifes
     if (manifestVer >= ManifestVer{ s_ManifestVersionV1_2 })
     {
         REQUIRE(manifest.DefaultInstallerInfo.DisplayInstallWarnings);
-        REQUIRE(manifest.DefaultInstallerInfo.UnsupportedArguments.size() == 2);
+        REQUIRE(manifest.DefaultInstallerInfo.UnsupportedArguments.size() == 1);
         REQUIRE(manifest.DefaultInstallerInfo.UnsupportedArguments.at(0) == UnsupportedArgumentEnum::Log);
-        REQUIRE(manifest.DefaultInstallerInfo.UnsupportedArguments.at(1) == UnsupportedArgumentEnum::Location);
     }
 
     if (isSingleton)
@@ -545,6 +544,8 @@ void VerifyV1ManifestContent(const Manifest& manifest, bool isSingleton, Manifes
         REQUIRE_FALSE(installer1.DisplayInstallWarnings);
         REQUIRE(installer1.ExpectedReturnCodes.at(3).ReturnResponseEnum == ExpectedReturnCodeEnum::Custom);
         REQUIRE(installer1.ExpectedReturnCodes.at(3).ReturnResponseUrl == "https://defaultReturnResponseUrl.com");
+        REQUIRE(installer1.UnsupportedArguments.size() == 1);
+        REQUIRE(installer1.UnsupportedArguments.at(1) == UnsupportedArgumentEnum::Location);
     }
 
     if (!isSingleton)
@@ -590,6 +591,8 @@ void VerifyV1ManifestContent(const Manifest& manifest, bool isSingleton, Manifes
             REQUIRE(installer3.ExpectedReturnCodes.at(11).ReturnResponseEnum == ExpectedReturnCodeEnum::Custom);
             REQUIRE(installer3.ExpectedReturnCodes.at(11).ReturnResponseUrl == "https://defaultReturnResponseUrl.com");
             REQUIRE_FALSE(installer3.DisplayInstallWarnings);
+            REQUIRE(installer3.UnsupportedArguments.size() == 1);
+            REQUIRE(installer3.UnsupportedArguments.at(0) == UnsupportedArgumentEnum::Location);
         }
 
         // Localization

src/AppInstallerCommonCore/Manifest/ManifestCommon.cpp

@@ -417,6 +417,19 @@ namespace AppInstaller::Manifest
         return "Unknown"sv;
     }
 
+    std::string_view UnsupportedArgumentToString(UnsupportedArgumentEnum unsupportedArg)
+    {
+        switch (unsupportedArg)
+        {
+        case UnsupportedArgumentEnum::Log:
+            return "log"sv;
+        case UnsupportedArgumentEnum::Location:
+            return "location"sv;
+        }
+
+        return "Unknown"sv;
+    }
+
     bool DoesInstallerTypeUsePackageFamilyName(InstallerTypeEnum installerType)
     {
         return (installerType == InstallerTypeEnum::Msix || installerType == InstallerTypeEnum::MSStore);

src/AppInstallerCommonCore/Public/AppInstallerErrors.h

@@ -99,7 +99,7 @@
 #define APPINSTALLER_CLI_ERROR_PORTABLE_PACKAGE_ALREADY_EXISTS  ((HRESULT)0x8A150054)
 #define APPINSTALLER_CLI_ERROR_PORTABLE_SYMLINK_PATH_IS_DIRECTORY ((HRESULT)0x8A150055)
 #define APPINSTALLER_CLI_ERROR_INSTALLER_PROHIBITS_ELEVATION    ((HRESULT)0x8A150056)
-#define APPINSTALLER_CLI_ERROR_PORTABLE_UNINSTALL_FAILED          ((HRESULT)0x8A150057)
+#define APPINSTALLER_CLI_ERROR_PORTABLE_UNINSTALL_FAILED        ((HRESULT)0x8A150057)
 
 // Install errors.
 #define APPINSTALLER_CLI_ERROR_INSTALL_PACKAGE_IN_USE           ((HRESULT)0x8A150101)

src/AppInstallerCommonCore/Public/winget/ManifestCommon.h

@@ -265,6 +265,8 @@ bool HasExtension(std::string_view extension) const;
 
     std::string_view ScopeToString(ScopeEnum scope);
 
+    std::string_view UnsupportedArgumentToString(UnsupportedArgumentEnum unsupportedArg);
+
     // Gets a value indicating whether the given installer type uses the PackageFamilyName system reference.
     bool DoesInstallerTypeUsePackageFamilyName(InstallerTypeEnum installerType);