Sviluppatori

Tutto è scriptabile.
Tutto è integrabile.

uVersion offre un CLI completo, un'API REST documentata e plugin nativi per gli IDE usati nel gamedev. Se scrivi la tua pipeline, ci integriamo.

CLI `uversion`

Il binario uversion.exe (~6 MB) copre tutte le operazioni VCS ed espone un output --json da analizzare da qualsiasi script.

Le credenziali sono condivise con il client desktop tramite il keyring di sistema, senza doppio login. Il chunking CDC, la compressione zstd e il tracciamento di .uversionignore sono identici al client desktop.

Riferimento completo del CLI →

# Login + clone + checkin

$ uversion login https://team.uversion.io --username alex.dev

✓ Authenticated as alex.dev

$ uversion clone hero-rpg ./HeroRPG

Cloning to ./HeroRPG ...

✓ 8,432 files in 47s

$ uversion checkout Content/Characters/Hero.uasset

✓ Lock acquired

$ uversion checkin -m "Hero pose pass"

✓ Committed as 7f3a9b1

Plugin per editor

Integrazione nativa negli IDE usati per lo sviluppo Unreal.

Plugin Unreal Engine

Disponibile

Source Control Provider integrato nell'editor. UE 5.6 e successivi. Distribuito come binario precompilato: il client desktop lo installa per te nel progetto e ti segnala gli aggiornamenti, per versione di Unreal e per piattaforma. Nessuno ZIP da estrarre.

Checkout / Checkin / Revert dal Content Browser
Diff visivo dei Blueprint integrato
Validazione prima del checkin con 10 regole integrate
Auto-checkout alla modifica
Auto-login tramite Windows Credential Manager
Reconcile all'avvio (Content/ + Plugins/*/Content/)

Documentazione →

Plugin Rider

Disponibile

Integrazione VCS per JetBrains Rider, l'IDE di riferimento dello sviluppo di giochi Unreal.

Refresh / Update / Checkin / Revert dal menu VCS
Delega al CLI uversion sotto il cofano
Filtra per estensioni sorgente (.cpp, .h, .cs, .uproject)
Autenticazione condivisa con il client desktop

Plugin Visual Studio

Coming soon

Integrazione VCS in Visual Studio 2022+ per gli sviluppatori C++ che restano sull'IDE Microsoft. Le stesse funzioni del plugin Rider, esposte nel menu Team Explorer.

Extension VS Code

Coming soon

Estensione VS Code per lo scripting, la modifica della configurazione e la scrittura della documentazione di progetto senza lasciare l'editor. Icone di stato nell'explorer, checkout / checkin dalla palette dei comandi.

API REST

Il server uVersion espone un'API HTTP JSON autenticata tramite JWT. Tutte le operazioni del client (auth, repos, files, locks, comments, builds) sono disponibili via REST.

POST /api/auth/login: ottieni un JWT di 30 giorni
POST /api/auth/refresh: rinnova senza reinserire la password
GET /api/repositories: elenca i repository accessibili
POST /api/files/{repo_id}/upload-chunks: upload binario a chunk
POST /api/locks/{repo_id}/acquire: bloccare i file
POST /api/builds/{repo_id}/upload: pubblicare una build di playtest

Riferimento completo dell'API →

# Ottieni l'elenco dei repository

curl -X GET https://team.uversion.io/api/repositories \
  -H "Authorization: Bearer $UV_TOKEN"

# Risposta

{
  "success": true,
  "data": [
    {
      "id": 12,
      "name": "hero-rpg",
      "owner": "acme",
      "current_revision": "7f3a9b1...",
      "file_count": 8432,
      "size_bytes": 14211938405
    }
  ]
}

CI/CD

Il CLI uversion è pensato per le pipeline automatizzate. Modalità --json, codici di ritorno standard, JWT a lunga durata (30 giorni) rinnovabile senza reinserire la password.

# .github/workflows/build.yml

name: Nightly build
on:
  schedule: [{ cron: '0 2 * * *' }]
jobs:
  build:
    runs-on: [self-hosted, unreal]
    steps:
      - name: Login + sync from uVersion
        env:
          UV_SERVER: ${{ secrets.UV_SERVER }}
          UV_USER: ${{ secrets.UV_USER }}
          UV_PASSWORD: ${{ secrets.UV_PASSWORD }}
        run: |
          uversion login "$UV_SERVER" --username "$UV_USER" --password "$UV_PASSWORD" --json
          uversion clone hero-rpg ./project --json
          uversion sync --json
      - name: Build packaged client
        run: |
          ./project/Engine/Build/BatchFiles/RunUAT.bat \
            BuildCookRun -project=./project/HeroRPG.uproject \
            -clientconfig=Development -platform=Win64

Affidabile e veloce

Binario server nativo, client desktop leggero (pochi MB, apertura istantanea), upload e download massicciamente parallelizzati per i file di grandi dimensioni. Autenticazione JWT, password con hash secondo gli standard, audit completo delle azioni sensibili. Server sulla tua infrastruttura con TLS autofirmato: il client fissa l'impronta al primo contatto (TOFU), uversion trust per automatizzare la fiducia in CI.

Immergiti nella documentazione.

Leggi il wiki Riferimento CLI

Tutto è scriptabile.Tutto è integrabile.

CLI uversion