Making an Existing Project Available in the Workspace through Altium Designer

プロジェクトを扱う際に推奨され、最も強力な方法は、接続されたワークスペース内で直接新しいプロジェクトを作成することです。既存のプロジェクトがある場合は、それをオンラインで利用可能にし、正式なバージョン管理を有効にすることで、ワークスペースに取り込むことができます。どちらの場合も、プロジェクトはワークスペースのネイティブバージョン管理システム（VCS）を通じて保存および管理されます。これにより、Altium Designerを通じてプロジェクトを扱う際に、プロジェクトの全機能を利用できます。ワークスペースのVCSの完全な管理下にプロジェクトを置くことは、そのプロジェクトを複数の人々と共有し、Altium Designerを通じて編集（ワークスペースのメンバーである場合）し、履歴追跡や高度なプロジェクト共有など、プラットフォームの追加機能を利用する唯一の方法です。

既存のプロジェクト（ローカルプロジェクトまたは現在外部バージョン管理下にあるプロジェクト）をワークスペースで利用可能にするには、通常どおりAltium Designerでプロジェクトを開き、Projectsパネルのエントリを右クリックして、コンテキストメニューからMake Project Available Onlineを選択し、Make Available Onlineダイアログにアクセスします。エンタープライズサーバーワークスペースを使用する場合、Make Project Available on ServerコマンドがMake Available On Serverダイアログを開きます。

既存のローカルプロジェクトをワークスペースで利用可能にし、事実上ワークスペースに「登録」し、それの「ミラー」を作成します。

Make Available Onlineダイアログを使用して、プロジェクトのNameを変更し、Descriptionを追加します。デフォルトでは、名前は元のプロジェクトのものになります。

Version Controlオプションをチェックすると、プロジェクトがWorkspaceの独自の組み込みVCS（Git）の下に追加されます。このオプションがチェックされていない場合（Altium 365 Workspaceのオプションのみ）、プロジェクトファイルは単にWorkspaceに保存され、基本的なアクセスを可能にし、他の人が閲覧やコメントをするための共有を有効にします - シンプル同期の配置です。バージョン管理を有効にすることをお勧めします。そうすることで、WorkspaceおよびAltium 365プラットフォームを通じて、およびそれによって提供される最大の機能にアクセスできるようになります。プロジェクトをWorkspaceでミラーリングする機能（シンプル同期）は、Altium 365 Workspaceに接続している場合にのみ利用可能です。

ダイアログのAdvancedリンクをクリックすると、Folderフィールドが表示されます。このフィールドは、ミラーリングされるプロジェクトのフォルダをWorkspaceのフォルダ構造内に作成する場所を指定するために使用されます。新しいプロジェクトのデフォルトパスは、WorkspaceのブラウザインターフェースのAdmin – Settings – Projectsページで指定されます（デフォルトでは、これはProjects\<ProjectName>になります）。必要に応じて異なるWorkspaceフォルダを参照して選択するために、ボタンをクリックします。

Make Available Online ダイアログでプロジェクト移行のプロパティを必要に応じて定義した後、OKをクリックします。外部バージョン管理下にないプロジェクトがオンラインで利用可能にされた場合（Altium 365 WorkspaceでVersion Controlオプションがチェックされた）、プロジェクトとファイルはWorkspaceのVersioned Storage設計リポジトリにコミットおよびプッシュされます。Projectsパネルは、Workspace設計リポジトリとローカル（作業コピー）リポジトリの間に存在する完全に同期された状態を、関連するアイコンによって示します。プロジェクトは真のWorkspaceプロジェクトになります - 単にWorkspaceに「登録」されたのではなく、実際にWorkspaceのバージョン管理の下にコミットされます。設計に加えられた変更は、Workspaceのリポジトリに保存（コミット/プッシュ）されなければなりません。

Workspaceで利用可能にされたプロジェクトは、その後、WorkspaceのブラウザインターフェースのProjectsページから利用可能になります。

既存の外部バージョン管理リポジトリを使用する場合の制限

前述のように、ローカルの設計は既に既存の外部バージョン管理システム（Git、SVN、EPDMなど）で追跡されている場合があります。Altium 365 Workspaceを使用する場合、以前と同様にこのセットアップを続け、Make Project Available Online機能を使用して、それらの設計をWorkspaceに登録することでWorkspaceで利用可能にすることができます。

