Workshop の変更履歴パネル

Workshop の変更履歴パネルを使うと、ビルダーはモジュールのバージョン間の変更を視覚的に確認できます。時間の経過とともに加えられた変更を追跡したり、モジュールの問題をデバッグする際に、どの変更が問題の原因となった可能性があるかを特定したりするのに役立ちます。

変更履歴を理解する

選択したモジュールのバージョン間に変更がある場合、パネルに変更履歴ノードが表示されます。変更には5つの種類があります。

• 変更： ノードが変更されました（たとえば、ボタンのテキストが変更された場合）。
• 追加： モジュールにノードが追加されました。
• 削除： モジュールからノードが削除されました。
• 移動： ノードの配置が変更されました（たとえば、ページ1からページ2に移動した場合）。
• 未使用に変更： ウィジェットが削除されましたが、モジュールからは削除されず、未使用のウィジェットに移動しました。

上の画像は、次の内容を示しています。

• メトリックカード A が編集されました。
• メトリックカード B がモジュールに追加されました。
• メトリックカード C が未使用に変更されました。
• メトリックカード D がモジュールから削除されました。

JSON の差分を開くと、変更ノードをさらに詳しく確認できます。ここでは、ノードに加えられた変更の詳細を確認できます。下のスクリーンショットでは、変数の値が Hello から Hello world に変更され、変数名が var1 から hello world に変更されたことがわかります。

また、変更履歴パネルには、変更の階層が視覚的に表示されます。下の例では、階層から、メトリックカードコンテナセクションにメトリックカード A ウィジェットが含まれており、両方が変更されたことがわかります。さらに、メトリックカード A の値がメトリックカード A 内で使用されており、モジュールに追加されたこともわかります。

モジュールの選択

モジュールのバージョンを選択する方法は2つあります。

• 範囲選択： 開始バージョンと終了バージョンを選択して、その間の変更を確認します。たとえば、0.1.0 と 0.4.0 を選択すると、バージョン 0.1.0 と 0.4.0 の間の変更を確認できます。

• 単一選択： 単一選択では、特定のモジュールバージョンを前のバージョンと比較して、変更を確認できます。たとえば、バージョン 0.5.0 を選択すると、変更履歴に 0.4.0 と 0.5.0 の間の変更が表示されます。

リベース中に変更履歴パネルを使用する

ブランチの変更を main にマージする前にリベースが必要な場合、変更履歴パネルには通知ドットが表示され、リベースを開始するオプションが用意されます。

main の変更を取り込む必要がある場合は、リベースと競合解決のビジュアルガイドに沿って、差分アイコンを確認し、ブランチの設定を比較して、競合を解決してください。

リベース中、変更履歴パネルには、このブランチからモジュールの最新の main バージョンに適用される変更が表示され、マージの競合が強調表示されます。main とこのブランチの両方で変更されている場合、その変更は競合として指定されます。よくある例は次のとおりです。

• ウィジェットまたは変数が、main とこのブランチの両方で変更された場合。
• セクションが main で削除され、ブランチで編集された場合。
• ウィジェットが、main では場所 A から B に、このブランチでは A から C に移動された場合。

競合を解決する際は、モジュールを3つの状態に切り替えて、結果をリアルタイムで評価できます。

• 最新のメイン： main にある設定。
• 現在のブランチ： このブランチにある設定。
• 現在のセッション： リベースを開始した後に、差異を調整するために加えた変更。

競合を解決し、モジュールに問題がないことを確認したら、保存してリベースを完了します。その後、このブランチを安全に main にマージできます。