了解Edgegap的工作原理

了解Edgegap的工作原理

/

Unity Package Manager

/

Unity Package Manager

部署至 Edgegap

已发布

已发布

已发布

最近一次准确性审核

最近一次准确性审核

最近一次准确性审核

Unity Package Manager:如何从 Git URL 安装软件包

Unity Package Manager:如何从 Git URL 安装软件包

本指南将向您展示如何通过 Package Manager 窗口或编辑项目的 manifest,直接从 Git 仓库在 Unity 中安装软件包,以及如何固定版本、从子文件夹安装、访问私有仓库和解决常见错误。我们以 Edgegap 的 Unity 软件包为例;这些步骤适用于托管在 Git 上的任何软件包。

Edgegap 在专用服务器上托管多人游戏。一旦您的游戏服务器容器化,Edgegap 只需通过一个简单的 API 调用即可将其(按需)部署到全球 615+ 个边缘云节点,并完全按用量计费:无需在比赛之间租用、配置或维持整台服务器运行。对于保留容量的持久服务器,Edgegap 提供了专用队列 (Private Fleets)。Edgegap 的對局配對构建在此基础之上,并且是可选的。

想要托管整个 Unity 游戏?请参阅 Unity Engine 了解从专用服务器构建到撮合匹配的完整路径。

无需信用卡。免费版包含部署真实游戏服务器所需的资源。

无需信用卡。免费版包含部署真实游戏服务器所需的资源。

分步指南

详细集成步骤

1. 开始之前:安装 Git

Unity 的 Package Manager 本身并不下载 Git 软件包:它会运行安装在计算机上的 Git 客户端。

  • PATH 中需要有 Git 2.14.0 或更高版本。macOS 通常已自带该工具(Xcode Command Line Tools)。在 Windows 上,请安装 Git 并保留安装程序的默认选项,以便将 Git 添加到 PATH 中。

  • 安装 Git 后重启 Unity 和 Unity Hub,以便它们识别新的 PATH。

  • Git LFS,仅当软件包使用 Git LFS 存储大文件时才需要。如果没有 LFS 客户端,Unity 会检出微小的指针文件而非实际资源,且不会报错。

  • 任何较新的 Unity 版本。以下步骤使用的是 Unity 6.3 LTS。

检查是否生效:打开一个新的终端并运行 git --version。

2. 在包管理器中通过 Git URL 安装包

  1. 在 Unity 中,打开 Window → Package Manager(在较新的 Unity 6 版本中为 Window → Package Management → Package Manager)。

  2. 选择左上角的 +,然后选择 Install package from git URL(在较旧版本中称为 Add package from git URL)。

  3. 粘贴以 .git 结尾的仓库 URL。对于 Edgegap 插件:https://github.com/edgegap/edgegap-unity-plugin.git

  4. 选择 Install。

几秒钟后,该包将显示在列表中,并带有 Git 标签。如果失败,可在 Unity 控制台(Console)中查看原因。

3. 或者通过编辑 manifest.json 进行安装

项目使用的每个包都会列在 Packages/manifest.json 中。在此处添加 Git URL 与使用 Package Manager 的效果相同,并且便于通过版本控制共享或让编码智能体(agent)来执行。

打开 Packages/manifest.json 并在 dependencies 下添加一行,以包名作为键(key),Git URL 作为值(value):

"com.edgegap.unity-sdk": "https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5",

保存文件并返回 Unity:系统便会安装该包。

配合您的智能体使用:

“通过 Packages/manifest.json 中的 Git URL 将 Edgegap Unity SDK 3.5.5 添加到该项目中。”

Git URL 只能添加到项目的 manifest.json 中,绝不能添加到包本身的 package.json 中。

4. 固定版本、更新或从子文件夹安装

  • 固定版本:在 URL 中添加 # 以及标签、分支或完整的 commit 哈希,例如 https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5。短 commit 哈希不起作用。如果不添加 #,你将获得默认分支的最新 commit。

  • 锁定:Unity 会记录其安装的确切 commit,以便你的团队成员获得相同的版本。分支名称本身不会自动向前移动更新。

  • 更新:从 + → 从 git URL 安装软件包 (Install package from git URL) 重新安装相同的 URL,或者将 # 标签更改为较新的版本。

  • 子文件夹:如果软件包不在代码仓库的根目录下,请在任何 # 之前添加 ?path= 以及包含其 package.json 的文件夹:https://github.com/owner/repo.git?path=/MyPackage#v1.2.3。顺序相反将导致失败。

  • 私有仓库:Unity 无法提示输入密码。对于 HTTPS,请先设置 Git 凭据助手 (credential helper)。对于 SSH (git@github.com:owner/repo.git),请在 Unity 外部设置你的 SSH 密钥;受密码短语保护的密钥只能通过 ssh-agent 等代理生效。

5. Edgegap 的 Unity 资源包

  • Edgegap 适用于 Unity 的自动化游戏服务器构建工具插件:通过 Unity 编辑器中的按钮构建您的 Linux 服务器、将其容器化并部署到云端。URL:https://github.com/edgegap/edgegap-unity-plugin.git。在 Tools → Edgegap Server Hosting 下打开它。

  • Edgegap Unity SDK:您的游戏在运行时使用的匹配客户端和服务器代码。URL:https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5。浏览器 (WebGL) 构建需要 3.5.5 或更高版本。

