Windows のローカルファイルと旧 WSL プロジェクト
Windows のプロジェクトフォルダーを開き、保存済みファイルを移動する際は旧 WSL プロジェクトを保持します。
Windows 版 Digital Design Studio 2.1.2.3 では、このPC → このPCのプロジェクト → プロジェクトフォルダーを開く からこの PC に保存されたフォルダーを開きます。以下の旧 WSL セクションでは、以前のインストール環境での復旧について説明します。検証済みのコピーを準備する間は、元のディストリビューションと保存済みファイルを保持してください。
既存プロジェクトを保持して移行する
復旧と検証済みのエクスポート・コピーが完了するまで、元のディストリビューション、ファイル、Git データ、未保存の作業を保持してください。ハッシュ、大文字と小文字を区別する名前、衝突、リンク、移動先の所有者を確認します。未解決のトランザクションは、元の所有者が復旧する必要があります。Linux の inode・UID 識別情報、ライセンス・デバイスの信頼、署名済み実行の適合確認、トランザクションジャーナルは、Windows や Cloud の権限にはなりません。ディストリビューションを削除したり、WSL パスを知らせずに Windows ルートとして開いたりしないでください。
旧方式:正しいプロジェクトの場所を選ぶ
WSL プロジェクトは、ソースと Linux エンジンの作業を、選択したディストリビューションの Linux ファイルシステム内に保持します。Windows アプリはウィンドウ、エディター、接続を提供します。Windows ローカルプロジェクトは別のアダプターを使用します。編集前に、ホストを意識して選択してください。
root ではない既定ユーザーを持つ、既存の x86-64 Ubuntu 24.04 WSL2 ディストリビューションを使用します。プロジェクトは Linux ユーザーのディレクトリ内、例えば /home/your-user/projects/demo に置いてください。/mnt/c やネットワーク共有は、この Linux ワークスペースの契約を満たしません。
旧方式:確認して接続する
PowerShell
wsl --list --verbose
目的のディストリビューションが WSL バージョン 2 として一覧に表示されることを確認します。アプリのプロジェクト接続は、ディストリビューションをインストールしません。
Windows アプリから、例えば
\\wsl.localhost\Ubuntu-24.04\home\your-user\projects\demoのような WSL プロジェクトパスを使って Linux プロジェクトを選択します。インストール済みアプリがバックエンドの準備を提供する場合は、その内容を確認し、対応する同梱バックエンドを使用してください。手動で差し替えたヘルパーは、互換性がない場合があります。
ディストリビューション、ユーザー、プロジェクトルート、接続状態を確認します。トランザクションやエンジン実行の前に、小さいテキストファイルを 1 つ開いて保存してください。
旧方式:ファイル、Git、エンジン
保存済みテキスト、プロジェクト設定、対応するソース管理操作は、Linux ワークスペースを通じて実行されます。ファイルの書き込みでは保存済みリビジョンを確認します。WSL をバックエンドとする Git の読み取り・編集は、そのプロジェクトの Linux Git を使用します。ワークスペースに接続しても、すべてのエンジン、バイナリビューアー、リモート Git 転送が有効になるわけではありません。インストール済みホストに表示される操作を確認してください。
旧方式:変更後に再接続する
変更またはメッセージ | 復旧方法 |
|---|---|
WSL が再起動した | 未保存のテキストを保持し、明示的に再接続して、保存前にファイルを読み直す。 |
プロジェクトディレクトリが移動または置換された | 目的のディレクトリを開き直す。新しいフォルダーの識別情報に古い接続を再利用しない。 |
root ユーザー、共有権限、Windows マウントが拒否された | 目的の非 root ユーザーで、ユーザーが所有する Linux フォルダーを選択する。 |
保存の結果が不確か | 書き込みを繰り返す前に、再読み込みして現在の保存済み内容を確認する。 |
パッケージ、バックアップ、エラー報告の手順については、Windows のインストール、ローカルワークスペース、診断を参照してください。
Use a Windows folder
このPC → このPCのプロジェクト → プロジェクトフォルダーを開く を選択します。プロジェクト用の通常の Windows フォルダーを選択します。このホストは WSL パスを開きません。
プロジェクトルートを確認し、ソースに無害な変更を保存して、再度開きます。ローカル Git などの Free ローカルツールはサインインなしで機能します。AI・Cloud・リモート Git・アカウントサービスにはサインインしてください。My PC にはデバイスライセンスは必要ありません。
以前の WSL の手順は、その接続を公開する古いアプリを対象としています。ファイルをコピーする前に、そこで元のプロジェクトを復旧して確認してください。元のディストリビューションを保持し、認証情報やトランザクションログを承認としてコピーしないでください。