结构体 ara::diag::SovdSwUpdate::UpdatePackageStatus

[SWS_DM_01902] Upstream: RS_Diag_04265

struct UpdatePackageStatus {...};

Definition of Update Status.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Forwarding-Header	#include "ara/diag/diag_fwd.h"
Scope	class ara::diag::SovdSwUpdate

用户指南人工智能生成

提供详细的阶段、进度和错误数据，以监控正在运行的软件更新包。

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 5279eba20862 来源未决问题（3）

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

提供详细的阶段、进度和错误数据，以监控正在运行的软件更新包。

结构体 ara::diag::SovdSwUpdate::UpdatePackageStatus 为 SOVD 诊断应用程序提供软件更新过程的状态、阶段和进度信息 [SWS_DM_01902]。它通过调用 GetUpdatePackageStatus 获取，并允许持续监控执行阶段、百分比进度以及单个步骤。如果发生错误，该结构体将发出失败信号，并通过可选的错误字段传递来自域 DiagSovdErrc 的确切错误代码 [SWS_DM_01909]。作为纯数据传输对象，该结构体在并发访问时推测需要应用程序端进行同步。问题 Q-1d228b6cab1b505e (未决)

上下文

数据结构 ara::diag::SovdSwUpdate::UpdatePackageStatus 是 AUTOSAR Adaptive Platform SWS Diagnostics §8.58.5 “Struct: UpdatePackageStatus” [SWS_DM_01902] 中 diag 模块的一部分。在面向服务的车辆诊断（SOVD，Service-Oriented Vehicle Diagnostics）框架下，它作为标准化信息载体，用于获取并提供软件包的当前状态。诊断接口通过 API 函数 ara::diag::SovdSwUpdate::GetUpdatePackageStatus 生成该状态对象，并将其传递给查询实例 SWS Diagnostics §8.58.2.1.3.5 “GetUpdatePackageStatus” [SWS_DM_01921]。

在系统架构内，该结构充当执行服务组件 SovdSwUpdate 与外部或内部诊断客户端之间的解耦元素。在服务控制实际的包处理和安装的同时，UpdatePackageStatus 封装了关于处理阶段、进度和可能错误状态的快照 [SWS_DM_01902]。

生命周期

作为纯数据容器（struct），UpdatePackageStatus 没有自己的内部状态逻辑，也不执行独立的资源管理 SWS Diagnostics §8.58.5 “Struct: UpdatePackageStatus” [SWS_DM_01902]。实例在调用 GetUpdatePackageStatus 的过程中创建，填充当前状态值，并按值返回给调用方 [SWS_DM_01921]。生命周期绑定到接收方的作用域，并随其销毁而结束。

尽管 C++ 对象是被动的，但其成员变量代表了底层更新过程的生命周期。类型为 SovdUpdatePhase 的字段 phase 描述了整个过程的当前阶段 SWS Diagnostics §8.58.5.1.2 “phase” [SWS_DM_01903]，而类型为 SovdUpdateStatus 的变量 status 则指示该阶段的具体状态 SWS Diagnostics §8.58.5.1.4 “status” [SWS_DM_01904]。由于未指定内部互斥锁或同步机制，对同一实例的并发访问需要使用者进行外部保护。

使用路径

典型使用路径包括诊断客户端对包更新进行周期性或按需监控：

状态查询：客户端调用接口 SovdSwUpdate 上的方法 GetUpdatePackageStatus SWS Diagnostics §8.58.2.1.3.5 “GetUpdatePackageStatus” [SWS_DM_01921]。
阶段和状态评估：在接收到对象 [SWS_DM_01902] 之后，客户端检查变量 phase [SWS_DM_01903] 和 status [SWS_DM_01904]，以确定流程是正常推进还是已完成。
进度分析：如果存在总体百分比进度，则通过可选成员 progress 对其进行评估 SWS Diagnostics §8.58.5.1.3 “progress” [SWS_DM_01905]。可以通过向量 subprogress 查看其他子阶段 [SWS_DM_01906]。
步骤显示：用于记录日志或用户指导时，将使用文本形式的步骤说明 step [SWS_DM_01907] 以及本地化键 step_translation_id [SWS_DM_01908]。

