Using External Git Version Control with Altium Designer

GitタイプのリポジトリはAltium Designerの外部で作成され、ローカルのGitリポジトリの内容には、そのホストフォルダからファイルを開いてアクセスします。リモートおよびローカルの作業Gitリポジトリの管理は、通常、企業システムと外部のGitツールを通じて行われますが、ファイルレベルの操作（コミット、プッシュ、更新など）はAltium Designerの編集環境内で処理されます。

Gitバージョン管理システムに追加

分散バージョン管理システムとして、GitはSVNのワークフローとは異なる方法を使用しますが、Altium Designerで確立されたプロジェクトファイルを扱う場合の違いは最小限です。簡単に言うと、Gitは単一のリポジトリターゲットの依存性に焦点を当てるのではなく、複数のリポジトリ間のデータ転送を適用します。

► 詳細情報および適用される原則の概要については、Gitのウェブサイトとバージョン管理の基本をご覧ください。

Git VCSシステムは通常、複数のGitリポジトリを必要に応じてホストできる中央集中型のリモートGitサーバーに基づいています。Gitの高速で軽量な特性は、各プロジェクトごとにリモートリポジトリを作成し、そのプロジェクトに取り組んでいる任意のユーザーが作業用リポジトリとして複製（コピー）できる実践に適しています。ユーザーの作業用Gitリポジトリの更新ファイルは、同期を達成するためにGitサーバー上のリモートリポジトリに「プッシュ」されます。

Altium DesignerプロジェクトをGitシステムに設定する方法は、会社のインフラと実践に依存し、Altium Designerの外部にあるツールやプロセスを含むことになります。しかし、プロジェクトがバージョン管理システムに入り、ローカル作業リポジトリとして利用可能になると、Altium DesignerでのGit VCSの使用は、SVN VCSの使用とほぼ同じになります。

プロジェクトをGitに追加する

例として、既存のAltium DesignerプロジェクトをローカルのGitリポジトリに追加することができます。これは、基本的なGitコマンドラインツールを使用して行います。このアプローチでは、プロジェクトフォルダがローカル（作業中の）Gitリポジトリになり、これが利用可能なリモートGitリポジトリにリンクされ、最終的に更新されます。

ここで、ツールは以下の用途に使用されます：

1. プロジェクトフォルダ内で作業用Gitリポジトリを初期化します。
2. プロジェクトファイルをGitバージョン管理に追加します。*.* ファイル指定はファイルを追加しますが、フォルダは追加しません。
3. ウェブサーバー上の共有リモートGitリポジトリへのリンク参照を指定します。PCrepoはリモートリポジトリURLのローカルエイリアスとして指名されます。

ローカルGitリポジトリにプロジェクトが追加されています

プロジェクトがAltium Designerで開かれると、プロジェクトパネルとストレージマネージャパネルのファイルの状態は「追加予定」()と表示されます。その後、作業リポジトリにコミットすると、ファイルは「サーバー先行」状態()に変わります。これは、リモートのGitリポジトリでまだバージョン管理されていないためです。

サーバーより先行して追加予定としてスケジュールされたファイル

Push コマンドは、ローカルリポジトリのファイルをリモートのGitサーバーに更新します。これには、対象リポジトリに対して有効な認証情報の提供が一度だけ必要になる場合があります。Altium Designerでは、コミットとPushの操作を一つのアクションで呼び出すことができます（ ）、しかし説明の目的でここでは個別のステップで完了しています。

有効な認証情報の要求に応じてファイルが更新されます

Altium Designer プロジェクトは、現在 Git バージョン管理の完全な下にあり、リモート Git リポジトリから他のユーザーが利用できるようになります。例えば、別のユーザーがリポジトリを複製してローカルマシンにダウンロードし、最終的に編集したファイルをリモートリポジトリにプッシュすることで、協力的なワークフローを実現できます。

Gitリポジトリを複製する

Gitバージョン管理に追加されたローカルプロジェクトは、プロジェクトのローカルフォルダ（作業リポジトリ）からAltium Designerによって編集でき、コミットされた変更はリモートのGitリポジトリに更新されます。ローカルリポジトリとリモートリポジトリは、VCSのPushコマンドによってリンクされ、最終的に同期されます。

設計に協力したい他のユーザーは、リモートのGitリポジトリをローカルの作業リポジトリに複製することでプロジェクトにアクセスできます。リモートのGitリポジトリからファイルにアクセスする方法は、会社のシステムや方法によって異なりますが、リモートリポジトリの内容をローカルの作業リポジトリに複製する基本的な方法は、以下の画像に示されているようにGitコマンドgit clone [リモートリポジトリのURL] [ターゲットの作業リポジトリフォルダ]を使用することです。

リモートGitリポジトリに更新された変更

このプロセスは、共有されたリモートリポジトリをローカルの作業リポジトリとして複製し、自動的に最新（HEAD）リビジョンをマスターブランチからチェックアウトします。その後、ファイルを編集、保存し、Altium DesignerのVCSにコミットし、最終的にリモートGitリポジトリにプッシュすることができます。

既存のGitリポジトリへの接続

Altium Designerは、新しいGitリポジトリを作成したり、既存のリポジトリに接続するためのコントロールを提供していません。しかし、他の方法（Gitユーザーによって好まれる伝統的な技術）を用いることで、このタイプの既存のリポジトリに効果的に接続することができます。そのためには：

1. リモートGitリポジトリを作成するか、または会社の外部リポジトリにアクセスします - その中にAltium Designerプロジェクトが保存されています。
2. リポジトリを複製して、ローカルの作業用Gitリポジトリを作成します。
3. ローカルリポジトリからAltium Designerプロジェクトを開きます。

Altium Designerは、プロジェクトがGitベースのリポジトリでバージョン管理されていることを認識し、VCS関連のステータスや、ファイルを操作するためのコマンド/機能（ローカル作業用Gitリポジトリへのコミットや、ローカルGitリポジトリからリモートGitリポジトリへのプッシュを含む）を提供します。