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 in Google Home Developer Console, le integrazioni sono considerate "senza versione". Una volta avviata la fase di test dello sviluppo nella scheda Test, viene eseguito il controllo delle versioni delle integrazioni. 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 qualche mese dopo.

Prerequisiti

Le versioni dell'integrazione sono uno snapshot di un'integrazione senza versione. Ciò significa che quando crei un piano di test per la certificazione, e quindi una versione di 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 della certificazione, assicurati di aver eseguito le seguenti operazioni:

  1. Hai creato un profilo aziendale.
  2. Inserisci l'ID fornitore di produzione (VID) per l'integrazione.
  3. Configurazione e branding configurati.

Se non hai completato tutte queste operazioni per l'integrazione, non può essere certificata una versione dell'integrazione creata per i test di certificazione. 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 tuo branding prima che una versione di 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 creato per un'integrazione creerà la versione v.1 per quell'integrazione. La creazione di un altro piano di test creerà la versione v.2 per l'integrazione, ma questa versione non sarà basata sulla v.1. Questa versione si basa invece sull'istanza senza versione dell'integrazione, come in 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, su Matter > Test nella Developer Console:

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

Metadati

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

Eventuali modifiche ai metadati di un'integrazione non si rifletteranno nelle versioni esistenti. È necessario creare una nuova versione per utilizzare i metadati aggiornati 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 aggiornate in modo da riflettere lo stato dell'integrazione (nuovo piano di test o prova sul campo) che può essere certificata e avviata.

Una versione dell'integrazione viene rimossa da Developer Console solo quando viene avviata e sostituita in un secondo momento dal lancio di un'altra versione.