Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

nl::Weave::Hồ sơ::Cập nhật phần mềm

Vùng chứa tên này bao gồm tất cả giao diện trong Weave cho hồ sơ Cập nhật phần mềm Weave, bao gồm giao thức tương ứng có cùng tên.

Tóm tắt

Bảng liệt kê

@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
}
enum
SoftwareUpdate Các loại thông báo.
@310{
  kStatus_NoUpdateAvailable = 0x0001,
  kStatus_UpdateFailed = 0x0010,
  kStatus_InvalidInstructions = 0x0050,
  kStatus_DownloadFailed = 0x0051,
  kStatus_IntegrityCheckFailed = 0x0052,
  kStatus_Abort = 0x0053,
  kStatus_Retry = 0x0091
}
enum
@311{
  kFlag_PackageSpecPresent = 1,
  kFlag_LocaleSpecPresent = 2,
  kFlag_TargetNodeIdPresent = 4
}
enum
Cờ kiểm soát cho trường kiểm soát của khung ImageQuery.
@312 enum
Yêu cầu cho trường các tùy chọn cập nhật không bắt buộc của ImageQueryResponse.
@313 enum
Shift bù trừ cho trường tùy chọn cập nhật của ImageQueryResponse.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
}
enum
@315 enum
Độ dài, tính bằng byte, cho chuỗi byte của đặc tả tính toàn vẹn.
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
}
enum
@317 enum
Thẻ Phần tử dữ liệu cho Cấu hình SoftwareUpdate.
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
}
enum
Các điều kiện điều chỉnh chính sách cập nhật.
UpdatePriority{
  Normal,
  Critical
}
enum
Cập nhật mức độ ưu tiên.

Hàm

integrityLength(uint8_t aType)
int
Một phương thức hỗ trợ liên kết các giá trị IntegrityTypes vào độ dài của các hàm băm thuộc loại đó.

Lớp

nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

Giao diện của đại biểu WeaveImageNotificationsServer.

nl::Weave::Profiles::SoftwareUpdate::ImageAnnounce

Lớp học mô tả thông báo ImageAnnounce.

nl::Weave::Profiles::SoftwareUpdate::ImageQuery

Một lớp hỗ trợ việc tạo và giải mã thông báo truy vấn hình ảnh.

nl::Weave::Profiles::SoftwareUpdate::ImageQueryResponse

Một lớp hỗ trợ việc tạo và giải mã thông báo phản hồi truy vấn hình ảnh.

nl::Weave::Hồ sơ::SoftwareUpdate::IntegritySpec

Một lớp phụ lưu giữ loại tính toàn vẹn và hàm băm thực tế của hình ảnh cập nhật phần mềm.

nl::Weave::Profiles::SoftwareUpdate::IntegrityTypeList

Một lớp phụ lưu giữ danh sách các loại toàn vẹn trong truy vấn hình ảnh.

nl::Weave::Hồ sơ::SoftwareUpdate::ProductSpec

Lớp phụ trợ cho một quy cách sản phẩm.

nl::Weave::Profiles::SoftwareUpdate::UpdateSchemeList

Một lớp bổ sung để lưu giữ danh sách các lược đồ cập nhật như một phần của truy vấn hình ảnh.

nl::Weave::Profiles::SoftwareUpdate::WeaveImageAnnounceServer

Máy chủ lắng nghe thông báo về hình ảnh Weave.

Bảng liệt kê

@309

 @309

SoftwareUpdate Các loại thông báo.

Thuộc tính
kMsgType_DownloadNotify

Một thông báo tùy chọn từ máy khách đến máy chủ được dùng để thông báo cho máy chủ về trạng thái tải xuống.

Phần tải dữ liệu này là một nl::Weave::Profiles::StatusReport::StatusReport có thông tin trạng thái bổ sung được lấy từ SoftwareUpdateStatusCodes.

kMsgType_ImageAnnounce

Sự lộn xộn không mong muốn là sự cố do máy chủ sử dụng để thông báo về khả năng cung cấp bản cập nhật phần mềm.

Thư không có trọng tải.

kMsgType_ImageQuery

Thông báo truy vấn do ứng dụng gửi đến máy chủ.

Định dạng của lớp đó được xác định bằng lớp ImageQuery.

kMsgType_ImageQueryResponse

Thông báo được tạo để phản hồi một thông báo truy vấn hình ảnh thành công.

Định dạng của lớp do lớp ImageQueryResponse xác định.

kMsgType_ImageQueryStatus

Thông báo được tạo để phản hồi thông báo truy vấn hình ảnh không thành công.

Phần tải dữ liệu này là một nl::Weave::Profiles::StatusReport::StatusReport có thông tin trạng thái bổ sung được lấy từ SoftwareUpdateStatusCodes.

kMsgType_NotifyResponse

Một thông báo được tạo để phản hồi thông báo tải xuống thông báo.

Phần tải dữ liệu này là một nl::Weave::Profiles::StatusReport::StatusReport có thông tin trạng thái bổ sung được lấy từ SoftwareUpdateStatusCodes.

kMsgType_UpdateNotify

Một thông báo tùy chọn từ ứng dụng đến máy chủ được dùng để thông báo trạng thái cuối cùng của bản cập nhật.

Phần tải dữ liệu này là một nl::Weave::Profiles::StatusReport::StatusReport có thông tin trạng thái bổ sung được lấy từ SoftwareUpdateStatusCodes. Vì thông báo dự kiến sẽ được tạo sau khi cập nhật thực tế, nên thông báo sẽ được gửi trên ExchangeContext mới và được coi là thông báo không mong muốn trên máy chủ.

