ストアフロントコードを検査および編集する

Runnerの条件付きコードエディターを開き、フォーカスされたファイル変更を保存し、Git変更を確認し、保存されていない作業を失わないようにします。

コードエディターを使用すると、現在のプレビューの背後にあるストアフロントファイルを検査するか、フォーカスされた変更を行うことができます。ビジュアル編集またはRunnerリクエストがより適切な場合にのみ使用してください。

このガイドの内容

条件付きコードエディターを開き、1つのフォーカスされたファイル変更を保存し、プレビューに戻って検証し、コミット、プッシュ、公開を別の意図的なアクションとして保ちます。

エントリーパス

ストアプロジェクトを開く → ストアフロント → コードエディターを開く。

開始前に

プロジェクトワークスペースとストアフロントプレビューが接続されるまで待ちます。
変更する予定のファイルを理解している場合にのみコードエディターを使用します。
各変更されたファイルをタブを閉じるか、ダイアログを閉じる前に保存します。保存されていないファイルを閉じても確認は表示されません。
保存されたファイルはプロジェクトワークスペースを変更しますが、自動的にコミット、プッシュ、公開、またはプレビューで証明されません。
コミットとプッシュは、プロジェクトの構成されたGitリモートを変更する権限がある場合にのみ使用します。

エディターコントロールとクリック結果

コントロールまたは状態	使用後の動作
コードエディターを開く	全高さのコードエディターダイアログを開きます。ダイアログを閉じるとストアフロントパネルがプレビューに戻ります。
ファイルアイコン	検索可能なストアフロントファイルツリーを表示します。フォルダーを展開するとその内容が読み込まれます。ファイルを選択するとタブで開きます。
ファイルタブ	エディターをそのオープンファイルに切り替えます。オレンジ色のドットはタブに保存されていない変更があることを意味します。
ファイルタブの閉じるアイコン	そのタブを閉じます。Runnerは保存されていない変更について質問しないため、最初に保存します。
コードエディター	アクティブなファイルを変更できます。入力するとオープンタブが変更されますが、ファイルは自動的に保存されません。
macOSでCommand-SまたはWindows/LinuxでControl-S	アクティブなファイルを接続されたプロジェクトワークスペースに保存します。成功後、オレンジ色の保存されていない指標がクリアされます。
Gitブランチアイコン	現在のブランチ、変更されたファイルリスト、コミットフォーム、プッシュコントロールを開きます。変更されたファイルを選択するとそのdiffが開きます。
ステージ / ステージ解除	次のコミットから1つのファイルを追加または削除します。保存されていないエディタータブを保存しません。
すべてをステージ / すべてをステージ解除	対応するリストのすべてのファイルに同じステージング選択を適用します。いずれかのアクションを使用する前にリストを確認します。
コミットメッセージ	次のコミットに添付される説明を記録します。
コミット	メッセージが空でない場合、ステージされたファイルからコミットを作成します。ステージされていない変更と保存されていない変更はそのコミットの外に残ります。
プッシュ	構成されたリモートより先にあるコミットを直ちに送信します。このパネルに2番目の確認はありません。
更新	接続されたプロジェクトワークスペースの最新Git状態をリクエストします。

1つのフォーカスされた編集を行い、検証する

プロジェクト名と現在のストアフロントをプレビューで確認します。
コードエディターを開くを選択します。
ファイルビューを開いたままにし、必要なフォルダーを展開し、1つのファイルを選択します。
変更前に既存のコンテンツを読みます。
最小限の意図した編集を行います。
Command-SまたはControl-Sを押し、オレンジ色のドットが消えることを確認します。
コードエディターを閉じ、プレビューで影響を受けたページを確認します。
変更がいずれかに影響する可能性がある場合、デスクトップとモバイルレイアウトを確認します。
結果が間違っている場合は、エディターに戻して修正するか、Runnerに特定のファイルと表示される問題を修復するよう依頼します。

保存はRunnerがファイルを書き込んだことのみを証明します。プレビューは現在のプロジェクトがそれを表示できることのみを証明します。公開とライブ顧客ジャーニーは別のチェックのままです。

必要な場合にのみコミットとプッシュを行う

含める予定のすべてのファイルを保存します。
Gitブランチビューを開きます。
各変更されたファイルを選択し、そのdiffを確認します。
意図したファイルに対してステージを使用します。関連のない変更が存在する場合はすべてをステージを避けます。
明確なコミットメッセージを入力します。
コミットを選択し、Git状態が更新されるまで待ちます。
ブランチとリモートワークフローを確認した後にのみプッシュを使用します。アクションは直ちに開始されます。
プレビューに戻り、表示される結果を検証します。成功したコミットまたはプッシュはストアフロントを公開しません。

トラブルシューティング

状態	意味	対応方法
コードエディターを開くがない	この機能はこのプロジェクトで有効になっていません。	デザインモードを使用するか、Runnerに変更を依頼します。コピーされた内部ルートに頼らないでください。
サンドボックスに接続中…	プロジェクトワークスペースがまだ接続されていません。	プロジェクトを開いたままにし、ワークスペースが再接続した後に再試行します。
ファイルツリースピナー	Runnerが現在のフォルダーを読み込んでいます。	別のフォルダーを繰り返し選択する前に待ちます。
ファイルを選択しても何もしない	ファイルを読み込めなかったか、ワークスペースが切断されました。	接続を確認し、ファイルをもう一度選択します。
保存後もオレンジ色のドットが残る	ファイルが正常に保存されませんでした。	タブを開いたままにし、エラーメッセージを読み、必要に応じて再接続後に再試行します。
ツリーからファイルを開く	アクティブなファイルがありません。	ファイルビューでファイルを選択します。
変更なし	Gitは保存されたファイル変更を報告しません。	エディタータブを保存し、更新を選択します。
コミットが無効	ステージされたファイルまたはコミットメッセージがありません。	意図したファイルをステージし、メッセージを入力します。
プッシュが無効	ブランチがリモートより先にローカルコミットを持たないか、プッシュが実行中です。	意図した変更をコミットするか、現在のプッシュを待ちます。
Gitステータスの読み込みに失敗しました	Runnerはリポジトリ状態を読み込めませんでした。	再試行を選択します。ステータスが読み込まれるまでステージまたはプッシュしないでください。
下矢印カウントはブランチが遅れていることを示す	リモートにはワークスペースに存在しないコミットが含まれています。	プッシュする前に停止し、プロジェクト所有者にブランチを安全に更新する方法を尋ねます。
保存、ステージ、コミット、またはプッシュエラー	アクションが完了しませんでした。	現在の状態を保ち、エラーを読み、接続と権限を確認した後にのみ再試行します。