WinAppMigrator

此页面由机器从英文翻译而来,可能存在错误。阅读英文页面,或报告翻译问题。

在新电脑上安装

安装程序只有一个窗口。它会检查自身,向你显示安装位置以及它将设置的所有内容,并且只在你单击安装时才进行安装。本页使用屏幕上的文字,从上到下逐一介绍这个窗口。

Fabrikam Data Sync 的安装程序,显示它未签名,以及安装位置、所需空间和除文件之外还会设置的内容

开始之前

打开安装程序

双击安装程序。Windows 会显示 UAC 提示。除非生成安装程序的人对它进行了签名,否则安装程序是未签名的,因此提示通常显示未知发布者。这是正常的。请参阅隐私和安全。

窗口“WinAppMigrator 安装程序”(“重新安装在另一台电脑上捕获的应用”)会立即打开,无论安装程序有多大。在检查其整个程序包的哈希时,它显示“正在检查安装程序…”。这需要读取整个程序包,因此大型安装程序需要一段时间。从这时起,安装程序会让它自己的文件保持打开状态,如果有数据文件,数据文件也一样,因此在窗口打开期间,两者都无法被更改或替换。

检查可能会在此停止,并显示一条红色消息。常见的有:

所有这些情况都在疑难解答中有说明。

检查通过后,窗口的标题会变为“安装”加上应用的名称。

安装程序的语言

安装程序使用其所运行的电脑的语言,而不是生成它的电脑的语言:如果 Windows 的显示语言是 WinAppMigrator 支持的 24 种语言之一,就使用该语言,否则使用英语。右上方的语言可以为本次运行更改语言。它列出的有关应用的内容,包括 WinAppMigrator 生成安装程序时写下的说明,也会使用该语言。使用 WinAppMigrator 0.6 或更早版本生成的安装程序会按原样以英语显示这些说明。从命令行静默安装时始终以英语回应,以便脚本读取。

应用及其安装位置

第一张卡片显示应用的名称,其下方是发布者和版本,例如“Fabrikam Inc. · 1.7.3”。然后是:

行 显示的内容
捕获自 应用来源电脑的名称。仅当安装程序是在打开用户数据选项的情况下生成时才会出现。
安装程序 此安装程序文件是否已签名:先显示“正在检查其签名…”,然后显示“未签名:发布者未知”,或者“签名者:”加上签名者的名称。如果签名经不起检查,则改为显示一条红色消息:“此安装程序的签名无效”,括号中是 Windows 给出的原因,然后是“签名后它可能已被更改。”
安装位置 应用将安装到的文件夹,旁边的浏览用于选择文件夹。初始值是应用在旧电脑上所在的文件夹。来自 32 位 Windows 的应用则初始为 Program Files (x86),64 位 Windows 将 32 位应用存放在这里。如果该文件夹在这里无法使用,其下方会有一条红色通知说明原因。
所需空间 安装在该驱动器上需要多少空间,以及可用空间有多少,例如“C: 上最多 824.0 MB(可用 356.0 GB)”。它既计算解压缩后的程序包,也计算应用的文件。

第一行中的发布者名称来自程序包,因此任何人都可以随意填写。安装程序行来自 Windows,才是值得信任的那一行。

安装位置无法使用时

如果安装位置中的文件夹无法使用,其下方会有一条红色通知说明原因。在你选择其他文件夹之前,安装和预览更改一直显示为灰色,旁边的一行文字显示“在安装位置可以使用之前,‘安装’和‘预览更改’不可用。”

最常见的原因是该文件夹中已经有文件。只有当文件夹中的文件是之前由 WinAppMigrator 安装的,才会使用该文件夹,这样就绝不会替换其他应用的文件:

通知 含义 处理方法
应用的名称,然后是“已安装在此文件夹中,因此这个副本不能安装到这里。” 该应用已经安装在此电脑上,通常是由它自己的安装程序安装的:它的主程序位于该文件夹中,或者 Windows 的已安装应用列表显示它在那里。许多电脑上已有的应用常会出现这种情况,例如 Web 浏览器、媒体播放器或 Office。 先在 Windows 设置的应用中卸载此电脑上的副本,然后重新打开安装程序。或者在安装位置中输入一个新的空文件夹,将这个副本安装在它旁边。
另一个应用的名称,然后是“已安装在此文件夹中”,并说明此应用“不能安装到这里”。 Windows 的已安装应用列表显示该文件夹中有另一个应用,例如另一个版本的 Office。 在安装位置中输入一个新的空文件夹。或者,如果你不再需要另一个应用,请先在 Windows 设置的应用中将其卸载,然后重新打开安装程序。
“此文件夹中已有并非由 WinAppMigrator 安装的文件。” 文件夹中有其他内容,但没有列出任何已安装的应用位于那里。这些内容可能属于其他应用。 在安装位置中输入一个新的空文件夹。如果这些文件是你已卸载的应用留下的,可以删除该文件夹,然后重新打开安装程序。

