在工作区中提供现有项目
概览
- 了解如何使用“使其在线可用”或“使其在服务器上可用”对话框,配置项目详细信息及其所在的工作区文件夹。
- 了解简单同步与工作区原生版本控制之间的区别,包括查看、评论和多用户编辑方面的差异。
- 探索将受外部版本控制的项目迁移到工作区原生版本化存储的选项。
处理项目时,推荐且功能最强大的方法是直接在已连接的工作区中创建新项目。如果您已有项目,可以将其设为在线可用,并选择启用正式版本控制,从而将其导入工作区。无论采用哪种方式,项目都将通过工作区的原生版本控制系统 (VCS) 进行存储和管理。这样,在 Altium Designer 中处理项目时,您就可以使用完整的项目功能。只有将项目完全纳入工作区 VCS 的管理,才能与多人共享该项目,让他们通过 Altium Designer 进行编辑(前提是他们是工作区成员),并使用平台的其他功能,例如历史记录跟踪和高级项目共享。
要将现有项目(本地项目或当前使用外部版本控制的项目)设为在工作区中可用,无论是作为 Altium 365 工作区中的镜像项目 (Simple Sync),还是作为纳入工作区原生 Git 版本控制的项目,都应先在 Altium Designer 中按常规方式打开该项目,然后右键单击“项目”面板中的项目条目,并从上下文菜单中选择 Make Project Available Online,以打开 Make Available Online 对话框。使用 Enterprise Server 工作区时,Make Project Available on Server 命令会打开 Make Available On Server 对话框。

