既存のプロジェクトをワークスペースで利用可能にする

プロジェクトを扱う際に推奨される最も強力な方法は、接続先の Workspace 内で新しいプロジェクトを直接作成することです。既存のプロジェクトがある場合は、オンラインで利用可能にし、正式なバージョン管理を有効にすることで、Workspace に取り込むことができます。いずれの場合も、プロジェクトは Workspace 標準のバージョン管理システム（VCS）を通じて保存および管理されます。これにより、Altium Designer でプロジェクトを扱う際に、すべての機能を利用できます。Altium Designer で複数のユーザーが編集できるようにプロジェクトを共有し（各ユーザーが Workspace のメンバーであることが条件）、履歴の追跡や高度なプロジェクト共有など、プラットフォームの追加機能を活用するには、プロジェクトを Workspace の VCS で完全に管理する必要があります。

既存のプロジェクト（ローカルプロジェクト、または現在外部でバージョン管理されているプロジェクト）を、Altium 365 Workspace 内のミラープロジェクト（Simple Sync）として、または Workspace 標準の Git バージョン管理下にあるプロジェクトとして Workspace で利用可能にするには、Altium Designer で通常どおりプロジェクトを開き、Projects パネルでそのプロジェクトのエントリを右クリックして、コンテキストメニューから Make Project Available Online を選択します。これにより、Make Available Online ダイアログが開きます。Enterprise Server Workspace を使用している場合、Make Project Available on Server コマンドで Make Available On Server ダイアログが開きます。

既存のローカルプロジェクトを Workspace で利用可能にします。これは実質的に、プロジェクトを Workspace に「登録」し、その「ミラー」を作成する操作です。

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

Version Controlオプションをオンにすると、Workspaceに組み込まれているVCS（Git）で管理するプロジェクトとして追加されます。このオプションをオフにすると（Altium 365 Workspaceでのみ利用可能）、プロジェクトファイルはWorkspaceに保存されるだけとなり、基本的なアクセスと、閲覧およびコメントのみを目的とした他のユーザーとの共有が可能になります。これがSimple Syncの仕組みです。WorkspaceおよびAltium 365プラットフォームが提供する機能を最大限に活用できるため、バージョン管理を有効にすることをお勧めします。なお、Workspaceにプロジェクトをミラーリングする機能（Simple Sync）は、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内のリポジトリに保存（コミット／プッシュ）する必要があります。

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

前述のとおり、ローカルの設計は、既存の外部バージョン管理システム（Git、SVN、EPDMなど）ですでに管理されている場合があります。Altium 365 Workspaceを使用する場合は、この構成を従来どおり使用しながら、Make Project Available Online機能で設計をWorkspaceに登録するだけで、Workspaceで利用可能にできます。

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

• 新しい設計プロジェクトを作成する際は、引き続き従来の手順に従う必要があります。つまり、外部VCSシステムで手動で作成します。その後、Make Project Available Online機能を使用してプロジェクトをWorkspaceに登録し、ミラーリングします。
• 設計を変更した際に、Altium Designerではなく外部ツールでコミット／プッシュを実行すると、その変更はWorkspace内のミラーリングされたプロジェクトに反映されません。次にAltium Designerでプロジェクトを開くと、ローカルプロジェクトとWorkspace内のミラーリングされたバージョンが自動的に同期され、この状態は解消されます。他のユーザーが変更を加えた場合、再度開いたプロジェクトのファイルはOut Of Date（）と表示されますが、バージョン管理のUpdateコマンドを使用して解消できます。
• 別のユーザーがプロジェクトを開くには、その外部VCSリポジトリへのアクセス権が必要です。
• 権限管理は、Workspaceとマスターソース（外部のGit／SVNなどのVCSリポジトリ）の2か所で設定および維持する必要があります。
• Altium 365プラットフォームで提供される一部の機能は、プロジェクトがWorkspaceのネイティブバージョン管理システムで管理されている場合にのみ動作します。プロジェクトを外部バージョン管理システムで管理し続けると、こうした機能がプラットフォームに追加されても利用できません。外部VCSからWorkspaceのネイティブVCSに移行することもできます。手順については、次のセクションを参照してください。