如果是其他原因,通知会显示“无法使用此文件夹:”、原因以及“请在上方输入其他文件夹。”这些原因是:

屏幕上显示的原因 处理方法
“它必须是完整路径” 输入以驱动器号开头的路径,例如 C:\Program Files\Fabrikam Data Sync。
“它不能是整个驱动器” 使用驱动器上的文件夹,而不是驱动器本身。
“它不能是 Windows 文件夹” 选择 C:\Windows 之外的文件夹。
“其中并列存放着其他内容,因此应用需要使用其中的一个子文件夹” 为应用添加一个文件夹,例如使用 C:\Program Files\Fabrikam Data Sync,而不是 C:\Program Files。
“它是属于 Windows 的文件夹,或者其内容会自行运行或加载” 选择一个普通文件夹。例如,“启动”文件夹会被拒绝。
“它必须是此电脑驱动器上的普通路径” 网络共享会被拒绝,Windows 会理解为其他东西的名称也会被拒绝。
说明它“是指向其他位置的链接,其他人可能能够更改它指向的位置” 使用该链接指向的文件夹。
“它是安装保存其记录的位置” 选择 %ProgramData%\WinAppMigrator 之外的文件夹。

如果文件夹中有文件,并且 WinAppMigrator 之前的某次安装确实记录在那里,安装程序将使用该文件夹,并发出警告:“此文件夹中已有文件。同名文件将被替换,卸载后会恢复。”

文件夹被接受后,窗口会替换同名的文件、注册表值、服务、任务、快捷方式或变量,就像命令行中的 --force 一样。已经属于其他应用的内容,例如它的服务或文件类型,仍然归该应用所有。

如果驱动器的空间看起来不足,会出现一条琥珀色说明,显示“此处可能没有足够的空间”以及所需的空间。程序包可以在其他驱动器上解压缩,但应用的文件仍须能放进这个驱动器。安装本身在开始之前会再次检查空间。

之前未完成的安装

如果这些安装程序中的任何一个之前执行的安装因崩溃或断电而中断,会出现一条琥珀色说明:先是该应用的名称,然后是“之前的一次安装未完成。安装时会先撤消该次安装。”单击安装时会自动执行此操作。

除文件之外还会设置的内容

这张卡片中的列表就是你单击安装时所同意的内容。在其标题下方显示:

所有这些操作都以管理员权限执行。如果安装失败,它所做的更改将被恢复,无法恢复的内容会告知你。你也可以稍后在“设置”的“已安装的应用”中撤消此安装。它替换的文件会恢复,它安装的运行时会保留。

每一行都有一个名称、右侧一个说明其类型的标签,以及一行说明其作用的文字。常规蓝色的标签表示普通项。琥珀色标签标记以完整权限运行的内容,例如以 LocalSystem 身份运行的服务、驱动程序,或允许入站连接的防火墙规则。请仔细检查这些内容。

如果列表为空,会显示“无:它只复制文件,以及应用自身注册表项中的设置。”

列表是针对框中的位置确定的。如果你更改了位置,它会短暂显示“正在确定在此位置将设置哪些内容…”,安装会等待。

各个标签的含义

