Controllo delle versioni dell'integrazione

Il controllo delle versioni consente agli sviluppatori di gestire più versioni di un'integrazione in diverse fasi di sviluppo.

Nella scheda Sviluppa di Google Home Developer Console, le integrazioni sono considerate "senza versione". Una volta avviata la fase di Test di sviluppo nella scheda Test, le integrazioni diventano versionate. Da quel momento in poi, viene utilizzata una versione dell'integrazione per ogni passaggio rimanente del flusso di lavoro, dal test al lancio.

Ad esempio, potresti avere una versione di un'integrazione in fase di certificazione per un lancio imminente, mentre una versione più recente dell'integrazione con funzionalità diverse è in fase di test per un altro lancio tra qualche mese.

Prerequisiti

Le versioni delle integrazioni sono uno snapshot di un'integrazione senza versione. Ciò significa che quando crei un piano di test per la certificazione e quindi una versione dell'integrazione, tutti i metadati di branding relativi a questa integrazione devono essere le informazioni che vuoi utilizzare per l'integrazione lanciata.

Prima di creare un piano di test di certificazione, assicurati di aver fatto quanto segue:

  1. Crea un profilo aziendale.
  2. Inserisci l'ID fornitore (VID) di produzione per l'integrazione.
  3. Configura la configurazione e il branding.

Se non hai completato tutti questi passaggi per la tua integrazione, una versione dell'integrazione creata per i test di certificazione non può essere certificata. Dovrai creare una nuova versione e ricominciare dal passaggio Test.

Dovrai anche creare una nuova versione e ricominciare se vuoi aggiornare il tuo branding prima che una versione dell'integrazione venga certificata.

Creare una nuova versione

Quando crei un piano di test per la certificazione, viene creata una nuova versione dell'integrazione. Questa versione numerata è elencata in tutti gli elenchi di integrazioni in Developer Console a partire dalla scheda Test.

Le nuove versioni non vengono mai create da altre versioni numerate. Ad esempio, il primo piano di test che crei per un'integrazione creerà la versione v.1 per questa integrazione. La creazione di un altro piano di test creerà la versione v.2 per questa integrazione, ma questa versione non sarà basata su v.1. Questa versione si basa invece sull'istanza senza versione dell'integrazione, proprio come v.1.

La versione N/A di un'integrazione rappresenta l'istanza senza versione dell'integrazione, gestita nella scheda Sviluppa.

In altre parole, in Matter > Test in the Developer Console:

  • Se fai clic su Test per la versione N/A dell'integrazione, viene creata una nuova versione. Il numero di versione sarà superiore di uno rispetto a qualsiasi versione numerata esistente.
    • Se non esistono versioni numerate, viene creata la versione v.1.
    • Se esiste la versione v.1, viene creata la versione v.2. Se esiste la versione v.2 , viene creata la versione v.3 e così via.
  • Se fai clic su Test per una versione numerata dell'integrazione (ad esempio, v.1), non viene creata una nuova versione. Viene invece eseguito di nuovo il test della versione v.1.

Metadati

Quando viene creata una versione, tutti i metadati elencati nei prerequisiti che sono stati aggiunti per l'integrazione senza versione vengono allegati alla versione. Tuttavia, i metadati allegati a una versione non possono essere visualizzati o modificati.

Eventuali modifiche ai metadati di un'integrazione non verranno applicate alle versioni esistenti. È necessario creare una nuova versione per utilizzare i metadati aggiornati per la certificazione e il lancio.

Eliminare una versione

Le versioni delle integrazioni non possono essere eliminate e non sono progettate per essere eliminate. Devono essere aggiornate per riflettere uno stato dell'integrazione (nuovo piano di test o prova sul campo) che può essere certificato e lanciato.

Una versione dell'integrazione viene rimossa dal Developer Console solo quando è stata lanciata e viene sostituita dal lancio di una versione diversa.