Per ottimizzare la gestione delle risorse in tutto il team o su più progetti, è possibile convertire singole risorse o gerarchie di risorse in pacchetti e riutilizzarli in più esperienze. Quando un pacchetto viene aggiornato, tu o i membri del tuo team potete aggiornare copie specifiche alla versione più recente, aggiornare tutte le copie all'interno di un'esperienza o impostare copie specifiche per l'aggiornamento automatico. I pacchetti includono inoltre un meccanismo di configurazione che consente ai creatori e agli editori di pacchetti di includere opzioni per personalizzare il comportamento di un pacchetto.
Creazione di pacchetti
Un pacchetto può essere creato da qualsiasi nodo o nodo radice sottoalbero nel modello di dati.
Nella finestra Explorer, fai clic con il pulsante destro del mouse sull'oggetto/nodo desiderato e seleziona Converti in pacchetto dal menu contestuale.
Nella finestra di dialogo, compila i dettagli richiesti. In particolare, se si lavora in una group, set Proprietà al gruppo desiderato in cui si ha l'autorizzazione per creare/modificare le esperienze di gruppo.
I trasferimenti di Proprietà non sono supportati dal sistema risorse, quindi considera attentamente il proprietario quando crei un pacchetto.Fai clic sul pulsante Invia.
Una volta completato, il pacchetto è identificato da un simbolo "collegamento a catena" sopra l'icona dell'oggetto. Inoltre, sarà visibile un nuovo oggetto PackageLink principale dell'oggetto.
L'oggetto PackageLink oggetto non deve essere cancellato o riparato. In questo modo per qualsiasi copia di un pacchetto si interrompe l'associazione con la versione pubblicata e si converte la copia in un oggetto normale.
Inserimento di pacchetti
Per inserire un pacchetto che non esiste già nel posto attuale, devi inizialmente inserirlo dal Pannello degli strumenti sotto queste linee guida:
- Da Creazioni → Pacchetti di gruppo per i pacchetti pubblicati dai membri del tuo gruppo (incluso te stesso).
Una volta inserito un pacchetto nel modello dati di un'ubicazione, esso appare nella cartella Pacchetti dell'Asset Manager e resta lì anche se in seguito ne elimini tutte le copie. Tuttavia, quando si pubblica l'ubicazione, la cartella verrà aggiornata per riflettere solo i pacchetti utilizzati all'interno dell'ubicazione stessa.
Modifica pacchetti
Si possono modificare i pacchetti e i loro secondari proprio come per gli altri oggetti. Nella prima modifica che cambia un'istanza del pacchetto, viene visualizzata una finestra di avviso, che fornisce una notifica specifica che un pacchetto modificato non può essere aggiornato con qualsiasi mezzo e deve essere ripristinato per annullare una serie di modifiche.
La maggior parte delle modifiche contrassegnerà il pacchetto come modificato, anche se le seguenti modifiche non sono considerate modifiche del pacchetto:
| Modifica | Modifica pacchetto |
|---|---|
| Modifica del nome del nodo radice. | No |
| Modifica della posizione o rotazione del nodo radice di un pacchetto che è BasePart, Model o GuiObject. | No |
| Modifica della proprietà Attivata di un nodo radice GuiObject come ScreenGui, SurfaceGui o BillboardGui. | No |
| Modifica di un riferimento parziale di un Weld all'interno del pacchetto che fa riferimento a un'instanza eterna al pacchetto stesso. | No |
Una volta modificati, i pacchetti con modifiche non pubblicate vengono contrassegnati con un pallino giallo nella struttura gerarchica di Explorer.
Aggiunta o aggiornamento delle configurazioni
È possibile includere gli attributi di istanza nella radice di un pacchetto per personalizzarne il comportamento, ad esempio la velocità massimo di un veicolo impacchettato o il tempo di debounce per un pulsante impacchettato.
Quando pubblichi un pacchetto, l'attuale set di attributi/valori diventerà la configurazione predefinita del pacchetto stesso. Su una determinata copia di un pacchetto, le configurazioni sono mostrate in corsivo grassetto e i valori di tali attributi possono essere modificati per istanza. Quando le copie dei pacchetti vengono aggiornate, si mantengono i valori di configurazione modificati, mentre altri attributi verranno aggiornati all'ultimo valore predefinito.
Attualmente, l'unico modo per gestire i valori di configurazione è aggiungere script nel pacchetto che leggono e applicano il comportamento in base alla configurazione nel tempo di esecuzione.
Se si desidera semplicemente aggiornare i **valori ** predefiniti per le configurazioni, è possibile modificarli e ripubblicare il pacchetto (in questo caso, il pacchetto non sarà contrassegnato come modificato). Se si desidera pubblicare altre modifiche, ma non modificare i valori di configurazione predefiniti, è necessario pubblicare su un pacchetto senza alcuna modifica del valore o ripristinare le configurazioni predefinite prima di pubblicarle.
Pacchetti annidati
È possibile annidare i pacchetti all'interno di altri pacchetti per mantenere e intervenire su gerarchie complesse, come una serie di sistemi meccanici di un veicolo che può essere modificata indipendentemente dal pacchetto principale del veicolo.
Se modifichi un pacchetto annidato, sia il pacchetto annidato che il pacchetto principale vengono considerati come modificati. È necessario pubblicare le modifiche a qualsiasi pacchetto annidato prima di poter pubblicare le modifiche al relativo pacchetto principale, poiché la pubblicazione del pacchetto principale lo contrassegnerebbe come corrente/non modificato e quindi in conflitto con le modifiche del pacchetto annidato.
Script del pacchetto
Ogni script all'interno di un pacchetto non modificato è di sola lettura e mostra una notifica in alto con un collegamento ipertestuale per sbloccare lo script.
Facendo clic sul collegamento ipertestuale:
- Contrassegna il pacchetto come modificato indipendentemente dal fatto che lo script venga modificato.
- Rimuove la notifica/il collegamento ipertestuale da altri script all'interno del pacchetto.
Una volta che il pacchetto viene pubblicato e spostato in uno stato non modificato, gli script sotto di esso diventano di sola lettura con un collegamento ipertestuale da modificare.
Pubblicazione delle modifiche al pacchetto
È possibile pubblicare un pacchetto modificato (contrassegnato con un pallino giallo) per rendere tali modifiche disponibili ad altre copie del pacchetto in tutta l'ubicazione e in tutte le esperienze. Notare che non è necessario pubblicare un pacchetto modificato prima di pubblicare un'ubicazione (la versione modificata verrà salvata insieme all'ubicazione per l'iterazione futura).
Per pubblicare le modifiche a un pacchetto:
Nella finestra di Explorer, fai clic con il pulsante destro del mouse sulla copia modificata (contrassegnata con un pallino giallo) e seleziona Pubblica su pacchetto.
Per le copie dei pacchetti impostate per l'aggiornamento automatico, Studio attiverà immediatamente la versione aggiornata. Altre copie saranno contrassegnate da un'icona di sincronizzazione verde accanto al nome e potrai aggiornarle individualmente o in gruppo in base alle necessità.
Aggiornamento delle copie obsolete
È possibile aggiornare le copie obsolete dei pacchetti alla versione più recente oppure continuare a utilizzare la versione precedente.
Per aggiornare una o più copie del pacchetto all'ultima versione:
Nella finestra di Explorer, individua le copie obsolete grazie all'icona verde di sincronizzazione posta accanto al loro nome.
Fai clic con il pulsante destro del mouse su una singola copia obsoleta e seleziona Ottieni il pacchetto più recente dal menu contestuale oppure seleziona più copie (almeno una di esse modificata), fai clic con il pulsante destro del mouse e seleziona Ottieni l'ultima versione per i pacchetti selezionati.
L'opzione di menu Ottieni l'ultimo [] è disattivata se una delle copie del pacchetto è stata modificata. Se stai lavorando su una serie di modifiche non pubblicate, dovrai ripristinarle prima di poter recuperare l'ultima versione.
Aggiornamenti di gruppo
L'uso estensivo di pacchetti può portare a molte copie di pacchetti in più ubicazioni in un'unica esperienza. Oltre alla sincronizzazione individuale e agli aggiornamenti automatici, è possibile aggiornare tutte le copie di un pacchetto tramite l'aggiornamento di gruppo.
(Consigliato) Chiudi altre istanze su Studio con una qualsiasi delle ubicazioni aperte dell'esperienza; questo impedisce ad un'altra istanza non salvata di un'ubicazione di sovrascrivere potenzialmente i tuoi aggiornamenti.
Nella finestra di Explorer, fai clic con il pulsante destro del mouse sul pacchetto desiderato e seleziona Aggiorna tutto dal menu contestuale.
Nella finestra pop-up, sotto i dettagli relativi alla versione/data, spunta Tutti per selezionare tutte le ubicazioni dell'esperienza o seleziona solo quelle specifiche in cui applicare l'aggiornamento di gruppo.
Fai clic sul tasto Aggiorna.
L'aggiornamento di gruppo dei pacchetti automaticamente salva le ubicazioni selezionate ma non le pubblica, quindi è necessario pubblicare separatamente per vedere le modifiche.
Al fine di evitare sovrascritture involontarie, l'aggiornamento di gruppo non influisce sulle ](#modifying-packages)versioni [modificate di un pacchetto, ma Studio notificherà il numero di pacchetti non aggiornati attraverso il processo.
Aggiornamenti automatici
Per facilitare la sincronizzazione, è possibile abilitare una copia del pacchetto all'aggiornamento automatico ogni volta che viene pubblicata una versione più recente e quando esiste all'interno di una sessione Studio aperta.
Nella finestra di Explorer, espandi la struttura gerarchica e seleziona l'oggetto PackageLink.
Nella finestra Proprietà, attiva la proprietà AutoAggiornamento. Questa proprietà si applica solo al pacchetto principale di livello più alto in una gerarchia di pacchetti annidati, il che significa che gli aggiornamenti automatici si verificano solo quando viene aggiornato il pacchetto principale.
L'aggiornamento automatico non si applica alle copie modificate dei pacchetti. Una volta modificata un'istanza del pacchetto, la proprietà di AutoAggiornamento si disattiva e viene ignorata.
Condivisione e livelli di accesso
Se lo si desidera, è possibile condividere i pacchetti con gli amici o concedere l'accesso a ruoli utente specifici all'interno del gruppo.
Su Explorer, Pannello degli strumenti o Manager risorse, fai clic con il pulsante destro del mouse sul pacchetto desiderato e seleziona Dettagli pacchetto dal menu contestuale.
Nella finestra pop-up, seleziona Autorizzazioni nella colonna di sinistra per rivelare le opzioni di condivisione/accesso per i pacchetti di proprietà del gruppo o di proprietà dell'utente.
Per un pacchetto di proprietà del gruppo, espandi l'albero dei ruoli facendo clic su›accanto all'icona del gruppo, quindi scegli un livello di autorizzazione per ciascun ruolo. Le caselle di selezione scolorite/disattivate indicano che l'autorizzazione è già configurata per quel ruolo e non può essere modificata da questa finestra.
Autorizzazioni Descrizione Modifica I membri del ruolo saranno in grado di utilizzare, visualizzare e modificare le versioni dei pacchetti attuali e precedenti, incluse le modifiche apportate. La concessione dell'accesso alla modifica di un ruolo da questa finestra consente solo l'accesso al pacchetto specifico. Nessun accesso I membri del ruolo non avranno accesso ad alcuna nuova versione del pacchetto, anche se manterranno l'accesso alle versioni attuali e precedenti. Per un pacchetto di proprietà dell'utente, cerca un amico attraverso il campo di ricerca, fai clic sul suo avatar/nome utente e scegli un livello di autorizzazione.
Autorizzazioni Descrizione Utilizza e visualizza L'utente potrà utilizzare e visualizzare (ma non modificare) le versioni dei pacchetti attuali e precedenti. Una volta fornita a un utente questa capacità, non è possibile revocare l'accesso a una copia già inserita nella propria esperienza; la revoca dell'accesso impedirà il reinserimento o l'aggiornamento dei pacchetti, ma le copie dei pacchetti nel loro modello di dati rimarranno intatte. Modifica L'utente sarà in grado di utilizzare, visualizzare e modificare le versioni dei pacchetti attuali e precedenti, incluse le modifiche alla pubblicazione.
Annullare le modifiche del pacchetto
Invece di annullare un'intera serie di modifiche a un pacchetto, è possibile ripristinare le modifiche non pubblicate in un'azione, ripristinare un pacchetto a una versione precedente o ripristinare le modifiche a configurazioni specifiche.
Ripristino delle modifiche non pubblicate
Per annullare un'intera serie di modifiche non pubblicate:
Nella finestra di Explorer, individua le copie modificate con il pallino giallo accanto al loro nome.
Fai clic con il pulsante destro del mouse su una singola copia modificata e seleziona Annulla le modifiche al pacchetto dal menu contestuale oppure seleziona più copie (almeno una di esse modificata), fai clic con il pulsante destro del mouse e seleziona Annulla le modifiche ai pacchetti selezionati.
Ripristino della versione
Per ripristinare un pacchetto a una versione pubblicata in precedenza:
Su Explorer, Pannello degli strumenti o Manager risorse, fai clic con il pulsante destro del mouse sul pacchetto desiderato e seleziona Dettagli pacchetto dal menu contestuale.
Nella finestra pop-up, seleziona Versioni nella colonna di sinistra. La versione attualmente pubblicata e le versioni precedentemente pubblicate appaiono (V1, V2, ...) insieme alla data/all'ora in cui sono state pubblicate.
Fai clic sul segno di spunta accanto alla versione che desideri ripristinare e fai clic su Invia.
Il ripristino delle modifiche a un pacchetto non ripristina la configurazione predefinita. Vedi Ripristino della configurazione.
Ripristino delle configurazioni
Per ripristinare qualsiasi attributo di configurazione predefinito, seleziona l'opzione Reimposta dal menu ingranaggi nella sezione Attributi della finestra Proprietà.
Confronto delle modifiche allo script
Quando un oggetto pacchetto contiene script, o lo script stesso è un pacchetto, è possibile confrontare le differenze linea per linea utilizzando lo strumento di differenze integrato. Questo può aiutare a decidere se aggiornare così come esplorare cos'altro nell'esperienza può avere bisogno di modifiche per rendere l'aggiornamento compatibile.
Per confrontare le modifiche allo script:
Nella finestra Explorer, fai clic con il pulsante destro del mouse su un pacchetto modificato od obsoleto. Ricorda che il pacchetto deve essere uno script o contenere script.
Seleziona Visualizza modifiche script dal menu contestuale.
Nella scheda Risultato differenze che si aprirà, confronta tutte le modifiche tra la copia del pacchetto attuale e l'ultima versione pubblicata o locale, simile alle applicazioni di controllo sorgente.
In questo esempio di confronto, il print()comando sulla riga 1 è stato modificato. La riga evidenziata in rosso mostra la riga 1 così come esiste nella copia dello script obsoleta, mentre la riga verde immediatamente seguente mostra la riga 1 come esiste nel pacchetto di script pubblicato. Inoltre, due nuove righe sono state aggiunte al pacchetto script pubblicato: una pausa vuota sulla linea 2 e un nuovo print()comando sulla riga 3 .
