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