StonesAndDice/gnubg-unity-installer
GitHub: StonesAndDice/gnubg-unity-installer
一个 Unity Package Manager 包,用于自动下载并配置跨平台的 GNU Backgammon 运行时二进制文件到 Unity 项目中。
Stars: 0 | Forks: 0
# GNUBG Unity 安装程序 (UPM)
Unity Package Manager 安装程序,从 GitHub Releases 下载 GNUBG 二进制文件,并将其解压到 Assets/StreamingAssets/gnubg。
您*不必*非要这样做,但这确实是最简洁的设置方式:
本仓库包含一个 Unity Package Manager (UPM) 包,用于将 GNU Backgammon (GNUBG) 运行时二进制文件安装到 Unity 项目中。
在安装时(或通过菜单),该包会从单独的 GitHub Releases 仓库下载预构建的 GNUBG 包,然后将其解压到:
```
Assets/StreamingAssets/gnubg/
windows/
macos/
linux/
```
这种布局旨在支持 Unity 桥接程序,以便从 `StreamingAssets` 启动 `gnubg-cli`。
## 此包的功能
- 从配置的构建仓库获取**最新的 GitHub Release** 元数据
- 下载以下资源:
- `gnubg-windows.zip`
- `gnubg-macos.zip`
- `gnubg-linux.zip`
- 将每个 zip 解压到 `Assets/StreamingAssets/gnubg//`
- 统一可执行文件名称为:
- Windows: `gnubg-cli.exe`
- macOS/Linux: `gnubg-cli`
- 确保 macOS/Linux 上的可执行权限(Editor 端)
## 系统要求
- 推荐使用 Unity 2021.3+
- 安装/更新期间需要网络访问(Editor)
- 需要一个通过 GitHub Releases 发布 GNUBG zip 资源的构建仓库
## 安装
Unity **Package Manager → Add package from git URL…**
使用:
```
[https://github.com/](https://github.com/)/.git?path=/Packages/com.stonesanddice.gnubg.installer#v0.1.0
```
将 `` 和 `` 替换为本仓库。
## 配置构建仓库
安装程序需要知道从哪里下载 GNUBG 二进制文件。
编辑:
```
Packages/com.stonesanddice.gnubg.installer/Editor/GnubgInstaller.cs
```
设置:
- `GitHubOwner`
- `GitHubRepo`
构建仓库必须发布以下 release 资源:
- `gnubg-windows.zip`
- `gnubg-macos.zip`
- `gnubg-linux.zip`
## 安装 / 更新二进制文件
菜单:
**Tools → GNUBG → Install or Update Binaries**
这将下载所有平台的文件并解压到 `Assets/StreamingAssets/gnubg/`。
## 每个 zip 内预期的文件布局
每个 zip 应包含一个以平台命名的单个顶层文件夹,或直接包含文件内容。如有需要,安装程序可以展平额外的一层平台文件夹。
推荐的 zip 内容:
```
windows/
gnubg-cli.exe
*.dll
share/gnubg/...
lib/python3.12/... (if embedding python)
macos/
gnubg-cli
share/gnubg/...
linux/
gnubg-cli
share/gnubg/...
```
## 嵌入式 Python 说明
如果您的 GNUBG 构建包含嵌入式 Python,请确保 Windows zip 包含:
- `lib/python3.12/`(包括 `encodings/`)
- `lib/python312.zip`(如果您的构建需要)
如果您的运行时设置了 `PYTHONHOME`/`PYTHONPATH`,请将其设置为相对于解压文件夹的路径。
标签:CSharp, DNS 反向解析, GitHub Releases, GNU Backgammon, GNUBG, IP 地址批量处理, StreamingAssets, Unity, Unity Editor Extension, Unity Package Manager, UPM, 下载器, 包管理器, 安装程序, 工具库, 游戏开发, 统一API, 网络信息收集, 网络调试, 自动化, 西洋双陆棋, 解压缩, 资源管理, 运行时二进制文件