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

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

در برگه توسعه در 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 برداشته می‌شود که راه‌اندازی شده باشد و بعداً با راه‌اندازی نسخه دیگری جایگزین شود.