nl::Weave::Profiles::SoftwareUpdate

تشمل مساحة الاسم هذه جميع الواجهات ضمن Weave في الملف الشخصي Weave Software Update، والذي يتضمّن البروتوكول المقابل الذي يحمل الاسم نفسه.

ملخّص

عمليات التعداد
@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
} 		تعداد
أنواع الرسائل SoftwareUpdate
@310{
  kStatus_NoUpdateAvailable = 0x0001,
  kStatus_UpdateFailed = 0x0010,
  kStatus_InvalidInstructions = 0x0050,
  kStatus_DownloadFailed = 0x0051,
  kStatus_IntegrityCheckFailed = 0x0052,
  kStatus_Abort = 0x0053,
  kStatus_Retry = 0x0091
} 		تعداد
@311{
  kFlag_PackageSpecPresent = 1,
  kFlag_LocaleSpecPresent = 2,
  kFlag_TargetNodeIdPresent = 4
} 		تعداد
علامات التحكّم في حقل التحكّم لإطار ImageQuery
@312 تعداد
Bitmasks لحقل خيارات التحديث الاختياري لـ ImageQueryResponse.
@313 تعداد
إزاحة Shift لحقل خيارات التحديث الاختياري لـ ImageQueryResponse.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
} 		تعداد
@315 تعداد
الأطوال، بالبايت، لسلاسل البايت لمواصفات السلامة.
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
} 		تعداد
@317 تعداد
علامات عناصر البيانات للملف الشخصي SoftwareUpdate
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
} 		تعداد
الشروط التي تحكم سياسة التعديل.
UpdatePriority{
  Normal,
  Critical
} 		تعداد
حدِّث الأولويات.

الدوال
integrityLength(uint8_t aType)
int
يشير ذلك المصطلح إلى طريقة دعم تربط قيم IntegrityTypes بأطوال علامات التجزئة من هذا النوع.

صفوف
nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

واجهة المستخدم المفوَّض WeaveImageAnnounceServer

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

الصف الذي يصف رسالة ImageAnnounce.

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

فئة لدعم إنشاء رسائل طلب البحث عن الصور وفك ترميزها.

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

فئة تتيح إنشاء وفك ترميز رسائل الردّ على طلب البحث عن الصور.

nl::Weave::Profiles::SoftwareUpdate::IntegritySpec

تمثّل هذه السمة فئة إضافية تحمل نوع السلامة والتجزئة الفعلية لصورة تحديث البرنامج.

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

فئة إضافية تتضمّن قائمة أنواع التكامل كجزء من طلب بحث الصورة.

nl::Weave::Profiles::SoftwareUpdate::ProductSpec

تمثّل هذه السمة فئة إضافية تمثّل مواصفات المنتج.

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

فئة إضافية تتضمّن قائمة بأساليب التعديل كجزء من طلب بحث الصورة.

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

الخادم الذي ينتظر إشعارات صور Weave.

عمليات التعداد

@309

 @309

أنواع الرسائل SoftwareUpdate

أماكن إقامة
kMsgType_DownloadNotify

رسالة اختيارية من العميل إلى الخادم يستخدمها لإعلام الخادم بحالة التنزيل.

وتكون حمولتها nl::Weave::Profiles::StatusReporting::StatusReport، كما يتم الحصول على معلومات الحالة الإضافية من SoftwareUpdateStatusCodes.

kMsgType_ImageAnnounce

رسالة اختيارية غير مرغوب فيها، يستخدمها الخادم للإعلان عن توفُّر تحديث للبرنامج.

لا تحمل الرسالة أي حمولة.

kMsgType_ImageQuery

يشير هذا المصطلح إلى رسالة طلب بحث يرسلها العميل إلى الخادم.

ويتم تحديد تنسيقه باستخدام الفئة ImageQuery.

kMsgType_ImageQueryResponse

رسالة تم إنشاؤها استجابةً لرسالة طلب بحث ناجحة عن الصورة.

وتحدّد الفئة ImageQueryResponse تنسيقها.

kMsgType_ImageQueryStatus

رسالة تم إنشاؤها ردًا على رسالة تعذّر إجراؤها لطلب البحث عن الصورة.

وتكون حمولتها nl::Weave::Profiles::StatusReporting::StatusReport، كما يتم الحصول على معلومات الحالة الإضافية من SoftwareUpdateStatusCodes.

kMsgType_NotifyResponse

رسالة يتم إنشاؤها استجابةً لرسالة الإشعار بالتنزيل.

وتكون حمولتها nl::Weave::Profiles::StatusReporting::StatusReport، كما يتم الحصول على معلومات الحالة الإضافية من SoftwareUpdateStatusCodes.

kMsgType_UpdateNotify

رسالة اختيارية من العميل إلى الخادم تُستخدم لإبلاغ الحالة النهائية للتحديث.

وتكون حمولتها nl::Weave::Profiles::StatusReporting::StatusReport، كما يتم الحصول على معلومات الحالة الإضافية من SoftwareUpdateStatusCodes. وبما أنه من المتوقع إنشاء الرسالة بعد التحديث الفعلي، يتم إرسالها في ExchangeContext جديد ويتم التعامل معها كرسالة غير مرغوب فيها على الخادم.

@310

 @310

رموز الحالة الخاصة بالملف الشخصي من خلال SoftwareUpdate

أماكن إقامة
kStatus_Abort