正在使用 Mirror?最近的 Mirror 版本已经包含了 Edgegap 插件(Assets/Mirror/Hosting/Edgegap)。切勿再次从 Git 安装,否则 Unity 会报告脚本重复。

6. 下一步:添加匹配机制

安装 Edgegap SDK 后,您的游戏可以对玩家进行分组,并在他们附近自动启动专用服务器。有关设置,请参阅 Unity 對局配對 SDK;或参阅 Unity Engine,从您的专用服务器版本开始。

7. 检查安装

  1. 在 Package Manager 中,选择 In Project:该包已列出,并带有 Git 标签及其版本或提交。

  2. Unity 控制台未显示任何 Package Manager 错误。

  3. 对于 Edgegap 的插件,通过 Tools → Edgegap Server Hosting 可打开插件窗口。

常见问题

关于通过 Git URL 安装 Unity Package 的常见问题。

如何在 Unity 中解决“未找到 ‘git’ 可执行文件”(No 'git' executable was found)的问题?

安装 Git 2.14.0 或更高版本并确保它已添加到您的 PATH 环境变量中,然后重启 Unity 和 Unity Hub。在 Windows 上,Git 安装程序的默认选项会将其添加到您的 PATH。在新的终端中运行 git --version 进行检查。

如何从 Git 安装特定版本的 Unity 软件包?

在 Git URL 末尾添加 # 以及标签、分支或完整的提交哈希,例如 https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5。如果不添加,Unity 将安装默认分支的最新提交。

如何更新通过 Git 安装的 Unity 资源包?

从 Package Manager 的 + 菜单再次安装相同的 Git URL,或者在 Packages/manifest.json 中更改 # 后面的版本。Unity 会锁定其安装的提交,因此它不会自行更新。

Unity 可以从私有 Git 仓库安装 Package 包吗?

是的。Unity 无法请求密码,因此在安装之前,请针对 HTTPS 设置 Git 凭据助手,或针对 SSH URL 设置 SSH 密钥。受密码保护的 SSH 密钥需要像 ssh-agent 这样的代理。

为什么在安装 Edgegap 插件后会出现重复脚本错误?

您的项目已包含该插件,这通常是因为最近的 Mirror 版本将其包含在 Assets/Mirror/Hosting/Edgegap 下。请删除其中一份:保留 Mirror 的版本,或者删除该文件夹并使用 Git 软件包。

客户

了解更多已接入 Edgegap 的客户案例

提供 31 个从其他平台迁移至 Edgegap 的工作室案例研究。

他们选择 Edgegap 的关键原因

了解 Edgegap 自动化游戏服务器编排如何带来无缝的多人游戏体验。

费用

定价

定价

通过混合编排优化成本与性能

通过混合编排优化成本与性能

通过混合编排优化成本与性能

边缘云

按需

$0.00115

/ vCPU

/ 分钟

按分钟计费,仅按实际使用量收费

只有在玩家在线玩游戏时才需付费。0 个活动服务器 = $0

在全球 615 多个边缘云节点中按实例部署游戏服务器。零承诺。

只需添加信用卡。

边缘云

按需

$0.00115

/ vCPU

/ 分钟

按分钟计费,仅按实际使用量收费

只有在玩家在线玩游戏时才需付费。0 个活动服务器 = $0

在全球 615 多个边缘云节点中按实例部署游戏服务器。零承诺。

只需添加信用卡。

专属物理机集群 (裸金属)

预留容量

$0.0261

/ vCPU

/ 小时

按月计费,始终开启

每个主机每月 $280(12个月标准价),或按月支付每月 $350

通过无出站流量费用的专用机队托管,优化您游戏服务器的成本效益。

持久在线,24/7全天候可用,您的工作室专属。

专属物理机集群 (裸金属)

预留容量

$0.0261

/ vCPU

/ 小时

按月计费,始终开启

每个主机每月 $280(12个月标准价),或按月支付每月 $350

通过无出站流量费用的专用机队托管,优化您游戏服务器的成本效益。

持久在线,24/7全天候可用,您的工作室专属。

您的账单因费率和使用量而异;这可能会根据游戏类型、玩家人数等因素而有所不同。

您的账单因费率和使用量而异;这可能会根据游戏类型、玩家人数等因素而有所不同。

使用我们的预估计算器模拟您的用量 ->

使用我们的预估计算器模拟您的用量 ->

Edgegap 的功能与价格:边缘云与私有集群(Private Fleets)详细对比

Edgegap 的功能与价格:边缘云与私有集群(Private Fleets)详细对比

对比

免费试用

边缘云

Private Fleets

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

在帐户中添加信用卡后,即可解锁各项功能。

对比

免费试用

边缘云

Private Fleets

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

在帐户中添加信用卡后,即可解锁各项功能。

对比

免费试用

边缘云

Private Fleets

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

在帐户中添加信用卡后,即可解锁各项功能。