类 ara::diag::SovdSwUpdate

[SWS_DM_01874] Upstream: RS_Diag_04265

class SovdSwUpdate {...};

Class to implement the SovdSwUpdate interface.

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

用户指南人工智能生成

用作在 AUTOSAR 诊断服务器中通过 ASAM SOVD 协议处理软件更新的接口。

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

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

用作在 AUTOSAR 诊断服务器中通过 ASAM SOVD 协议处理软件更新的接口。

该类提供了应用程序端接口，用于根据 ASAM SOVD 通过 SOVD 协议处理标准化的软件更新 [SWS_DM_01796]。实例化后，应用程序通过方法 Offer() [SWS_DM_01924] 激活将诊断请求转发给特定的更新处理程序。通过异步方法注册、准备、自动或手动安装以及再次删除软件包。所有与数据传输和生命周期相关的操作都通过 Future 以非阻塞方式进行处理。

上下文

类 ara::diag::SovdSwUpdate 定义了在 AUTOSAR Adaptive Platform 内根据 ASAM SOVD 实现标准化软件更新的接口 [SWS_DM_01874]。由于软件更新的实际业务逻辑不位于 Diagnostic Management（DM）功能集群中，因此执行仍由相应的应用程序负责，而 ara::diag::SovdSwUpdate 则专注于底层 SOVD 协议的合规处理 AUTOSAR_AP_SWS_Diagnostics §7.4 “SOVD Software Update API - concept”。对于更新文件的上传，这里采用了针对 UDS 服务 0x38（RequestFileTransfer）所指定的传输策略 AUTOSAR_AP_SWS_Diagnostics §7.4 “SOVD Software Update API - concept”、[SWS_DM_01923]。

在流程中涉及三个主要组件：外部 SOVD 客户端、用于协议和路由管理的 Diagnostic Server (DM) 实例，以及 ara::diag::SovdSwUpdate 的特定于应用程序的处理程序实现 [SWS_DM_01796]、[SWS_DM_01924]。

上下文图：SOVD 客户端、Diagnostic Server (DM) 与 ara::diag::SovdSwUpdate 的交互。来源：[SWS_DM_01796]、[SWS_DM_01924]、AUTOSAR_AP_SWS_Diagnostics §7.4 “SOVD Software Update API - concept”

生命周期

ara::diag::SovdSwUpdate 的实例化通过构造函数进行，需指定指向已建模 DiagnosticSovdUpdateInterface 的端口原型的 ara::core::InstanceSpecifier 以及并发模式（ConcurrencyType：kConcurrent 或 kNotConcurrent）[SWS_DM_01910]。该构造函数被指定为线程安全和异常安全 [SWS_DM_01910]。作为唯一接口实例的代表，复制构造函数和复制赋值运算符已删除（=delete）且受保护 [SWS_DM_01912]、[SWS_DM_01914]。移动构造和移动赋值作为受保护成员可用，但不是线程安全的 [SWS_DM_01913]、[SWS_DM_01915]。

对象的析构通过虚析构函数 ~SovdSwUpdate() 处理，该函数被视为非线程安全 [SWS_DM_01911]。该类的虚回调方法是否必须并发执行，直接取决于传递给构造函数的 ConcurrencyType [SWS_DM_01910]、[SWS_DM_01916]。

使用路径

解释：由于提供的接口方法被声明为纯虚函数（=0），派生的应用程序类应当实现这些方法以执行实际的更新执行，而基类则管理平台连接。问题 Q-10500d9fc58503ea (未决)

常规流程分为以下阶段：