GitHubの使用

GitHubプラットフォームを外部バージョン管理システム（VCS）として使用することは、設計プロジェクトをホストして共有する一般的な方法です。Altium DesignerはGitリポジトリをサポートしています。Altium 365 Workspaceについて前述したように、既存の外部VCS環境をWorkspaceと同期（ミラーリング）することで、高度なデータ管理機能やコラボレーション機能を活用できます。

GitHub自体の通常の使い方は、会社の運用方法や使用しているGitツールによって異なります。ただし一般的には、ローカルGitリポジトリに設計プロジェクトを作成し、それをGitHubのリモートリポジトリにプッシュするか、GitHub上の既存のプロジェクトをローカルリポジトリにクローンします。ローカルGitリポジトリに配置されたプロジェクトは、Altium Designerで開いて編集できます。Altium Designerは、ローカルおよびリモートのGitHubリポジトリを認識して使用します。

GitベースのプロジェクトをAltium 365 Workspaceにミラーリングすると（Make Project Available Online）、Workspaceに保存されている他のプロジェクトと同じように、Altium Designerで管理および作業できます。この構成では、Workspaceのプロジェクト管理システムの利点をすべて利用できるうえ、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システムがGitHubのSSH接続など、HTTPS以外のプロトコルを使用している場合、リモートからクローンしたリポジトリにはそのプロトコルがあらかじめ設定されています。このプロトコルはAltium Designerと互換性がないため、プロジェクトをAltium Workspaceと統合しようとするとエラーが発生します。SSH接続の場合は、代わりにサポート対象のHTTPS接続プロトコルを使用するよう、そのリポジトリの更新を試みるオプションが提示されます（リポジトリ自体がこのプロトコルをサポートしている場合）。 ローカルGitリポジトリで使用されているリモートURLのプロトコルが不明な場合は、git remote – vコマンドで確認できます。

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

git remote set-url <name> <URL>コマンドを使用すると、Altium Designerとの互換性を確保するためにHTTPSプロトコルに変更するなど、リポジトリに別のURLを設定できます。プロトコルの種類はURLのプレフィックスで指定します。

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

外部VCSからWorkspaceのネイティブVCSへの移行

Altium 365 Workspaceに接続している場合、Altium Designerでは、外部VCSシステムを使用するプロジェクトを、設計ファイルを独自のGitリポジトリでホストする完全管理型のWorkspaceプロジェクトへ、忠実にmigrateすることもできます。変換後の設計プロジェクトでは、以前のVCSコミット履歴が保持され、高度なプロジェクト共有、認証の一本化、イベントベースの履歴タイムラインなど、WorkspaceのネイティブVCSを活用した機能を利用できます。

プロジェクトのVCS移行機能は、外部バージョン管理システムのGitとSVNの両方をサポートしています。この機能は、ローカルのファイルベースのプロジェクトをオンラインで利用可能にするとき、またはミラーリングされた（同期のみの）プロジェクトをWorkspace独自の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リポジトリがWorkspaceのGitリポジトリに置き換えられ、プロジェクトはAltium 365 Workspaceに保存・管理される形式に変換されます。また、可能な場合は、外部VCSのバージョンコミット履歴も引き継がれます。なお、移行オプションをオフのままにすると、外部リポジトリをVCSストレージとして維持したまま、プロジェクトがWorkspaceにミラーリングされます（Simple Sync構成）。

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

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

Migrate Projectダイアログ

最後のVCSコミットを含む一連の指示に従うと、プロジェクトはWorkspaceのGitリポジトリでバージョン管理されるようになります。外部VCSのコミット履歴とそのコメント／メッセージは、新しいWorkspace VCSプロジェクトに引き継がれ、Altium DesignerのHistoryビューで確認できます。Projectsパネルでプロジェクト名を右クリックし、History & Version Control » Show Project Historyコマンドを選択してください。

移行すると、プロジェクトの外部VCSコミット履歴（左）がAltium DesignerのHistoryビュー（右）に転送されます。

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

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

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

