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 Sviluppo di Google Home Developer Console, le integrazioni sono considerate "senza versione". Una volta avviata la fase di test dello sviluppo nella scheda Test, le integrazioni vengono sottoposte al controllo delle versioni. 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 verrà testata per un altro lancio a partire da qualche mese.

Prerequisiti

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

Prima di creare un piano di test di certificazione, assicurati di:

  1. Creazione di un profilo dell'azienda.
  2. È stato inserito l'ID fornitore (VID) di produzione per l'integrazione.
  3. Configurazione e branding configurati.

Se non hai completato tutte queste operazioni per l'integrazione, una versione dell'integrazione creata per i test di certificazione non può essere certificata. Dovrai creare una nuova versione e ricominciare dal passaggio di test.

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

Crea 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 integrazione 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 l'integrazione in questione. La creazione di un altro piano di test creerà la versione v.2 per l'integrazione, che però non sarà basata sulla v.1. Questa versione si basa invece sull'istanza senza versione dell'integrazione, come era la versione v.1.

La versione N/D di un'integrazione rappresenta l'istanza senza versione dell'integrazione, che viene gestita nella scheda Sviluppo.

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

  • Se fai clic su Test per la versione N/A dell'integrazione, viene creata una nuova versione. Il numero di versione sarà di uno superiore 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 testata di nuovo la versione v.1.

Metadati

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

Qualsiasi modifica ai metadati di un'integrazione non si rifletterà nelle versioni esistenti. È necessario creare una nuova versione per i metadati aggiornati da utilizzare per la certificazione e il lancio.

Eliminare una versione

Le versioni dell'integrazione non possono essere eliminate e non sono progettate per essere eliminate. Devono essere aggiornati 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 da Developer Console solo dopo essere stata avviata e successivamente sostituita dal lancio di una versione diversa.