Wiki
Quickstart
10分以内で最初のcheckinを、ターミナル不要で。
このページは、uVersionのプロジェクトに参加して作業を始めたい方のためのものです。 すべてはデスクトップクライアント上で完結し、コマンドラインを入力する必要はありません。
必要なのは、スタジオのuVersionサーバーのアドレス、ユーザー名、 そしてパスワードだけです(これらの情報はスタジオの管理者から伝えられています)。
1. デスクトップクライアントのインストール
お使いのシステム用のクライアントを uversion.io/downloads からダウンロードします。
- Windows:
uVersion_x.y.z_x64-setup.exe。ダブルクリックしてインストーラーに従ってください。 - macOS (Apple Silicon):
uVersion_x.y.z_macos-arm64.app.zip。解凍して、uVersion.appを アプリケーション にドラッグします。 - Linux:
uVersion_x.y.z_amd64.AppImage(ポータブル)またはuVersion_x.y.z_amd64.deb(apt)。
2. サーバーへのサインイン
デスクトップクライアントを起動します。初回起動時に、次の3つの情報を求められます。
- サーバーアドレス:スタジオのアドレス(例:
https://uversion.mygamestudio.com) - ユーザー名
- パスワード
一度サインインすると、クライアントがセッションを記憶します。日々の作業でパスワードを 再入力する必要はありません。
3. プロジェクトを自分のマシンに取得する
デスクトップクライアントで:
- アクセス権のあるプロジェクトの一覧が表示されます
- 目的のプロジェクトの横にある Clone をクリックします
- ディスク上のダウンロード先(空のフォルダー)を選びます
- クライアントがプロジェクト全体をダウンロードします。進捗バーが表示されます
光回線であれば、おおよそ 10 GBあたり1〜2分 を見込んでください。 完了すると、プロジェクトはUnrealで開ける状態になります。
4. ファイルを編集して送信する
典型的な3ステップのワークフロー:
- 編集する前にファイルを予約する(checkout)。予約している間は他の人が変更できません。
- Unrealまたは他の任意のツールでファイルを編集する。
- 変更内容を説明する短いメッセージを添えて、変更を送信する(checkin)。
チームメンバーがすでにファイルを予約している場合は、その名前と、相手に通知を送る 解放をリクエスト ボタンが表示されます。
このファイルを保存できないのはなぜ?
プロジェクトのファイルは、予約する(checkout)まで読み取り専用です。
これは安全対策で、チームメンバーが作業中のassetを誤って編集してしまうのを防ぎます。
デスクトップクライアントから、またはUnrealで直接checkoutすれば、
ファイルが編集可能になります。
5. Unrealから直接作業する
プロジェクトにuVersionプラグイン(プロジェクト内の Plugins/uVersion/ フォルダー)が含まれている場合、
エディターを離れることなくすべての操作ができます。
- Unrealでプロジェクトを開きます
- メニュー Tools → Source Control → Connect to Source Control
- ドロップダウンから uVersion を選びます
- 確定します。認証情報はデスクトップクライアントから自動的に取得されます。
接続すると、すべてのソース管理がUnreal内で行えます。
- assetを右クリック → Source Control → Check Out で予約する
- Content Browserの小さなアイコンで各assetの状態を確認できる
- 履歴からBlueprintのdiffを利用できる
- checkin時に自動検証(Blueprintのコンパイル、命名規則など)
次のステップ
- デスクトップクライアントのすべての機能を見る
- プロジェクトに Unreal Engineプラグイン をインストールする