将现有本地项目设为在工作区中可用,本质上就是将其“注册”到工作区并创建其“镜像”。
“设为在线可用”对话框的选项和控件
-
Project Name – 项目在工作区中的名称。默认情况下,名称与原始项目相同。
-
Description – 输入所需的项目描述。
-
Version Control – 选中此选项可将本地项目添加到工作区自带的内置 VCS (Git) 中。如果未选中此选项,项目文件将仅存储在工作区中,以供基本访问,并可共享给其他人进行查看和评论,但不能编辑,可以说是一种不太正式的 Simple Sync。建议启用正式版本控制,这样您就能使用工作区和 Altium 365 平台提供的最全面的功能。此选项仅在项目当前未纳入版本控制时可用。
-
Migrate to Altium 365 Versioned Storage – 启用此选项可将使用外部 VCS 的项目迁移为完全由工作区 VCS 管理的项目。迁移后,项目即可使用工作区的原生 VCS 功能。此选项仅在项目当前使用外部 VCS 时可用。
-
Advanced – 单击以访问附加选项。
-
Folder – 此字段用于指定在工作区的文件夹结构中为正在迁移的项目创建文件夹的位置。新项目的默认路径在工作区浏览器界面的 Admin – Settings – Projects 页面上指定(默认路径为
Projects\<ProjectName>)。单击
可打开 Choose Folder 对话框。该对话框是 Explorer 面板的精简版,您可以根据需要在其中浏览并选择其他服务器文件夹。
-
“设为在服务器上可用”对话框的选项和控件
- Project Name – 项目在工作区中的名称。默认情况下,名称与原始项目相同。
- Description – 输入所需的项目描述。
- Migrate to Altium Versioned Storage – 启用此选项可将使用外部 VCS 的项目迁移为完全由工作区 VCS 管理的项目。迁移后,项目即可使用工作区的原生 VCS 功能。此选项仅在项目当前使用外部 VCS 时可用。
-
Advanced – 单击以访问附加选项。
-
Repository – 此下拉菜单(如果存在)会列出所有通过工作区的版本控制服务进行管理、且已共享给您使用的设计存储库。选择用于存储新项目及其文件的存储库,默认情况下只有一个基于 Git 的存储库 (
Versioned Storage) 可用。此外,还提供了一个 Repository Folder 字段,用于指定或浏览选择存储库中的其他目标文件夹。单击
可打开 Add to Version Control 对话框,您可以在其中导航到存储库内的相应位置,并创建所需的文件夹结构。
-
Folder – 此字段用于指定要在工作区文件夹结构中的哪个位置创建待迁移项目的文件夹。新项目的默认路径在工作区浏览器界面的 Admin – Settings – Projects 页面中指定(默认情况下为
Projects\<ProjectName>)。单击
打开 Choose Folder 对话框,该对话框是 Explorer 面板的精简版,您可以在其中浏览并根据需要选择其他工作区文件夹。
-
使用 Make Available Online 对话框更改项目的 Name 并添加 Description。默认情况下,名称与原始项目相同。
勾选 Version Control 选项,将项目纳入工作区自带的内置 VCS(Git)管理。取消勾选此选项时(仅适用于 Altium 365 工作区),项目文件只会存储在工作区中,以提供基本访问,并支持与他人共享以供查看和评论,即 Simple Sync(简单同步)方式。建议启用版本控制,这样您就能充分使用工作区和 Altium 365 平台提供的功能。请注意,只有连接到 Altium 365 工作区时,才能在工作区中镜像项目(Simple Sync)。
单击对话框中的 Advanced 链接,显示 Folder 字段。此字段用于指定要在工作区文件夹结构中的哪个位置创建镜像项目的文件夹。新项目的默认路径在工作区浏览器界面的 Admin – Settings – Projects 页面中指定(默认情况下为 Projects\<ProjectName>)。如有需要,单击
按钮以浏览并选择其他工作区文件夹。
在 Make Available Online 对话框中按需设置项目迁移属性后,单击 OK。 对于未纳入外部版本控制的项目,将其发布到线上后(在 Altium 365 工作区中,已勾选 Version Control 选项),项目及其文件将提交并推送到工作区的 Versioned Storage 设计存储库。随后,Projects 面板将通过相应的
图标,反映工作区设计存储库与本地(工作副本)存储库之间的完全同步状态。该项目将成为真正的工作区项目,不仅仅是在工作区中“注册”,而是实际提交并纳入工作区的版本控制。对设计所做的任何更改都必须保存(提交/推送)回工作区中的存储库。
使用现有外部版本控制存储库时的限制
如前所述,您的本地设计可能已由现有的外部版本控制系统(Git、SVN、EPDM 等)跟踪。使用 Altium 365 工作区时,您可以继续沿用此设置,只需使用 Make Project Available Online 功能将设计注册到工作区,即可在工作区中访问这些设计。
在此模式下,每当您更改设计并将这些更改提交到外部 VCS 存储库时,该设计数据就会在后台镜像到工作区,并照常执行所有必要的处理,例如预览、使用位置分析等。不过,您需要注意以下限制:
- 创建新的设计项目仍须遵循之前的流程,即在外部 VCS 系统中手动创建项目。然后,使用 Make Project Available Online 功能将项目注册并镜像到工作区。
-
如果对设计进行了更改,但使用外部工具而非 Altium Designer 执行提交/推送,这些更改将不会显示在工作区中的镜像项目中。下次在 Altium Designer 中重新打开项目时,此问题将得到纠正,系统会自动将本地项目与工作区中的镜像版本同步。如果更改由其他用户完成,则重新打开的项目文件将显示为
Out Of Date(
),可使用版本控制命令 Update 进行纠正。
- 其他人打开该项目时,需要具有该外部 VCS 存储库的访问权限。
- 必须在两个位置设置和维护权限管理:工作区和主源存储库(外部 Git/SVN 等 VCS 存储库)。
- Altium 365 平台提供的某些功能,仅适用于纳入工作区原生版本控制系统管理的项目。如果您的项目仍使用外部版本控制系统,那么即使平台推出了这些功能,您也无法使用。您可以从外部 VCS 迁移到工作区原生 VCS,有关具体操作步骤,请参阅下一节。
使用 GitHub
使用 GitHub 平台作为外部版本控制系统(VCS)是托管和共享设计项目的一种常见方式,Altium Designer 支持 Git 仓库。如上文关于 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 目前仅支持使用 HTTP/HTTPS 协议连接本地 Git 仓库及其远程主仓库。实际使用的协议由远程仓库连接所指定的 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 设置。
可以使用 git remote set-url <name> <URL> 命令为仓库重新配置其他 URL,例如使用 HTTPS 协议以兼容 Altium Designer,其中 URL 的前缀指定协议类型。
更改远程仓库连接 URL 的协议,然后使用 remote 命令进行确认。
从外部 VCS 迁移到工作区原生 VCS
连接到 Altium 365 工作区后,Altium Designer 还支持将使用外部 VCS 系统的项目完整地migrate为完全托管的工作区项目,其设计文件托管在工作区自身的 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 的版本提交历史记录。请注意,如果不勾选迁移选项,项目将镜像到工作区(简单同步配置),同时仍使用外部仓库作为其 VCS 存储。
要将本地 VCS 项目迁移为 Altium 365 工作区中完全托管的 VCS 项目,请在将项目上线时勾选 VCS 迁移选项。
随后会打开 Migrate Project 对话框,提醒您项目即将迁移至工作区 VCS 的完全管理之下。单击 Browse 按钮,在硬盘上选择一个文件夹,用于创建新的(基于 Git 的)本地项目仓库。单击 Migrate 按钮继续迁移。

