نسخه‌بندی یکپارچه‌سازی

نسخه‌بندی به توسعه‌دهندگان امکان می‌دهد چندین نسخه از یک یکپارچه‌سازی را در مراحل مختلف توسعه مدیریت کنند.

در برگه توسعه در Google Home Developer Console، یکپارچه‌سازی‌ها «بدون نسخه» درنظر گرفته می‌شوند. وقتی مرحله آزمایش توسعه را در برگه آزمایش شروع کنید، یکپارچه‌سازی‌ها نسخه‌بندی می‌شوند. از آن نقطه به بعد، از نسخه یکپارچه‌سازی برای همه مراحل باقی‌مانده در گردش کار، از «آزمایش» تا «راه‌اندازی»، استفاده می‌شود.

برای مثال، ممکن است یک نسخه از یک ادغام درحال گذراندن گواهینامه برای راه‌اندازی قریب‌الوقوع باشد، درحالی‌که نسخه جدیدتری از ادغام با عملکرد متفاوت برای راه‌اندازی دیگری در چند ماه آینده آزمایش می‌شود.

پیش‌نیازها

نسخه‌های یکپارچه‌سازی نمای لحظه‌ای از یکپارچه‌سازی بدون نسخه هستند. این یعنی وقتی طرح آزمایشی برای گواهینامه و درنتیجه نسخه ادغام ایجاد می‌کنید، همه فراداده‌های نمانام مربوط به آن ادغام باید اطلاعاتی باشد که می‌خواهید برای ادغام راه‌اندازی‌شده استفاده کنید.

قبل‌از ایجاد طرح آزمون گواهینامه، مطمئن شوید که موارد زیر را انجام داده‌اید:

  1. نمایه شرکت ایجاد کرده‌اید.
  2. «شناسه فروشنده» تولید (VID) را برای ادغام وارد کردید.
  3. راه‌اندازی و نمانام‌سازی پیکربندی‌شده.

اگر همه این موارد را برای یکپارچه‌سازی خود تکمیل نکرده باشید، نسخه یکپارچه‌سازی ایجادشده برای آزمایش گواهینامه نمی‌تواند گواهینامه دریافت کند. باید نسخه جدیدی ایجاد کنید و از مرحله «آزمایش» دوباره شروع کنید.

همچنین اگر بخواهید نمانام خود را قبل‌از تأیید نسخه یکپارچه‌سازی به‌روز کنید، باید نسخه جدیدی ایجاد کنید و از ابتدا شروع کنید.

ایجاد نسخه جدید

وقتی برای گواهینامه طرح آزمایشی ایجاد می‌کنید، نسخه جدیدی از ادغام ایجاد می‌شود. این نسخه شماره‌دار در همه فهرست‌های یکپارچه‌سازی در Developer Console از برگه «آزمایش» به بعد فهرست شده است.

نسخه‌های جدید هرگز از نسخه‌های شماره‌دار دیگر ایجاد نمی‌شوند. برای مثال، اولین طرح آزمایشی که برای یکپارچه‌سازی ایجاد می‌کنید، نسخه v.1 را برای آن یکپارچه‌سازی ایجاد می‌کند. ایجاد طرح آزمایشی دیگر نسخه v.2 را برای آن ادغام ایجاد خواهد کرد، اما این نسخه براساس v.1 نخواهد بود. درعوض، این نسخه براساس نمونه بدون نسخه یکپارچه‌سازی است، همان‌طور که v.1 بود.

نسخه N/A یکپارچه‌سازی نشان‌دهنده نمونه بدون نسخه یکپارچه‌سازی است که در برگه توسعه مدیریت می‌شود.

به‌عبارت دیگر، در Matter > آزمایش در Developer Console:

  • اگر روی آزمایش برای نسخه N/A از یکپارچه‌سازی کلیک کنید، نسخه جدیدی ایجاد می‌شود. شماره نسخه یک واحد از هر نسخه شماره‌گذاری‌شده موجود بالاتر خواهد بود.
    • اگر نسخه شماره‌گذاری‌شده‌ای وجود نداشته باشد، نسخه v.1 ایجاد می‌شود.
    • اگر نسخه v.1 وجود داشته باشد، نسخه v.2 ایجاد می‌شود. اگر نسخه v.2 وجود داشته باشد، نسخه v.3 ایجاد می‌شود و به همین ترتیب ادامه می‌یابد.
  • اگر روی آزمایش برای نسخه شماره‌دار ادغام (برای مثال، v.1) کلیک کنید، نسخه جدیدی ایجاد نمی‌شود. درعوض، نسخه v.1 دوباره آزمایش می‌شود.

فراداده

وقتی نسخه‌ای ایجاد می‌شود، هر فراداده‌ای که در پیش‌نیازها فهرست شده است و برای ادغام بدون نسخه اضافه شده است به نسخه پیوست می‌شود. بااین‌حال، فراداده پیوست‌شده به یک نسخه قابل مشاهده یا تغییر نیست.

هر تغییری در فراداده یک ادغام در نسخه‌های موجود منعکس نخواهد شد. برای استفاده از فراداده به‌روزرسانی‌شده در «گواهینامه» و «راه‌اندازی»، باید نسخه جدیدی ایجاد شود.

حذف نسخه

نسخه‌های ادغام را نمی‌توان حذف کرد و برای حذف طراحی نشده‌اند. باید به‌روز شوند تا وضعیت یکپارچه‌سازی (طرح آزمایشی جدید یا آزمایش میدانی) را که می‌تواند گواهی شود و راه‌اندازی شود منعکس کنند.

نسخه یک ادغام تنها زمانی از Developer Console برداشته می‌شود که راه‌اندازی شده باشد و بعداً با راه‌اندازی نسخه دیگری جایگزین شود.