このモードでは、設計に変更を加えて外部VCSリポジトリにそれらの変更をコミットするたびに、その設計データはバックグラウンドでWorkspaceにミラーリングされ、通常どおり必要な処理が実行されます - プレビュー、使用箇所など。ただし、注意すべきいくつかの制限があります：

• 新しい設計プロジェクトの作成は、以前のフローに従う必要があります。つまり、外部VCSシステムで手動で作成されます。その後、プロジェクトはMake Project Available Online機能を使用してワークスペースに登録され、ミラーリングされます。
• 設計変更が行われたが、コミット/プッシュがAltium Designerを通じずに外部ツールによって実行された場合、それらの変更はワークスペースのミラープロジェクトには表示されません。これは、プロジェクトが次にAltium Designerで再オープンされたときに修正され、ローカルプロジェクトがミラーワークスペースバージョンと自動的に同期されます。変更が別のユーザーによって行われた場合、再オープンされたプロジェクトファイルはOut Of Date ()として表示され、バージョンコントロールのUpdateコマンドを使用して修正できます。
• プロジェクトを2人目の人が開く場合、その外部VCSリポジトリへのアクセスが必要になります。
• 権限管理は、ワークスペースとマスターソース（外部のGit/SVNなどのVCSリポジトリ）の両方で設定/維持する必要があります。
• Altium 365プラットフォームを通じて提供される一部の機能は、プロジェクトがワークスペースのネイティブバージョンコントロールシステム下にある場合にのみ機能します。外部バージョンコントロールシステムを使用してプロジェクトを保持することで、プラットフォームに利用可能になるこれらの機能は利用できません。外部VCSからワークスペースのネイティブVCSへの移行は可能です。次のセクションを参照して、これを実現する手順を確認してください。

GitHubを使用して作業する

外部バージョンコントロールシステム（VCS）としてGitHubプラットフォームを使用することは、設計プロジェクトをホストおよび共有するための人気の方法であり、GitリポジトリはAltium Designerによってサポートされています。上記のAltium 365ワークスペースの場合と同様に、既存の外部VCSアレンジメントはワークスペースと同期（ミラーリング）され、その高度なデータ管理およびコラボレーション機能を利用できます。

GitHub自体の使用方法は、会社の慣行や手元にあるGitツールによって異なりますが、一般的には、設計プロジェクトはローカルGitリポジトリで作成され、その後GitHub（リモート）リポジトリにプッシュされるか、GitHubからローカルリポジトリにクローンされます。ローカルGitリポジトリにあるプロジェクトは、Altium Designerで編集用に開くことができます。ソフトウェアはローカル/リモートのGitHubリポジトリを認識して使用します。

GitベースのプロジェクトがAltium 365ワークスペースにミラーリングされた場合（Make Project Available Online）、プロジェクトはAltium Designer内の他のプロジェクトと同様に管理および作業できます。このアレンジメントでは、ワークスペースは引き続きプロジェクト管理システムのすべての利点を提供し、GitHubと透過的に通信して主要なVCSアクション（コミット、プッシュ、プルなど）を実行します。Altium DesignerはGitHubログイン資格情報を要求し、その後のGitHubとのやり取りにこれらを保持します。

GitHubプロトコル

Git VCSによって提供されるデータ転送プロトコルの範囲がありますが、Altium Designerは現在、ローカルGitリポジトリとそのリモートマスターリポジトリ間の接続についてHTTP/HTTPSプロトコルのみをサポートしています。実際には、適用されるプロトコルはリモートリポジトリ接続のURLプレフィックスによって設定されます。https://<remote repository>、ssh://<remote repository>、git://<remote repository>などです。

GitHubはSSHとHTTPSプロトコルの両方をサポートしており、接続にはHTTPS URLの使用を推奨しています。

► GitHubでどのリモートURLを使用すべきか?を参照してください。

外部VCSシステムがHTTPS以外のプロトコル、たとえばGitHub SSH接続にバインドされている場合、これはリモートからクローンされたリポジトリにプリセットされます。このプロトコルはAltium Designerと互換性がないため、プロジェクトをAltiumワークスペースと統合しようとするとエラーが発生します。SSH接続の場合、リポジトリ自体がこのプロトコルをサポートしている場合、サポートされているHTTPS接続プロトコルを使用するようにリポジトリを更新するよう提案されます。ローカルGitリポジトリで使用されているリモートURLプロトコルが不明な場合は、git remote – vコマンドを使用して確認できます。