• WorkspaceのチームメンバーがプロジェクトをAltium Versioned Storageに移行したら、他のプロジェクト共同作業者がチームのWorkspaceに接続し、ローカルのプロジェクト作業コピーを更新するようにしてください。更新が必要な場合、Projectsパネルでプロジェクトファイルにアイコン（最新ではない状態）が表示され、Project » History & Version Control » Update Whole Projectコマンドで更新できます。
• 移行したプロジェクトを更新すると、Altium Designerは、プロジェクトのローカル作業フォルダーを再構築して新しいリポジトリへのリンクを更新することを提案します。Fix version control linkダイアログで推奨オプションを選択し、ローカルプロジェクトの更新を完了してください。

• プロジェクトの共同作業者がチームのWorkspaceに接続notせずにVCSの設計変更をコミットすると、変更は引き続き外部リポジトリに登録されるため、移行済みのWorkspace VCSプロジェクトとは同期されないことに注意してください。
• 移行中、Altium Designerは元のリポジトリにコミットを実行して通知マークを設定します。これにより、他のチームメンバーのAltium Designerでも、移行済みであることを認識できます。

WorkspaceのSVNからWorkspaceのGitへの移行

Altium DesignerがEnterprise Server Workspaceに接続されており、設計プロジェクトがWorkspaceの バージョン管理サービスを通じて管理されているSVNリポジトリに保存されている場合、このプロジェクトをSVNリポジトリからWorkspaceの内蔵Gitリポジトリ（Versioned Storage）に移行できます。これを行うには、Projectsパネルでプロジェクトの項目を右クリックし、コンテキストメニューから History & Version Control » Migrate Project to Altium Versioned Storage コマンドを選択します。または、Project OptionsダイアログのMigrate to Server Versioned Storageボタンをクリックします。

最後のVCSコミットなど、画面の指示に従って操作すると、プロジェクトはWorkspaceのGitリポジトリのバージョン管理に移行されます。

プロジェクトの同期の制御

ローカルプロジェクトをWorkspaceで利用可能にすると、Project Optionsダイアログの全般タブで、オンラインでの利用と同期を制御できます。

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

タブのGeneral 領域にあるオプションを使用して、プロジェクトの説明を変更できます。この変更は、Workspace内のプロジェクトにのみ適用されます。

タブのOnline Availability and Synchronization領域にあるVersion Controlオプションは、現在のオンラインでの利用形態を示します。

• Option Enabled – プロジェクト（およびそのソースファイル）は、Workspace独自のネイティブVCS（Git）で管理されます。この方法では、WorkspaceおよびAltium 365プラットフォームを通じて提供される機能を最大限に利用できるため、推奨されます。

• Option Disabled – プロジェクトファイルはWorkspaceに保存され、基本的なアクセスに加え、閲覧とコメントのみを目的として他のユーザーと共有できます。これはSimple Sync構成です（Altium 365 Workspaceのみ）。

必要に応じて、このオプションで2つの形態を切り替えます。

ローカルプロジェクトと、Workspaceで利用可能になっているそのプロジェクトとの同期を停止するには、ボタンをクリックします。Turn off project synchronizationウィンドウが表示されます。Unlink オプションをクリックし、Project Optionsダイアログに戻ってOK をクリックします。ローカルプロジェクトとWorkspace内のプロジェクトとの関連付けが解除されます。

ローカルプロジェクトを保存すると、この変更がプロジェクトパネルに反映され、プロジェクトはアクティブなWorkspaceの配下ではなく、アクティブなプロジェクトグループ（*.DsnWrk）の配下に表示されます。Workspace内のプロジェクトへのリンクがプロジェクトファイルから削除されるため、保存が必要です。

Workspace内のプロジェクトはそのまま残ります。この操作で削除されることはありません。

ローカルプロジェクトと、Workspaceで利用可能になっているそのプロジェクトとの接続を解除できます。

ローカルプロジェクトは、ミラーリングされたプロジェクト、または完全なVCSプロジェクト（Version Control）として、いつでも再びオンラインで利用可能にできます。Altium 365 Workspaceに接続している場合、Project OptionsダイアログのGeneral タブにボタンが表示され、このボタンからMake Available Onlineダイアログにアクセスできます。

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