标签 它是什么 其下方那行文字的示例
服务 服务:Windows 在后台运行的程序 “以 NT AUTHORITY\LocalService 身份运行 FabrikamSync.exe,立即启动,并在此电脑每次启动时启动”。其他服务会显示“立即启动,并在此电脑每次启动后不久启动”、“仅在有程序请求时启动”或“已禁用”。
驱动程序 应用拥有的驱动程序 “将”某个文件“加载到 Windows 内核中”。始终为琥珀色。项目的测试从未加载过驱动程序。
计划任务 计划任务 “以 SYSTEM 身份运行”,或以某个帐户身份运行。“并使用其可拥有的最高权限”标记为琥珀色。在旧电脑上以某个人的身份运行的任务,会以执行安装的人的身份运行。
自动启动 启动项 “在你登录时运行”、“在任何人登录时运行”或“‘启动’文件夹中的快捷方式,适用于你”
快捷方式 桌面或“开始”菜单中的快捷方式 “打开 Fabrikam.exe,适用于此电脑上的所有人”或“适用于你”
PATH 添加到 Path 变量中的条目 “添加到 Path”和“安装文件夹\bin”。它会追加到已有内容中,绝不会取代原有内容。
环境变量 环境变量 “设置为”及其值
外壳扩展 加载到文件资源管理器中的代码 “将”某个文件“加载到文件资源管理器中,适用于此电脑上的所有人”。琥珀色。
菜单命令 右键菜单中的命令 “向”某类文件“的菜单添加命令”。“更改打开此类项时执行的操作”为琥珀色。
链接类型 链接协议,例如 fabrikam: “此类链接使用此应用打开”
文件类型 文件类型,例如 .fds “此类型的文件使用此应用打开”
COM 其他程序可以启动的 COM 类 某个文件“中的 COM”,以及设置的数量。“COM 权限”为琥珀色。
防火墙规则 针对其某个程序的防火墙规则 “允许入站连接(端口:8080),用于 FabrikamSync.exe,适用于所有网络”。允许入站连接为琥珀色。
事件日志源 应用写入 Windows 事件日志时使用的名称 “可以使用其自身文件中的消息写入 Application 日志”
字体 安装文件夹中的字体 “在你登录时从安装文件夹加载”
ODBC 驱动程序 用于 ODBC 的数据库驱动程序 “加载到使用 ODBC 访问数据库的程序中”。琥珀色。
ODBC 数据源 保存的数据库连接 “数据库连接,适用于此电脑上的所有人”
兼容性设置 Windows 如何启动它的某些程序 “其程序的启动方式”
默认应用 让你可以在“默认应用”中选择此应用的条目 “可在‘默认应用’中选择。不会将任何默认设置更改为它”
程序名称 “运行”和其他程序可以用来找到它的名称 “‘运行’和其他程序可以通过此名称找到它”
其他设置 应用自身注册表项和上述类型之外的注册表值 “应用自身注册表项之外的 3 项设置”,以及“位于”这些注册表项。如果其中有任何值位于 Microsoft 的注册表项中,则为琥珀色。

有些内容只有在安装进行到那一步时才能判断,例如已经属于其他应用的同名服务。这些内容会按请求保留在列表中。安装进行到那里时,会保持它们不变,并加以说明。

说明和已排除的内容

在这些行下方,琥珀色说明会告诉你应当知道的事项,例如:

然后,以琥珀色列出安全规则排除的每一项,并附上原因。前 20 项会完整显示。其余的位于“另有 … 项已排除”下,你可以展开查看。即使没有这些内容,安装的其余部分仍会继续进行。哪些内容会被拒绝以及原因,请参阅安装程序中包含哪些内容。

如果程序包根本无法安装到所选位置,会显示一条红色消息“此程序包无法安装到此位置”及原因。

选项

只有当安装程序包含用户数据或许可证数据时,才会显示这张卡片。每个复选框最初都处于勾选状态。

选项 显示的内容
用户数据 “开:设置、文档和保存的游戏将放入当前登录者的常用文件夹。关:全部放在安装文件夹下,且不会设置任何从中运行的内容。”如果安装程序说明了它包含谁的数据,下方会有一行文字显示“这里包含”该帐户“的数据”。
许可证 “激活和许可证文件,以及保存许可证的注册表值。部分可能需要在此重新激活。”

更改复选框会立即相应地更改上面的列表。

用户数据始终放入当前登录 Windows 的人的帐户,即使在 UAC 提示中输入的是另一个管理员的名称。如果安装程序无法确定登录的是谁,它会说明这一点,排除按用户的设置,并将用户数据放在安装文件夹下,而不是去猜测。如果该会话中没有人登录,用户数据和按用户的设置将归属于运行安装程序的帐户,它同样会说明这一点。

依赖项

“此应用需要的内容,以及每项的提供方式。”每个运行时都有一个标签:

标签 含义
已包含 在安装程序中。无需联网即可安装,但 DirectX End-User Runtime 除外,它的安装程序会从 Microsoft 获取它。其中只有 x64 Visual C++ 运行时在项目的测试中真正安装过。
通过 winget 安装: 和一个 ID 生成安装程序时无法下载它,因此安装程序使用 winget,这需要联网。项目的测试尚未运行过这种方式。
Windows 功能:NetFx3 .NET Framework 3.5,作为 Windows 功能启用。这可能需要联网。项目的测试尚未运行过这种方式。
Windows 内置 .NET Framework 4,Windows 10 和 11 已经自带
随应用提供 应用自带一份副本
手动安装 这里没有它的安装程序。请自行安装。

如果没有任何依赖项,会显示“未检测到其他运行时依赖项。”请参阅运行时。

预览更改

预览更改会准确确定安装将执行的操作,但不做任何更改。它会检查空间是否足够,将程序包解压缩到一个专用文件夹,确定更改内容,然后再删除该文件夹。结果卡片的标题为“预览:尚未进行任何更改”,其中有计划的更改以及更改列表,服务、任务和快捷方式排在最前面。窗口会列出前 300 项,然后说明还有多少项。

预览不会检查每个文件的哈希。窗口打开时已经检查过整个程序包的哈希。

安装

在位置可以使用、并且列表是针对该位置确定的之前,安装一直显示为灰色。如果程序包根本无法安装到该位置,旁边会有一行文字显示“‘安装’不可用,因为此程序包无法安装到此位置。”,原因以红色显示在除文件之外还会设置的内容中。单击它时:

  1. 它会再次确定列表。如果自你查看以来它将执行的操作发生了变化,它不会安装任何内容,而是显示新的列表,并显示“在此处将执行的操作已发生变化,因此未安装任何内容。请查看下面的列表,如果符合你的要求,请再次单击‘安装’。”
  2. 它检查它要写入的每个驱动器上是否有足够的空间。
  3. 它将程序包解压缩到只有管理员才能使用的文件夹,并在解压缩每个文件时检查其哈希。
  4. 它进行安装,并在每项更改之前先将其写入更改记录,以便可以撤消。
  5. 它读回安装的每个文件并检查其哈希。
  6. 它启动设置为自动启动的服务。

在底部,你可以看到它正在做什么、计数(如果有)、已用时间、进度条以及取消。你可能看到的步骤有“正在准备…”、“正在解压缩”、“正在检查程序包”、“正在撤消之前未完成的安装”、“正在安装运行时”、“正在复制文件”、“正在设置服务”、“正在设置驱动程序”、“正在写入注册表设置”、“正在还原许可证数据”、“正在设置计划任务”、“正在创建快捷方式”、“正在设置环境变量”、“正在将应用添加到‘设置’”和“正在检查已安装的内容”。

取消会显示“将在当前步骤完成后取消…”,然后显示“正在恢复已更改的内容”。在安装过程中关闭窗口与单击取消的效果相同:窗口会一直保留,直到所有内容都已恢复。如果尚未进行任何更改,它会显示“已取消。未进行任何更改。”

哈希检查

安装程序会检查三次哈希:

  1. 窗口打开时:检查整个程序包的哈希。被截断的副本,或在生成后被编辑过的副本,在读取其中任何内容之前就会被拒绝。
  2. 解压缩时:在将任何内容写入其位置之前,检查每个文件的哈希。
  3. 安装之后:读回安装的每个文件并再次检查。

哈希可以发现损坏,以及没有同时更新哈希的人所做的更改。哈希无法证明安装程序是谁制作的。只有签名才能做到这一点。

结果

结果卡片显示在顶部,标题为“安装结果”。

消息 含义
“应用已安装,并已通过哈希检查。” 一切正常。如果规则排除了某些内容,它会加上“但不包括下面列为已排除的内容。”
“安装已取消,其所做的更改已恢复。” 你取消了安装。
“安装失败,其所做的更改已恢复。” 某项操作失败。它所做的更改已恢复,但它安装的运行时除外。其下方以琥珀色列出的内容被保留了下来,并说明了原因,例如只有在电脑重启时才会删除的服务。
“安装失败,且其所做的更改未能全部恢复。剩余的内容列在下面,下次安装时会再次尝试。” 请阅读该列表。再次运行安装程序时会再次尝试恢复这些内容。
“安装未正常完成。请查看下面的问题。” 请阅读其下方的消息。

然后是三个磁贴:已进行的更改(失败后为已恢复的更改)、警告和错误。标签显示程序包哈希有效和已安装的文件有效,或者以红色显示程序包哈希无效和已安装的文件无效。最多显示五条警告,所有错误都会作为消息显示。“某个依赖项需要重启才能完成。请重启 Windows,然后启动应用。”表示某个运行时要求重启。

更改及其计数会打开已执行操作的列表,最多 300 项。如果安装未正常完成,会以日志显示其日志的路径。

安装正常完成后,底部的按钮会变为关闭和打开安装文件夹。

内容最终的位置

常见的拒绝原因

你看到的内容 原因 处理方法
“此应用无法在此电脑上运行,因此未进行任何更改” 它的程序是为另一种处理器生成的,或者需要较新版本的 Windows 在与旧电脑匹配的电脑上安装
“空间不足,因此未进行任何更改” 它要写入的某个驱动器上没有足够的可用空间 释放空间,或选择其他驱动器上的位置
“另一个安装或卸载正在运行” 一次只能运行一个 等它完成后重试
某个文件“的名称会被此版本的 Windows 当作设备而不是文件打开” 应用中有名为 aux.h 之类的文件,Windows 11 之前的 Windows 无法保存这种文件 在 Windows 11 上安装
某个数据文件夹(例如 %AppData%)位于链接之下 安装程序不会通过链接写入 取消勾选用户数据和许可证,然后在不包含它们的情况下安装

更多原因请参阅疑难解答。

上次更改时间:2026-11-15。所述内容适用于 WinAppMigrator 的最新版本 0.7.1。