如何为.NET MAUI应用创建对应不同标志参数的MSIX安装包？

关于你尝试的安装参数方案 #

安装时传递参数的思路不可行。MSIX基于容器化安装机制，安装阶段的参数不会被应用启动时捕获，用户双击图标启动应用时，主进程也不会自动携带安装时的参数，因此该方案无法实现需求。

以下是几种可行的实现方式：

方案1：条件编译+MSBuild属性生成独立变体包 #

通过编译时嵌入不同标志值，直接生成对应功能的独立MSIX包，安装后双击图标即触发对应逻辑。

• 步骤1：配置项目属性变体
  在MAUI项目的.csproj文件中添加对应不同标志的属性组，编译时自动切换常量、应用名称和包名：

<PropertyGroup Condition="'$(Variant)' == 'FeatureA'">
  <DefineConstants>$(DefineConstants);FEATURE_A</DefineConstants>
  <ApplicationTitle>我的应用 - 功能A</ApplicationTitle>
  <PackageDisplayName>我的应用-功能A</PackageDisplayName>
  <MsixPackageName>com.mycompany.myapp.featurea</MsixPackageName>
</PropertyGroup>

<PropertyGroup Condition="'$(Variant)' == 'FeatureB'">
  <DefineConstants>$(DefineConstants);FEATURE_B</DefineConstants>
  <ApplicationTitle>我的应用 - 功能B</ApplicationTitle>
  <PackageDisplayName>我的应用-功能B</PackageDisplayName>
  <MsixPackageName>com.mycompany.myapp.featureb</MsixPackageName>
</PropertyGroup>

• 步骤2：代码中根据常量触发对应逻辑
  在应用启动逻辑中，通过编译常量判断要执行的代码片段：

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
#if FEATURE_A
    RunFeatureASnippet();
#elif FEATURE_B
    RunFeatureBSnippet();
#endif
    // 其他通用启动逻辑
}

private void RunFeatureASnippet()
{
    // 功能A对应的代码片段
}

private void RunFeatureBSnippet()
{
    // 功能B对应的代码片段
}

• 步骤3：脚本自动化打包
  用PowerShell或批处理一键生成所有变体包：

dotnet publish -f net8.0-windows10.0.19041.0 -c Release /p:Variant=FeatureA
dotnet publish -f net8.0-windows10.0.19041.0 -c Release /p:Variant=FeatureB

每个命令会生成独立的MSIX包，安装后图标显示对应名称，双击直接启动指定功能。

方案2：单MSIX包多快捷方式传参 #

如果不想生成多个包，可在单个MSIX中添加多个快捷方式，每个快捷方式启动时传递不同参数，触发对应逻辑。

• 步骤1：配置多快捷方式扩展
  在Package.appxmanifest中添加多个快捷方式扩展（需先在根节点添加xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"命名空间）：

<Applications>
  <Application Id="App" Executable="$targetnametoken$.exe" EntryPoint="$targetentrypoint$">
    <Extensions>
      <!-- 功能A快捷方式 -->
      <desktop:Extension Category="windows.shortcut">
        <desktop:Shortcut>
          <desktop:Id>FeatureA</desktop:Id>
          <desktop:DisplayName>我的应用 - 功能A</desktop:DisplayName>
          <desktop:Icon>Assets\FeatureAIco.ico</desktop:Icon>
          <desktop:TargetExecutable>$targetnametoken$.exe</desktop:TargetExecutable>
          <desktop:Arguments>/feature:a</desktop:Arguments>
        </desktop:Shortcut>
      </desktop:Extension>
      <!-- 功能B快捷方式 -->
      <desktop:Extension Category="windows.shortcut">
        <desktop:Shortcut>
          <desktop:Id>FeatureB</desktop:Id>
          <desktop:DisplayName>我的应用 - 功能B</desktop:DisplayName>
          <desktop:Icon>Assets\FeatureBIco.ico</desktop:Icon>
          <desktop:TargetExecutable>$targetnametoken$.exe</desktop:TargetExecutable>
          <desktop:Arguments>/feature:b</desktop:Arguments>
        </desktop:Shortcut>
      </desktop:Extension>
    </Extensions>
  </Application>
</Applications>

• 步骤2：代码中读取启动参数
  在启动逻辑中解析参数并执行对应代码：

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    var launchArgs = args.Arguments;
    if (launchArgs.Contains("/feature:a"))
    {
        RunFeatureASnippet();
    }
    else if (launchArgs.Contains("/feature:b"))
    {
        RunFeatureBSnippet();
    }
    // 通用逻辑
}

安装后开始菜单会显示多个快捷方式，每个对应不同功能入口。

方案3：MSIX变体包+配置文件隔离 #

适合需要不同资源、配置的场景，通过变体文件夹隔离不同配置，编译时自动替换。

• 步骤1：创建变体资源文件夹
  在项目中创建Variants/FeatureA和Variants/FeatureB文件夹，分别存放对应变体的appsettings.json、图标等资源。

• 步骤2：配置条件性文件包含
  在.csproj中添加条件，编译时自动引入对应变体的资源：

<ItemGroup Condition="'$(Variant)' == 'FeatureA'">
  <Content Include="Variants\FeatureA\appsettings.json" Link="appsettings.json" />
  <Content Include="Variants\FeatureA\AppIcon.ico" Link="Assets\AppIcon.ico" />
</ItemGroup>

<ItemGroup Condition="'$(Variant)' == 'FeatureB'">
  <Content Include="Variants\FeatureB\appsettings.json" Link="appsettings.json" />
  <Content Include="Variants\FeatureB\AppIcon.ico" Link="Assets\AppIcon.ico" />
</ItemGroup>

• 步骤3：代码读取配置标志
  通过配置文件中的标志值触发对应逻辑：

var config = new ConfigurationBuilder()
    .AddJsonFile("appsettings.json")
    .Build();
var featureFlag = config["FeatureFlag"];

switch(featureFlag)
{
    case "A": RunFeatureASnippet(); break;
    case "B": RunFeatureBSnippet(); break;
}

同样通过dotnet publish带Variant参数打包不同版本。

内容的提问来源于stack exchange，提问作者evidalpe