Migrate Project 对话框
按照提示完成操作(其中包括执行最后一次 VCS 提交)后,项目便会纳入工作区 Git 仓库的版本控制。外部 VCS 的提交历史记录及其注释/消息会迁移到新的工作区 VCS 项目中,您可以在 Altium Designer 的 History 视图中查看:在 Projects 面板中右键单击项目名称,然后选择 History & Version Control » Show Project History 命令。
迁移时,项目的外部 VCS 提交历史记录(左侧所示)会转移到 Altium Designer 的 History 视图(右侧)中。
如果外部 VCS 项目已作为镜像项目(本地与服务器文件同步)在 Altium 365 工作区中进行管理,则可以使用 Migrate to Altium Versioned Storage 命令将其 VCS 文件迁移到服务器的原生 Git 仓库。该命令可从项目历史视图、项目选项对话框 或项目面板 History & Version Control的右键快捷菜单中访问。
对于已与工作区同步(镜像到工作区)的 VCS 项目,可使用 Migrate Project to Altium Version Control 选项进行迁移。
迁移后的协作
-
工作区团队成员将项目迁移到 Altium 版本化存储后,需要确保其他项目协作者连接到团队工作区,然后更新其本地(工作)项目副本。Projects 面板中,项目文件旁的
图标(已过期)表示需要更新,可通过 Project » History & Version Control » Update Whole Project 命令执行更新。
- 迁移后的项目更新完成后,Altium Designer 会提示通过重建项目的本地工作文件夹来更新指向新仓库的链接。在 Fix version control link 对话框中选择推荐选项,即可完成本地项目更新。
- 请注意,如果项目协作者not连接到团队工作区,随后提交了 VCS 设计更改,这些更改仍会记录到外部仓库中,因此会与迁移后的工作区 VCS 项目不同步。
- 迁移期间,Altium Designer 会向原始仓库执行一次提交,以设置通知标记,使其他团队成员使用的 Altium Designer 能够识别出该项目已迁移。
将项目从外部 VCS 手动迁移到工作区 VCS
在某些情况下,您可能希望手动将使用外部 VCS 仓库的项目迁移为完全由 Altium 工作区及其原生 Git VCS 仓库管理的项目。为此,可以先创建项目快照,使其断开与外部 VCS 以及工作区(如果之前已提供到工作区)的连接,然后再次将其提供到工作区,但这次使用工作区的 VCS,相当于重新开始。具体操作步骤如下:
- 断开项目与外部版本控制系统的连接(从中移除项目)。您可以通过当前 VCS 的外部接口工具执行此操作,也可以通过 Altium Designer 执行。对于后者,虽然项目面板和存储管理器面板都提供了将项目从版本控制中移除的命令,但最彻底的方法是使用项目打包器。使用 Project Packager 将创建不包含版本控制信息的项目快照;如果您之前已将项目提供到工作区,它还会移除指向工作区中项目的链接。
- 从 Project Packager 创建的 Zip 压缩包中解压出“清理后”的项目。
- 在 Altium Designer 中打开项目。请注意,它既不受工作区管理(如果之前受管理),也不受版本控制。因此,这是一个干净的、未受管理的项目。
-
仅当您之前已将项目提供到工作区时,才需要执行此步骤。打包过程已解除项目链接,但工作区中的镜像项目仍保持不变。您应先删除服务器端的项目。访问工作区的浏览器界面(通过 Altium 365 平台界面)。在 Projects 页面中,单击选中要删除的项目,然后单击
控件,并从快捷菜单中选择 Delete 命令。
- 现在,再次将项目提供到在线工作区。为此,在项目面板中右键单击其条目,然后从快捷菜单中选择 Make Project Available Online ,打开 Make Available Online 对话框。确保启用启用正式版本控制选项,因为此选项会将项目纳入工作区自身内置的 VCS(Git)管理。
从工作区的 SVN 迁移到工作区的 Git
当 Altium Designer 已连接到 Enterprise Server 工作区,且设计项目存储在通过工作区的 版本控制服务管理的 SVN 存储库中时,您可以将此项目从 SVN 存储库迁移到工作区的内置 Git 存储库(Versioned Storage)。为此,请在 Projects 面板中右键单击该项目条目,然后从右键菜单中选择 History & Version Control » Migrate Project to Altium Versioned Storage 命令。或者,单击 Project Options 对话框中的 Migrate to Server Versioned Storage 按钮。
按照提示操作(包括执行最后一次 VCS 提交)后,项目将迁移到工作区 Git 存储库的版本控制中。
控制项目同步
本地项目在工作区中可用后,您可以通过 Project Options 对话框的 常规选项卡控制其在线可用性和同步。