时序图：用于状态查询以及评估 UpdatePackageStatus 成员变量的调用序列。来源：[SWS_DM_01921]、[SWS_DM_01902]、[SWS_DM_01904]、[SWS_DM_01909]。

错误场景

更新流程中的错误通过数据结构的特定属性透明呈现：

失败状态：如果进程出现问题，字段 status 将采用状态“failed”[SWS_DM_01904]。
错误详情：在此错误情况下，类型为 ara::core::Optional<ara::diag::DiagSovdErrc> 的字段 error 指定所发生的错误代码 SWS Diagnostics §8.58.5.1.1 “error” [SWS_DM_01909]。
常规流程：若不存在错误，可选字段 error 应当保持未设置，因为根据规范，它显式耦合到状态“failed”[SWS_DM_01909]。问题 Q-c26d1c1d25d7e938 (未决)
接口错误：若平台层级的 API 调用 GetUpdatePackageStatus 失败，应当返回平台特定的错误状态，而非状态对象 [SWS_DM_01921]。问题 Q-b029f911ee738cb1 (未决)

本指南基于 AUTOSAR Adaptive Platform 规范 Release R25-11。

成员图

常量

error phase progress status step step_translation_id subprogress

类图

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

详细视图

请在大纲中选择一个条目。

此版本没有元素数据

常量

error 变量

Specifies the error if status is failed.

ara::core::Optional<ara::diag::DiagSovdErrc> error;

phase 变量

Specifies the Update Status phase.

SovdUpdatePhase phase;

progress 变量

Specifies the progress of the Update phase in percentage.

ara::core::Optional<std::uint8_t> progress;

status 变量

Specifies the status of the Update phase.

SovdUpdateStatus status;

step 变量

Specifies the current step of the Update.

ara::core::String step;

step_translation_id 变量

Specifies the step_translation_id.

ara::core::String step_translation_id;

subprogress 变量

Specifies the progress of the Update phase in percent.

ara::core::Vector<SubProgress> subprogress;

点击条目以查看其关系。

常量 / 变量文档

变量 error [SWS_DM_01909] Upstream: RS_Diag_04265

ara::core::Optional<ara::diag::DiagSovdErrc> error;

Specifies the error if status is failed.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	struct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbol	error
Typ	ara::core::Optional< ara::diag::DiagSovdErrc >

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01909
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01909@rel:R25-11#c30d882e
Content hash: c30d882e
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01909

Status: valid/unmigrated Version: rel:R25-11#cfd3d293 Versionshistorie & Revisions (1 transition, 4 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01909@rel:R25-11#cfd3d293

Recorded Revisions (4):

R25-11rel:R25-11#4a4c26512026-09-30
R23-11rel:R23-11#cfd3d2932026-10-14
R24-11rel:R24-11#cfd3d2932026-10-14
R25-11rel:R25-11#cfd3d2932026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

变量 phase [SWS_DM_01903] Upstream: RS_Diag_04265

SovdUpdatePhase phase;

Specifies the Update Status phase.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	struct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbol	phase
Typ	SovdUpdatePhase

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01903
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01903@rel:R25-11#39f3891a
Content hash: 39f3891a
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01903

Status: valid/unmigrated Version: rel:R25-11#a843f38b Versionshistorie & Revisions (1 transition, 4 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01903@rel:R25-11#a843f38b

Recorded Revisions (4):

R25-11rel:R25-11#308e0d2b2026-09-30
R23-11rel:R23-11#a843f38b2026-10-14
R24-11rel:R24-11#a843f38b2026-10-14
R25-11rel:R25-11#a843f38b2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

变量 progress [SWS_DM_01905] Upstream: RS_Diag_04265

ara::core::Optional<std::uint8_t> progress;

Specifies the progress of the Update phase in percentage.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	struct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbol	progress
Typ	ara::core::Optional< std::uint8_t >

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01905
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01905@rel:R25-11#6e258e63
Content hash: 6e258e63
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01905

Status: valid/unmigrated Version: rel:R25-11#33e52ed5 Versionshistorie & Revisions (1 transition, 4 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01905@rel:R25-11#33e52ed5