提供：创建对象后，应用程序调用 Offer()，以使 Diagnostic Management 能够将传入的 SOVD 消息转发至该实例 [SWS_DM_01924]。
查询与注册：通过 GetAllUpdates() 可以查询现有的更新包 [SWS_DM_01797]、[SWS_DM_01916]。如果要传输新包，Diagnostic Server 通过 RequestUpdatePackageRegistration() 请求注册，该操作异步提供写入会话（DataTransferWriteSession）以及更新包 ID [SWS_DM_01923]。详细信息和状态通过 GetUpdatePackageDetails() 和 GetUpdatePackageStatus() 获取 [SWS_DM_01802]、[SWS_DM_01917]、[SWS_DM_01921]。
安装或删除：安装既可以通过 PutUpdatePackageAutomated() 自动触发 [SWS_DM_01799]、[SWS_DM_01918]，也可以分两步通过 PrepareUpdatePackage() [SWS_DM_01800]、[SWS_DM_01919] 随后通过 ExecuteUpdatePackage() [SWS_DM_01801]、[SWS_DM_01920] 进行。不再需要的包通过 DeleteUpdatePackage() 移除 [SWS_DM_01922]。
终止：在关闭之前，应用程序通过调用 StopOffer() 停用消息转发 [SWS_DM_01925]。

时序图：通过 SOVD 进行包注册和安装的典型流程。来源：[SWS_DM_01799]、[SWS_DM_01800]、[SWS_DM_01801]、[SWS_DM_01919]、[SWS_DM_01920]、[SWS_DM_01923]、[SWS_DM_01924]

错误场景

通过 Offer() 提供服务时，返回类型 ara::core::Result<void> 中可能会出现特定错误：如果实例已在提供中，则出现 DiagOfferErrc::kAlreadyOffered；如果配置与诊断提取（DEXT）不匹配，则出现 DiagOfferErrc::kConfigurationMismatch [SWS_DM_01924]。

如果使用错误的模型状态调用构造函数，将报告架构违规，包括 InstanceSpecifierMappingIntegrityViolation、PortInterfaceMappingViolation、ProcessMappingViolation 或 InstanceSpecifierAlreadyInUseViolation [SWS_DM_01910]。

所有功能性更新操作均返回 ara::core::Future，在出错时传递符合 ASAM SOVD 1.1 或 ISO 17978-3 的错误代码 [SWS_DM_01917]、[SWS_DM_01919]、[SWS_DM_01920]、[SWS_DM_01923]。此外，所有异步方法均接收一个 CancellationHandler，通过该参数指示当前诊断连接的提前中止 [SWS_DM_01916]、[SWS_DM_01919]、[SWS_DM_01923]。

本指南基于 AUTOSAR Adaptive R25-11 规范自动生成。

成员图

类图

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

详细视图

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

此版本没有元素数据

构造函数和析构函数

SovdSwUpdate 函数 3

Constructor for SovdSwUpdate.

重载 SovdSwUpdate 3

SovdSwUpdate (ara::core::InstanceSpecifier const &instanceSpecifier, ConcurrencyType concurrencyType) noexcept; SWS_DM_01910

SovdSwUpdate (SovdSwUpdate const &)=delete; SWS_DM_01912

SovdSwUpdate (SovdSwUpdate &&other) noexcept; SWS_DM_01913

~SovdSwUpdate 函数

Destructor of class SovdSwUpdate.

virtual ~SovdSwUpdate () noexcept;

方法

DeleteUpdatePackage 函数

Called for SOVD method "Delete Update Package from an SOVD Server".

virtual ara::core::Future< void > DeleteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

ExecuteUpdatePackage 函数

Called for SOVD method "Execute Installation of an Update".

virtual ara::core::Future< void > ExecuteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

GetAllUpdates 函数

Called for SOVD method "Retrieve List of All Updates".

virtual ara::core::Future< ara::core::Vector< ara::core::String > > GetAllUpdates (ara::core::String targetVersion, ara::core::String origin, MetaInfo const &metaInfo, CancellationHandler cancellation Handler) noexcept=0;

GetUpdatePackageDetails 函数

Called for SOVD method "Get Details of Update".