@310

 @310

SoftwareUpdate mã trạng thái dành riêng cho hồ sơ.

Thuộc tính
kStatus_Abort

máy chủ => client, cho biết rằng máy chủ cần phải từ bỏ vì máy chủ không có tùy chọn.

kStatus_DownloadFailed

client => server, cho biết rằng không thể tải xuống được.

kStatus_IntegrityCheckFailed

client => server, cho biết hình ảnh đã được tải xuống nhưng không thể kiểm tra tính toàn vẹn sau đó.

kStatus_InvalidInstructions

client => server cho biết ứng dụng không thể tải hình ảnh xuống vì hướng dẫn tải xuống có trong ImageQueryResponse, tức là

URI, lược đồ cập nhật, điều kiện cập nhật, có định dạng kém hoặc không nhất quán.

kStatus_NoUpdateAvailable

máy chủ => client, cho biết rằng đã nhận và hiểu được một truy vấn hình ảnh và máy chủ không có bản cập nhật cho ứng dụng này vào lúc này.

kStatus_Retry

máy chủ => client, cho biết ứng dụng phải gửi truy vấn hình ảnh khác và khởi động lại/tiếp tục quá trình cập nhật

kStatus_UpdateFailed

client => server, cho biết rằng không cố gắng cài đặt hình ảnh do máy chủ chỉ định.

@311

 @311

Cờ kiểm soát cho trường kiểm soát của khung ImageQuery.

Thuộc tính
kFlag_LocaleSpecPresent

Có thông số Locale trong ImageQuery.

kFlag_PackageSpecPresent

Thông số kỹ thuật về gói có trong ImageQuery.

kFlag_TargetNodeIdPresent

Mã nút mục tiêu hiển thị trong ImageQuery.

@312

 @312

Yêu cầu cho trường các tùy chọn cập nhật không bắt buộc của ImageQueryResponse.

@313

 @313

Shift bù trừ cho trường tùy chọn cập nhật của ImageQueryResponse.

@314

 @314

Các loại tính toàn vẹn được hỗ trợ trong cấu hình SoftwareUpdate.

Khung truy vấn hình ảnh chứa thông tin về quá trình kiểm tra tính toàn vẹn mà ứng dụng hỗ trợ và phản hồi truy vấn hình ảnh chứa loại tính toàn vẹn và giá trị cho hình ảnh mà ứng dụng đang được hướng dẫn tải xuống và cài đặt. Các loại kết quả được hỗ trợ là:

Thuộc tính
kIntegrityType_Last

Số phần tử hợp lệ trong bảng liệt kê.

kIntegrityType_SHA160

Hàm băm 160 bit an toàn (SHA-1), bắt buộc.

kIntegrityType_SHA256

Hàm băm bảo mật 256 bit (SHA-2).

kIntegrityType_SHA512

512 bit, Hàm băm bảo mật (SHA-2).

@315

 @315

Độ dài, tính bằng byte, cho chuỗi byte của đặc tả tính toàn vẹn.

@316

 @316

Lược đồ cập nhật được cấu hình SofwareUpdate hỗ trợ.

Tương tự như các loại tính toàn vẹn được hỗ trợ, truy vấn hình ảnh chứa thông tin về các lược đồ cập nhật, tức là giao thức tải xuống, ứng dụng được hỗ trợ và phản hồi chứa giá trị để cho biết lược đồ cập nhật dùng để tải hình ảnh xuống. Lược đồ được hỗ trợ là:

Thuộc tính
kUpdateScheme_BDX

Chuyển dữ liệu Weave sẽ được sử dụng làm giao thức tải xuống.

kUpdateScheme_HTTP

HTTP sẽ được sử dụng làm giao thức tải xuống.

kUpdateScheme_HTTPS

HTTPS sẽ được sử dụng làm giao thức tải xuống.

kUpdateScheme_Last

Số phần tử hợp lệ trong bảng liệt kê.

kUpdateScheme_SFTP

SFTP sẽ được sử dụng làm giao thức tải xuống.

@317

 @317

Thẻ Phần tử dữ liệu cho Cấu hình SoftwareUpdate.

UpdateCondition

 UpdateCondition

Các điều kiện điều chỉnh chính sách cập nhật.

Thuộc tính
IfLater

Tải xuống và cài đặt hình ảnh nếu bản đặc tả phiên bản trong khung phản hồi mới hơn phiên bản phần mềm hiện đã cài đặt.

IfUnmatched

Tải xuống và cài đặt hình ảnh nếu bản đặc tả phiên bản trong khung phản hồi không khớp với phiên bản phần mềm hiện được cài đặt.

OnOptIn

tải xuống và cài đặt hình ảnh trên một số trình kích hoạt do người dùng trên trang web cung cấp.

Unconditionally

Tải xuống và cài đặt hình ảnh bất kể phiên bản phần mềm hiện đang chạy.

Mức độ ưu tiên của bản cập nhật

 UpdatePriority

Cập nhật mức độ ưu tiên.

Thuộc tính
Critical

Quá trình cập nhật phải được thực thi ngay lập tức.

Normal

Quá trình cập nhật có thể được thực hiện theo quyết định của khách hàng.

Hàm

tính toàn vẹn

int integrityLength(
  uint8_t aType
)

Một phương thức hỗ trợ liên kết các giá trị IntegrityTypes vào độ dài của các hàm băm thuộc loại đó.

Thông tin chi tiết
Các thông số
[in] aType
Giá trị IntegrityTypes
Trả về
Độ dài của hàm băm của loại hàm băm được cung cấp.