Recorded Revisions (4):

R25-11rel:R25-11#34e3e47e2026-09-30
R23-11rel:R23-11#33e52ed52026-10-14
R24-11rel:R24-11#33e52ed52026-10-14
R25-11rel:R25-11#33e52ed52026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

变量 status [SWS_DM_01904] Upstream: RS_Diag_04265

SovdUpdateStatus status;

Specifies the status of the Update phase.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	struct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbol	status
Typ	SovdUpdateStatus

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01904
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01904@rel:R25-11#dfc1d337
Content hash: dfc1d337
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01904

Status: valid/unmigrated Version: rel:R25-11#c3381562 Versionshistorie & Revisions (1 transition, 4 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01904@rel:R25-11#c3381562

Recorded Revisions (4):

R25-11rel:R25-11#685ed7002026-09-30
R23-11rel:R23-11#c33815622026-10-14
R24-11rel:R24-11#c33815622026-10-14
R25-11rel:R25-11#c33815622026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

变量 step [SWS_DM_01907] Upstream: RS_Diag_04265

ara::core::String step;

Specifies the current step of the Update.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	struct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbol	step
Typ	ara::core::String

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01907
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01907@rel:R25-11#e52e0fa1
Content hash: e52e0fa1
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01907

Status: valid/unmigrated Version: rel:R25-11#5eacde13 Versionshistorie & Revisions (1 transition, 4 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01907@rel:R25-11#5eacde13

Recorded Revisions (4):

R25-11rel:R25-11#19d1f0392026-09-30
R23-11rel:R23-11#5eacde132026-10-14
R24-11rel:R24-11#5eacde132026-10-14
R25-11rel:R25-11#5eacde132026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

变量 step_translation_id [SWS_DM_01908] Upstream: RS_Diag_04265

ara::core::String step_translation_id;

Specifies the step_translation_id.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	struct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbol	step_translation_id
Typ	ara::core::String

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01908
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01908@rel:R25-11#5b32ccb8
Content hash: 5b32ccb8
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01908

Status: valid/unmigrated Version: rel:R25-11#f97411b0 Versionshistorie & Revisions (1 transition, 4 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01908@rel:R25-11#f97411b0

Recorded Revisions (4):

R25-11rel:R25-11#6b35d3a12026-09-30
R23-11rel:R23-11#f97411b02026-10-14
R24-11rel:R24-11#f97411b02026-10-14
R25-11rel:R25-11#f97411b02026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

变量 subprogress [SWS_DM_01906] Upstream: RS_Diag_04265

ara::core::Vector<SubProgress> subprogress;

Specifies the progress of the Update phase in percent.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	struct ara::diag::SovdSwUpdate::UpdatePackageStatus
Symbol	subprogress
Typ	ara::core::Vector< SubProgress >

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01906
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01906@rel:R25-11#763e7fb8
Content hash: 763e7fb8
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01906

Status: valid/unmigrated Version: rel:R25-11#51179198 Versionshistorie & Revisions (1 transition, 4 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01906@rel:R25-11#51179198

Recorded Revisions (4):

R25-11rel:R25-11#5034457c2026-09-30
R23-11rel:R23-11#511791982026-10-14
R24-11rel:R24-11#511791982026-10-14
R25-11rel:R25-11#511791982026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

结构体 ara::diag::SovdSwUpdate::UpdatePackageStatus

用户指南人工智能生成

上下文

生命周期

使用路径

错误场景

成员图

常量

类图

详细视图

常量

常量 / 变量文档

变量 error [SWS_DM_01909] Upstream: RS_Diag_04265

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

变量 phase [SWS_DM_01903] Upstream: RS_Diag_04265

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

变量 progress [SWS_DM_01905] Upstream: RS_Diag_04265

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

变量 status [SWS_DM_01904] Upstream: RS_Diag_04265

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

变量 step [SWS_DM_01907] Upstream: RS_Diag_04265

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

变量 step_translation_id [SWS_DM_01908] Upstream: RS_Diag_04265

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

变量 subprogress [SWS_DM_01906] Upstream: RS_Diag_04265

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: