pop-upgrade

用于升级 Pop!_OS 及其恢复分区到新版本的实用工具。此工具将作为 Ubuntu 的 do-release-upgrade 脚本的替代品。目标是降低错误率，确保升级时保留关键包，并与 Pop!_OS 更好地集成。

DBus API

以守护进程模式启动时（需要 root 权限），将注册一个新的 Dbus 服务，以下为详细信息

• 接口：com.system76.PopUpgrade
• 名称：com.system76.PopUpgrade
• 路径：/com/system76/PopUpgrade

DBus 方法

• FetchUpdates(additional_strings: as,download_only:b) -> (updates_available: b, completed: s, total: s)
  • 创建一个任务，用于获取所有可用的更新，包括额外的软件包。
  • 如果有更新任务正在执行，则 completed 和 total 将具有非零值。
  • 如果 updates_available 返回 false，则没有可获取的软件包。
  • 除非指定 download_only 为 true，否则将安装软件包。
• RecoveryUpgradeByFile(path:s) -> (result: y)
  • 创建一个任务，通过指定路径的文件升级恢复分区。
• RecoveryUpgradeByRelease(version:s,arch:s,flags:q) -> (result: y)
  • 创建一个任务，通过发布 API 使用定义的详细信息升级恢复分区。
  • 如果可用软件包更新，则将先执行 FetchUpdates 任务。
  • how 定义了如何升级恢复分区。
    • 可能的选项有 file 和 release。
  • version 定义了要获取的套件（例如：20.04）
  • arch 定义了要获取该版本的哪个变体（例如：nvidia）
  • flags 设置了任务的附加配置参数
• RefreshOS() -> (result: y)
• ReleaseCheck() -> (当前：s，下一个：s，构建：n)
  • 快速检查当前的发布版本，确定下一个发布版本，并说明是否有更新可用。
• ReleaseUpgrade(方式:q,从:s,到:s)
  • 创建一个任务来启动发行版发布升级。
  • from 定义了要从哪个套件升级。
  • to 定义了要升级到的套件。
  • 执行升级方法由 how 决定。
    • 1 将使用 systemd 进行离线升级。
    • 2 将使用恢复分区进行离线升级。
    • 任何其他值将导致错误。
• ReleaseRepair()
  • 执行自动修复可能影响系统操作的任何问题
    • 如果某些挂载丢失或挂载了错误的 ID，则将修正 /etc/fstab 文件
    • 如果源列表缺失任何关键存储库，也将解析和修正它们
• 状态() -> (状态：q，子状态：q)
  • 报告守护进程的当前状态，其中零表示不活动。
  • 如果 status 有 sub_status，则将其设置为非零值。
  • 主状态的有效状态如下
    • 0：不活动，
    • 1：获取软件包，
    • 2：恢复升级，
    • 3：发布升级，
    • 4：软件包升级
• UpgradePackages()
  • 升级当前版本的软件包，类似于执行正常的非交互式升级。