Git Bashコマンドラインインターフェースを使用して、リポジトリのリモートURL設定を確認します。

リポジトリを異なるURL、たとえばAltium Designerとの互換性を可能にするHTTPSプロトコルに再設定するには、git remote set-url <name> <URL>コマンドを使用します。ここで、URLのプレフィックスはプロトコルタイプを指定します。

リモートリポジトリ接続URLプロトコルを変更し、リモートコマンドで確認します。

外部VCSからワークスペースネイティブVCSへの移行

Altium 365ワークスペースに接続されている場合、Altium Designerはまた、外部VCSシステムを使用するプロジェクトを、設計ファイルを独自のGitリポジトリでホストする完全に管理されたワークスペースプロジェクトに忠実に移行する機能を提供します。変換された設計プロジェクトは、以前のVCSコミットの履歴を保持し、ワークスペースのネイティブVCS対応機能、高度なプロジェクト共有、シングル認証、およびイベントベースの履歴タイムラインなどの利点を享受できます。

プロジェクトVCS移行機能は、GitおよびSVNの外部バージョンコントロールシステムの両方をサポートしており、ローカルファイルベースのプロジェクトをオンラインで利用可能にする場合、またはミラー（同期のみ）プロジェクトをワークスペース自身のGit VCSの下に昇格させる場合に利用できます。

外部バージョンコントロールの下に格納されたプロジェクトを単純に移行するには、Projectsパネルでプロジェクト名を右クリックし、コンテキストメニューからMake Project Available Onlineオプションを選択するか、メインメニューからProject » Make Available Onlineを選択します。次に表示されるMake Available Onlineダイアログで、Migrate to Altium 365 Versioned Storageオプションをチェックし、操作を確認します（OK）。

有効にされたMigrate to Altium 365 Versioned Storageオプションは、外部VCSリポジトリをワークスペースGitリポジトリに置き換え、プロジェクトをAltium 365ワークスペースで格納および管理されるものに変換し、可能な場合は外部VCSからのバージョンコミット履歴を持ち込むことを意味します。移行オプションがチェックされていない場合、プロジェクトはワークスペースにミラーリングされます（Simple Syncアレンジメント）が、外部リポジトリをそのVCSストレージとして維持します。Altium DesignerがEnterprise Server Workspaceに接続されている場合、VCS移行も利用可能です。この場合、Make Available On ServerダイアログでMigrate to Altium Versioned Storageオプションが利用できます。移行オプションがチェックされていない場合、プロジェクトの外部リポジトリはそのVCSストレージとして維持されます（Simple Syncの配置はEnterprise Server Workspaceではサポートされていません）。

ローカルVCSプロジェクトをAltium 365 Workspaceの完全に管理されたVCSプロジェクトに移植するには、オンラインで利用可能にする際にVCS移行オプションをチェックします。

Migrate Projectダイアログが開き、プロジェクトがWorkspaceのVCSの完全な管理下に移行されることを警告します。新しい（gitベースの）ローカルプロジェクトリポジトリが作成されるハードドライブ上のフォルダを選択するためにBrowseボタンをクリックします。移行を進めるにはMigrateボタンをクリックします。

Migrate Projectダイアログ

指示に従った後、最終VCSコミットを含むと、プロジェクトはWorkspace Gitリポジトリのバージョン管理下にあります。外部VCSのコミット履歴とそのコメント/メッセージは、新しいWorkspace VCSプロジェクトに移植され、Altium DesignerのHistory viewでアクセスできます - Projectsパネルでプロジェクト名を右クリックし、History & Version Control » Show Project Historyコマンドを選択します。

移行されたとき、プロジェクトの外部VCSコミット履歴（左に表示）はAltium Designer History view（右）に転送されます。

外部VCSプロジェクトが既にAltium 365 Workspaceでmirrored project（同期されたローカル-サーバーファイル）として管理されている場合、そのVCSファイルはProject History view、Project Optionsダイアログ、またはProjectsパネルの History & Version Control右クリックコンテキストメニューから利用できるMigrate to Altium Versioned Storageコマンドを使用して、サーバーのネイティブGitリポジトリに移行できます。

Workspaceと同期（ミラーリング）されたVCSプロジェクトは、Migrate Project to Altium Version Controlオプションを使用して移行されます。

移行後のコラボレーション

