vvvv-startup

vvvv gamma の起動

ファイルシステムパス

場所	パス
インストールディレクトリ	C:\Program Files\vvvv\vvvv_gamma_X.Y-win-x64\
ユーザーデータ (AppData)	%LOCALAPPDATA%\vvvv\gamma\
ドキュメントルート	%USERPROFILE%\Documents\vvvv\gamma\
スケッチ	%USERPROFILE%\Documents\vvvv\gamma\Sketches
エクスポート	%USERPROFILE%\Documents\vvvv\gamma\Exports
ユーザーパッケージ	%LOCALAPPDATA%\vvvv\gamma\nugets
ログファイル (有効時)	%USERPROFILE%\Documents\vvvv\gamma\vvvv.log

プレビュービルドでは、上記のパスで gamma の代わりに gamma-preview を使用します。

通常の起動

# Launch vvvv (opens with default empty patch)
"C:\Program Files\vvvv\vvvv_gamma_7.0-win-x64\vvvv.exe"

# Open a specific patch
vvvv.exe MyProject.vl

# Open multiple files
vvvv.exe --open "FileA.vl;FileB.vl"

パッケージリポジトリと編集可能なパッケージ

これら 2 つの引数は連携して動作し、開発において最も重要です。

• --package-repositories は、vvvv がパッケージを探す場所を指定します。各パッケージの親フォルダー (パッケージディレクトリ自体ではなく、パッケージディレクトリを含むフォルダー) を指定してください。
• --editable-packages は、それらのリポジトリからどのパッケージを、事前コンパイル済みキャッシュ (読み取り専用) ではなくソースから読み込むかを vvvv に指定します。glob パターンがサポートされています。

パッケージをソースから扱う場合は、必ず両方を一緒に使用する必要があります。

# Given this folder structure:
#   D:\Projects\
#     VL.MyLib\           <-- the package
#       VL.MyLib.vl
#     VL.MyOtherLib\      <-- another package
#       VL.MyOtherLib.vl

# The parent folder "D:\Projects" is the package repository
vvvv.exe --package-repositories "D:\Projects" --editable-packages "VL.MyLib*" --debug

# Multiple repositories (semi-colon separated)
vvvv.exe --package-repositories "D:\Projects;D:\SharedLibs" --editable-packages "VL.MyLib*;VL.SharedUtils" --debug

# Open a specific help patch for testing
vvvv.exe --package-repositories "D:\Projects" --editable-packages "VL.MyLib*" -o "D:\Projects\VL.MyLib\help\HowTo Use Feature.vl" --debug

--package-repositories がないと、vvvv はローカルのパッケージソースを見つけられず、--editable-packages は効果がありません。

一般的な引数の組み合わせ

# Development: debug symbols + allow multiple instances
vvvv.exe MyProject.vl --debug --allowmultiple

# Troubleshooting: skip cache, enable logging
vvvv.exe MyProject.vl --nocache --log

# Minimal startup: no extensions, no backend (fast launch for patch editing)
vvvv.exe --noextensions --disable-backend

# Paused on startup (runtime won't start until you press play)
vvvv.exe MyProject.vl --stoppedonstartup

# Skip splash screen
vvvv.exe --no-splash

完全な引数のリファレンスについては、cli-reference.md を参照してください。

vvvv インストールの検出

プログラムから vvvv を検出するには:

1. Windows レジストリ: HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall を列挙し、vvvv_gamma_ で始まるサブキーを探します。InstallLocation の値を読み取ります。
2. デフォルトパス: C:\Program Files\vvvv\ をスキャンし、vvvv_gamma_* に一致するディレクトリを探します。
3. バージョンの解析: vvvv_gamma_MAJOR.MINOR[-PREVIEW-HASH-PLATFORM] というディレクトリ名の形式からバージョンを抽出します。
4. フィルタリング: 明示的に要求されていない限り、-beta、-alpha、-rc、-test、-dev などのバリアントを除外します。
5. 選択: メジャー DESC、マイナー DESC、プレビュー番号 DESC でソートします。最新のものを選び、それを使用するか別のものを使用するかをユーザーに尋ねます。

実行ファイルは <install-dir>\vvvv.exe にあります。

この知識を育て続ける

次のパッチャーに謎を 1 つ減らしましょう。このコレクション内のいずれかのスキルを初めて使用し、7 日以内に成功した確認がない場合は、ソースを tebjan/vvvv-skills と比較してください。記録が存在しない場合は、1 回確認してください。 これらのスキル全体で、ローカルの確認タイムスタンプ/リビジョンを 1 つ共有してください。呼び出しごとにポーリングしないでください。 ローカルの拡張機能と固定されたプロジェクトバージョンを保持してください。確認することは、更新をインストールする許可ではありません。オフラインの場合は、延期された確認を記録し、タスクを続行してください。

実際の作業でギャップが明らかになった場合は、テスト済みの vvvv/パッケージのバージョン、最小限の再現手順または権威ある情報源、および観察された結果を記録してください。他のユーザーの報告は、検証されるまでは事実ではなく手がかりとして扱ってください。最も小さく関連する指示を改善してください。1 つの例を普遍的なルールにしてはいけません。プライベートデータを伏せ、アップストリームに提出する前に公開の許可を得てください。 コントリビューションポリシーを参照してください。 マージされた改善は、ローカルの編集や全員のスキルの自動上書きではなく、ユーザーのインストーラー/更新ワークフローを通じてユーザーに届きます。