与项目在线可用性相关的选项和控件位于 Project Options 对话框的 General 选项卡中。
使用该选项卡 General 区域中的选项可修改项目描述。此操作仅影响工作区中的项目。
在该选项卡的 Online Availability and Synchronization 区域中,Version Control 选项反映了当前的在线可用方式:
-
Option Enabled – 项目(及其源文件)存储在工作区自身的原生 VCS(Git)中。这是推荐的方式,因为这样您可以充分利用工作区和 Altium 365 平台提供的全部功能。
-
Option Disabled – 项目文件存储在工作区中,以提供基本访问,并允许与他人共享,但仅供查看和评论——即 Simple Sync 方式(仅适用于 Altium 365 工作区)。
可根据需要使用此选项在这两种方式之间切换。
如果您希望停止本地项目与工作区中对应项目之间的同步,请单击
按钮。此时将显示 Turn off project synchronization 窗口。单击 Unlink 选项,然后返回 Project Options 对话框并单击 OK 。本地项目将不再与工作区中的项目关联。
保存本地项目后,项目面板中会体现这一变化:项目将显示在当前项目组(*.DsnWrk)下,而不再作为当前工作区下的条目显示。由于指向工作区中项目的链接会从项目文件中移除,因此需要执行保存操作。
工作区中的项目不受影响——此操作不会将其移除。
您随时可以将本地项目作为镜像项目或完整 VCS 项目(Version Control)重新上线。连接到 Altium 365 工作区时,Project Options 对话框的 General 选项卡中会显示
按钮,单击该按钮可打开 Make Available Online 对话框。





