uVersion
Türkçe
İndir →

Geliştiriciler

Her şey betiklenebilir.
Her şey entegre edilebilir.

uVersion eksiksiz bir CLI, belgelenmiş bir REST API ve oyun geliştirmede kullanılan IDE'ler için yerel eklentiler sunar. Pipeline'ınızı kodla kuruyorsanız, ona entegre oluruz.

CLI uversion

uversion.exe ikili dosyası (~6 MB) tüm VCS işlemlerini kapsar ve herhangi bir betikten ayrıştırılabilen bir --json çıktısı sunar.

Kimlik bilgileri sistem keyring'i üzerinden masaüstü istemcisiyle paylaşılır, çift giriş yok. CDC chunking, zstd sıkıştırma ve .uversionignore takibi masaüstü istemcisiyle birebir aynıdır.

Tam CLI referansı →
# 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

Editör eklentileri

Unreal geliştirmede kullanılan IDE'lere yerel entegrasyon.

Plugin Unreal Engine

Mevcut

Editöre entegre Source Control Provider. UE 5.6 ve üzeri. Önceden derlenmiş ikili olarak dağıtılır: masaüstü istemcisi onu sizin için projeye kurar ve güncellemeleri Unreal sürümüne ve platforma göre bildirir. Çıkarılacak ZIP yok.

  • Content Browser'dan Checkout / Checkin / Revert
  • Yerleşik görsel Blueprint diff
  • 10 yerleşik kuralla checkin öncesi doğrulama
  • Değişiklikte otomatik Checkout
  • Windows Credential Manager ile otomatik giriş
  • Başlangıçta Reconcile (Content/ + Plugins/*/Content/)
Belgeler →

Plugin Rider

Mevcut

Unreal oyun geliştirmenin referans IDE'si JetBrains Rider için VCS entegrasyonu.

  • VCS menüsünden Refresh / Update / Checkin / Revert
  • Arka planda uversion CLI'ye devreder
  • Kaynak uzantılarına göre filtreler (.cpp, .h, .cs, .uproject)
  • Masaüstü istemcisiyle kimlik doğrulama paylaşımı

Plugin Visual Studio

Coming soon

Microsoft IDE'sinde kalan C++ geliştiricileri için Visual Studio 2022+ VCS entegrasyonu. Rider eklentisiyle aynı işlevler, Team Explorer menüsünde sunulur.

Extension VS Code

Coming soon

Editörden çıkmadan betik yazma, yapılandırma düzenleme ve proje belgelerini yazma için VS Code eklentisi. Gezginde durum simgeleri, komut paletinden checkout / checkin.

API REST

uVersion sunucusu JWT ile kimliği doğrulanan bir JSON HTTP API sunar. İstemcinin tüm işlemleri (auth, repos, files, locks, comments, builds) REST üzerinden kullanılabilir.

  • POST /api/auth/login: 30 günlük bir JWT alır
  • POST /api/auth/refresh: parolayı yeniden girmeden yeniler
  • GET /api/repositories: erişilebilir depoları listeler
  • POST /api/files/{repo_id}/upload-chunks: parçalı ikili yükleme
  • POST /api/locks/{repo_id}/acquire: dosyaları kilitler
  • POST /api/builds/{repo_id}/upload: bir playtest yapısı yayınlar
Tam API referansı →
# Depo listesini al
curl -X GET https://team.uversion.io/api/repositories \
  -H "Authorization: Bearer $UV_TOKEN"
# Yanıt
{
  "success": true,
  "data": [
    {
      "id": 12,
      "name": "hero-rpg",
      "owner": "acme",
      "current_revision": "7f3a9b1...",
      "file_count": 8432,
      "size_bytes": 14211938405
    }
  ]
}

CI/CD

uversion CLI otomatik pipeline'lar için tasarlandı. --json modu, standart dönüş kodları, parolayı yeniden girmeden yenilenebilen uzun ömürlü JWT (30 gün).

# .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

Güvenilir ve hızlı

Yerel sunucu ikilisi, hafif masaüstü istemcisi (birkaç MB, anında açılır), büyük dosyalar için yoğun paralelleştirilmiş yükleme ve indirme. JWT kimlik doğrulama, standartlara göre hash'lenmiş parolalar, hassas işlemlerin tam denetimi. Kendi altyapınızdaki sunucu kendinden imzalı TLS ile çalışır: istemci ilk temasta parmak izini sabitler (TOFU), CI'da güveni betiklemek için uversion trust.

Belgelere dalın.