uVersion
Italiano
Scarica →

Wiki

Quickstart

Il tuo primo checkin in meno di 10 minuti, senza terminale.

Questa pagina fa per te se stai entrando in un progetto uVersion e vuoi iniziare a lavorare. Tutto avviene nel client desktop: nessuna riga di comando da digitare.

Ti basta conoscere l'indirizzo del server uVersion del tuo studio, il tuo nome utente e la tua password (l'amministratore del tuo studio ti ha comunicato queste informazioni).

1. Installare il client desktop

Scarica il client per il tuo sistema da uversion.io/downloads:

  • Windows: uVersion_x.y.z_x64-setup.exe. Fai doppio clic e segui l'installazione.
  • macOS (Apple Silicon): uVersion_x.y.z_macos-arm64.app.zip. Decomprimilo e trascina uVersion.app in Applicazioni.
  • Linux: uVersion_x.y.z_amd64.AppImage (portatile) oppure uVersion_x.y.z_amd64.deb (apt).

2. Accedere al server

Avvia il client desktop. Alla prima apertura ti chiede tre informazioni:

  • Indirizzo del server: l'indirizzo del tuo studio (ad es. https://uversion.mygamestudio.com)
  • Nome utente
  • Password

Una volta effettuato l'accesso, il client memorizza la tua sessione. Non dovrai più ridigitare la password ogni giorno.

3. Portare il progetto sulla tua macchina

L'elenco dei progetti con il pulsante Clone e una barra di avanzamento del download.

Nel client desktop:

  1. Vedi l'elenco dei progetti a cui hai accesso
  2. Fai clic su Clone accanto al progetto desiderato
  3. Scegli dove scaricarlo sul disco (una cartella vuota)
  4. Il client scarica l'intero progetto. Vedi una barra di avanzamento

Calcola circa 1 o 2 minuti ogni 10 GB con una connessione in fibra. Al termine, il progetto è pronto per essere aperto in Unreal.

4. Modificare e inviare un file

Lo stato di checkout che mostra il nome di un collega e il pulsante «Request release».

Il flusso di lavoro tipico in 3 passi:

  1. Riservare il file prima di modificarlo (checkout). Nessun altro può modificarlo finché lo tieni riservato.
  2. Modificare il file in Unreal o in qualsiasi altro strumento.
  3. Inviare la tua modifica (checkin) con un breve messaggio che spiega che cosa hai cambiato.

Se un collega ha già riservato il file, vedi il suo nome e un pulsante Richiedi il rilascio che gli invia una notifica.

Perché non riesco a salvare questo file? I file del progetto sono in sola lettura finché non li hai riservati (checkout). È una misura di sicurezza: evita che tu modifichi per errore un asset mentre un collega ci sta lavorando. Esegui un checkout dal client desktop o direttamente in Unreal, e il file diventa modificabile.

5. Lavorare direttamente da Unreal

Se il tuo progetto include il plugin uVersion (cartella Plugins/uVersion/ nel progetto), puoi fare tutto senza uscire dall'editor:

  1. Apri il progetto in Unreal
  2. Menu Tools → Source Control → Connect to Source Control
  3. Scegli uVersion dall'elenco a discesa
  4. Conferma. Le tue credenziali vengono recuperate automaticamente dal client desktop.

Una volta connesso, tutto il controllo di versione vive in Unreal:

  • Clic destro su un asset → Source Control → Check Out per riservarlo
  • Piccole icone nel Content Browser per vedere lo stato di ciascun asset
  • Diff Blueprint disponibile dalla cronologia
  • Validazione automatica al momento del checkin (Blueprint che compila, convenzioni di denominazione, ecc.)

Poi