الخادم => العميل، إلى أنه يجب على العميل الاستسلام لأن الخادم خارج الخيارات.

kStatus_DownloadFailed

client => Server، يشير إلى فشل محاولة التنزيل.

kStatus_IntegrityCheckFailed

client => Server، يشير إلى أنه تم تنزيل صورة ولكنها فشلت في عملية التحقق اللاحقة من السلامة.

kStatus_InvalidInstructions

الخادم =>، إلى أن العميل لم يتمكن من تنزيل صورة بسبب تعليمات التنزيل الواردة في ImageQueryResponse، أي

معرّف موارد منتظم (URI) أو مخطط التحديث أو حالة التحديث أو تنسيقه غير صحيح أو غير متسق.

kStatus_NoUpdateAvailable

يشير الخادم => إلى أنه تم استلام استعلام صورة وفهمه وأنه ليس لدى الخادم أي تحديث للعميل في الوقت الحالي.

kStatus_Retry

الخادم => العميل، إلى أنه يجب على العميل إرسال استعلام صورة آخر وإعادة تشغيل/متابعة التحديث

kStatus_UpdateFailed

العميل => الخادم، يشير إلى تعذّر محاولة تثبيت صورة حددها الخادم.

@311

 @311

علامات التحكّم في حقل التحكّم لإطار ImageQuery

أماكن إقامة
kFlag_LocaleSpecPresent

تتوفّر مواصفات اللغة في ImageQuery.

kFlag_PackageSpecPresent

تتوفّر مواصفات الحزمة في ImageQuery.

kFlag_TargetNodeIdPresent

يتوفّر رقم تعريف العقدة المستهدَفة في ImageQuery.

@312

 @312

Bitmasks لحقل خيارات التحديث الاختياري لـ ImageQueryResponse.

@313

 @313

إزاحة Shift لحقل خيارات التحديث الاختياري لـ ImageQueryResponse.

@314

 @314

أنواع التكامل المتوافقة مع الملف الشخصي SoftwareUpdate

يحتوي إطار طلب بحث الصور على معلومات عن ميزة التحقّق من سلامة التطبيق التي يوفّرها العميل، ويحتوي ردّ طلب بحث الصورة على نوع التكامل وقيمة الصورة التي يتم توجيه العميل بتنزيلها وتثبيتها. الأنواع المتوافقة هي:

أماكن إقامة
kIntegrityType_Last

عدد العناصر الصالحة في التعداد.

kIntegrityType_SHA160

التجزئة الآمنة 160 بت، (SHA-1)، مطلوبة.

kIntegrityType_SHA256

التجزئة الآمنة 256 بت (SHA-2)

kIntegrityType_SHA512

512 بت، تجزئة آمنة (SHA-2).

@315

 @315

الأطوال، بالبايت، لسلاسل البايت لمواصفات السلامة.

@316

 @316

يمكنك تعديل المخططات المتوافقة مع الملف الشخصي على SofwareUpdate.

على نحو مشابه لأنواع التكامل المتوافقة، يحتوي طلب بحث الصورة على معلومات عن أنظمة التحديث، أي بروتوكولات التنزيل التي يدعمها البرنامج، وتحتوي الاستجابة على قيمة للإشارة إلى نظام التحديث المراد استخدامه في تنزيل الصور. المخطَّطات المتوافقة هي:

أماكن إقامة
kUpdateScheme_BDX

سيتم استخدام نقل البيانات المجمّعة في Weave كبروتوكول التنزيل.

kUpdateScheme_HTTP

سيتم استخدام HTTP كبروتوكول التنزيل.

kUpdateScheme_HTTPS

سيتم استخدام HTTPS كبروتوكول التنزيل.

kUpdateScheme_Last

عدد العناصر الصالحة في التعداد.

kUpdateScheme_SFTP

سيتم استخدام بروتوكول النقل الآمن للملفات (SFTP) كبروتوكول التنزيل.

@317

 @317

علامات عناصر البيانات للملف الشخصي SoftwareUpdate

UpdateCondition

 UpdateCondition

الشروط التي تحكم سياسة التعديل.

أماكن إقامة
IfLater

قم بتنزيل الصورة وتثبيتها إذا كانت مواصفات الإصدار في إطار الاستجابة أحدث من إصدار البرنامج المثبت حاليًا.

IfUnmatched

نزِّل الصورة وثبِّتها إذا كانت مواصفات الإصدار في إطار الاستجابة لا تتوافق مع إصدار البرنامج المثبَّت حاليًا.

OnOptIn

تنزيل الصورة وتثبيتها على بعض المشغِّلات التي يقدمها أحد مستخدمي الموقع.

Unconditionally

تنزيل الصورة وتثبيتها بغض النظر عن إصدار البرنامج قيد التشغيل حاليًا

UpdatePriority

 UpdatePriority

حدِّث الأولويات.

أماكن إقامة
Critical

يجب تنفيذ التعديل على الفور.

Normal

يمكن تنفيذ التعديل وفقًا لتقدير العميل.

الدوال

integrityLength

int integrityLength(
  uint8_t aType
)

يشير ذلك المصطلح إلى طريقة دعم تربط قيم IntegrityTypes بأطوال علامات التجزئة من هذا النوع.

التفاصيل
المَعلمات
[in] aType
قيمة IntegrityTypes
المرتجعات
طول التجزئة لنوع التجزئة المقدّم.