virtual ara::core::Future< UpdatePackageDetails > GetUpdatePackage Details (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

GetUpdatePackageStatus 函数

Called for SOVD method "Get Status of an Update".

virtual ara::core::Future< UpdatePackageStatus > GetUpdatePackage Status (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Offer 函数

This Offer will enable the DM to forward request messages to this handler.

ara::core::Result< void > Offer () noexcept;

PrepareUpdatePackage 函数

Called for SOVD method "Prepare Installation of an Update".

virtual ara::core::Future< void > PrepareUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

PutUpdatePackageAutomated 函数

Called for SOVD method "Automated Installation of an Update".

virtual ara::core::Future< void > PutUpdatePackageAutomated (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

RequestUpdatePackageRegistration 函数

Called for SOVD method "Register an Update at the SOVD Server".

virtual ara::core::Future< std::tuple< DataTransferWriteSession, ara::core::String > > RequestUpdatePackageRegistration (MetaInfo const &metaInfo, ara::core::Optional< uint64_t > expectedSize, Cancellation Handler cancellationHandler) noexcept=0;

StopOffer 函数

This StopOffer will disable the forwarding of request messages from DM.

void StopOffer () const noexcept;

运算符

operator= 函数 2

SovdSwUpdate shall be a single not assignable instance.

重载 = 2

SovdSwUpdate & operator= (SovdSwUpdate const &)=delete; SWS_DM_01914

SovdSwUpdate & operator= (SovdSwUpdate &&other) & noexcept; SWS_DM_01915

嵌套类型

SubProgress 类

UpdatePackageDetails 类

UpdatePackageStatus 类

点击条目以查看其关系。

方法文档

函数 DeleteUpdatePackage [SWS_DM_01922] Upstream: RS_Diag_04265

virtual ara::core::Future< void > DeleteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Delete Update Package from an SOVD Server".

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 8b58fd563e10 来源

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

根据 [SWS_DM_01803]，当需要执行 SOVD 方法“Delete Update Package from an SOVD Server”时，类 ara::diag::SovdSwUpdate 的纯虚函数 DeleteUpdatePackage 会被 Diagnostic Server 实例调用（[SWS_DM_01922]）。它触发更新包在服务器端的移除。

该调用异步进行并返回一个 ara::core::Future<void>，其指示成功完成或提供错误对象 [SWS_DM_01922]。签名要求以下输入参数：

updatePackageId：作为 ara::core::String 指明要删除的更新包的唯一 ID。
metaInfo：作为 MetaInfo const& 传递请求的附加上下文信息。
cancellationHandler：传递一个 CancellationHandler 类型的对象，该对象通知当前会话是否已被取消。

如果在处理过程中发生错误，Future 将包含相应的 SOVD 错误。规范为此规定必须使用来自 ASAM SOVD 1.1 或 ISO 17978-3 的相应错误代码 [SWS_DM_01922]。

在并发性方面，该方法被定义为条件线程安全：实现必须以线程安全还是非线程安全方式执行，由构造函数中传递的 ConcurrencyType 决定 [SWS_DM_01922]。此外，该函数被声明为 noexcept 且异常安全，因此不允许有异常逃逸。

本使用说明基于 AUTOSAR Adaptive R25-11 规范，由 AI 生成。

实现者指南即将推出（复杂度 I1）

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id to be deleted
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive results or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

Status: valid/unmigrated Version: rel:R25-11#3e5d5362 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_01922@rel:R25-11#3e5d5362

Recorded Revisions (4):

R25-11rel:R25-11#6203bff42026-09-30
R23-11rel:R23-11#af1834882026-10-14
R24-11rel:R24-11#113a04fa2026-10-14
R25-11rel:R25-11#3e5d53622026-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

函数 ExecuteUpdatePackage [SWS_DM_01920] Upstream: RS_Diag_04265

virtual ara::core::Future< void > ExecuteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Execute Installation of an Update".

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

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

使用

接口 ara::diag::SovdSwUpdate 的纯虚方法 ExecuteUpdatePackage 用于执行 SOVD 方法“Execute Installation of an Update” [SWS_DM_01920]。其声明位于头文件 ara/diag/sovd_sw_update.h 中 AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.2 “ExecuteUpdatePackage”。更新包标识符（updatePackageId）以及请求数据（metaInfo）作为输入参数传递 [SWS_DM_01920]。此外，对象 cancellationHandler 在当前会话被取消时进行通知 [SWS_DM_01920]。该调用异步进行并返回一个 ara::core::Future<void>，其提供正面结果或报告 SOVD 错误 [SWS_DM_01920]。

错误处理

该接口被指定为 noexcept 且为异常安全（“exception safe”） [SWS_DM_01920]。因此，执行期间的错误不得通过 C++ 异常抛出，而是必须通过 ara::core::Future 异步返回来自 ASAM SOVD 1.1 或 ISO 17978-3 的适用错误代码 [SWS_DM_01920]。

并发性与边界条件

关于线程安全性，存在条件性要求（“conditional”）：该函数必须实现为线程安全还是非线程安全，由传递给构造函数的参数 ConcurrencyType 决定 [SWS_DM_01920]。实现大概需要对 cancellationHandler 进行求值，以便在会话取消时有序终止更新包安装 [SWS_DM_01920]。问题 Q-8fe6950e8f5a168c (未决)

本文由 AI 生成，仅供参考。唯一具有约束力的是官方 AUTOSAR 规范。

实现者指南即将推出（复杂度 I1）

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id of the update to be executed
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive results or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

Status: valid/unmigrated Version: rel:R25-11#250ba828 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_01920@rel:R25-11#250ba828

Recorded Revisions (4):

R25-11rel:R25-11#da8394102026-09-30
R23-11rel:R23-11#c3f2b7802026-10-14
R24-11rel:R24-11#f4456b492026-10-14
R25-11rel:R25-11#250ba8282026-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

函数 GetAllUpdates [SWS_DM_01916] Upstream: RS_Diag_04265

virtual ara::core::Future< ara::core::Vector< ara::core::String > > GetAllUpdates (ara::core::String targetVersion, ara::core::String origin, MetaInfo const &metaInfo, CancellationHandler cancellation Handler) noexcept=0;

Called for SOVD method "Retrieve List of All Updates".

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
targetVersion	Optional parameter to be used if the target-version query parameter is used in the request. If the parameter is not set the String shall be left empty. set in the request the String shall be left empty
origin	Optional parameter to be used if the origin query parameter is used in the request. If the parameter is not set the String shall be left empty
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<ara::core::Vector<ara::core::String > >	A future with a span of all update package ids. The span shall not be modified until the releaseHandler is called.

Fehler

Fehlercode	Beschreibung
This function does not specify any standardized errors.

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

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

Status: valid/unmigrated Version: rel:R25-11#fa31eee5 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_01916@rel:R25-11#fa31eee5

Recorded Revisions (4):

R25-11rel:R25-11#cfb37af32026-09-30
R23-11rel:R23-11#1313500b2026-10-14
R24-11rel:R24-11#2fff52ce2026-10-14
R25-11rel:R25-11#fa31eee52026-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

函数 GetUpdatePackageDetails [SWS_DM_01917] Upstream: RS_Diag_04265

virtual ara::core::Future< UpdatePackageDetails > GetUpdatePackage Details (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Get Details of Update".

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id of the update to be read
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<UpdatePackageDetails >	A future with the details of the requested update package or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

Status: valid/unmigrated Version: rel:R25-11#08879f75 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_01917@rel:R25-11#08879f75

Recorded Revisions (4):

R25-11rel:R25-11#5194b7fa2026-09-30
R23-11rel:R23-11#bed00f3c2026-10-14
R24-11rel:R24-11#71be4b722026-10-14
R25-11rel:R25-11#08879f752026-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

函数 GetUpdatePackageStatus [SWS_DM_01921] Upstream: RS_Diag_04265

virtual ara::core::Future< UpdatePackageStatus > GetUpdatePackage Status (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Get Status of an Update".

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id of which the status shall be read
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<UpdatePackageStatus >	A future with either the current UpdatePackageStatus or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

Status: valid/unmigrated Version: rel:R25-11#a8720fc8 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_01921@rel:R25-11#a8720fc8

Recorded Revisions (4):

R25-11rel:R25-11#6c5291e82026-09-30
R23-11rel:R23-11#6a27c4202026-10-14
R24-11rel:R24-11#f41bfa0b2026-10-14
R25-11rel:R25-11#a8720fc82026-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

函数 Offer [SWS_DM_01924] Upstream: RS_Diag_04265

ara::core::Result< void > Offer () noexcept;

This Offer will enable the DM to forward request messages to this handler.

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

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

成员函数 ara::diag::SovdSwUpdate::Offer 向 Diagnostic Management (DM) 注册 SOVD 软件更新处理程序，以使其能够将传入的请求消息转发至该处理程序 [SWS_DM_01924]。该调用通过头文件 ara/diag/sovd_sw_update.h 同步且无参数进行，并且根据 noexcept 不引发任何 C++ 异常 [SWS_DM_01924]。

操作结果以 ara::core::Result<void> 返回 [SWS_DM_01924]。如果提供服务失败，该函数将返回具有回滚语义的错误 [SWS_DM_01924]：

DiagOfferErrc::kAlreadyOffered：该服务之前已针对此处理程序成功提供 [SWS_DM_01924]。
DiagOfferErrc::kConfigurationMismatch：Monitor 配置与 DEXT 配置不一致 [SWS_DM_01924]。

关于并发性，该方法被指定为 exception safe，但明确指定为非线程安全（not thread-safe） [SWS_DM_01924]。解释：因此在多线程访问时，大概需要外部的应用程序端同步。问题 Q-4636ad27701d59df (未决)通过 Offer 进行提供的原则符合诊断处理程序（如 [SWS_DM_00557] 或 [SWS_DM_00735]）的通用模式，在这些模式中，只有在相应接口被主动提供后，DM 才能转发请求 [SWS_DM_01525]。

本使用说明基于 AUTOSAR Adaptive R25-11 规范自动生成。

实现者指南即将推出（复杂度 I1）

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	Returns nothing or an error.

Fehler

Fehlercode	Beschreibung
DiagOfferErrc::kConfigurationMismatch	rollback_semantics monitor configuration does not match DEXT
DiagOfferErrc::kAlreadyOffered	rollback_semantics The service is already offered.

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

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

Status: valid/unmigrated Version: rel:R25-11#1b6fc58c 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_01924@rel:R25-11#1b6fc58c

Recorded Revisions (4):

R25-11rel:R25-11#4434cb652026-09-30
R23-11rel:R23-11#032ce7bb2026-10-14
R24-11rel:R24-11#438685592026-10-14
R25-11rel:R25-11#1b6fc58c2026-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

函数 PrepareUpdatePackage [SWS_DM_01919] Upstream: RS_Diag_04265

virtual ara::core::Future< void > PrepareUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Prepare Installation of an Update".

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

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

接口 ara::diag::SovdSwUpdate 的纯虚方法 PrepareUpdatePackage 用于根据 [SWS_DM_01919] (AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.7 “PrepareUpdatePackage”) 在 SOVD 方法“Prepare Installation of an Update”的框架下准备软件更新包的安装。

调用与参数

该函数通过头文件 ara/diag/sovd_sw_update.h 提供，并接收以下参数：

updatePackageId：要准备的更新包标识符（ara::core::String）。
metaInfo：传入 SOVD 请求的元数据（MetaInfo const&）。
cancellationHandler：用于通知当前会话已取消的监控对象（CancellationHandler）。

该调用被指定为 noexcept 且表现为异常安全（exception-safe）。异步结果通过 ara::core::Future<void> 提供，其要么指示成功完成，要么提供错误 [SWS_DM_01919]。

错误处理与并发

如果在准备期间发生错误，须在 Future 中返回符合 ASAM SOVD 1.1 或 ISO 17978-3 的相应错误代码 [SWS_DM_01919]。关于线程安全性，适用条件性要求（conditional）：该函数是否必须实现为线程安全，由实例化时在构造函数中指定的 ConcurrencyType 决定 [SWS_DM_01919]。若请求提前终止，应用程序大概能够通过对象 cancellationHandler 取消耗时的准备步骤。问题 Q-be4c53d9a0427ed5 (未决)

本文件由人工智能根据 AUTOSAR 规范生成。

实现者指南即将推出（复杂度 I1）

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id of the update to be prepared
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive result or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

Status: valid/unmigrated Version: rel:R25-11#7bdc8dcb 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_01919@rel:R25-11#7bdc8dcb

Recorded Revisions (4):

R25-11rel:R25-11#d529788a2026-09-30
R23-11rel:R23-11#cb96813b2026-10-14
R24-11rel:R24-11#124b85892026-10-14
R25-11rel:R25-11#7bdc8dcb2026-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

函数 PutUpdatePackageAutomated [SWS_DM_01918] Upstream: RS_Diag_04265

virtual ara::core::Future< void > PutUpdatePackageAutomated (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Automated Installation of an Update".

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： a14ff9457ed9 来源

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

使用

纯虚方法 PutUpdatePackageAutomated 在 SOVD 方法“Automated Installation of an Update”的上下文中被调用 [SWS_DM_01918]。它在类 ara::diag::SovdSwUpdate 内的头文件 ara/diag/sovd_sw_update.h 中声明 AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 “PutUpdatePackageAutomated”。该函数用于自动化安装由其标识符指定的更新包。

该接口需要以下输入参数：

updatePackageId (ara::core::String)：要传递给自动安装的更新包标识符 [SWS_DM_01918]。
metaInfo (MetaInfo const &)：传入服务请求的元信息 [SWS_DM_01918]。
cancellationHandler (CancellationHandler)：通知该操作当前会话是否已被取消 [SWS_DM_01918]。

该调用具有异步语义。返回值是一个 ara::core::Future<void>，其在完成后指示成功执行或包含错误状态 [SWS_DM_01918]。

错误处理与并发

发生错误时，须通过 Future 返回来自 ASAM SOVD 1.1 或 ISO 17978-3 的适用错误代码 [SWS_DM_01918]。该方法被指定为异常安全（exception safe），且作为 noexcept 函数不抛出 C++ 异常 AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 “PutUpdatePackageAutomated”。

该方法的线程安全性是有条件的（conditional）：实现必须以线程安全还是非线程安全方式执行，由构造函数调用时传入的 ConcurrencyType 决定 [SWS_DM_01918]。

本使用说明是基于 AUTOSAR 规范针对版本 R25-11 自动生成的。

实现者指南即将推出（复杂度 I1）

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
updatePackageId	update-package-id of the update to be put to automated
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive result or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

Status: valid/unmigrated Version: rel:R25-11#befb20e2 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_01918@rel:R25-11#befb20e2

Recorded Revisions (4):

R25-11rel:R25-11#cde948f42026-09-30
R23-11rel:R23-11#97eae9312026-10-14
R24-11rel:R24-11#0f5da9f52026-10-14
R25-11rel:R25-11#befb20e22026-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

函数 RequestUpdatePackageRegistration [SWS_DM_01923] Upstream: RS_Diag_04265

virtual ara::core::Future< std::tuple< DataTransferWriteSession, ara::core::String > > RequestUpdatePackageRegistration (MetaInfo const &metaInfo, ara::core::Optional< uint64_t > expectedSize, Cancellation Handler cancellationHandler) noexcept=0;

Called for SOVD method "Register an Update at the SOVD Server".

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

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

类 ara::diag::SovdSwUpdate 的纯虚函数 RequestUpdatePackageRegistration 用于处理 SOVD 方法“Register an Update at the SOVD Server” [SWS_DM_01923]。它启动更新包在服务器上的注册，并初始化关联的传输会话 AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.9 “RequestUpdatePackageRegistration”。

该调用异步进行并返回一个 ara::core::Future，其在成功时包含一个由 DataTransferWriteSession 和带有更新包 ID 的 ara::core::String 组成的元组 [SWS_DM_01923]。调用时传递以下参数：

metaInfo：传入请求的元信息。
expectedSize：可选的更新包预期总大小（ara::core::Optional<uint64_t>），前提是请求中已声明。
cancellationHandler：在当前会话被取消时发出信号。

该方法被定义为 noexcept 且异常安全 [SWS_DM_01923]。因此，错误不会通过 C++ 异常报告，而是通过 Future 异步提供；为此须使用来自 ASAM SOVD 1.1 或 ISO 17978-3 的相应错误代码 [SWS_DM_01923]。

线程安全性是有条件的（“conditional”）：该方法是否必须实现为线程安全，由构造函数中指定的 ConcurrencyType 决定 [SWS_DM_01923]。因此，具体实现大概会根据实例化情况需要其自身的同步机制。问题 Q-7e80e557bdd7627a (未决)

本段文本由 AI 生成，旨在协助使用该 API 元素。

实现者指南即将推出（复杂度 I1）

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
metaInfo	MetaInfo of the request.
expectedSize	Specifies the expected size if available in the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<std::tuple< DataTransferWriteSession, ara::core::String > >	A future with either an instance of a "SOVD file writing session" with the corresponding update package id or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

Status: valid/unmigrated Version: rel:R25-11#b092f8d8 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_01923@rel:R25-11#b092f8d8

Recorded Revisions (4):

R25-11rel:R25-11#0245e3c02026-09-30
R23-11rel:R23-11#c6f57bb12026-10-14
R24-11rel:R24-11#5e5e1b832026-10-14
R25-11rel:R25-11#b092f8d82026-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

函数 SovdSwUpdate [SWS_DM_01910] Upstream: RS_Diag_04265, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

SovdSwUpdate (ara::core::InstanceSpecifier const &instanceSpecifier, ConcurrencyType concurrencyType) noexcept;

Constructor for SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe
Verletzungen (Violations)	InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is referenced by a pingViolation DiagnosticSovdUpdatePortMapping needs to be typed by a DiagnosticSovdUpdateInterface. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.

Parameter (in)

Parameter	Beschreibung
instanceSpecifier	InstanceSpecifier to a PortPrototype of a DiagnosticSovdUpdateInterface service instance in the manifest.
concurrencyType	Specifies if the interface is implemented as thread safe ( kConcurrent) or non-thread safe (kNotConcurrent).

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

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

Status: valid/unmigrated Version: rel:R25-11#39b10a70 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_01910@rel:R25-11#39b10a70

Recorded Revisions (4):

R25-11rel:R25-11#5bc9aa6d2026-09-30
R23-11rel:R23-11#cb3f1d3a2026-10-14
R24-11rel:R24-11#71a1ee492026-10-14
R25-11rel:R25-11#39b10a702026-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

函数 SovdSwUpdate [SWS_DM_01912] Upstream: RS_Diag_04265

SovdSwUpdate (SovdSwUpdate const &)=delete;

SovdSwUpdate shall be a single not copy-able instance.

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

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

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

Status: valid/unmigrated Version: rel:R25-11#a9b2eed0 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_01912@rel:R25-11#a9b2eed0

Recorded Revisions (4):

R25-11rel:R25-11#29457c012026-09-30
R23-11rel:R23-11#920c2b292026-10-14
R24-11rel:R24-11#a9b2eed02026-10-14
R25-11rel:R25-11#a9b2eed02026-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

函数 SovdSwUpdate [SWS_DM_01913] Upstream: RS_Diag_04265

SovdSwUpdate (SovdSwUpdate &&other) noexcept;

Move constructs an instance of SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	unsafe
Sichtbarkeit	protected

Parameter (out)

Parameter	Beschreibung
other	The other object

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

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

Status: valid/unmigrated Version: rel:R25-11#4c757859 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_01913@rel:R25-11#4c757859

Recorded Revisions (4):

R25-11rel:R25-11#662a98ac2026-09-30
R23-11rel:R23-11#2175e3ea2026-10-14
R24-11rel:R24-11#4c7578592026-10-14
R25-11rel:R25-11#4c7578592026-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

函数 StopOffer [SWS_DM_01925] Upstream: RS_Diag_04265

void StopOffer () const noexcept;

This StopOffer will disable the forwarding of request messages from DM.

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

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

使用

方法 ara::diag::SovdSwUpdate::StopOffer 终止服务的提供，并停用将传入请求消息从 Diagnostic Management (DM) 转发至软件更新组件 [SWS_DM_01925]。该调用通过来自 ara/diag/sovd_sw_update.h 的接口进行，无参数且没有返回值 [SWS_DM_01925]。终止服务提供以同步方式进行，对应于 AUTOSAR Adaptive 中诊断功能的概念性停用 AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”。

错误处理与并发

该函数具备规范 noexcept，因而具有异常安全性；未设计通过异常或错误代码表示错误状态 [SWS_DM_01925]。对于调用上下文，该函数被定义为非线程安全（“not thread-safe”） [SWS_DM_01925]。对同一实例的并发调用必须在应用程序端进行同步。解释：在已处于非活动状态下重复调用 StopOffer 大概不会产生错误影响，因为不存在错误处理。问题 Q-efaccde5507eb444 (未决)

相互作用

在整个系统中，该函数融入了 DM 服务生命周期的统一模式中。它构成了提供服务的功能对等部分，并与其它诊断服务（如 ara::diag::DownloadService [SWS_DM_00793]、ara::diag::GenericUDSService [SWS_DM_00620] 以及 ara::diag::EcuResetRequest [SWS_DM_01017]）的停用操作表现类似。

本文由 AI 基于 AUTOSAR 规范 R25-11 生成。

实现者指南即将推出（复杂度 I2）

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
None

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

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

Status: valid/unmigrated Version: rel:R25-11#b5890de5 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_01925@rel:R25-11#b5890de5

Recorded Revisions (4):

R25-11rel:R25-11#60438b2c2026-09-30
R23-11rel:R23-11#aac09bc62026-10-14
R24-11rel:R24-11#b5890de52026-10-14
R25-11rel:R25-11#b5890de52026-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

函数 operator= [SWS_DM_01914] Upstream: RS_Diag_04265

SovdSwUpdate & operator= (SovdSwUpdate const &)=delete;

SovdSwUpdate shall be a single not assignable instance.

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

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

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

Status: valid/unmigrated Version: rel:R25-11#193efe55 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_01914@rel:R25-11#193efe55

Recorded Revisions (4):

R25-11rel:R25-11#f93349172026-09-30
R23-11rel:R23-11#bd4a8b212026-10-14
R24-11rel:R24-11#193efe552026-10-14
R25-11rel:R25-11#193efe552026-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

函数 operator= [SWS_DM_01915] Upstream: RS_Diag_04265

SovdSwUpdate & operator= (SovdSwUpdate &&other) & noexcept;

Move assigns an instance of SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe
Sichtbarkeit	protected

Parameter (out)

Parameter	Beschreibung
other	The other object

Rückgabewert

Typ	Beschreibung
SovdSwUpdate &	Reference to self

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

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

Status: valid/unmigrated Version: rel:R25-11#1ed1cfe6 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_01915@rel:R25-11#1ed1cfe6

Recorded Revisions (4):

R25-11rel:R25-11#9f73c1222026-09-30
R23-11rel:R23-11#7eb86d6a2026-10-14
R24-11rel:R24-11#1ed1cfe62026-10-14
R25-11rel:R25-11#1ed1cfe62026-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

函数 ~SovdSwUpdate [SWS_DM_01911] Upstream: RS_Diag_04265

virtual ~SovdSwUpdate () noexcept;

Destructor of class SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

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

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

Status: valid/unmigrated Version: rel:R25-11#2b411c6a 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_01911@rel:R25-11#2b411c6a

Recorded Revisions (4):

R25-11rel:R25-11#7b4f357a2026-09-30
R23-11rel:R23-11#0a7ddd152026-10-14
R24-11rel:R24-11#5ddc97882026-10-14
R25-11rel:R25-11#2b411c6a2026-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

用户指南人工智能生成

上下文

生命周期

使用路径

错误场景

成员图

构造函数和析构函数

方法

运算符

嵌套类型

类图

详细视图

构造函数和析构函数

方法

运算符

嵌套类型

方法文档

函数 DeleteUpdatePackage [SWS_DM_01922] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 ExecuteUpdatePackage [SWS_DM_01920] Upstream: RS_Diag_04265

使用

错误处理

并发性与边界条件

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetAllUpdates [SWS_DM_01916] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetUpdatePackageDetails [SWS_DM_01917] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetUpdatePackageStatus [SWS_DM_01921] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 Offer [SWS_DM_01924] Upstream: RS_Diag_04265

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 PrepareUpdatePackage [SWS_DM_01919] Upstream: RS_Diag_04265

调用与参数

错误处理与并发

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 PutUpdatePackageAutomated [SWS_DM_01918] Upstream: RS_Diag_04265

使用