• WorkspaceチームメンバーがプロジェクトをAltium Versioned Storageに移行した場合、他のプロジェクトコラボレーターがチームWorkspaceに接続し、その後、ローカル（作業中）プロジェクトコピーを更新することを確認する必要があります。後者は、Projectsパネルでプロジェクトファイルに関連付けられたアイコン（Out of Date）によって示され、Project » History & Version Control » Update Whole Projectコマンドによってアクションされます。
• 移行されたプロジェクトが更新されると、Altium Designerは新しいリポジトリへのリンクを更新するために、プロジェクトのローカル作業フォルダを再構築することを提案します。Fix version control linkダイアログで推奨されるオプションを選択して、ローカルプロジェクトの更新を完了します。

• プロジェクトコラボレーターがチームWorkspaceに接続せずにVCS設計変更をコミットした場合、これらは外部リポジトリに登録され続け、したがって移行されたWorkspace VCSプロジェクトと同期していないことに注意してください。
• 移行中、Altium Designerは元のリポジトリに通知マークを設定するコミットを実行し、他のチームメンバーのAltium Designerインスタンスによって移行されたと認識できるようにします。

ワークスペースのSVNからワークスペースのGitへの移行

Altium DesignerがEnterprise Serverワークスペースに接続され、デザインプロジェクトがワークスペースのバージョン管理サービスを通じて管理されているSVNリポジトリに格納されている場合、プロジェクトパネルのエントリを右クリックして、コンテキストメニューからHistory & Version Control » Migrate Project to Altium Versioned Storageコマンドを選択することで、このプロジェクトをワークスペースの組み込みGitリポジトリ（Versioned Storage）に移行できます。または、プロジェクトオプションダイアログのMigrate to Server Versioned Storageボタンをクリックします。

最終VCSコミットを含むプロンプトに従った後、プロジェクトはワークスペースGitリポジトリのバージョン管理に移行されます。

プロジェクト同期の制御

ローカルプロジェクトがAltium 365ワークスペースで利用可能になった後、そのオンラインでの利用可能性と同期に関する制御は、Project OptionsダイアログのGeneralタブを通じて提供されます。

プロジェクトをオンラインで利用可能にしたことに関連するオプションと制御は、プロジェクトオプションダイアログのGeneralタブに表示されます。

タブのGeneral領域で利用可能なオプションを使用して、プロジェクトの説明を変更します。これはワークスペース内のミラープロジェクトにのみ影響します。

タブのOnline Availability and Synchronization領域では、Version Controlオプションが現在のオンラインでの利用可能性のスタイルを反映しています：

• オプションが有効 – プロジェクト（およびそのソースファイル）は、ワークスペース自身のネイティブVCS（Git）の下に格納されます。これにより、ワークスペースとAltium 365プラットフォームを通じて、およびそれによって提供される最大の機能にアクセスできるため、推奨されるアプローチです。
• オプションが無効 – プロジェクトファイルは、基本的なアクセスを提供し、他の人との共有を可能にするためにワークスペースに格納されます。シンプル同期の配置です。

これらの二つの間で必要に応じて変更してください。

ローカルプロジェクトと、ワークスペースで利用可能にされたその管理されたインカーネーションとの同期を停止したい場合は、ボタンをクリックしてください。プロジェクト同期を解除ウィンドウが表示されます。Unlinkオプションをクリックし、その後OKをクリックしてプロジェクトオプションダイアログに戻ります。ローカルプロジェクトは、ワークスペース内のプロジェクトと関連付けられなくなります。

これは、ローカルプロジェクトを保存した後にProjectsパネルで反映され、プロジェクトがアクティブなプロジェクトグループ(*.DsnWrk)の下に表示されるようになり、アクティブなワークスペースの下のエントリとしてではなくなります。ワークスペース内のプロジェクトへのリンクがプロジェクトファイルから削除されるため、保存が必要です。

ワークスペース内のプロジェクトはこのアクションによって削除されることはありません - そのまま残ります。

ローカルプロジェクトと、ワークスペースで利用可能にされたそのインカーネーションとの接続を切ることができます。

ローカルプロジェクトを再びオンラインで利用可能にすることができます。これは、ミラーリングされたプロジェクトまたは完全なVCSプロジェクト(Version Control)としてです。Project OptionsダイアログのGeneralタブでは、ボタンを使用してMake Available Onlineダイアログにアクセスできます。

ローカルプロジェクトは、Project OptionsダイアログのGeneralタブのから、ワークスペース内でオンラインで利用可能にすることもできます。