.NET7 WPF ClickOnce应用ActivationUri为何为空？

问题背景 #

• 环境：.NET7 WPF ClickOnce离线应用（应用2），从第三方应用（应用1）启动并传递参数
• 已配置：ClickOnce发布时开启「允许将URL参数传递给应用」
• 问题现象：
  1. 使用ApplicationDeployment.ActivationUri.Query读取参数时，ActivationUri始终为空
  2. 尝试通过.appref-ms快捷方式传递参数时，应用在进入OnStartup前崩溃（空WPF项目也存在该问题）
  3. 原AppDomain.CurrentDomain.SetupInformation.ActivationArguments.ActivationData方法在.NET7中已废弃，无法使用
  4. 需要支持离线环境（无法访问应用更新/安装的网络驱动器）

ActivationUri为空的原因 #

1. 场景不匹配：ApplicationDeployment.ActivationUri仅针对通过URL/ClickOnce协议启动的场景生效（比如网页链接点击启动）。离线通过.appref-ms快捷方式或直接启动本地部署程序时，不属于URI激活场景，该属性不会被填充。
2. .appref-ms的设计限制：.appref-ms快捷方式本身不支持直接附加命令行参数，强行传递会触发未处理异常，导致应用崩溃。

替代解决方案 #

方案1：基于ClickOnce协议的参数传递（离线兼容） #

利用ClickOnce的URI激活机制，即使离线环境下也能正常使用——因为.appref-ms本质是指向本地已安装应用的启动器，无需连接部署服务器。

方式A：修改.appref-ms文件内容

原.appref-ms文件内容示例：

http://your-deploy-url/YourApp.application#YourApp.application, Culture=neutral, PublicKeyToken=xxxx, processorArchitecture=msil

在末尾添加&参数名=参数值（用&分隔，模拟URI查询参数），修改后内容：

http://your-deploy-url/YourApp.application#YourApp.application, Culture=neutral, PublicKeyToken=xxxx, processorArchitecture=msil&args=arg+test

应用1启动代码：

// 读取原快捷方式内容并修改
var shortcutPath = $@"{Environment.GetFolderPath(Environment.SpecialFolder.Programs)}\Company\{myAppName}.appref-ms";
var shortcutContent = File.ReadAllText(shortcutPath);
var modifiedContent = shortcutContent + "&args=arg+test";
// 生成临时.appref-ms文件
var tempShortcut = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.appref-ms");
File.WriteAllText(tempShortcut, modifiedContent);

// 启动临时快捷方式
var p = new Process();
p.StartInfo = new ProcessStartInfo(tempShortcut) { UseShellExecute = true };
p.Start();

// 可选：延迟删除临时文件
Task.Delay(1000).ContinueWith(_ => File.Delete(tempShortcut));

应用2读取参数：保留你原有的ApplicationDeployment.ActivationUri.Query解析代码即可，此时ActivationUri会被正确填充。

方式B：构造ClickOnce协议URI直接启动

无需修改原快捷方式，直接构造appref://协议的URI启动应用，格式：

appref://{PublicKeyToken}/{AssemblyName}/{Version}/{Culture}/{ProcessorArchitecture}?参数名=参数值

应用1启动代码：

// 替换为你的应用标识信息
var activationUri = new Uri("appref://xxxx/YourApp/1.0.0.0/neutral/msil?args=arg+test");
Process.Start(new ProcessStartInfo(activationUri.ToString()) { UseShellExecute = true });

应用2同样用原有代码解析ActivationUri.Query即可。

方案2：通用离线参数传递（不依赖ClickOnce机制） #

如果不想依赖ClickOnce的URI激活逻辑，可使用临时文件或注册表传递参数。

方式A：临时文件传递

应用1启动前写入参数到临时文件：

var tempFilePath = Path.Combine(Path.GetTempPath(), $"App2Args_{Guid.NewGuid()}.txt");
File.WriteAllText(tempFilePath, "arg test");

// 启动应用2
var shortcutPath = $@"{Environment.GetFolderPath(Environment.SpecialFolder.Programs)}\Company\{myAppName}.appref-ms";
Process.Start(new ProcessStartInfo(shortcutPath) { UseShellExecute = true });

应用2启动后读取并删除临时文件：

// 遍历临时目录查找约定命名的文件
var tempDir = new DirectoryInfo(Path.GetTempPath());
var argFile = tempDir.GetFiles("App2Args_*.txt").FirstOrDefault();
if (argFile != null)
{
    var args = File.ReadAllText(argFile.FullName);
    File.Delete(argFile.FullName);
    // 处理参数逻辑
}

方式B：注册表传递

应用1启动前写入注册表：

using var regKey = Microsoft.Win32.Registry.CurrentUser.CreateSubKey(@"Software\YourCompany\YourApp");
regKey.SetValue("StartupArgs", "arg test");

// 启动应用2
var shortcutPath = $@"{Environment.GetFolderPath(Environment.SpecialFolder.Programs)}\Company\{myAppName}.appref-ms";
Process.Start(new ProcessStartInfo(shortcutPath) { UseShellExecute = true });

应用2启动后读取并清理注册表：

using var regKey = Microsoft.Win32.Registry.CurrentUser.OpenSubKey(@"Software\YourCompany\YourApp", writable: true);
if (regKey != null)
{
    var args = regKey.GetValue("StartupArgs") as string;
    regKey.DeleteValue("StartupArgs");
    // 处理参数逻辑
}

方案3：直接启动本地安装的EXE #

ClickOnce应用安装后会在用户目录生成本地EXE，路径类似：

C:\Users\{用户名}\AppData\Local\Apps\2.0\{随机字符串}\{随机字符串}\you..tion_{版本}\YourApp.exe

你可以通过解析.appref-ms内容或WMI查询定位到该EXE，直接启动并传递命令行参数，然后用Environment.GetCommandLineArgs()读取参数。缺点是需要处理动态变化的安装路径，实现复杂度较高。

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